GenSan Sari-Sari Market
Project Status Report -
Overall Project
65%
Customer App
85%
Admin Dashboard
75%
Merchant POS
70%
System Architecture
The system is a multi-platform ecosystem designed for local commerce in General Santos City. It utilizes Firebase as a unified backend, providing real-time data synchronization across all interfaces.
| Module | Technology | Status |
|---|---|---|
| Customer Android App | Kotlin / Jetpack Compose | Advanced Beta |
| Admin Dashboard | HTML / JS / Firebase SDK | Functional Prototype |
| Merchant POS | HTML / JS / Firebase SDK | Early Beta |
| Rider App | Android (Planned) | Planning / Early Logic |
| Backend / Database | Firestore / RTDB / Storage | Operational |
Customer App (Android)
Accomplishments
- UI Full Jetpack Compose implementation for ~20 screens.
- Auth Firebase Authentication (Email/Password) integrated.
- Core Home Feed with Categories, Merchants, and Products.
- Logic Shopping Cart and Loyalty Point calculation.
- Order Order history and tracking UI connected to Firestore.
Unfinished Work
- Real-time Rider tracking on Map (UI ready, logic pending).
- GCash / Maya Payment Gateway integration.
- Modularization of
MainActivity.kt(Currently 2,900+ lines).
Admin Dashboard (Web)
Accomplishments
- Control Merchant approval/suspension workflow.
- Products Global product approval and management.
- Delivery Delivery Zone management and Fare Matrix config.
- Marketing Promo Banner and Voucher creation.
Unfinished Work
- Advanced Sales Analytics and Reporting charts.
- Automated Merchant Payout verification.
- Admin User Role management.
Merchant POS (Web)
Accomplishments
- Inventory Real-time product management (CRUD).
- POS Walk-in customer order processing.
- Status Store lock/unlock status linked to Platform Admin.
Unfinished Work
- Integration with thermal printers for receipt printing.
- Merchant-specific loyalty reward configuration.
- Low-stock notification system.
Firebase Backend
Accomplishments
- Schema Robust Firestore schema (Merchants > Products).
- Seeding Automated seeding logic for initial data.
- Storage Image upload pipelines for products/riders.
Unfinished Work
- Cloud Functions for Order status transitions.
- Fine-grained Firestore Security Rules.
- Firebase App Check for production security.
Delivery & Rider System
What's Working
- Fare Matrix: Base fare + per KM calculation logic.
- Zone System: Ability to define specific delivery areas.
- Tracking: Real-time location updates via Firebase RTDB.
What's Missing
- Rider App: The dedicated mobile interface for riders.
- Dispatch Logic: Auto-assigning orders to the nearest rider.
- Proof of Delivery: Photo/Signature capture at doorstep.
Development Roadmap
Short Term
Refactoring & Optimization
Moving Composables out of MainActivity.kt into ui.screens. Finalizing the Firebase Messaging service for background notifications.
Medium Term
Rider Ecosystem
Developing the Rider Mobile App and implementing the "Order Acceptance" flow. Integrating GCash/Maya for real payments.
Production
Hardening & Launch
Full security audit, load testing with 100+ concurrent merchants, and deployment to Play Store / Web Hosting.
Known Issues & Recommendations
- Build Stability: The project currently assembles successfully (
:app:assembleDebug), butMainActivity.ktis too large and may cause IDE lag. - Security: Firestore rules need review before public beta to prevent unauthorized data access.
- Sync: Real-time tracking in the Admin Dashboard depends on valid Google Maps API keys which must be restricted to production domains.
Recommendation: Prioritize Modularization and Payment Integration next to reach a "Launch Candidate" state for the Customer App.