Bendahara

Panduan Bendahara — pengurus keuangan komunitas. Semua langkah web only di gp2.halort.com/admin.

Akses menu

Menu admin	Akses bendahara
Dashboard	✓
Warga	✗
Pasar	✗
Keuangan	✓
Agenda	✗
Pengumuman	✗
Pengaduan	✗
Kampanye	✓
Pengaturan	✗

Masuk ke admin

1. Login di gp2.halort.com dengan akun bendahara.
2. Buka /admin/dashboard — ringkasan keuangan dan aktivitas terbaru.

Kelola keuangan

Modul Keuangan (/admin/keuangan) punya tab: Iuran · Kas · Anggaran · Pengeluaran · Laporan · Google Sheet.

Deep-link berguna:

• /admin/keuangan?tab=anggaran&kampanye_id=… — buka anggaran untuk kampanye tertentu (juga ada tombol Anggaran di menu Kampanye).
• /admin/keuangan?tab=sheet — setelah OAuth Google Sheet selesai, kembali ke tab ini.

1. Iuran

1. Form jenis — buat master jenis iuran (contoh: Iuran Bulanan, Sampah, Keamanan) dengan nominal default.
2. Tab Periode — buat periode per jenis + bulan/tahun, lalu Generate tagihan untuk semua unit rumah.
3. Tab Tagihan — lihat status per unit; Tandai lunas untuk pembayaran tunai/manual (tanpa bukti warga).
4. Tab Verifikasi — review pembayaran warga:
   • Upload bukti → Setujui / Tolak
   • Bayar online (Duitku) → menunggu gateway; setelah sukses otomatis lunas (tidak perlu setujui manual)

2. Kas

1. Lihat ringkasan saldo, total masuk, total keluar.
2. Catat transaksi masuk / keluar (untuk pengeluaran RT umum yang bukan kampanye).
3. Baris yang terkunci dari donasi tidak bisa diedit.

3. Anggaran

1. Filter tahun dan kampanye.
2. Tambah pos — item anggaran (estimasi, realisasi, sumber dana, catatan).
3. Realisasi naik otomatis bila pengeluaran kampanye ditautkan ke pos anggaran; bisa juga diedit manual.
4. Ringkasan: total estimasi, realisasi, sisa.

4. Pengeluaran

1. Catat pengeluaran terikat kampanye (opsional tautkan ke pos anggaran).
2. Edit / hapus baris yang sudah ada; bukti bisa berupa URL.
3. Pengeluaran kas RT umum tetap dicatat di tab Kas (jenis keluar).

5. Laporan

1. Pilih rentang tanggal (dari / sampai).
2. Lihat ringkasan arus kas.
3. Unduh Excel: arus kas, iuran, pengeluaran, atau neraca (ringkasan kas + anggaran + cuplikan pengeluaran kampanye).

Ringkasan kas publik untuk warga: Laporan warga.

6. Google Sheet

1. Isi Spreadsheet ID (dari URL docs.google.com/spreadsheets/d/<ID>/…).
2. Sesuaikan nama tab (Kas, Iuran, Pengeluaran, Donasi, Summary) bila perlu.
3. Hubungkan Google (OAuth) — butuh GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET di API. Atau unggah service account JSON lewat API credentials_json.
4. Centang Auto-sync berkala agar server menyinkronkan tab setiap beberapa jam (bisa dimatikan kapan saja).
5. Sync semua atau sync per tab. Log hasil muncul di bawah panel.

Checklist Google Cloud (operator platform):

1. Enable Google Sheets API di project yang sama dengan login OAuth.
2. OAuth consent screen → add scope https://www.googleapis.com/auth/spreadsheets.
3. Authorized redirect URI tetap {API}/api/auth/google/callback (sama dengan login).

Kelola kampanye

1. Admin → Kampanye (/admin/campaign).
2. Buat kampanye — judul, target donasi, deskripsi, periode.
3. Publikasikan — warga donasi lewat web/mobile (Kampanye warga).
4. Verifikasi donasi — setujui/tolak bukti transfer donatur.
5. Tombol Anggaran — lompat ke Keuangan → Anggaran untuk kampanye itu.
6. Pantau progres vs target di dashboard kampanye.

Billing SaaS HaloRT (pengurus)

Ini langganan platform (bukan iuran warga). Lihat juga Duitku SaaS Billing.

1. Pengaturan → Layanan — pilih paket, bayar lewat Duitku, lihat riwayat invoice.
2. Email kwitansi PDF — setelah bayar sukses, pengurus menerima email SUBSCRIPTION_INVOICE_PAID dengan lampiran halort-invoice-….pdf.
3. Pengingat perpanjangan — ±14 hari sebelum masa aktif berakhir:
   • Email SUBSCRIPTION_RENEWAL_DUE (+ PDF tagihan)
   • WhatsApp ke no_wa pengurus (jika Fonnte dikonfigurasi)

Alur verifikasi tipikal

Warga bayar iuran
  → Upload bukti  → Bendahara Setujui/Tolak di Keuangan → Iuran
  → ATAU Bayar online (Duitku) → callback otomatis lunas + kas masuk
Donasi kampanye → unggah bukti → Bendahara review di Kampanye
→ Status otomatis ke warga (web + mobile)

Lihat juga

• Iuran (sisi warga)
• Laporan keuangan (sisi warga)
• Admin Ketua RT
• Billing SaaS HaloRT — bukan iuran warga