thatomoloto/zuza-mzansi

A Township First C2C Marketplace for South African Traders # Zuza-Mzansi **A township-first C2C marketplace for South Africa.** Zuza-Mzansi connects local buyers and sellers through a secure, escrow-backed platform with built-in support for Zulu, Sotho, Tswana, and Afrikaans — designed to empower everyday entrepreneurs in South African townships. --- ## Features - **Product listings** — sell across categories: Electronics, Clothing, Home, Food, Tools, Vehicles, Services - **Auction/bidding system** — time-limited auctions with real-time bid tracking - **Escrow payments** — 3-day hold period with 5% platform fee before funds release - **Zuza Lockers** — pickup points at local spaza shops for safe, convenient delivery - **Seller verification** — ID document upload and verified seller badge - **Ratings & reviews** — 5-star seller rating system - **User wallets** — escrow balance per account - **Multilingual UI** — English, Zulu, Sotho, Tswana, Afrikaans - **Admin dashboard** — multi-role management (super_admin, admin, moderator, seller, buyer) with full audit logging --- ## Tech Stack | Layer | Technology | |-------|-----------| | Backend | PHP 8+ (procedural + class-based) | | Database | MySQL 8 | | Frontend | HTML5, CSS3, vanilla JS, jQuery 3.7.1 | | Icons | Material Icons | | Currency | South African Rand (ZAR) | | Timezone | Africa/Johannesburg | --- ## Project Structure ``` zuza-mzansi/ ├── admin/ # Admin dashboard (users, products, orders, reports…) │ ├── api/ # Admin API endpoints │ ├── css/ │ └── js/ ├── database/ │ └── schema.sql # Full DB schema ├── includes/ │ ├── Auth.php # Session-based auth with CSRF tokens │ ├── Database.php # PDO singleton wrapper │ ├── config.php # DB credentials & app constants (not committed) │ └── lang.php # Language loader ├── lang/ │ ├── en.php # English translations │ └── zu.php # Zulu translations ├── public/ # User-facing pages │ ├── api/ # Public API endpoints …