- Extract & install dependency
unzip urunan-iuran-source.zip -d urunan-iuran
cd urunan-iuran
npm install
- Jalankan langsung (mode demo, tanpa setup apa-apa)
npm run dev
Buka http://localhost:3000 — aplikasi langsung jalan pakai data contoh (tidak konek ke database manapun). Cocok buat lihat-lihat tampilan/fitur dulu.
3. Setup database asli (Supabase) — kalau mau data beneran & bisa disimpan
- Buat project baru di supabase.com → catat Project URL, anon key, dan service_role key (Settings → API).
- Salin .env.example jadi .env.local:
cp .env.example .env.local
- isi .env.local dengan kredensial Supabase tadi:
NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=xxxxx
SUPABASE_SERVICE_ROLE_KEY=xxxxx
- Migrasi skema database
File migrasi ada di folder supabase/migrations/ (urut sesuai nomor file). Ada dua cara:
- via supabase
npx supabase login
npx supabase link --project-ref xxxxx
npx supabase db push
- Manual via SQL Editor: buka Supabase Dashboard → SQL Editor → copy-paste isi tiap file di supabase/migrations/ satu per satu, urut dari nomor terkecil, lalu klik Run. Juga jalankan setup_db.sql di root project kalau ada tabel tambahan di situ.
- Isi data contoh (opsional, biar dashboard nggak kosong)
npx tsx scripts/seed-supabase.ts
Script ini bikin 5 perumahan, 10 warga per perumahan, admin, data keuangan, dan tagihan dengan berbagai status (lunas/tunggakan/pending) — otomatis aman dijalankan ulang.
6. Jalankan ulang aplikasi
npm run dev
- (Opsional) Aktifkan pembayaran & notifikasi WA asli
- Paywuz: isi PAYWUZ_API_KEY di .env.local (dari dashboard Paywuz), lalu set Payment Notification URL di dashboard Paywuz ke http://localhost:3000/api/payments/paywuz-notification (pakai tool seperti ngrok kalau perlu expose ke internet untuk testing webhook).
- Fonnte (reminder WA): daftar & connect device di fonnte.com, salin token ke FONNTE_TOKEN.
- Denda otomatis: opsional, jadwalkan select public.apply_overdue_fines(); via pg_cron di Supabase kalau mau denda keterlambatan jalan otomatis tiap hari.