Update README.md

README.md

@@ -1,59 +1,94 @@
-<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
+# WebGIS Pengentasan Kemiskinan
 
-<p align="center">
+WebGIS Pengentasan Kemiskinan adalah sebuah sistem informasi berbasis web yang dirancang untuk membantu pengelolaan, pemetaan, dan distribusi bantuan sosial secara tepat sasaran. Sistem ini memanfaatkan teknologi Sistem Informasi Geografis (GIS) untuk memetakan lokasi penerima bantuan, serta mengintegrasikan sistem kupon digital (QR Code) untuk memastikan transparansi dan akuntabilitas dalam proses penyaluran bantuan.
-<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
-<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
-<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
-<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
-</p>
 
-## About Laravel
+## Fitur Utama
 
-Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
+- **Manajemen Data Penerima Bantuan:** Pendaftaran, pembaruan, dan pengelolaan data warga yang berhak menerima bantuan, lengkap dengan dokumen pendukung dan foto bukti.
+- **Pemetaan Spasial (WebGIS):** Visualisasi lokasi penerima bantuan dan titik penyalur (Tempat Ibadah) pada peta interaktif. Sistem juga mengestimasi jarak antara penerima dan penyalur.
+- **Persetujuan (Approval) Berjenjang:** Alur verifikasi data penerima bantuan oleh Admin (Disetujui, Ditolak, atau Menunggu Persetujuan) beserta alasan penolakan.
+- **Sistem Kupon Digital (QR Code):** Pembuatan dan pencetakan kupon bantuan berbasis QR Code yang dienkripsi (Signed URL) untuk mencegah pemalsuan.
+- **Scanner Kupon:** Fitur pemindaian (scan) QR Code kupon pada saat penyaluran bantuan untuk memverifikasi keaslian dan mencatat riwayat pengambilan secara otomatis.
+- **Manajemen Penyalur (Tempat Ibadah):** Pengelolaan entitas penyalur bantuan yang bertugas membagikan bantuan kepada warga di sekitarnya.
+- **Pelaporan & Riwayat Distribusi:** Pencatatan otomatis setiap bantuan yang telah disalurkan beserta laporan bulanan/berkala.
 
-- [Simple, fast routing engine](https://laravel.com/docs/routing).
+## Hak Akses (Role)
-- [Powerful dependency injection container](https://laravel.com/docs/container).
-- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
-- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
-- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
-- [Robust background job processing](https://laravel.com/docs/queues).
-- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
 
-Laravel is accessible, powerful, and provides tools required for large, robust applications.
+Sistem ini mendukung pengelolaan hak akses berbasis *role*:
+1. **Admin:** Memiliki akses penuh ke seluruh fitur, termasuk menyetujui/menolak pengajuan penerima bantuan, mengelola data penyalur, serta memantau peta dan riwayat distribusi keseluruhan.
+2. **User (Penyalur/Tempat Ibadah):** Mengelola data penerima bantuan di wilayahnya, mencetak kupon untuk warga yang telah disetujui, dan melakukan *scan* kupon saat bantuan disalurkan.
 
-## Learning Laravel
+## Teknologi yang Digunakan
 
-Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. You can also check out [Laravel Learn](https://laravel.com/learn), where you will be guided through building a modern Laravel application.
+- **Framework:** Laravel 11 (PHP)
+- **Frontend:** Blade Templating, Tailwind CSS
+- **Pemetaan:** Library GIS (seperti Leaflet.js atau sejenisnya)
+- **QR Code:** Endroid QR Code
+- **Database:** MySQL / MariaDB
 
-If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
+## Prasyarat Lingkungan
 
-## Laravel Sponsors
+- PHP >= 8.2
+- Composer
+- Node.js & NPM
+- Database MySQL / MariaDB
 
-We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the [Laravel Partners program](https://partners.laravel.com).
+## Panduan Instalasi
 
-### Premium Partners
+Ikuti langkah-langkah berikut untuk menjalankan proyek secara lokal:
 
-- **[Vehikl](https://vehikl.com)**
+1. **Kloning Repositori:**
-- **[Tighten Co.](https://tighten.co)**
+   ```bash
-- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)**
+   git clone <url-repo-anda>
-- **[64 Robots](https://64robots.com)**
+   cd webgis_pengentasankemiskinan
-- **[Curotec](https://www.curotec.com/services/technologies/laravel)**
+   ```
-- **[DevSquad](https://devsquad.com/hire-laravel-developers)**
-- **[Redberry](https://redberry.international/laravel-development)**
-- **[Active Logic](https://activelogic.com)**
 
-## Contributing
+2. **Instalasi Dependensi PHP (Composer):**
+   ```bash
+   composer install
+   ```
 
-Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
+3. **Instalasi Dependensi Frontend (NPM):**
+   ```bash
+   npm install
+   ```
 
-## Code of Conduct
+4. **Konfigurasi Environment:**
+   Salin file `.env.example` menjadi `.env`.
+   ```bash
+   cp .env.example .env
+   ```
+   Sesuaikan konfigurasi database (`DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD`) pada file `.env`.
 
-In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
+5. **Generate Application Key:**
+   ```bash
+   php artisan key:generate
+   ```
 
-## Security Vulnerabilities
+6. **Jalankan Migrasi & Seeder Database:**
+   ```bash
+   php artisan migrate --seed
+   ```
+   *Catatan: Anda dapat membuat user admin default melalui seeder.*
 
-If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
+7. **Kompilasi Aset Frontend:**
+   ```bash
+   npm run build
+   # atau untuk mode development: npm run dev
+   ```
 
-## License
+8. **Buat Symbolic Link untuk Storage:**
+   (Dibutuhkan untuk menampilkan foto dan dokumen bukti yang diunggah)
+   ```bash
+   php artisan storage:link
+   ```
 
-The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
+9. **Jalankan Development Server:**
+   ```bash
+   php artisan serve
+   ```
+   Akses aplikasi melalui browser pada `http://localhost:8000`.
+
+## Lisensi
+
+Proyek ini adalah perangkat lunak tertutup atau berpemilik yang dikembangkan untuk tujuan spesifik (Pengentasan Kemiskinan). Hubungi pihak pengembang atau instansi terkait mengenai aturan penggunaan dan lisensi.