$ cat ./e-qurban/README.md
E-Qurban
E-Qurban was developed to solve the logistical and administrative challenges often faced by local communities during the annual Eid al-Adha festival. Managing participant contributions, tracking the purchase of livestock, and ensuring the fair, organized distribution of meat can be chaotic when handled manually. E-Qurban digitizes and automates this entire workflow. The application features a robust role-based access control (RBAC) system catering to four distinct user types: Admins (for overall system oversight), Committee / Panitia (for operational and financial management), Donors / Pekurban (for contribution tracking), and Citizens / Warga (for receiving distributions). By implementing dynamic, tailored dashboards for each role, the system ensures that everyone involved has real-time visibility into the process. A standout feature of the platform is its digital QR-code-based distribution system. By generating unique QR cards for participants, the committee can easily scan and verify attendees using mobile devices, preventing double-claiming and automating the recording of actual meat weights distributed.
Background & Problem Statement
During Eid al-Adha, local mosques and community organizers handle large amounts of cash contributions and are responsible for the equitable distribution of sacrificial meat. Traditional manual recording methods using paper and spreadsheets often lead to miscalculations, unequal distribution, long queues, and a lack of financial transparency. The goal of this project was to create a structured, transparent, and scalable digital solution to modernize this traditional community event.
Technical Challenges
Complex User Journeys: Designing a unified system that accommodates drastically different workflows—from a donor paying for a Qurban unit (e.g., 1/7th of a cow) to a citizen checking their designated pickup time.
Distribution Integrity: Ensuring that meat is distributed exactly as allocated (e.g., 1/3 for the donor, the rest for the community) without duplication or fraud during the chaotic distribution day.
Framework Architecture: Building a lightweight, custom MVC framework from scratch to handle complex routing, authentication, and database migrations without the overhead of enterprise frameworks like Laravel.
Solutions & Key Features
Engineered a Custom MVC Framework: Developed a secure and lightweight MVC architecture in native PHP. This included building custom database connection handlers, a routing engine, and a migration/seeder CLI (
cli.php), demonstrating a deep understanding of backend architecture.Dynamic Role-Based Dashboards: Created customized UI experiences based on user roles. Admins can view high-level financial statistics, the Committee can manage livestock purchases and scan QR codes, Donors can track their payment status, and Citizens can view their meat allocation and pickup schedules.
QR Code Integration: Implemented
jsQRto generate digital QR code cards for all registered participants. On the day of distribution, the committee simply scans the QR code using a smartphone camera to instantly verify the user, input the actual distributed weight, and update the database in real-time.Financial & Logistics Tracking: Built comprehensive modules for the committee to log collected funds (swadaya), track livestock purchases, and manage logistical expenses (bags, water, etc.), providing full financial transparency.
Results & Impact
E-Qurban successfully modernizes a critical community event by replacing manual paperwork with a streamlined digital workflow. The integration of QR codes ensures a fast, verifiable distribution process, drastically reducing wait times. Furthermore, the comprehensive dashboard provides organizers with real-time insights into funds and livestock availability. On a technical level, this project serves as a testament to my ability to build robust, scalable web applications and foundational software architectures from the ground up.
$ ls ./screenshots/