Deploy WebGIS 01-05 dengan Docker
This commit is contained in:
@@ -0,0 +1,510 @@
|
||||
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
|
||||
=================================================================
|
||||
Reference in New Issue
Block a user