# Rancangan dan skema
Monolit Laravel 12: Blade merender halaman, Tailwind lokal untuk tampilan, Alpine lokal untuk interaksi. Controller menangani validasi/otorisasi; Ledger menangani pembukuan transaksional; Midtrans melakukan verifikasi server; ZakatCalculator memakai profil berversi. Tidak ada multi-lembaga.

| Folder | Isi |
|---|---|
| app/Http/Controllers | Publik, akun, donasi, zakat, dashboard |
| app/Http/Middleware | Kunci instalasi, peran, header keamanan |
| app/Models, app/Services | Entitas, ledger, gateway, kalkulator, ekspor, audit |
| database/migrations, database/seeders | Skema, data awal, demo opsional |
| resources/views | Blade publik, pengelola, formulir, PDF |
| resources/css, resources/js | Sumber Tailwind dan Alpine |
| public/assets | Aset hasil build, tanpa CDN |
| public/install.php | Installer mandiri |
| storage/app/private | Bukti dan berkas sementara privat |
| storage/app/public | Gambar via rute media tervalidasi |
| tests, scripts | Pengujian dan pengemasan |
| vendor | Dependensi PHP produksi |

| Tabel | Isi / relasi |
|---|---|
| users | Akun donatur dan 4 peran petugas |
| password_reset_tokens | Hash token pemulihan |
| settings | Identitas, gateway, mutex keuangan |
| categories | Kelompok program |
| campaigns | FK kategori, target, jadwal, publikasi, demo |
| posts | Berita/halaman/banner/pembaruan, FK program opsional |
| bank_accounts | Rekening penerimaan |
| zakat_rules | Jenis, wilayah, tahun, versi, parameter, pengesahan |
| donations | Nomor/UUID, pemilik, program, data privat, tagihan, snapshot |
| ledger_entries | Payment/refund/fee/disbursement, nominal, dana, kunci unik |
| audit_logs | Pelaku, waktu, tindakan, perubahan penting |
| notification_logs | Status pengiriman WhatsApp unik per transaksi dan peristiwa |

Kategori memiliki program; program memiliki tagihan dan pembaruan; tagihan memiliki ledger; pengguna memiliki donasi dan tindakan. Snapshot perhitungan tidak bergantung pada perubahan aturan berikutnya.

Nominal memakai BIGINT Rupiah; bobot dihitung dalam bilangan bulat per seribu gram/kg. Pembulatan ke atas ke Rupiah penuh. Row lock pada finance_mutex/entitas serta kunci unik idempotensi menertibkan pencatatan InnoDB. Bukti privat tidak memiliki URL publik.

Asumsi: IDR, domain khusus tanpa subfolder, satu tujuan per tagihan, pencatatan refund/penyaluran setelah transfer nyata. Tata kelola dan legalitas lembaga diisi pemilik.

Versi 1.1 menambah tabel tripay_payments (relasi satu-ke-satu dengan donations): mode asal, referensi unik per mode, kanal, total, biaya pelanggan/merchant, penerimaan bersih dan status penyedia. Layanan Tripay memverifikasi callback dan API; UpgradeController menjalankan migrasi tambahan melalui Super Admin.

Versi 1.3 menambah `users.phone` terenkripsi dan `users.phone_hash` unik untuk akun berbasis nomor WhatsApp. Kolom lama `donations.whatsapp_opt_in` dipertahankan untuk kompatibilitas, selalu bernilai aktif pada transaksi baru, dan tidak lagi ditampilkan sebagai checkbox. `notification_logs` memakai kunci unik `(donation_id, channel, event)` serta status pengiriman untuk mencegah pengiriman ulang setelah Fonnte menerima permintaan. Scheduler menangani pengingat dan percobaan ulang; konfirmasi pertama dipicu setelah transaksi ledger paling luar berhasil commit.
