diff --git a/Panduan-Penggunaan-Aplikasi.md b/Panduan-Penggunaan-Aplikasi.md new file mode 100644 index 0000000..af0c469 --- /dev/null +++ b/Panduan-Penggunaan-Aplikasi.md @@ -0,0 +1,334 @@ +# Panduan Penggunaan Aplikasi Desa+ + +## Daftar Isi +1. [Gambaran Umum Aplikasi](#gambaran-umum-aplikasi) +2. [Fitur-fitur Utama](#fitur-fitur-utama) +3. [User Roles dan Hak Akses](#user-roles-dan-hak-akses) +4. [Petunjuk Penggunaan](#petunjuk-penggunaan) +5. [Troubleshooting](#troubleshooting) + +## Gambaran Umum Aplikasi + +Aplikasi Desa+ adalah platform digital berbasis mobile yang dirancang untuk membantu pengelolaan dan komunikasi di lingkungan desa/kelurahan. Aplikasi ini menyediakan berbagai fitur untuk memudahkan administrasi desa, komunikasi antar warga, dan pengelolaan informasi penting. + +### Teknologi yang Digunakan +- React Native dengan Expo +- Firebase (Authentication, Realtime Database, Cloud Messaging) +- Redux Toolkit untuk manajemen state +- TypeScript untuk type safety + +## Fitur-fitur Utama + +### 1. Otentikasi (Login & Verifikasi) +**Deskripsi:** Sistem login menggunakan nomor telepon dan verifikasi OTP (One Time Password) +- **Fungsi:** Memverifikasi identitas pengguna sebelum mengakses aplikasi +- **Siapa yang bisa mengakses:** Semua pengguna yang terdaftar +- **Cara menggunakan:** + 1. Masukkan nomor telepon yang terdaftar + 2. Klik "Kirim OTP" + 3. Masukkan kode OTP yang diterima melalui WhatsApp + 4. Klik "Verifikasi" untuk masuk ke aplikasi + +### 2. Dashboard/Home Screen +**Deskripsi:** Tampilan utama aplikasi yang menampilkan informasi dan akses cepat ke berbagai fitur +- **Fungsi:** Menyediakan ringkasan informasi desa dan akses cepat ke fitur-fitur utama +- **Siapa yang bisa mengakses:** Semua pengguna yang telah login +- **Komponen:** + - Carousel banner untuk promosi atau informasi penting + - Grafik progres kegiatan + - Grafik dokumen + - Daftar kegiatan terbaru + - Daftar divisi aktif + - Daftar acara mendatang + - Diskusi terbaru + +### 3. Pengumuman +**Deskripsi:** Fitur untuk membuat, melihat, dan mengelola pengumuman desa +- **Fungsi:** Menyebarkan informasi penting kepada seluruh warga +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin + - Melihat: Semua pengguna +- **Cara menggunakan:** + 1. Pilih menu "Pengumuman" dari fitur utama + 2. Untuk membuat pengumuman baru, klik tombol "+" di kanan atas + 3. Isi judul dan deskripsi pengumuman + 4. Pilih grup yang akan menerima pengumuman (opsional) + 5. Klik "Simpan" untuk menerbitkan + +### 4. Diskusi Umum +**Deskripsi:** Forum diskusi untuk komunikasi antar warga dan pihak pengelola +- **Fungsi:** Tempat berdiskusi mengenai berbagai topik yang berkaitan dengan desa +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin + - Melihat: Semua pengguna + - Berkomentar: Semua pengguna +- **Cara menggunakan:** + 1. Pilih menu "Diskusi" dari fitur utama + 2. Untuk membuat diskusi baru, klik tombol "+" di kanan atas + 3. Isi judul dan deskripsi diskusi + 4. Pilih anggota yang akan menjadi partisipan + 5. Klik "Simpan" untuk membuat diskusi + 6. Klik pada judul diskusi untuk membuka dan memberikan komentar + +### 5. Kegiatan/Proyek +**Deskripsi:** Fitur untuk mengelola dan melacak proyek atau kegiatan desa +- **Fungsi:** Mengelola dan memonitor kemajuan proyek-proyek desa +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin + - Melihat: Semua pengguna + - Status (Buka/Tutup): Berdasarkan hak akses +- **Status Kegiatan:** + - Segera: Proyek yang akan segera dimulai + - Dikerjakan: Proyek yang sedang dalam proses pengerjaan + - Selesai: Proyek yang telah selesai + - Batal: Proyek yang dibatalkan +- **Cara menggunakan:** + 1. Pilih menu "Kegiatan" dari fitur utama + 2. Untuk membuat kegiatan baru, klik tombol "+" di kanan atas + 3. Isi nama kegiatan dan deskripsi + 4. Pilih tahun pelaksanaan + 5. Tambahkan anggota yang terlibat + 6. Klik "Simpan" untuk membuat kegiatan + +### 6. Divisi +**Deskripsi:** Fitur untuk mengelola struktur organisasi desa berdasarkan divisi +- **Fungsi:** Mengorganisir warga dan tugas-tugas berdasarkan divisi-divisi tertentu +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin + - Melihat: Semua pengguna + - Anggota: Berdasarkan divisi yang diikuti +- **Cara menggunakan:** + 1. Pilih menu "Divisi" dari fitur utama + 2. Untuk membuat divisi baru, klik tombol "+" di kanan atas + 3. Isi nama dan deskripsi divisi + 4. Pilih grup induk (jika ada) + 5. Tambahkan anggota dan admin divisi + 6. Klik "Simpan" untuk membuat divisi + 7. Klik pada nama divisi untuk melihat detail dan fitur dalam divisi tersebut + +### 7. Anggota +**Deskripsi:** Fitur untuk mengelola data warga atau anggota desa +- **Fungsi:** Menyimpan dan mengelola informasi tentang warga desa +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin + - Melihat: Semua pengguna +- **Cara menggunakan:** + 1. Pilih menu "Anggota" dari fitur utama + 2. Gunakan fitur pencarian untuk menemukan anggota tertentu + 3. Gunakan filter untuk menampilkan anggota aktif/tidak aktif + 4. Klik pada nama anggota untuk melihat detail profil + 5. Untuk menambah anggota baru, klik tombol "+" di kanan atas + +### 8. Jabatan +**Deskripsi:** Fitur untuk mengelola posisi atau jabatan dalam organisasi desa +- **Fungsi:** Mendefinisikan struktur jabatan dalam lembaga desa +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin + - Melihat: Semua pengguna +- **Cara menggunakan:** + 1. Pilih menu "Jabatan" dari fitur utama + 2. Gunakan fitur pencarian untuk menemukan jabatan tertentu + 3. Gunakan filter untuk menampilkan jabatan aktif/tidak aktif + 4. Untuk menambah jabatan baru, klik tombol "+" di kanan atas + +### 9. Lembaga Desa +**Deskripsi:** Fitur untuk mengelola berbagai lembaga dalam desa +- **Fungsi:** Mengorganisir struktur organisasi desa berdasarkan lembaga +- **Siapa yang bisa mengakses:** + - Pembuatan/Edit/Hapus: Super Admin, Developer + - Melihat: Semua pengguna +- **Cara menggunakan:** + 1. Pilih menu "Lembaga Desa" dari fitur utama + 2. Gunakan fitur pencarian untuk menemukan lembaga tertentu + 3. Gunakan filter untuk menampilkan lembaga aktif/tidak aktif + 4. Untuk menambah lembaga baru, klik tombol "+" di kanan atas + +### 10. Diskusi Divisi +**Deskripsi:** Forum diskusi khusus untuk masing-masing divisi +- **Fungsi:** Tempat berdiskusi secara internal dalam divisi +- **Siapa yang bisa mengakses:** Hanya anggota divisi yang bersangkutan +- **Cara menggunakan:** + 1. Pilih sebuah divisi dari menu "Divisi" + 2. Pilih submenu "Diskusi Divisi" + 3. Klik tombol "+" untuk membuat diskusi baru + 4. Isi judul dan deskripsi diskusi + 5. Klik "Simpan" untuk membuat diskusi + +### 11. Tugas Divisi +**Deskripsi:** Fitur untuk mengelola tugas-tugas dalam masing-masing divisi +- **Fungsi:** Menetapkan dan melacak tugas-tugas yang harus diselesaikan oleh anggota divisi +- **Siapa yang bisa mengakses:** Hanya anggota divisi yang bersangkutan +- **Cara menggunakan:** + 1. Pilih sebuah divisi dari menu "Divisi" + 2. Pilih submenu "Tugas Divisi" + 3. Klik tombol "+" untuk membuat tugas baru + 4. Isi nama tugas dan detail lainnya + 5. Tambahkan anggota yang bertugas + 6. Klik "Simpan" untuk membuat tugas + +### 12. Dokumen +**Deskripsi:** Sistem manajemen dokumen untuk menyimpan dan mengelola file-file desa +- **Fungsi:** Menyimpan dokumen penting dalam struktur folder +- **Siapa yang bisa mengakses:** Akses berdasarkan divisi dan hak akses +- **Cara menggunakan:** + 1. Pilih sebuah divisi dari menu "Divisi" + 2. Pilih submenu "Dokumen" + 3. Buat folder baru atau upload file + 4. Gunakan fitur share untuk membagikan dokumen ke divisi lain + +### 13. Kalender/Acara +**Deskripsi:** Fitur untuk menjadwalkan dan mengelola acara-acara desa +- **Fungsi:** Menjadwalkan kegiatan dan acara penting desa +- **Siapa yang bisa mengakses:** Hanya anggota divisi yang bersangkutan +- **Cara menggunakan:** + 1. Pilih sebuah divisi dari menu "Divisi" + 2. Pilih submenu "Kalender" + 3. Klik tombol "+" untuk membuat acara baru + 4. Isi detail acara (judul, deskripsi, tanggal, waktu) + 5. Tambahkan anggota yang ikut serta + 6. Klik "Simpan" untuk membuat acara + +### 14. Notifikasi +**Deskripsi:** Sistem notifikasi untuk memberitahu pengguna tentang aktivitas penting +- **Fungsi:** Memberitahu pengguna tentang pengumuman, komentar, atau aktivitas lainnya +- **Siapa yang bisa mengakses:** Semua pengguna +- **Cara menggunakan:** + 1. Klik ikon notifikasi di bagian atas layar + 2. Lihat daftar notifikasi yang belum dibaca + 3. Klik pada notifikasi untuk membuka konten terkait + +### 15. Profil +**Deskripsi:** Fitur untuk melihat dan mengedit informasi pribadi pengguna +- **Fungsi:** Menampilkan dan mengelola informasi akun pengguna +- **Siapa yang bisa mengakses:** Pengguna yang bersangkutan +- **Cara menggunakan:** + 1. Klik menu "Profil" dari navigasi bawah + 2. Lihat informasi pribadi + 3. Klik "Edit" untuk mengubah informasi (tidak tersedia untuk developer) + +### 16. Banner +**Deskripsi:** Fitur untuk mengelola banner promosi atau informasi penting di halaman utama +- **Fungsi:** Menampilkan informasi atau promosi penting di tampilan awal +- **Siapa yang bisa mengakses:** Super Admin, Deputy Super Admin, Developer +- **Cara menggunakan:** + 1. Pilih menu "Banner" dari fitur utama (jika tersedia) + 2. Klik tombol "+" untuk membuat banner baru + 3. Upload gambar banner dan isi deskripsi + 4. Klik "Simpan" untuk menerbitkan banner + +## User Roles dan Hak Akses + +Aplikasi Desa+ memiliki sistem hierarki peran pengguna sebagai berikut: + +### 1. Developer +- **Deskripsi:** Peran tertinggi dengan semua hak akses +- **Hak akses:** + - Semua fitur dan fungsi dalam aplikasi + - Manajemen semua data dan pengaturan sistem + +### 2. Super Admin (Supadmin) +- **Deskripsi:** Administrator utama desa +- **Hak akses:** + - Semua fitur kecuali beberapa fungsi sistem tingkat tinggi + - Manajemen Deputy Super Admin, Admin, Co-Admin, dan User + - Akses ke semua data dan fungsi administratif + +### 3. Deputy Super Admin (Cosupadmin) +- **Deskripsi:** Wakil administrator utama +- **Hak akses:** + - Manajemen Admin, Co-Admin, dan User + - Akses ke sebagian besar fitur administratif + - Dapat mengelola banner + +### 4. Admin +- **Deskripsi:** Administrator tingkat menengah +- **Hak akses:** + - Manajemen Co-Admin dan User + - Akses ke fitur-fitur administratif dasar + - Tidak dapat mengelola Deputy Super Admin dan Super Admin + +### 5. Deputy Admin (Coadmin) +- **Deskripsi:** Wakil administrator +- **Hak akses:** + - Manajemen User + - Akses terbatas ke fitur-fitur administratif + - Tidak dapat mengelola Admin ke atas + +### 6. User +- **Deskripsi:** Pengguna biasa +- **Hak akses:** + - Akses ke fitur-fitur umum + - Tidak dapat mengelola pengguna lain + - Tidak dapat mengakses fungsi administratif + +## Petunjuk Penggunaan + +### Login ke Aplikasi +1. Buka aplikasi Desa+ +2. Masukkan nomor telepon yang terdaftar +3. Klik "Kirim OTP" +4. Cek WhatsApp untuk menerima kode OTP +5. Masukkan kode OTP yang diterima +6. Klik "Verifikasi" untuk masuk ke aplikasi + +### Navigasi Utama +- **Home:** Tampilan utama dengan informasi dan akses cepat +- **Fitur:** Menu utama untuk mengakses semua fitur aplikasi +- **Pencarian:** Mencari konten di seluruh aplikasi +- **Notifikasi:** Melihat pemberitahuan penting +- **Profil:** Informasi akun dan pengaturan pribadi + +### Membuat Pengumuman Baru +1. Pilih menu "Fitur" dari navigasi bawah +2. Klik "Pengumuman" +3. Klik tombol "+" di kanan atas +4. Isi judul dan deskripsi pengumuman +5. Pilih grup sasaran (opsional) +6. Klik "Simpan" + +### Bergabung dalam Diskusi +1. Pilih menu "Fitur" dari navigasi bawah +2. Klik "Diskusi" +3. Pilih diskusi yang ingin diikuti +4. Ketik komentar di kotak bawah +5. Klik "Kirim" untuk mengirim komentar + +### Mengelola Divisi +1. Pilih menu "Fitur" dari navigasi bawah +2. Klik "Divisi" +3. Klik pada nama divisi untuk melihat detail +4. Di dalam detail divisi, Anda dapat mengakses: + - Tugas Divisi + - Dokumen Divisi + - Diskusi Divisi + - Kalender Divisi + +## Troubleshooting + +### Masalah Login +- Pastikan nomor telepon yang dimasukkan sudah benar dan terdaftar +- Pastikan koneksi internet stabil saat menerima OTP +- Jika tidak menerima OTP, coba kirim ulang setelah beberapa menit + +### Tidak Bisa Mengakses Fitur Tertentu +- Pastikan peran Anda memiliki hak akses ke fitur tersebut +- Beberapa fitur hanya tersedia untuk peran tertentu (misalnya Admin ke atas) + +### Notifikasi Tidak Muncul +- Pastikan izin notifikasi diaktifkan di pengaturan aplikasi +- Pastikan aplikasi tetap berjalan di latar belakang + +### Gambar Tidak Muncul +- Periksa koneksi internet +- Coba refresh halaman atau restart aplikasi + +### Lupa Password +- Aplikasi ini menggunakan sistem login OTP, jadi tidak ada password yang disimpan +- Cukup gunakan nomor telepon dan minta OTP kembali + +## Dukungan dan Bantuan + +Jika Anda mengalami masalah atau memiliki pertanyaan tentang penggunaan aplikasi, silakan hubungi administrator desa atau tim pengembang aplikasi. + +--- +*Dokumen ini terakhir diperbarui pada 4 Februari 2026* \ No newline at end of file