Portal web HaloRT (app.halort.com dan tenant seperti gp2.halort.com) menyertakan bantuan kontekstual dan tur interaktif agar warga dan pengurus dapat belajar fitur tanpa meninggalkan aplikasi. Panduan lengkap tetap di docs.halort.com.
| Portal | Tur otomatis | Bantuan per menu | Tombol ulang tur |
|---|---|---|---|
Warga (/dashboard, …) | ✓ sekali per browser | ✓ ikon ? di sidebar | ✓ Bantuan di atas konten |
Admin komunitas (/admin/*) | ✓ sekali per browser | ✓ ikon ? di sidebar & Pengaturan | ✓ Bantuan di atas konten |
Super admin (admin.halort.com) | — | — | Lihat [[Guides/Platform/Super Admin Platform |
Implementasi: halort-platform-web — react-joyride + modal bantuan → tautan docs.
Tur interaktif (react-joyride)
Saat kunjungan pertama ke portal warga atau admin komunitas, tur dimulai otomatis (~1 detik setelah halaman siap). Tur menjelaskan:
- Sidebar navigasi — menu layanan / modul admin
- Item menu — contoh Dashboard
- Ikon bantuan (?) — panduan singkat per menu
- Tombol Bantuan — memutar ulang tur kapan saja
- Area konten utama — tempat detail setiap halaman ditampilkan
Kontrol tur: Lanjut, Kembali, Lewati, Selesai (Bahasa Indonesia).
Status selesai disimpan di localStorage browser:
| Kunci | Portal |
|---|---|
halort_tour_done_resident | Warga |
halort_tour_done_admin | Admin komunitas |
Untuk melihat tur lagi: klik tombol Bantuan di pojok kanan atas area konten, atau buka modal bantuan menu mana pun → Mulai tur halaman.
Bantuan per menu
Di samping setiap item menu sidebar (dan sub-menu Pengaturan), ikon ? membuka modal berisi:
- Judul dan ringkasan singkat fitur
- Tautan ke panduan lengkap di docs.halort.com
- Tombol Buka panduan (tab baru)
- Tombol Mulai tur halaman (opsional)
Pemetaan menu → panduan dikelola di src/config/docs.ts (HELP_BY_HREF). Contoh:
| Menu | Panduan docs |
|---|---|
| Dashboard warga | Guides/Warga/Ringkasan Fitur |
| Iuran | Iuran |
| Surat | Surat |
| Dashboard admin | Guides/Pengurus/Admin Ketua RT |
| Kependudukan | Kependudukan |
| Pengaturan → Modul | Guides/Pengurus/Admin Ketua RT |
| Hierarki RW | Guides/Pengurus/Ketua RW |
Sub-menu Pengaturan (/admin/settings/*) memakai komponen SettingsShell dengan pola bantuan yang sama.
Asisten AI + bantuan
Widget Asisten HaloRT (ikon robot, pojok kanan bawah portal warga) menyertakan ikon ? yang membuka panduan Asisten AI di docs.halort.com.
Onboarding pengurus baru
Selain tur, pengurus pertama dapat diarahkan ke wizard Onboarding (/admin/onboarding) — langkah profil komunitas, tema, impor warga, dan penyelesaian setup. Setelah selesai, flag onboardingComplete disimpan di pengaturan tenant.
Panduan: Guides/Pengurus/Admin Ketua RT.
Super admin (admin.halort.com)
Konsol operator menyertakan tur in-app (react-joyride) dan ikon ? per menu → docs.halort.com, sama pola dengan portal komunitas.
Dukungan teknis vs bantuan in-app
| Kebutuhan | Cara |
|---|---|
| Cara pakai menu (iuran, surat, dll.) | Ikon ? atau docs.halort.com |
| Pengingat navigasi portal | Tombol Bantuan / tur |
| Masalah teknis / tagihan SaaS | [[Guides/Pengurus/Tiket Dukungan HaloRT |
| Operator platform | Guides/Platform/Tiket Dukungan Operator |