Wachiradanito/zaruni-engineering

Engineering architecture, case studies, and extracted tools from building Zaruni — a multi-service super-app for Kenya # Zaruni Engineering > Architecture, case studies, and extracted tools from building a multi-service super-app for Kenya ## What is Zaruni? Zaruni is a multi-service marketplace and jobs platform handling real M-PESA payments at production scale in Kenya. It combines: - 💼 **Jobs Marketplace** — Gig worker matching and task management - 🛠️ **Service Bookings** — Home services, repairs, and professional services - 🏪 **Product Marketplace** — Local shops and C2C commerce - 🚚 **Delivery Orchestration** — Logistics and last-mile delivery - 💬 **Real-time Chat** — In-app messaging for all transactions - 💰 **Escrow-backed Payments** — M-PESA integration with payment guarantees **Live Product:** zaruni.co.ke ## Why This Repository Exists Zaruni's source code is private to protect the business. This repository documents the architecture, shares engineering decisions, and showcases the reusable components we've extracted and open-sourced. Think of this as the **engineering museum exhibit** — the real artifacts remain in the archive, but you can see what we built and how we built it. ### The Two-Repo Model | `zaruni` (private) | `zaruni-engineering` (public) | |-------------------|-------------------------------| | Actual source code | Architecture narratives | | Business logic | Tech decision documentation | | Production data models | Problem-solving case studies | | **For:** Running the product | **For:** Proving engineering competence | This is how companies like Twitter, GoDaddy, and Red Hat operate — closed source product, open engineering insights. ## What's in This Repository ### 🗺️ Diagrams Interactive Mermaid diagrams — rendered directly on GitHub. - System Overview — Full architecture, module dependency rules - Payments Flow — STK Push sequence, escrow state machine, provider class diagram - Auth Flow — Registration, JWT lifecycle, OTP security model, tier progression - Deployment Topology — Infrastructure, request routing, Celery tasks, CI/CD pipeline …