🕋

Prompt dan Source Code Aplikasi Sikurban

Sistem Manajemen Qurban Modern & Anti Ribet

Apa Itu Ibadah Qurban?

Ibadah Qurban adalah salah satu ibadah sangat mulia dalam ajaran agama Islam yang dilaksanakan pada bulan Dzulhijjah (tepatnya pada Hari Raya Idul Adha dan hari-hari Tasyrik). Ibadah ini dilakukan dengan menyembelih hewan ternak (seperti sapi, kambing, domba, atau unta) dengan niat mendekatkan diri (taqarrub) kepada Allah SWT.

Selain bernilai ibadah yang sangat tinggi, Qurban juga memiliki dimensi sosial yang luar biasa. Daging hewan qurban didistribusikan kepada kaum fakir miskin, kerabat, tetangga, serta warga sekitar. Pengelolaan dan pendistribusian yang adil menuntut panitia untuk bekerja secara profesional dan terorganisir.

Teknologi Di Balik "Sikurban": Google Apps Script & Blogger

Aplikasi Sikurban diciptakan agar panitia dapat mengelola dana iuran peserta, mencetak kwitansi/kartu ber-stempel dan tanda tangan digital, hingga menerbitkan kupon daging anti-ganda (dilengkapi scanner barcode).

Apa Itu Google Apps Script (GAS)?

Google Apps Script adalah platform berbasis JavaScript dari Google yang memungkinkan kita membuat aplikasi "Back-End" secara gratis. Dalam aplikasi ini, GAS berfungsi sebagai otak yang menyimpan semua data peserta dan keuangan langsung ke dalam Google Sheets (Spreadsheet).
Manfaat untuk Panitia: Data aman, tidak akan hilang, bisa diakses dari mana saja, dan tidak memerlukan biaya sewa server/hosting (100% Gratis).

Apa Itu Blogger (XML Template)?

Blogger adalah platform blogging gratis dari Google. Kita menyulap Blogger menjadi "Front-End" (Tampilan Layar) dari aplikasi Sikurban dengan memasukkan kode HTML/XML khusus.
Manfaat untuk Panitia: Sangat responsif (mudah dibuka di HP panitia), tampilannya seperti aplikasi premium sungguhan, mudah diedit, dan loadingnya sangat ringan tanpa batas limit traffic.

Buat Mandiri Menggunakan AI (Prompt Detail)

Bagi Anda yang ingin meminta AI untuk membangun aplikasi ini dari awal secara mandiri, Anda dapat menggunakan perintah (prompt) komprehensif di bawah ini.

Bertindaklah sebagai Expert Full-Stack Developer. Buatkan saya aplikasi manajemen qurban bernama "Sikurban V3.2 Platinum".

Aplikasi terdiri dari 2 bagian:
1. FRONTEND: Menggunakan XML Blogger murni yang menyertakan Tailwind CSS, Html5Qrcode (untuk scan), dan jsPDF + AutoTable (untuk cetak dokumen). Harus satu file utuh yang responsif dan mobile friendly. Menu navigasi dapat digeser (horizontal scroll).
2. BACKEND: Menggunakan Google Apps Script yang terhubung ke Google Sheets dengan 4 sheet otomatis: 'Peserta', 'Kas', 'Settings', dan 'Scanned'. Wajib menggunakan LockService agar aman dari tabrakan data (Concurrency).

