Lewati ke konten
Nur Amin
← Semua proyek
P-04generus-mobile2026

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
Teknologi
  • Kotlin
  • Jetpack Compose
  • Room
  • WorkManager
  • Supabase
  • PostgreSQL
  • CameraX
  • ML Kit

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

Judul Generus Android dengan tiga ponsel Android: beranda, checklist presensi, dan pemindai QR.
FIG. 01Beranda, checklist, dan pemindai di aplikasi native. Mockup digambar ulang dengan data contoh.
Diagram: aplikasi Android dan PWA sama-sama terhubung ke satu project Supabase — Auth, PostgREST, 41 fungsi RPC mobile_*, RLS yang tidak berubah, dan Edge Function admin — dengan flavor uji dan resmi di bawahnya.
FIG. 02Klien kedua tanpa backend baru: aturan yang sama menjaga kedua aplikasi.
Checklist presensi Android dengan dua item menunggu kirim, di samping empat pemicu pengiriman antrean Room dan perbandingan dengan PWA di iOS.
FIG. 03Ketukan disimpan di HP lebih dulu; WorkManager mengirimnya walau aplikasi sudah ditutup.
Tiga layar pemindai Android — tercatat hijau, sudah tercatat kuning, ditolak merah — di atas alur dari CameraX dan ML Kit hingga pencocokan roster ber-hash.
FIG. 04Tiga jawaban jelas, masing-masing dengan bunyi dan getarnya sendiri.
Kartu ID Generus potret dengan kode QR, di samping halaman PDF A4 berisi sembilan kartu serta kartu import Excel dan ekspor laporan.
FIG. 05Kartu ID digambar di HP dan diekspor sembilan per halaman A4; nama panjang disingkat jadi huruf awal.

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

  1. 01Beranda dengan pengajian yang sedang berlangsung atau berikutnya, aksi cepat, kehadiran bulanan, dan peringatan alpa tiga kali berturut-turut.
  2. 02Agenda — sekali atau mingguan — dengan batal, kunci, dan petugas scan.
  3. 03Checklist offline H/T/I/S/A, hadirkan semua, dan delegasi untuk admin kelompok.
  4. 04Pemindai QR dengan CameraX dan ML Kit, bunyi dan getar per hasil, dan cari nama sebagai cadangan.
  5. 05Data generus dengan filter, perubahan status, mutasi, terbitkan ulang kartu, dan kenaikan jenjang massal.
  6. 06Kartu ID yang digambar di perangkat lalu diekspor ke PDF A4, sembilan kartu per lembar, siap dicetak atau dibagikan.
  7. 07Import Excel yang divalidasi di HP, dan ekspor laporan bulanan ke Excel.
  8. 08Periode kurikulum, target, dan pustaka materi berteks Arab; checklist capaian dan progres kitab massal.
  9. 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