steve-ongera/AfyaBoraHMIS

A comprehensive, cloud-ready HMIS built for Level 5 hospitals and multi-branch pharmacy chains in Kenya. Designed to comply with Ministry of Health standards, NHIF/SHA integration, KRA eTIMS, and the Kenya Health Policy 2014–2030. # AfyaBoraHMIS — Level 5 Hospital Management Information System > **"Afya Bora"** — Swahili for *"Better Health"* A comprehensive, cloud-ready HMIS built for **Level 5 hospitals** and **multi-branch pharmacy chains** in Kenya. Designed to comply with Ministry of Health standards, NHIF/SHA integration, KRA eTIMS, and the Kenya Health Policy 2014–2030. --- ## 🏥 System Overview AfyaBoraHMIS is a full-stack electronic health record and hospital operations platform that covers the complete patient journey — from **reception triage** through **consultation**, **pharmacy**, **laboratory**, **inpatient care**, and **billing** — while maintaining a longitudinal patient record accessible across all connected facilities (hospitals and chemists). --- ## 🌐 Multi-Facility Architecture ``` AfyaBoraHMIS Cloud │ ├── Level 5 Hospital (Main) │ ├── OPD / Triage / Emergency │ ├── Inpatient / Wards / ICU │ ├── Laboratory & Radiology │ ├── Pharmacy │ └── Billing / Insurance │ ├── Branch Pharmacy 1 (Nairobi CBD) ├── Branch Pharmacy 2 (Westlands) └── Branch Pharmacy N (...) ``` Patients are identified by a **national ID or phone number**. Their records (prescriptions, diagnoses, allergies, chronic conditions) are accessible at any connected facility. --- ## 🚀 Tech Stack | Layer | Technology | |-------|-----------| | Backend | Django 4.x + Django REST Framework | | Database | PostgreSQL 15+ | | Cache / Queues | Redis + Celery | | Auth | JWT (SimpleJWT) + 2FA | | File Storage | AWS S3 / MinIO | | Frontend | React 18 + Vite | | HTTP Client | Axios | | UI | Tailwind CSS + Ant Design | | Real-time | Django Channels (WebSocket) | | Deployment | Docker + Nginx + Gunicorn | --- ## 📦 Modules | Module | Description | |--------|-------------| | **Authentication** | Login, 2FA, account lock, session tracking | | **Patient Registry** | Unified patient records across all facilities | | **Reception & Queue** | Walk-in registration, triage queue, appointment booking | | * …