1. Ruang lingkup peran

Super admin adalah pemegang akses tertinggi. Semua data seluruh sistem air se-Kabupaten Pekalongan terlihat tanpa penyaringan, dan seluruh menu panel tampil. Beberapa menu hanya muncul untuk peran ini:

• Pengaduan Masyarakat (seluruh aduan warga se-kabupaten)
• Data Penduduk Desa
• Foto Dokumentasi (konten website)
• Usulan Program (rekap pengajuan dari form publik)
• Backup & Restore basis data
• Widget Mode Pemeliharaan

2. Masuk panel admin

1. Buka /admin pada peramban.
2. Masuk dengan email dan kata sandi akun super admin.
3. Menu di sisi kiri dikelompokkan: Master Data, Manajemen Sistem Air, Keuangan, Pengaduan, Data Demografi, Usulan Program, Konten Website, Analitik.

3. Dashboard

Dashboard menampilkan widget ringkasan lintas sistem air:

• Ringkasan sistem air, keberfungsian, dan kesehatan sistem
• Distribusi sumber air dan jenis sistem
• Kapasitas produksi dan investasi/anggaran
• Cakupan penduduk terlayani
• Widget Mode Pemeliharaan untuk mematikan sementara dashboard publik

Menu Analitik → Peta menampilkan sebaran unit dalam peta interaktif.

4. Data sistem air

Master Data → Sistem Air. Isian utama:

Nama kecamatan dan desa otomatis terisi dari pilihan wilayah, jadi cukup pilih dari dropdown.

5. Tarif, biaya & Gateway Pembayaran Midtrans

Pengaturan tarif dan gateway pembayaran diatur langsung pada form sistem air:

• Tarif tetap — satu harga per m³.
• Tarif progresif — 4 blok bertingkat: batas blok 1, 2, 3 beserta tarif tiap blok dan tarif blok ke-4 (di atas batas 3). Perhitungan kumulatif: tiap m³ dihitung sesuai bloknya.
• Abonemen (biaya langganan tetap per tagihan) serta biaya admin & biaya transaksi.

Arsitektur Pembayaran Cashless (Midtrans) Multi-Merchant:

6. Pelanggan & kode QR

• Nomor pelanggan otomatis dengan pola NNN-YYYY-NNNN (kode sistem air, tahun, urutan). Jangan diisi manual; tersedia aksi Regenerate Number dan versi massalnya bila perlu penataan ulang.
• Impor pelanggan dari berkas — unduh dulu templatnya lewat tombol Download Template agar kolomnya sesuai.
• Generate QR per pelanggan dan Print QR; tersedia Print QR Codes massal untuk banyak pelanggan sekaligus (keluaran PDF).
• QR berisi nomor pelanggan. Saat dipindai aplikasi mobile, data pelanggan dan tarifnya ditarik dari server.

7. Aset

Master Data → Aset mencatat sarana tiap unit (jenis aset, kondisi, lokasi/koordinat). Petugas lapangan dapat memperbarui titik koordinat aset dari aplikasi mobile bila diberi izin update_asset_location.

8. Pencatatan meter & tagihan

Manajemen Sistem Air → Pencatatan Meter. Alur status tagihan:

• Pemakaian dan total tagihan dihitung otomatis dari angka meter sekarang dikurangi angka sebelumnya; angka sebelumnya diambil dari pencatatan terakhir pelanggan.
• Aksi baris: Konfirmasi, Terima Tunai, Lihat Nota, Cetak Nota.
• Aksi massal: konfirmasi banyak baris, tandai tertagih, dan Cetak Nota Massal.
• Saat status berubah menjadi paid (baik via tunai maupun Webhook Midtrans), sistem otomatis membuat catatan pemasukan keuangan kategori Tagihan Air dengan referensi BILL-{id}.

9. Keuangan & anggaran

• Transaksi keuangan — pemasukan (Tagihan Air, Biaya Sambungan, Biaya Pemeliharaan, Denda, Pemasukan Lain) dan pengeluaran (Operasional, Pemeliharaan, Perbaikan, Listrik, Bahan Kimia, Gaji, Peralatan, Pengeluaran Lain).
• Hanya transaksi berstatus completed yang dihitung ke total pemasukan/pengeluaran.
• Anggaran — realisasi (spent) dihitung otomatis dari transaksi pengeluaran pada sistem air, kategori, dan tahun yang sama. Tidak perlu diisi manual.
• Keuangan → Neraca menampilkan rekap per periode dan bisa diekspor ke Excel.