Fitur Frontend yang wajib ada:
- Tab Peserta: Input nama, jenis hewan (sapi/kambing), target iuran, status lunas, dan tombol bayar cicilan.
- Tab Keuangan: Dashboard total kas, pemasukan, pengeluaran, input pengeluaran, dan tabel riwayat transaksi.
- Tab Cetak Laporan: Cetak Laporan Keuangan (A4), Kartu Cicilan (PDF A5 dilengkapi QR code TTD, Barcode keaslian, Stempel Panitia dinamis via canvas), Laporan Distribusi Kupon, dan Cetak Kupon Daging massal (maksimal 100 per proses agar tidak memory crash).
- Tab Pengaturan: Input URL Google Apps Script, Nama Masjid, Alamat, Tahun H/M, Nama Ketua, Bendahara, Tempat TTD, dan tombol Reset Scanner.
- Tab Scan: Scanner barcode kamera (bisa swap kamera untuk desktop/HP) yang mencegah kupon ganda dan bisa validasi dokumen asli.
Tampilan harus modern dengan warna utama Emerald dan Slate. Gunakan SweetAlert2 untuk semua notifikasi dan konfirmasi. Jangan sertakan tag head bawaan blogger, gunakan b:include.

Download Skrip Database (Backend GS)

Jika Anda tidak ingin repot meng-generate melalui AI, silakan unduh Source Code Backend Google Apps Script (GS) yang sudah siap pakai, lengkap dengan proteksi anti-tabrakan data (Concurrency) melalui tombol di bawah ini.

Download Template Blogger (Frontend XML)

Silakan unduh file XML Tema Blogger yang berisi tampilan interaktif dan fungsionalitas utuh dari aplikasi Sikurban melalui tombol di bawah ini (File akan langsung terunduh secara otomatis).

Langkah-Langkah Instalasi & Setup

Ikuti panduan di bawah ini secara berurutan agar aplikasi dapat berjalan sempurna!

Tahap 1: Setup Database di Google Sheets

  • Buka Google Sheets Baru menggunakan akun Google Anda. Beri nama file tersebut (misal: "Database Sikurban").
  • Pada menu atas, klik Ekstensi lalu pilih Apps Script.
  • Hapus kode bawaan yang ada di editor. Buka file GS yang baru saja Anda download (menggunakan Notepad), Copy semua isinya, lalu Paste/Tempelkan ke dalam editor Apps Script tersebut.
  • Klik ikon Simpan (Disket) atau tekan Ctrl+S.
  • Klik tombol Terapkan (Deploy) berwarna biru di sudut kanan atas > pilih Deployment Baru.
  • Pilih Jenis (ikon roda gigi) > pilih Aplikasi Web.
  • Pada bagian "Siapa yang memiliki akses", WAJIB pilih "Siapa saja" (Anyone). Lalu klik Terapkan.
  • Berikan izin akses (Autorisasi). Jika ada peringatan keamanan, klik Lanjutan (Advanced) > Buka/Go to (Tidak aman) > Izinkan.
  • Salin URL Aplikasi Web yang muncul. Simpan link ini, kita akan menggunakannya sebentar lagi!

Tahap 2: Install Tema di Blogger

  • Buka dashboard Blogger Anda, buat Blog baru, dan beri nama "Aplikasi Qurban".
  • Pergi ke menu Tema (Theme) di bilah kiri.
  • Klik ikon panah kecil di sebelah tombol Sesuaikan, lalu pilih Edit HTML.
  • Hapus seluruh kode yang ada di dalam kotak editor HTML tersebut.
  • Buka file XML Tema yang Anda download (menggunakan Notepad atau text editor), Copy semua isinya, dan Paste ke dalam Blogger.
  • Klik ikon Simpan di pojok kanan atas.

Tahap 3: Menghubungkan Aplikasi & Database

  • Kembali ke Dashboard Blogger, klik menu Lihat Blog di bagian bawah kiri.
  • Aplikasi Sikurban akan terbuka! Pergi ke tab menu ⚙️ Pengaturan.
  • Paste/Tempelkan URL Aplikasi Web (Script URL) yang Anda dapatkan dari Tahap 1 ke dalam kolom pertama yang tersedia.
  • Isi data nama Masjid, Ketua Panitia, dan pengaturan lainnya.
  • Klik SIMPAN PENGATURAN & SYNC. Selamat! Aplikasi Sikurban Platinum Anda siap digunakan secara penuh.