Lewati ke konten
Nur Amin
← Semua proyek
P-03Generus2026

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
Teknologi
  • 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

Logo Generus dengan beranda versi desktop di browser dan versi ponsel, menampilkan pengajian yang sedang berlangsung dengan 142 dari 528 tercatat.
FIG. 01Satu aplikasi untuk HP dan laptop: menu samping di desktop, tab bawah di HP. Mockup digambar ulang dengan data contoh.
Tiga ponsel memindai kartu QR untuk pengajian yang sama — tercatat, sudah tercatat, dan terlambat — di atas alur empat langkah dari membaca kartu hingga sinkron dengan ON CONFLICT DO NOTHING.
FIG. 02Banyak petugas, tanpa perlu sinyal: scan dicocokkan di perangkat dan catatan pertama yang menang.
Pohon unit dengan path ltree yang menyorot satu desa dan empat kelompoknya, di samping kebijakan RLS generus_select, rekap agregat untuk tim kurikulum, dan enam kartu peran.
FIG. 03Siapa melihat apa cukup satu kondisi ltree ber-indeks, ditegakkan row-level security di setiap tabel.
Halaman presensi desktop untuk pengajian desa: total per status, checklist dengan tombol H/T/I/S/A per orang, serta panel progres per kelompok, petugas scan, jendela delegasi, dan kunci otomatis.
FIG. 04Presensi checklist, jendela delegasi untuk admin kelompok, lalu penguncian otomatis lewat pg_cron.
Periode kurikulum Oktober 2026 dengan target Al-Qur’an dan kitab serta hafalan berteks Arab, di samping progres bacaan per generus per ayat dan checklist materi.
FIG. 05Target bulanan per jenjang, dengan progres bacaan dipantau per ayat atau halaman.

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

  1. 01Pohon wilayah, akun, dan enam peran — dari superadmin hingga kyai yang hanya melihat — masing-masing terikat pada satu unit dan seluruh turunannya.
  2. 02Data generus dengan import Excel, kenaikan jenjang massal, dan perubahan status yang tetap menyimpan riwayat.
  3. 03Kartu ID potret siap cetak berisi token QR acak, bukan data pribadi.
  4. 04Agenda sekali atau mingguan yang otomatis tampil di unit-unit di bawahnya.
  5. 05Scan QR offline-first dengan banyak petugas per agenda, plus pencarian nama sebagai cadangan.
  6. 06Jendela delegasi untuk admin kelompok, lalu penguncian otomatis lewat pg_cron.
  7. 07Pustaka materi, target periode yang disalin dari bulan sebelumnya, dan progres kitab per ayat atau halaman.
  8. 08Rekap capaian lintas unit, dasbor, dan laporan bulanan.
  9. 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