AI-powered medicine tracking for Zimbabwe's public health supply chain. QR-coded consignments, auto-reorder engine, IoT cold-chain monitoring, equipment dashboard, live national inventory view. Pilot-ready. Works offline. Rwanda-proven model.
# HealthBridge MedTrack
**Zimbabwe Medicine Traceability & Stock Management System**
A mobile-first system for tracking medicine consignments from NatPharm central warehouse to hospital pharmacies across Zimbabwe. Features QR code-based receipt confirmation, real-time stock visibility, AI-powered reorder alerts, and e-GP compliance monitoring.
## System Architecture
```
┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ Flutter Mobile │────▶│ Firebase/ │◀────│ React Admin │
│ App (Pharmacy) │ │ Supabase │ │ Dashboard │
│ │ │ Backend │ │ (NatPharm/MoH) │
│ - QR Scanning │ │ │ │ │
│ - Stock View │ │ - Firestore DB │ │ - Stock Map │
│ - Offline Mode │ │ - Cloud Funcs │ │ - Reorder Eng │
│ - Adjustments │ │ - Auth │ │ - Compliance │
└─────────────────┘ └──────────────────┘ └──────────────────┘
```
## Project Structure
```
healthbridge-medtrack/
├── backend/ # Firebase Configuration & Cloud Functions
│ ├── firestore.rules # Firestore security rules
│ ├── firestore.indexes.json # Composite indexes
│ ├── firebase.json # Firebase project config
│ ├── storage.rules # Storage security rules
│ └── functions/
│ ├── package.json
│ ├── tsconfig.json
│ └── src/
│ ├── index.ts # Function exports
│ ├── config.ts # Firebase init & constants
│ ├── middleware/auth.ts # Auth helpers
│ ├── api/ # Callable API functions
│ │ ├── stockApi.ts
│ │ ├── consignmentApi.ts
│ │ ├── facilityApi.ts
│ │ ├── supplierApi.ts
│ │ └── reorderApi.ts
│ ├── triggers/ # Firestore triggers
│ │ ├── stockTriggers.ts
│ │ └── consignmentTri …