steve-ongera/Kenya-Level-4-Hospital-HMIS
Domain:
healthcareRecord type:
software
Creator:
ste
Host:
Hospital Management Information System eTIMS (KRA) · SHA (Social Health Authority) · MOH Kenya Compliant
# 🏥 Kenya Level 4 Hospital — HMIS v2.0
> Hospital Management Information System
> eTIMS (KRA) · SHA (Social Health Authority) · MOH Kenya Compliant
---
## Architecture
```
hmis/
├── backend/ # Django (single `core` app)
│ ├── hmis_project/
│ │ ├── settings.py # All configuration
│ │ └── urls.py # Main router (mounts core.urls)
│ ├── core/
│ │ ├── models.py # ALL models in one file
│ │ ├── serializers.py # ALL DRF serializers
│ │ ├── views.py # ALL ViewSets + DashboardView
│ │ ├── urls.py # DefaultRouter wiring
│ │ └── admin.py # Django admin registration
│ ├── manage.py
│ └── requirements.txt
│
└── frontend/ # React + Vite
└── src/
├── App.jsx # Root: auth + layout shell
├── main.jsx # Vite entry
├── styles/global.css # Design system CSS variables
├── services/api.js # Axios + all API service calls
├── components/
│ ├── layout/Sidebar.jsx # Role-aware navigation
│ ├── layout/Navbar.jsx # Top bar + live clock
│ └── ui/index.jsx # Badge, Button, Card, Table…
└── pages/
├── auth/LoginPage.jsx
├── receptionist/ReceptionistDashboard.jsx
├── nurse/NurseDashboard.jsx
├── doctor/DoctorDashboard.jsx
├── pharmacy/PharmacyDashboard.jsx
├── lab/LabDashboard.jsx
├── radiology/RadiologyDashboard.jsx
└── admin/AdminDashboard.jsx
```
---
## Patient Flow
```
Reception (search / register) → Pay consultation fee
→ Triage (nurse records vitals)
→ Doctor Queue
→ Consultation (open)
├─ Order Labs → Lab results → Resume
├─ Order Scans → Radiology results → Resume
└─ Prescribe
→ Pharmacy (dispense)
→ Discharged ✅
```
---
## Backend Setup
```bash
cd backend
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
# Configure DB (PostgreSQL)
createdb hmis_db
createuser hmis_user -P # password: hmis_pass
# …