TUTORIAL CARA PAKAI APLIKASI WEBGIS POVERTY MAPPING PROJECT 05
=================================================================

A. AKUN LOGIN DEMO
------------------

Semua password akun demo adalah:

password

Akun utama:

1. Super Admin
   Username : superadmin
   Password : password

Contoh akun admin rumah ibadah jika memakai database demo:

2. Admin Gereja Sesilia
   Username : admingerejasesilia
   Password : password

3. Admin Gereja Elim
   Username : admingerejaelim
   Password : password

Contoh akun penerima jika memakai database demo:

4. Penerima 02
   Username : penerima02
   Password : password

5. Penerima 04
   Username : penerima04
   Password : password

6. Penerima 05
   Username : penerima05
   Password : password

Catatan:
- Akun nonaktif tidak bisa login.
- Jika membuat akun baru, password minimal 6 karakter.

=================================================================

B. ALUR UMUM APLIKASI
---------------------

Aplikasi ini dipakai untuk:

1. Memetakan rumah ibadah.
2. Memetakan calon penerima bantuan.
3. Menghubungkan penerima dengan rumah ibadah terdekat dalam radius 300 meter.
4. Menyetujui atau menolak pengajuan penerima.
5. Membuat program bantuan.
6. Mencatat penyaluran bantuan.
7. Melihat laporan penerima yang sudah/belum diberi bantuan per bulan.

Role pengguna:

1. Super Admin
   Mengelola semua data.

2. Admin Rumah Ibadah
   Mengelola rumah ibadah, penerima, program, dan penyaluran sesuai rumah ibadahnya.

3. Penerima
   Mengajukan titik lokasi rumah dan melihat riwayat bantuan.

=================================================================

C. CARA LOGIN
-------------

1. Buka aplikasi:
   http://localhost/webgis-poverty/05/

2. Masukkan username.

3. Masukkan password.

4. Klik Login.

5. Setelah berhasil, pengguna masuk ke dashboard.

=================================================================

D. CARA LOGOUT
--------------

1. Klik tombol Logout di bagian atas halaman.
2. Sistem akan keluar dari akun.
3. Pengguna diarahkan kembali ke halaman login.

=================================================================

E. CARA PAKAI SEBAGAI SUPER ADMIN
---------------------------------

Super Admin adalah role tertinggi.
Super Admin dapat mengelola seluruh data aplikasi.

1. Login Super Admin

   Username : superadmin
   Password : password

2. Melihat Dashboard

   Setelah login, dashboard menampilkan statistik seperti:
   - Rumah ibadah menunggu.
   - Rumah ibadah diterima.
   - Penerima menunggu.
   - Penerima diterima.
   - Penerima ditolak.
   - Program aktif.

3. Mengelola Akun

   Langkah:
   - Buka Dashboard.
   - Cari bagian Kelola Akun Pengguna.
   - Isi nama, username, password, role, dan status akun.
   - Pilih role: Admin Rumah Ibadah atau Penerima.
   - Klik Buat Akun.

   Super Admin dapat:
   - membuat akun admin rumah ibadah;
   - membuat akun penerima;
   - mengedit akun;
   - menonaktifkan akun;
   - menghapus akun jika belum punya relasi data.

   Jika akun sudah punya relasi data, sistem tidak menghapus permanen, tetapi menonaktifkan akun agar data riwayat tetap aman.

4. Menambah Rumah Ibadah

   Langkah:
   - Klik Buka Peta.
   - Klik titik lokasi rumah ibadah di peta.
   - Klik Tambah Rumah Ibadah.
   - Isi username admin rumah ibadah.
   - Isi nama rumah ibadah.
   - Pilih agama.
   - Isi alamat dan nomor HP.
   - Klik Ajukan/Tambah.

   Jika Super Admin yang menambah, data dapat langsung aktif/diterima.

5. Menyetujui Rumah Ibadah

   Langkah:
   - Buka peta.
   - Klik marker rumah ibadah yang berstatus menunggu.
   - Klik Setujui jika data benar.
   - Klik Tolak jika data tidak valid.

   Jika rumah ibadah disetujui, sistem akan menghitung ulang penerima yang berada dalam radius 300 meter.

6. Menambah Penerima

   Langkah:
   - Buka peta.
   - Klik lokasi rumah penerima.
   - Klik Tambah Penerima.
   - Isi username akun penerima.
   - Isi nama, NIK, nomor HP, alamat, pekerjaan, penghasilan, jumlah tanggungan, kondisi rumah, dan jenis bantuan.
   - Klik Simpan.

   Sistem akan mencari rumah ibadah terdekat dalam radius 300 meter.

7. Menyetujui Penerima

   Langkah:
   - Buka peta.
   - Klik marker penerima berstatus menunggu.
   - Klik Setujui untuk menerima.
   - Klik Tolak untuk menolak.

   Penerima yang diterima dapat masuk ke laporan dan penyaluran bantuan.

