1. Ruang lingkup

Admin sistem air mengelola unit yang ditugaskan kepadanya. Seluruh daftar (pelanggan, aset, pencatatan meter, pengaduan warga, keuangan, anggaran) otomatis tersaring ke unit tersebut — data unit lain tidak muncul.

Satu akun bisa memegang lebih dari satu unit. Bila demikian, form penambahan data menyediakan pilihan unit. Bila akun belum ditugaskan ke unit mana pun, daftar akan kosong — hubungi super admin.

2. Masuk panel

1. Buka /admin, masuk dengan email dan kata sandi.
2. Dashboard menampilkan ringkasan unit Anda: keberfungsian, kapasitas, cakupan penduduk, dan investasi.
3. Akun yang sama dipakai untuk aplikasi mobile.

3. Data unit sendiri & Gateway Pembayaran Midtrans

Master Data → Sistem Air. Admin dapat melihat dan mengubah data unitnya — misalnya memperbarui jumlah penduduk terlayani, kapasitas, status keberfungsian, kontak pengelola, foto, dan dokumen pendukung.

Pengaturan Tarif: Tarif tetap atau progresif 4 blok, abonemen, biaya admin, dan biaya transaksi. Angka ini langsung dipakai saat pencatatan meter berikutnya.

4. Pelanggan & kode QR

• Tambah pelanggan — isi nama, alamat, jumlah anggota keluarga, NIK, dan kontak. Nomor pelanggan (NNN-YYYY-NNNN) dibuat otomatis, jangan diisi manual.
• Impor massal — unduh templat lewat Download Template, isi, lalu unggah.
• Generate QR lalu Print QR untuk ditempel di rumah pelanggan. Untuk banyak pelanggan sekaligus, centang barisnya lalu pilih Print QR Codes (PDF siap cetak).
• QR inilah yang dipindai petugas di lapangan untuk membuka form pencatatan.

5. Aset

Master Data → Aset — catat sarana unit (jenis, kondisi, tahun, lokasi/koordinat). Petugas lapangan hanya bisa memperbarui titik lokasi aset dari aplikasi mobile; penambahan dan perubahan data lengkap dilakukan admin.

6. Pencatatan meter

Manajemen Sistem Air → Pencatatan Meter. Pencatatan bisa masuk dari dua jalur: diinput admin di panel, atau dikirim petugas dari aplikasi mobile.

• Isian pokok: pelanggan, tanggal baca, angka meter sekarang, nama pembaca, foto meteran (opsional).
• Angka meter sebelumnya diambil otomatis dari pencatatan terakhir pelanggan tersebut.
• Pemakaian (m³) dan total tagihan dihitung otomatis mengikuti tarif unit — termasuk rincian per blok bila memakai tarif progresif, ditambah abonemen dan biaya lain.
• Periksa kewajaran angka: pemakaian nol atau melonjak jauh biasanya menandakan salah baca atau meteran bermasalah.

7. Tagihan, nota, dan pembayaran

• Konfirmasi — memvalidasi hasil baca sehingga tagihan siap ditagihkan. Bisa dilakukan sekaligus untuk banyak baris.
• Tandai tertagih (billed) — untuk tagihan yang sudah disampaikan ke pelanggan.
• Terima Tunai — catat uang yang diterima langsung di tempat; kembalian dihitung otomatis dan status berubah menjadi lunas.
• Pembayaran Online (Midtrans / QRIS) — pelanggan dapat membayar mandiri via QRIS / VA bila fitur cashless diaktifkan pada unit Anda. Saat lunas, webhook otomatis mengubah status menjadi paid.
• Lihat Nota / Cetak Nota per baris, dan Cetak Nota Massal untuk satu periode penagihan.
• Begitu tagihan berstatus paid, sistem otomatis membuat catatan pemasukan keuangan kategori Tagihan Air dengan referensi BILL-{id}.

8. Pengaduan masyarakat

Menu Pengaduan menampilkan keluhan dan aduan warga yang ditujukan untuk unit sistem air Anda (serta aduan umum desa terkait).

• Nomor Tiket: Berformat ADU-YYYY-NNNNN memudahkan konfirmasi dengan warga pelapor.
• Tinjau Aduan & Foto: Periksa kronologi keluhan warga beserta foto bukti (contoh: pipa pecah, air keruh, meter mati).
• Perbarui Status: Ubah status menjadi Sedang Diproses saat petugas menuju lokasi, lalu Selesai setelah perbaikan rampung.
• Tulis Tanggapan: Masukkan penjelasan solusi teknis yang telah dilakukan sebagai bukti penanganan resmi.

9. Keuangan

• Pemasukan: Tagihan Air (otomatis saat lunas), Biaya Sambungan, Biaya Pemeliharaan, Denda, Pemasukan Lain.
• Pengeluaran: Operasional, Pemeliharaan, Perbaikan, Listrik, Bahan Kimia, Gaji, Peralatan, Pengeluaran Lain.
• Isian: tanggal, jenis, kategori, uraian, jumlah, status, bukti/keterangan.
• Hanya transaksi berstatus completed yang masuk hitungan total dan neraca.

10. Anggaran & neraca

• Anggaran disusun per kategori pengeluaran per tahun. Kolom realisasi terisi otomatis dari transaksi pengeluaran yang cocok (unit + kategori + tahun) — cukup isi pagunya.
• Keuangan → Neraca menampilkan pemasukan, pengeluaran, dan saldo bersih per periode, lengkap dengan tombol ekspor Excel untuk laporan ke pengurus atau dinas.

11. Mengelola petugas

Master Data → Pengguna. Admin dapat menambah dan mengubah akun petugas (peran field_officer) serta menugaskannya ke unit. Petugas akan memakai akun ini untuk masuk ke aplikasi mobile. Penghapusan akun adalah wewenang super admin.

13. Rutinitas bulanan yang disarankan

1. Pastikan data pelanggan baru sudah masuk dan QR-nya tercetak.
2. Petugas melakukan pencatatan meter (mobile atau panel) sepanjang periode baca.
3. Periksa daftar pencatatan: cek angka janggal, lalu konfirmasi massal.
4. Cetak nota massal dan sampaikan ke pelanggan; tandai tertagih.
5. Catat pembayaran (tunai atau online Midtrans) sampai status lunas.
6. Tindak lanjuti pengaduan warga yang masuk secara berkala.
7. Input pengeluaran bulan berjalan, lalu cetak Neraca sebagai laporan.