Panduan Sistem Wargaku - Daftar Lengkap
Dokumentasi Lengkap Sistem Manajemen Perumahan Wargaku
📚 Daftar Panduan
1. Panduan Complaint Management
📘 Siklus Lengkap Complaint
URL: /guide/complaint-complete-cycle
Panduan komprehensif yang mencakup seluruh siklus complaint dari pengajuan hingga penyelesaian.
🌟 LIHAT DIAGRAM VISUAL - Versi interaktif dan visual dari alur complaint.
Topik yang Dibahas:
- ✅ Cara pengajuan complaint (Internal & Public)
- ✅ Review & validasi oleh admin
- ✅ Jalur Normal (via pembahasan rapat)
- ✅ Jalur Urgent (tindakan langsung)
- ✅ Eksekusi task
- ✅ Penyelesaian & closing
- ✅ Status & transisi
- ✅ Role & permissions
- ✅ FAQ & troubleshooting
Cocok untuk: Semua user (Warga, Admin, PIC)
📗 Panduan Pengajuan Complaint
URL: /guide/complaint-submission-guide
Panduan detail untuk warga yang ingin mengajukan complaint.
Topik yang Dibahas:
- ✅ Cara mengajukan complaint internal (dengan akun)
- ✅ Cara mengajukan complaint public (tanpa akun)
- ✅ Dua jalur proses (Normal & Urgent)
- ✅ Diagram alur lengkap
- ✅ Estimasi waktu penyelesaian
- ✅ Tips membuat complaint yang baik
- ✅ FAQ untuk warga
Cocok untuk: Warga/Pelapor
📙 Panduan Status Complaint
URL: /guide/complaint-status-guide
Penjelasan detail tentang setiap status complaint dan artinya.
Topik yang Dibahas:
- ✅ Daftar semua status complaint
- ✅ Arti setiap status
- ✅ Warna badge untuk setiap status
- ✅ Transisi antar status
- ✅ Status khusus (Need Action, Action Status)
Cocok untuk: Semua user
📕 Workflow Complaint Actions
URL: /guide/complaint-action-workflow
Panduan teknis untuk mengelola complaint yang memerlukan tindakan.
Topik yang Dibahas:
- ✅ Konsep Complaint Actions
- ✅ Kapan complaint masuk ke Complaint Actions
- ✅ Status vs Prioritas
- ✅ Alur kerja lengkap
- ✅ Database schema
- ✅ Logic update status
Cocok untuk: Admin, Developer
2. Panduan Meeting Management
📘 Panduan Meeting
URL: /guide/meeting-guide
Panduan lengkap untuk mengelola rapat pengurus.
Topik yang Dibahas:
- ✅ Membuat meeting baru
- ✅ Mengelola agenda (complaints & custom topics)
- ✅ Pelaksanaan meeting
- ✅ Pembahasan complaint di rapat
- ✅ Menyelesaikan meeting
- ✅ Meeting report & dokumentasi
- ✅ Tips & best practices
Cocok untuk: Admin, Pengurus
3. Panduan Task Management
📘 Panduan Task
URL: /guide/task-guide
Panduan lengkap untuk pengelolaan dan pengerjaan tugas.
Topik yang Dibahas:
- ✅ Membuat task dari Complaint Actions
- ✅ Mengelola task
- ✅ Mengerjakan task (untuk PIC)
- ✅ Tracking progress
- ✅ Upload evidence & dokumentasi
- ✅ Menyelesaikan task
- ✅ My Tasks (dashboard PIC)
- ✅ Tips & troubleshooting
Cocok untuk: Admin, PIC (Petugas Lapangan)
4. Panduan Sistem (General)
📘 Pengenalan Sistem
URL: /guide/01-introduction
Pengenalan umum tentang Sistem Wargaku.
📘 Data Master
URL: /guide/02-data-master
Panduan pengelolaan data master (Kompleks, Blok, Rumah).
📘 Layanan Warga
URL: /guide/03-citizen-services
Panduan layanan untuk warga.
📘 Manajemen Rapat
URL: /guide/04-meeting-management
Panduan manajemen rapat (versi lama).
📘 Manajemen Iuran
URL: /guide/05-fee-management
Panduan pengelolaan iuran dan pembayaran.
🎯 Panduan Berdasarkan Role
Untuk Warga
Wajib Baca:
Opsional:
- Siklus Lengkap Complaint - Untuk memahami proses lengkap
Untuk Admin/Pengurus
Wajib Baca:
Opsional:
Untuk PIC (Petugas Lapangan)
Wajib Baca:
Opsional:
- Siklus Lengkap Complaint - Untuk konteks
🖼️ Diagram & Visual
Diagram yang Perlu Dibuat
Untuk melengkapi dokumentasi, berikut diagram yang direkomendasikan:
1. Complaint Flow - Complete Cycle
File: public/images/docs/complaint-flow-complete.png
Diagram lengkap siklus complaint dari pengajuan sampai selesai, termasuk:
- Entry point (Internal & Public)
- Review & validasi
- Split jalur (Normal & Urgent)
- Meeting process
- Task execution
- Closing
Tools: Draw.io, Lucidchart, Mermaid
2. Complaint Flow - Normal Path
File: public/images/docs/complaint-flow-normal.png
Diagram jalur normal (via rapat):
- Pending → Review → Schedule → Discussion → Decision
- Loop postponed
- Create task → Complete
3. Complaint Flow - Urgent Path
File: public/images/docs/complaint-flow-urgent.png
Diagram jalur urgent (direct action):
- Pending → Review → Need Action → Task → Complete
4. Meeting Workflow
File: public/images/docs/meeting-workflow.png
Diagram proses meeting:
- Create → Add agenda → Start → Discuss → Finish
- Decision tree untuk setiap complaint
5. Task Workflow
File: public/images/docs/task-workflow.png
Diagram proses task:
- Create → Assign → Start → Progress → Complete → Verify
6. Status Transition Diagram
File: public/images/docs/status-transition.png
Diagram transisi status complaint:
- Semua status dan arrow transisi
- Kondisi untuk setiap transisi
📝 Cara Menggunakan Panduan
Akses via Web
Semua panduan bisa diakses melalui URL:
http://your-domain/guide/{nama-panduan}
Contoh:
http://your-domain/guide/complaint-complete-cyclehttp://your-domain/guide/meeting-guidehttp://your-domain/guide/task-guide
Navigasi
Di halaman guide, tersedia:
- Sidebar: Daftar semua panduan
- Search: Cari panduan (jika tersedia)
- Table of Contents: Daftar isi per panduan
Download
Panduan juga tersedia dalam format:
- Markdown (.md): Di folder
resources/docs/ - PDF: (Coming soon)
🔄 Update & Maintenance
Versi Terkini
Semua panduan diupdate per: 1 Desember 2024
Changelog
v3.0 - 1 Desember 2024:
- ✅ Tambah Panduan Siklus Lengkap Complaint
- ✅ Tambah Panduan Meeting (versi baru)
- ✅ Tambah Panduan Task
- ✅ Update semua panduan ke Bahasa Indonesia
- ✅ Reorganisasi struktur dokumen
v2.0 - 27 November 2024:
- ✅ Tambah Panduan Pengajuan Complaint
- ✅ Tambah Panduan Status
- ✅ Tambah Workflow Complaint Actions
📞 Bantuan & Feedback
Jika ada pertanyaan atau saran untuk perbaikan dokumentasi:
- Email: support@wargaku.com
- GitHub Issues: (jika open source)
- Admin: Hubungi pengurus komplek
🎓 Training & Onboarding
Untuk User Baru
Langkah Onboarding:
-
Warga Baru:
- Baca: Pengenalan Sistem
- Baca: Panduan Pengajuan Complaint
- Praktek: Buat complaint pertama
-
Admin Baru:
- Baca: Siklus Lengkap Complaint
- Baca: Panduan Meeting
- Baca: Panduan Task
- Praktek: Shadow admin senior
-
PIC Baru:
- Baca: Panduan Task
- Praktek: Kerjakan task sederhana dulu
📊 Statistik Dokumentasi
- Total Panduan: 11 dokumen
- Total Halaman: ~150 halaman (estimasi)
- Bahasa: Bahasa Indonesia
- Format: Markdown
- Diagram: 6 diagram (perlu dibuat)
Terakhir diupdate: 1 Desember 2024
Versi: 3.0
Maintainer: Tim Pengembang Wargaku