8. Menghapus Marker/Pin

   Super Admin dapat langsung menghapus marker rumah ibadah atau pin penerima dari peta aktif.

   Langkah:
   - Klik marker/pin.
   - Klik Hapus Marker atau Hapus Pin.
   - Isi alasan jika diminta.
   - Konfirmasi.

   Data tidak hilang permanen dari database, tetapi tidak tampil lagi sebagai data aktif.

9. Memproses Pengajuan Hapus Marker/Pin

   Langkah:
   - Buka Dashboard.
   - Cari bagian Persetujuan Hapus Marker/Pin.
   - Lihat pengajuan hapus rumah ibadah atau penerima.
   - Klik Setujui Hapus atau Tolak Hapus.

10. Membuat Program Bantuan

   Langkah:
   - Buka Dashboard.
   - Cari bagian Buat Program Bantuan.
   - Pilih rumah ibadah.
   - Isi nama program.
   - Pilih jenis bantuan.
   - Isi bulan dan tahun.
   - Isi target frekuensi.
   - Isi nominal atau jumlah item jika ada.
   - Isi deskripsi.
   - Klik Simpan.

11. Menghapus Program Bantuan

   Langkah:
   - Buka bagian Daftar Program.
   - Pilih program.
   - Klik Hapus.

   Jika program sudah punya data penyaluran, sistem dapat membatalkan program, bukan menghapus permanen.

12. Mencatat Penyaluran Bantuan

   Langkah:
   - Buka Dashboard.
   - Cari bagian Catat Penyaluran Bantuan.
   - Pilih program.
   - Pilih penerima diterima.
   - Jenis bantuan, nominal, dan item akan mengikuti program.
   - Isi tanggal.
   - Isi keterangan jika perlu.
   - Klik Simpan.

   Syarat:
   - Penerima harus berstatus diterima.
   - Penerima harus berada pada rumah ibadah yang sama dengan program.
   - Penerima harus berada dalam radius 300 meter.
   - Program tidak boleh berstatus selesai atau dibatalkan.

13. Melihat Laporan Bulanan

   Langkah:
   - Buka Dashboard.
   - Cari bagian Monitoring Penyaluran Per Periode.
   - Pilih bulan dan tahun.
   - Gunakan filter rumah ibadah, agama, program, jenis bantuan, dan status.
   - Klik tampilkan/muat laporan.

   Status laporan:
   - belum_diberi
   - sudah_diberi
   - belum_memenuhi_target
   - sesuai_target
   - melebihi_target

14. Melihat Riwayat

   Langkah:
   - Buka Dashboard.
   - Cari bagian Riwayat Pengajuan dan Bantuan.
   - Lihat daftar pengajuan, perubahan status, dan penyaluran.

=================================================================

F. CARA PAKAI SEBAGAI ADMIN RUMAH IBADAH
----------------------------------------

Admin Rumah Ibadah mengelola data sesuai rumah ibadah miliknya.
Satu admin dapat mengelola lebih dari satu rumah ibadah.

1. Login Admin Rumah Ibadah

   Contoh:
   Username : admingerejasesilia
   Password : password

2. Mengajukan Rumah Ibadah

   Langkah:
   - Buka peta.
   - Klik lokasi rumah ibadah.
   - Klik Ajukan Rumah Ibadah.
   - Isi nama rumah ibadah, agama, alamat, dan nomor HP.
   - Klik Ajukan.

   Status awal adalah menunggu.
   Super Admin harus menyetujui pengajuan tersebut.

3. Membuat Akun Penerima

   Langkah:
   - Buka Dashboard.
   - Cari Kelola Akun Pengguna.
   - Isi nama, username, dan password penerima.
   - Role otomatis/terbatas sebagai penerima.
   - Klik Buat Akun.

4. Menambah Penerima

   Langkah:
   - Buka peta.
   - Klik lokasi rumah penerima.
   - Klik Tambah Penerima.
   - Isi username penerima.
   - Isi data penerima.
   - Klik Simpan.

   Catatan:
   - Penerima harus berada dalam radius 300 meter dari rumah ibadah milik admin.
   - Jika lokasi lebih dekat ke rumah ibadah lain, sistem akan menolak agar data tidak salah sinkron.

5. Menyetujui atau Menolak Penerima

   Langkah:
   - Buka peta.
   - Klik marker penerima menunggu.
   - Klik Setujui atau Tolak.

   Batasan:
   - Admin rumah ibadah tidak boleh mengembalikan status penerima ke menunggu.
   - Admin rumah ibadah tidak boleh membatalkan penerima yang sudah diterima.
   - Untuk reset/batal penerima diterima, hubungi Super Admin.

6. Membuat Program Bantuan

   Langkah:
   - Buka Dashboard.
   - Pilih rumah ibadah milik admin.
   - Isi nama program, jenis bantuan, bulan, tahun, target, nominal/item, dan deskripsi.
   - Klik Simpan.

