African mobile marketplace with escrow payments & live delivery tracking. Pinduoduo-style for the African market.
Multi-Sided E-Commerce & On-Demand Logistics Marketplace
Escrow-protected commerce built for emerging African markets
---
## 🌍 About Wunabuy
Wunabuy is an enterprise multi-sided mobile e-commerce and on-demand logistics platform designed specifically for emerging African markets, launching first in **Yaoundé, Cameroon**.
It connects three user groups through a single escrow-protected ecosystem:
| Role | What They Do |
|---|---|
| 🛒 **Buyers** | Search verified stores, purchase with escrow protection, track deliveries in real-time |
| 🏪 **Sellers (Store Owners)** | Digitize storefronts, manage inventory, receive guaranteed payouts after verified delivery |
| 🚚 **Transport Providers** | Accept delivery jobs, navigate with GPS, earn transparent mileage-based fees |
An internal **Staff Portal** provides operational dashboards across 6 departments (Finance, IT, Customer Service, Operations, Compliance, Marketing) with strict RBAC and MFA.
### Core Value Propositions
- **Escrow-Protected Payments** — Buyer funds are locked until delivery is confirmed via photo proof + buyer digital signature. 48-hour auto-release with dispute protection.
- **3.5% Platform Commission** — Transparent, configurable marketplace fee deducted before seller wallet credit.
- **Real-Time GPS Tracking** — Live transporter location updates every 10 seconds via Laravel Reverb WebSockets.
- **Offline-Resilient Design** — Built for spotty 3G/4G in African urban markets with queued background sync.
- **Multi-Language** — English, French, and Swahili support (Phase 1).
---
## 📁 Repository Structure
```
wunabuy/
├── backend/ # Laravel 13 Modular Monolith (PHP 8.3+)
│ ├── app/ # Core Service Providers & Middleware
│ ├── Modules/ # nwidart/laravel-modules (Auth, Commerce, Payment, Delivery, etc.)
│ ├── config/ # Horizon, Reverb, Sanctum, Permissions configuration
│ ├── database/ # PostgreSQL + PostGI …