10. Pengaduan masyarakat

Warga dapat menyampaikan pengaduan langsung melalui portal publik /aduan. Semua laporan masuk ke panel admin pada menu Pengaduan (/admin/complaints) dengan lencana status menunggu.

• Nomor Tiket: Dibuat otomatis dalam format ADU-YYYY-NNNNN (contoh: ADU-2026-00001) untuk pelacakan warga.
• Kategori Masalah: Air Mati / Tidak Mengalir, Pipa Bocor / Rusak, Kualitas Air Buruk (Keruh / Bau), Meteran Air Rusak, Masalah Tagihan, Pelayanan Petugas, dan Lainnya.
• Foto Bukti: Pengadu dapat menyertakan foto kondisi lapangan (misal: pipa pecah atau air keruh) yang langsung dapat ditinjau admin.
• Tindak Lanjut & Status: Admin dapat mengubah status: Menunggu → Sedang Diproses → Selesai atau Ditolak.
• Catatan Tanggapan: Admin dapat menginput catatan tindak lanjut dan solusi penanganan. Nama petugas dan waktu penanganan dicatat otomatis oleh sistem.

11. Data penduduk desa

Data Demografi → Data Penduduk Desa (khusus super admin). Diisi per desa per tahun: total penduduk, laki-laki/perempuan, jumlah KK, catatan. Satu desa hanya boleh punya satu baris per tahun. Data ini menjadi pembagi pada perhitungan cakupan layanan di dashboard dan laporan kecamatan.

12. Usulan program

Pengelola/desa mengirim usulan lewat form publik /usulan-program. Usulan masuk ke menu Usulan Program (khusus super admin), dengan lencana jumlah usulan baru.

• Isian usulan: pengelola & desa, lokasi layanan (dukuh/RT/RW), rencana sambungan rumah, pilihan program (sumur dalam, broncaptering, jaringan perpipaan beserta rinciannya, sambungan rumah), kelengkapan data dukung (ada/tidak), serta berkas PDF/ZIP/RAR.
• Tombol Rekap Excel di kanan atas mengunduh seluruh usulan sesuai filter/pencarian yang sedang aktif. Bisa juga mencentang beberapa baris lalu memakai Rekap Excel (terpilih).
• Aksi Tindak Lanjut untuk mengubah status (Baru Masuk / Sedang Ditinjau / Disetujui / Ditolak) dan menulis catatan. Nama peninjau dan waktunya tercatat otomatis.
• Usulan tidak bisa dibuat dari panel — sumbernya hanya form publik.

13. Konten website

Konten Website → Foto Dokumentasi mengatur galeri yang tampil di halaman publik: judul, deskripsi, kategori, urutan, status aktif, dan penanda foto unggulan.

14. Pengguna & izin

1. Master Data → Pengguna → Buat: isi nama, email, kata sandi.
2. Sistem Air — pilih satu atau beberapa unit. Penugasan inilah yang menentukan data apa saja yang bisa dilihat pengguna tersebut, baik di web maupun mobile.
3. Role — pilih superadmin, admin, atau field_officer. Role membawa paket izin bawaan yang langsung terlihat pada daftar "Sudah didapat dari role".
4. Izin tambahan untuk user ini — checklist untuk memberi izin di luar bawaan role, misalnya memberi petugas lapangan izin melihat keuangan.

Pengguna tanpa penugasan sistem air tidak akan melihat data apa pun meskipun rolenya admin.

15. Backup & mode pemeliharaan

• Menu Backups (khusus super admin) untuk membuat dan mengunduh cadangan.
• Widget Mode Pemeliharaan di dashboard mematikan sementara dashboard publik. Panel admin dan aplikasi mobile tetap jalan.
• Untuk administrator server tersedia perintah php artisan db:backup, php artisan db:restore <file.sql>, serta backup:run / backup:list / backup:clean.