7. Mencatat Penyaluran Bantuan

   Langkah:
   - Buka Dashboard.
   - Pilih program.
   - Pilih penerima yang sudah diterima.
   - Isi tanggal dan keterangan.
   - Klik Simpan.

   Sistem hanya menampilkan/menerima penerima yang sesuai dengan rumah ibadah program.

8. Melihat Laporan

   Langkah:
   - Buka Dashboard.
   - Pilih bulan dan tahun.
   - Gunakan filter yang tersedia.
   - Lihat data penerima yang sudah atau belum diberi bantuan.

9. Mengajukan Hapus Marker/Pin

   Langkah:
   - Buka peta.
   - Klik marker rumah ibadah milik admin atau pin penerima yang dikelola.
   - Klik Ajukan Hapus.
   - Isi alasan.
   - Kirim.

   Super Admin akan memutuskan setuju atau tolak.

=================================================================

G. CARA PAKAI SEBAGAI PENERIMA
------------------------------

Penerima dapat membuat akun sendiri melalui registrasi.

1. Registrasi Akun Penerima

   Langkah:
   - Buka halaman login.
   - Klik Registrasi.
   - Isi nama lengkap.
   - Isi username.
   - Isi password minimal 6 karakter.
   - Isi konfirmasi password.
   - Klik Daftar.

2. Login Penerima

   Langkah:
   - Buka halaman login.
   - Masukkan username dan password.
   - Klik Login.

3. Mengajukan Titik Lokasi Rumah

   Langkah:
   - Buka peta.
   - Klik lokasi rumah pada peta.
   - Isi data penerima.
   - Klik Simpan Pengajuan.

   Sistem akan memeriksa apakah lokasi masuk radius 300 meter dari rumah ibadah diterima.

4. Melihat Status Pengajuan

   Langkah:
   - Buka peta atau dashboard.
   - Lihat status pengajuan.

   Status yang mungkin:
   - menunggu
   - diterima
   - ditolak
   - dibatalkan

5. Melihat Riwayat Bantuan

   Langkah:
   - Buka Dashboard.
   - Lihat bagian riwayat atau laporan yang tersedia untuk akun penerima.

6. Mengajukan Hapus Pin

   Langkah:
   - Buka peta.
   - Klik pin milik sendiri.
   - Klik Ajukan Hapus Pin.
   - Isi alasan.
   - Kirim.

   Pengajuan hapus harus disetujui Super Admin.

=================================================================

H. ATURAN PENTING SISTEM
------------------------

1. Satu akun penerima hanya boleh punya satu pin aktif.

2. Rumah ibadah aktif adalah rumah ibadah yang statusnya diterima dan tidak dihapus.

3. Penerima aktif adalah penerima yang statusnya menunggu/diterima dan tidak dihapus.

4. Radius tanggung jawab rumah ibadah adalah 300 meter.

5. Jika ada beberapa rumah ibadah dalam radius 300 meter, penerima dikaitkan ke rumah ibadah terdekat.

6. Admin rumah ibadah hanya boleh mengelola data rumah ibadahnya sendiri.

7. Super Admin memiliki akses paling luas.

8. Password akun demo adalah password.

9. File SQL dan ZIP backup jangan dibiarkan di public_html setelah hosting.

=================================================================

I. TIPS SAAT PRESENTASI / DEMO
------------------------------

Urutan demo yang rapi:

1. Login sebagai Super Admin.
2. Tunjukkan dashboard.
3. Buka peta.
4. Tunjukkan marker rumah ibadah dan penerima.
5. Tambahkan akun penerima baru.
6. Tambahkan atau ajukan rumah ibadah.
7. Tambahkan penerima dari peta.
8. Setujui penerima.
9. Buat program bantuan.
10. Catat penyaluran bantuan.
11. Buka laporan bulanan.
12. Tunjukkan status sudah/belum diberi bantuan.
13. Tunjukkan pengajuan hapus marker/pin.
14. Logout.

=================================================================

J. MASALAH UMUM DAN SOLUSI CEPAT
--------------------------------

1. Tidak bisa login
   - Cek username.
   - Cek password: password.
   - Cek status akun harus aktif.

2. Peta tidak muncul
   - Pastikan internet aktif.
   - Leaflet diambil dari CDN.

3. Marker tidak muncul
   - Cek status data.
   - Data ditolak atau dihapus memang tidak tampil aktif.

4. Penerima tidak bisa ditambah
   - Cek apakah akun penerima sudah punya pin aktif.
   - Cek apakah koordinat valid.
   - Cek apakah username penerima benar dan aktif.

5. Admin rumah ibadah tidak bisa menambah penerima
   - Cek apakah lokasi penerima masuk radius 300 meter rumah ibadah miliknya.
   - Cek apakah penerima lebih dekat ke rumah ibadah lain.

6. Tidak bisa mencatat bantuan
   - Cek status program.
   - Cek status penerima.
   - Cek apakah program dan penerima berada pada rumah ibadah yang sama.

=================================================================

SELESAI
=================================================================
