Luke-Manyamazi/MrChow

Shared backend API for Mr Chow food, grocery, delivery, WhatsApp, and online payments in Masvingo, Zimbabwe. # Mr Chow Mr Chow is a food and grocery delivery platform for Masvingo, Zimbabwe. This repository contains the shared backend API that connects customers using the web app, mobile app, or WhatsApp with restaurants and merchants, delivery drivers, administrators, and online payment providers. > **Status: In progress** The API foundation is available now. Production authentication, client applications, database deployment, merchant onboarding, driver operations, and live payment credentials are still being completed. ## Platform scope - **Customer web and mobile apps:** browse merchants, view products, place orders, track delivery, and pay online. - **WhatsApp ordering:** receive text, interactive replies, and location messages through the Meta Cloud API. - **Admin app:** view operational metrics and orders, update order status, and assign deliveries. - **Merchant operations:** manage active merchants and their menus through the shared database and API foundation. - **Delivery operations:** assign drivers and update assigned, picked-up, and delivered states. - **Payments:** Paynow integration for Visa, Mastercard, EcoCash, and OneMoney flows where enabled by the merchant account. ## Setup 1. Copy `.env.example` to `.env` and set `DATABASE_URL` plus the WhatsApp credentials. 2. Install dependencies with `npm install`. 3. Generate the Prisma client with `npm run prisma:generate`. 4. Apply the schema to a development database with `npx prisma migrate dev --name init`. 5. Load repeatable Masvingo development data with `npm run prisma:seed`. 6. Start the API with `npm run dev`. The polished React web client lives in `web/`. Run it separately during development with `cd web && npm install && npm run dev`; it opens at `localhost` and proxies API calls to the backend on port `3012`. Build it for deployment with `npm run build` from the `web/` directory. The health check is available at `GET /health`. ## API - `GET /api/v1/merchants` - `GET /api/v1/merch …