RT03 Management System

Sistem informasi untuk sebuah RT — data warga, pengurus, keuangan, inventaris bersama, peminjaman, pengumuman, dan toko warga — dilengkapi asisten AI yang bisa menjawab pertanyaan tentang semuanya.

Sorotan

• Asistennya melihat seluruh lingkungan, bukan satu tabel — sisi klien mengumpulkan data warga, pengurus, keuangan, inventaris, peminjaman, pengumuman, produk toko, dan transaksi dari Firestore, merangkainya menjadi satu konteks terstruktur, lalu mengirimkannya ke model. Pertanyaan yang melintasi dua ranah sekaligus — siapa yang belum membayar iuran sekaligus sedang meminjam barang — bisa dijawab karena keduanya berada dalam satu prompt yang sama.
• Konteks disusun di klien, kuncinya tetap di server — peramban merangkai data yang memang sudah berhak ia baca, dan sebuah fungsi serverless Vercel memegang kunci API serta melakukan pemanggilan modelnya. Kunci itu tidak pernah dikirim ke peramban, dan fungsinya pun tidak perlu memegang kredensial basis data sendiri.
• Firestore sebagai keseluruhan backend — tidak ada server sendiri yang harus dijalankan atau dibiayai, dengan model datanya tinggal langsung di dalam koleksi dan situsnya dideploy sebagai halaman statis plus satu fungsi.
• Peminjaman dilacak sebagai keadaan, bukan sebagai catatan — barang inventaris bersama membawa catatan peminjaman, dan itulah beda antara daftar aset dengan benar-benar tahu tendanya sedang ada di mana.
• Toko warga di dalam situs RT itu sendiri — produk dan transaksi menjadi bagian utuh dari basis data yang sama yang dibaca asisten, sehingga aktivitas toko ikut muncul dalam jawaban seputar keuangan RT.
• Permukaan admin terpisah — login dan dasbor khusus untuk pengurus, dipisahkan dari halaman yang menghadap publik.

Fitur Utama

1. Data warga — catatan rumah tangga dan penduduk sebagai inti sistem.
2. Direktori pengurus — siapa memegang jabatan apa di kepengurusan RT.
3. Pencatatan keuangan — iuran dan pengeluaran yang dibukukan pada kas lingkungan.
4. Inventaris bersama dan peminjaman — aset milik RT, beserta siapa yang sedang memegangnya.
5. Pengumuman — pemberitahuan yang diterbitkan ke warga dari dasbor admin.
6. Toko warga — produk dan transaksi, dengan satu halaman debug untuk memeriksa data inventaris.
7. Chatbot AI — pertanyaan berbahasa alami dijawab dari isi Firestore terkini lewat endpoint serverless bertenaga DeepSeek.

Tech Stack

• HTML + CSS + JavaScript vanilla (multi-halaman, tanpa framework)
• Firebase Firestore (data) + Firebase Storage
• Vercel Serverless Functions (api/chat.js) dengan OpenAI SDK 4 yang diarahkan ke DeepSeek
• Node.js ≥ 18, dideploy lewat Vercel CLI

Status & Kematangan

Selesai. Tidak ada suite test otomatis; verifikasi dilakukan manual, dengan satu halaman debug yang sengaja ditinggal di repositori untuk memeriksa data inventaris secara langsung. Menyusun seluruh konteks di sisi klien lalu mengirimnya dalam satu request memang sederhana dan bekerja pada skala satu RT, tetapi di situ pula batas alami rancangannya — prompt-nya ikut membesar seiring basis data, sehingga lingkungan yang jauh lebih besar akan membutuhkan pengambilan bertahap, bukan pengiriman seluruh isi.

Metrik Terukur