Generus — Pemantauan Presensi & Kurikulum Generus
PWA untuk pembinaan generus tiga tingkat — daerah, desa, kelompok — mencakup presensi, target kurikulum bulanan, dan progres kitab, dengan hak akses yang ditegakkan langsung di database.
- Peran saya
- Pengembang tunggal — spesifikasi produk, model data, aplikasi, dan deployment.
- Bidang
- Pengembangan Web
- Next.js
- TypeScript
- PostgreSQL
- Supabase
- Drizzle ORM
- Dexie
- Tailwind CSS
- Vitest
Tinjauan
Presensi, target kurikulum bulanan, dan progres bacaan Al-Qur’an dulu tersebar di buku, spreadsheet, dan grup chat, sehingga pengurus di atas tingkat kelompok tidak bisa melihat kondisi di bawahnya. Generus menyatukan ketiganya dalam satu aplikasi web yang bisa dipasang, dipakai admin di HP dan tim kurikulum di laptop.
Kebutuhan terberatnya adalah pengajian desa dengan 300 peserta. Generus membawa kartu QR cetak; tiga atau empat petugas memindai di pintu dengan HP masing-masing, setiap scan dikonfirmasi lokal dalam kurang dari satu detik dan diantrikan di IndexedDB. Duplikasi diabaikan, keterlambatan dihitung dari batas waktu agenda, dan antrean disinkronkan secara idempoten begitu sinyal kembali.
Siapa melihat apa ditegakkan di Postgres, bukan hanya di UI. Setiap unit punya path ltree, sehingga “unit ini dan semua turunannya” cukup satu kondisi ber-indeks, dan row-level security menerapkannya di setiap tabel. Tim kurikulum mendapat angka capaian agregat lewat fungsi security-definer tanpa pernah membaca baris data generus satu per satu.
Dalam gambar





Fungsi
- Skala
- 1 daerah, 10 desa, 60 kelompok, ± 5.000 generus
- Presensi
- Checklist untuk pengajian kecil, scan QR banyak petugas untuk yang besar
- Akses
- RLS Postgres di atas hierarki unit ltree, enam peran
Yang dikerjakan
- 01Pohon wilayah, akun, dan enam peran — dari superadmin hingga kyai yang hanya melihat — masing-masing terikat pada satu unit dan seluruh turunannya.
- 02Data generus dengan import Excel, kenaikan jenjang massal, dan perubahan status yang tetap menyimpan riwayat.
- 03Kartu ID potret siap cetak berisi token QR acak, bukan data pribadi.
- 04Agenda sekali atau mingguan yang otomatis tampil di unit-unit di bawahnya.
- 05Scan QR offline-first dengan banyak petugas per agenda, plus pencarian nama sebagai cadangan.
- 06Jendela delegasi untuk admin kelompok, lalu penguncian otomatis lewat pg_cron.
- 07Pustaka materi, target periode yang disalin dari bulan sebelumnya, dan progres kitab per ayat atau halaman.
- 08Rekap capaian lintas unit, dasbor, dan laporan bulanan.
- 09Modul kurikulum yang bisa dinyalakan per server untuk penerapan bertahap.
Catatan teknis
- Pilihan platform
- PWA lebih dulu — pengguna iPhone dan dasbor laptop dalam satu codebase; aplikasi Android native menyusul
- QR di iOS
- BarcodeDetector dengan cadangan WASM zxing
- Pengujian
- 137 test; migrasi dan RLS diuji dengan PGlite, tanpa Docker