Compare commits

...

2 Commits

View File

@@ -1,334 +1,249 @@
# Panduan Penggunaan Aplikasi Desa+
# Panduan 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)
2. [User Roles dan Hak Akses](#user-roles-dan-hak-akses)
3. [Fitur-fitur Aplikasi](#fitur-fitur-aplikasi)
4. [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.
Aplikasi Desa+ adalah platform digital berbasis mobile yang dirancang untuk khusus untuk pegawai desa dalam mengelola data dan memantau progres kegiatan internal. Aplikasi ini menyediakan berbagai fitur seperti pengelolaan data per divisi, pemantauan kegiatan umum, forum diskusi, pengumuman, hingga manajemen folder dokumen, aplikasi ini membantu meningkatkan efisiensi kerja, koordinasi, serta transparansi di lingkungan desa.
### 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
## User Roles dan Hak Akses
Aplikasi Desa+ memiliki sistem hierarki peran pengguna sebagai berikut:
### 1. Super Admin
- **Hak akses:**
- Semua fitur dan fungsi dalam aplikasi
- Manajemen pengguna dengan role Wakil Super Admin, Admin, Wakil Admin, dan User
- Akses ke semua data dan fungsi administratif
### 2. Wakil Super Admin
- **Hak akses:**
- Manajemen pengguna dengan role Admin, Wakil Admin, dan User
- Akses ke sebagian besar fitur administratif
- Dapat mengelola banner
### 3. Admin
- **Hak akses:**
- Manajemen pengguna dengan role Wakil Admin dan User
- Akses ke fitur-fitur administratif dasar
- Tidak dapat mengelola Wakil Super Admin dan Super Admin
### 4. Wakil Admin
- **Hak akses:**
- Manajemen pengguna dengan role User
- Akses terbatas ke fitur-fitur administratif
- Tidak dapat mengelola Admin ke atas
### 5. User
- **Hak akses:**
- Akses ke fitur-fitur umum
- Tidak dapat mengelola pengguna lain
- Tidak dapat mengakses fungsi administratif (kecuali dalam divisi dimana pengguna tersebut adalah anggota)
## Fitur-fitur Aplikasi
### 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
- Fitur untuk mengakses semua fitur aplikasi
- Grafik progres kegiatan
- Grafik dokumen
- Daftar kegiatan terbaru
- Grafik jumlah dokumen
- Daftar kegiatan terupdate
- 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
### 3. Pencarian
**Deskripsi:** Fitur untuk mencari anggota, kegiatan dan divisi
- **Fungsi:** Mencari anggota, kegiatan dan divisi
- **Siapa yang bisa mengakses:** Semua pengguna
### 4. 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
### 5. Profil
**Deskripsi:** Fitur untuk melihat dan mengedit informasi pribadi pengguna
- **Fungsi:** Menampilkan dan mengelola informasi akun pengguna
- **Siapa yang bisa mengakses:** Pengguna yang bersangkutan
### 6. 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, Wakil Super Admin
### 7. 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
- Melihat: Super Admin
### 8. Jabatan
**Deskripsi:** Fitur untuk mengelola posisi atau jabatan
- **Fungsi:** Mengelola data jabatan
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin, Wakil Admin
- Melihat: Semua pengguna
### 9. Anggota
**Deskripsi:** Fitur untuk mengelola data pengguna
- **Fungsi:** Menyimpan dan mengelola informasi tentang pengguna
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin, Wakil Admin
- Melihat: Semua pengguna
### 10. Diskusi Umum
**Deskripsi:** Forum diskusi untuk komunikasi anggota terpilih
### 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
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, 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
- Berkomentar: Pengguna terpilih
### 11. Kegiatan/Proyek
### 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
- Pembuatan/Edit/Hapus/Membatalkan/Mengelola anggota: Super Admin, Wakil Super Admin, Admin
- Mengelola detail (file, task, link, laporan) : Super Admin, Wakil Super Admin, Admin, Anggota dari kegiatan
- 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
### 12. Pengumuman
**Deskripsi:** Fitur untuk membuat, melihat, dan mengelola pengumuman desa
- **Fungsi:** Menyebarkan informasi penting kepada anggota divisi terpilih
- **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
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin
- Melihat:
- Super admin: Semua pengumuman
- Wakil super admin & admin : Pengumuman sesuai lembaga desa
- Lainnya: Pengumuman yang ditujukan ke divisi mereka
### 7. Anggota
**Deskripsi:** Fitur untuk mengelola data warga atau anggota desa
- **Fungsi:** Menyimpan dan mengelola informasi tentang warga desa
### 13. Divisi
**Deskripsi:** Fitur untuk mengelola data desa berdasarkan divisi
- **Fungsi:** Mengorganisir tugas-tugas berdasarkan divisi-divisi tertentu
- **Catatan:** Anggota divisi (role : Wakil Admin dan User) yg diangkat menjadi "Admin Divisi", mendapat akses khusus untuk mengelola divisi tersebut
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Admin, Deputy Super Admin
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin
- Edit Divisi / Non aktifkan Divisi tertentu / Mengelola Anggota divisi tertentu : Super Admin, Wakil Super Admin, Admin, Admin Divisi
- Laporan semua divisi : Super Admin, Wakil Super Admin
- Laporan divisi tertentu : semua pengguna
- 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
### 14. Diskusi Divisi
### 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
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin, Admin Divisi
- Memberi komentar : Super Admin, Wakil Super Admin, Admin, Anggota divisi
- Melihat: Semua pengguna
### 15. Tugas Divisi
### 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
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin, Admin Divisi
- Mengelola detail (file, task, link, laporan) : Super Admin, Wakil Super Admin, Admin, Anggota divisi
- Melihat: Semua pengguna
### 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
### 16. Dokumen Divisi
### 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
**Deskripsi:** Sistem manajemen dokumen untuk menyimpan dan mengelola file-file disetiap divisi
### 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
- **Fungsi:** Menyimpan dokumen penting dalam struktur folder disetiap divisi
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin, Anggota divisi
- Melihat: Semua pengguna
### 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)
### 17. Kalender/Acara Divisi
### 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
**Deskripsi:** Fitur untuk menjadwalkan dan mengelola acara-acara desa disetiap divisi
## 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
- **Fungsi:** Menjadwalkan kegiatan dan acara penting desa disetiap divisi
- **Siapa yang bisa mengakses:**
- Pembuatan/Edit/Hapus: Super Admin, Wakil Super Admin, Admin, Anggota divisi
- Melihat: Semua pengguna
- Riwayat: Semua pengguna
## 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*
Jika Anda mengalami masalah atau memiliki pertanyaan tentang penggunaan aplikasi, silakan hubungi tim pengembang aplikasi.