KIGOMA-CONNECT/twenzetu-sokoni

This platform is a Pan-African Hyperlocal Multi-Service Ecosystem designed to run an asset-light business model across expanding African regions, starting with primary regional hubs (e.g., Kigoma, Tanzania). The system connects consumers with local merchants, market captains, laundry operators, secondhand sellers, and a multi-vehicle logistics # AfriMarket > **Twenzetu Sokoni** — the trusted commerce platform of Africa. Born in Tanzania, engineered to global standards, and organized as **Enterprise Suites**, not standalone modules. AfriMarket is a live, multi-tenant marketplace platform. It connects buyers, vendors, and service providers across web, Android (Trusted Web Activity), and USSD. The platform is structured to scale into a family of Enterprise Suites — Marketplace, Identity, Payments, Analytics, and beyond — governed by a single Constitution. ## Enterprise documentation - **The Constitution** — identity, vision, mission, values, engineering/architecture/product principles, governance, decision framework, and the future. The most important document in the project. - **Enterprise Suites** — how the platform is organized into suites and measured with maturity levels (L0–L7). - **Engineering Institute** — research, architecture, certification, and training: the knowledge ecosystem of the platform. - **Documentation home** ## Repository structure The monorepo is the seed of the platform (an Nx workspace). | Area | Path | Role | |---|---|---| | API | `apps/api` | NestJS API, the composed product (suites + applications) | | Web | `apps/web` | React SPA — the web channel | | Android | `android/` | TWA wrapper for the Play Store | | Suites | `libs/` | Suite-oriented libraries: `identity`, `marketplace`, `tenancy`, `ussd`, `integrations`, `core-*`, `database`, `kernel` | ## Quickstart ```sh npm install npm run serve # run the API locally npx nx build web # build the web app npm run build # build all projects npm run lint # lint all projects npm run test # test all projects ``` Database migrations and seeds: ```sh npm run migration:run npm run seed ``` ## Deployment Production runs from containers (`docker-compose.prod.yml`) behind nginx on commodity infrastructure. Auto-deploy pulls the default branch and runs `./deploy.sh`. Production boot fails fast unless …