Generus Android — Aplikasi Pendamping Native
Versi Kotlin native dari PWA Generus di project Supabase yang sama — presensi offline yang tetap terkirim setelah aplikasi ditutup, pemindai QR di perangkat, dan kartu ID yang digambar di HP.
- Peran saya
- Pengembang tunggal — aplikasi Android dan API database yang dipakainya.
- Bidang
- Aplikasi Mobile
Tinjauan
Generus dimulai sebagai PWA agar pengguna iPhone dan dasbor laptop memakai satu codebase. Kelemahannya ada di pekerjaan latar: di iOS, PWA hanya bisa mengirim antrean presensi selama dibuka. Petugas yang menutup aplikasi di aula tanpa sinyal membuat catatan tertahan sampai aplikasi dibuka lagi.
Aplikasi Android mencakup fitur yang sama dengan PWA, di project Supabase yang sama. Tidak ada backend baru. Tulis sederhana langsung ke tabel lewat PostgREST, dan query gabungan yang di PWA ada di TypeScript dijadikan 41 fungsi SQL yang berjalan sebagai pemanggil, sehingga row-level security yang sama tetap menentukan apa yang dilihat tiap akun.
Ketukan presensi dan hasil scan masuk antrean Room lebih dulu, berkunci agenda dan generus sehingga ketukan terakhir yang berlaku. Antrean dikirim saat status diketuk, saat jaringan kembali, setiap 20 detik selama aplikasi terbuka, dan oleh WorkManager setelah aplikasi ditutup. Pemindai membaca kartu dengan ML Kit di perangkat dan mencocokkan hash SHA-256 isi QR ke roster lokal, jadi tetap jalan tanpa sinyal.
Dalam gambar





Fungsi
- Backend
- Tidak ada yang baru — project Supabase, RLS, dan trigger yang sama dengan PWA
- Offline
- Antrean Room, dikirim WorkManager walau aplikasi sudah ditutup
- Pemindai
- CameraX + ML Kit di perangkat, dengan bunyi dan getar
Yang dikerjakan
- 01Beranda dengan pengajian yang sedang berlangsung atau berikutnya, aksi cepat, kehadiran bulanan, dan peringatan alpa tiga kali berturut-turut.
- 02Agenda — sekali atau mingguan — dengan batal, kunci, dan petugas scan.
- 03Checklist offline H/T/I/S/A, hadirkan semua, dan delegasi untuk admin kelompok.
- 04Pemindai QR dengan CameraX dan ML Kit, bunyi dan getar per hasil, dan cari nama sebagai cadangan.
- 05Data generus dengan filter, perubahan status, mutasi, terbitkan ulang kartu, dan kenaikan jenjang massal.
- 06Kartu ID yang digambar di perangkat lalu diekspor ke PDF A4, sembilan kartu per lembar, siap dicetak atau dibagikan.
- 07Import Excel yang divalidasi di HP, dan ekspor laporan bulanan ke Excel.
- 08Periode kurikulum, target, dan pustaka materi berteks Arab; checklist capaian dan progres kitab massal.
- 09Admin wilayah dan akun lewat Edge Function yang memegang service role, serta wajib ganti password saat login pertama.
Catatan teknis
- Build
- Dua flavor — server uji dan resmi — bisa terpasang berdampingan
- Target
- minSdk 26, targetSdk 36, JDK 17
- Kunci rahasia
- APK hanya membawa URL dan publishable key