ajm1313/MCH-VoiceCare

Maternal and Child Health Digital Health Intervention Solution for Rural Northern Ghana # MCH VoiceCare **Maternal & Child Health VoiceCare** — a clinical decision-support platform for community health workers (CHWs) in Ghana, covering pregnancy, newborn, immunisation, and growth-monitoring workflows with offline-first mobile capture, server-side ML/rule-engine risk stratification, and multi-channel referral & notification capabilities. --- ## Table of Contents 1. Architecture Overview 2. Repository Structure 3. Prerequisites 4. Backend Setup (Django) 5. Mobile App Setup (React Native) 6. Running the Full Stack 7. Testing 8. API Documentation 9. Deployment 10. Project Documentation --- ## Architecture Overview ``` ┌─────────────────────────────────────────────────────────┐ │ Mobile App (React Native) │ │ Offline-first SQLite · Rule-engine · OCR · IVR/USSD │ │ Pregnancy · Newborn · Immunisation · Growth · Referrals │ └───────────────┬─────────────────────────────────────────┘ │ REST API (JWT) + FHIR R4 + Sync outbox ┌───────────────▼─────────────────────────────────────────┐ │ Backend (Django 5 + DRF) │ │ 16 apps · 39 models · ML service · Rule packages │ │ OCR service · Telephony · FHIR · Web dashboard │ │ Django Admin · Monitoring · Aggregate dashboards │ └───────────────┬─────────────────────────────────────────┘ │ PostgreSQL (prod) / SQLite (dev) │ Redis (caching, optional) ``` **Key features:** - **Offline-first mobile** — full clinical workflows work without connectivity; sync queue with retry - **Risk stratification** — server-side ML model + rule-engine with RED/ORANGE/AMBER/GREEN/GREY urgency - **OCR** — scan paper MCH cards/prescriptions; confidence thresholds configurable - **Telephony** — IVR/DTMF and USSD follow-up calls for illiterate users - **FHIR R4** — interoperability endpoint for EHR integration - **Referrals** — QR-token-based with acknowledgment tracking and escalation - **MFA** — TOTP-based multi-factor authentication for ad …