HaloRT Docs

Fitur Operasional Komunitas

Properties1
tagsproject/halort, type/meta, status/current

4 menit baca

Rilis Agustus 2026 menambahkan sembilan kemampuan operasional inti untuk RT/RW di app.halort.com dan tenant seperti gp2.halort.com. Dokumen ini merangkum fitur baru untuk warga dan pengurus, beserta endpoint API terkait.

PDF: output/fitur-operasional-komunitas.pdf (hasil bun scripts/generate-community-ops-pdf.ts)

Ringkasan fitur

FiturPeranRute webModul
Buku tamuWarga + Pengurus/tamu, /admin/tamutamu
Musyawarah & votingWarga + Pengurus/musyawarah, /admin/musyawarahmusyawarah
Surat + unduh PDFWarga + Pengurus/surat, /admin/suratsurat
KependudukanPengurus/admin/kependudukanwarga
Dashboard operasionalPengurus/admin/dashboard—
Hierarki RWKetua RW/admin/settings/rw—
Asisten AIWargaWidget di portal warga—
Lupa / reset kata sandiSemua/forgot-password, /reset-password—
Edit profil wargaWarga/profile—

1. Dashboard operasional (pengurus)

Panel KPI di /admin/dashboard memberi ringkasan operasional harian dan tautan cepat ke modul terkait.

Indikator yang ditampilkan:

  • Tunggakan iuran
  • Surat menunggu proses
  • Pengaduan baru
  • Tamu menunggu persetujuan
  • Musyawarah aktif
  • Total warga terdaftar

API: GET /api/statistik/operasional

Dashboard operasional pengurus

2. Buku tamu / visitor log

Modul Buku Tamu menggantikan pencatatan manual tamu di pos ronda.

Warga (/tamu)

  • Daftarkan tamu: nama, keperluan, tanggal/waktu kunjungan, plat kendaraan, identitas
  • Pantau status permohonan (menunggu / disetujui / ditolak)
  • Setelah disetujui, tampilkan QR untuk check-in di gerbang

API warga: POST /api/visitor, GET /api/visitor/mine

Portal warga — buku tamu

Pengurus (/admin/tamu)

  • Review dan setujui/tolak permohonan tamu
  • Check-in / check-out tamu di gerbang (scan QR)
  • Notifikasi email saat tamu disetujui

API pengurus: GET /api/visitor, PUT /api/visitor/:id, POST /api/visitor/gate/check-in, POST /api/visitor/gate/check-out

Admin — kelola buku tamu

3. Musyawarah & voting

Modul Musyawarah mendukung keputusan kolektif RT/RW secara digital.

Pengurus (/admin/musyawarah)

  • Buat polling: judul, opsi jawaban, jadwal mulai/selesai
  • Atur status (draft / aktif / ditutup), kuorum, anonimitas, multi-pilihan
  • Pantau hasil suara per opsi

API: POST /api/musyawarah, PUT /api/musyawarah/:id, DELETE /api/musyawarah/:id

Admin — musyawarah

Warga (/musyawarah)

  • Lihat polling aktif
  • Berikan suara (satu atau multi-pilihan sesuai konfigurasi)
  • Hasil diperbarui setelah vote tercatat

API: GET /api/musyawarah, POST /api/musyawarah/:id/vote

Warga — musyawarah

4. Surat administrasi + PDF

Fitur Surat diperluas dengan unduhan PDF resmi setelah permohonan selesai.

Jenis surat (12 tipe)

Domisili, SKTM, pengantar KTP/KK, usaha, kematian, tidak mampu, pindah, dan lainnya — lihat GET /api/surat/jenis.

Alur warga (/surat)

  1. Ajukan permohonan (jenis, atas nama, keperluan, field tambahan)
  2. Pantau status di daftar permohonan
  3. Saat status selesai dan nomor surat terisi, unduh PDF

API: POST /api/surat, GET /api/surat/mine, GET /api/surat/:id/pdf

Warga — permohonan surat

Alur pengurus (/admin/surat)

  • Proses permohonan: ubah status, isi nomor surat dan tanggal
  • Unduh PDF untuk arsip atau cetak

API: GET /api/surat, PUT /api/surat/:id

Admin — kelola surat

5. Kependudukan (pengurus)

Registri Kependudukan di /admin/kependudukan untuk data KK lingkungan.

Fitur UI:

  • Statistik: total KK, jiwa, kendaraan, distribusi per blok
  • Pencarian dan daftar kepala keluarga
  • Tambah / edit / hapus KK
  • Detail KK: anggota keluarga + kendaraan
  • Tab unit & koordinat + export Excel

API: GET /api/kependudukan/*

Admin — kependudukan

6. Hierarki RW (ketua RW)

Untuk tenant tipe RW, pengaturan di /admin/settings/rw menghubungkan RT anak ke RW induk.

Kemampuan:

  • Tautkan / lepaskan RT anak berdasarkan slug tenant
  • Lihat ringkasan agregat lintas RT: warga, tunggakan, surat, pengaduan

API: GET /api/tenant-hierarchy/children, GET /api/tenant-hierarchy/summary, POST /api/tenant-hierarchy/link-child, DELETE /api/tenant-hierarchy/link-child/:slug

Admin — hierarki RW

7. Asisten AI warga

Widget Asisten HaloRT tersedia di semua halaman portal warga (sudut kanan bawah).

Kemampuan:

  • Jawab pertanyaan seputar iuran, surat, pengaduan, tamu, musyawarah
  • Konteks tenant + data pengguna (tagihan tertunda, surat aktif, dll.)
  • Percakapan multi-turn (riwayat chat dikirim ke API)
  • Backend: OpenAI-compatible API di ai.suherman.net

API: GET /api/ai/status, POST /api/ai/chat

Widget asisten AI

8. Lupa & reset kata sandi

Alur pemulihan akun tanpa magic link:

  1. Warga buka /forgot-password, masukkan email
  2. Sistem kirim tautan reset via layanan notifikasi
  3. Buka /reset-password?token=…, set kata sandi baru (min. 8 karakter)

API: POST /api/auth/forgot-password, POST /api/auth/reset-password

Lupa kata sandi

Atur ulang kata sandi

9. Edit profil warga

Halaman /profile memungkinkan warga memperbarui:

  • Nama lengkap
  • Nomor WhatsApp
  • Unit hunian (blok + nomor rumah)

Profil lengkap menandai profileComplete untuk modul yang membutuhkan identitas unit (mis. iuran).

API: PUT /api/user/profile

Profil warga

Aktivasi modul

Pengurus mengaktifkan modul baru di Pengaturan → Modul Fitur (/admin/settings/modul):

  • tamu — Buku Tamu
  • musyawarah — Musyawarah
  • surat — Surat (sudah ada, kini dengan PDF)
  • warga — Kependudukan + akun warga

Menghasilkan ulang PDF & screenshot

Dari repo halort-docs:

# 1. Buat akun demo + JWT (butuh DATABASE_URL + JWT_SECRET produksi)
bun scripts/create-docs-users.ts
 
# 2. Ambil screenshot dari gp2.halort.com
bun scripts/capture-community-ops-screenshots.ts
 
# 3. Bangun PDF
bun scripts/generate-community-ops-pdf.ts

Hasil: output/fitur-operasional-komunitas.pdf

Terkait

Features/Web Features · Features/Feature Map · Surat · Surfaces/Platform API

Tampilan Grafik

Tautan Balik