stephenombuya/smart-health-expert-system
Domain:
healthcareRecord type:
softwareproject
Creator:
ste
Host:
The Smart Health Expert System (SHES) is a full-stack web application that provides AI-driven clinical decision support tailored to Kenya's healthcare context. It bridges the critical gap between patients and the severely overstretched healthcare system by offering instant, evidence-based medical guidance through a rule-based inference engine.
# SHES — Smart Health Expert System
```
╔═══════════════════════════════════════════════════════╗
║ SMART HEALTH EXPERT SYSTEM (SHES) ║
║ AI-Driven Clinical Decision Support for Kenya ║
╚═══════════════════════════════════════════════════════╝
```
---
## Table of Contents
1. Project Overview
2. The Problem Being Solved
3. System Features
4. Technology Stack
5. System Architecture
6. Project Structure
7. Prerequisites
8. Installation & Setup
- Database Setup
- Backend Setup
- Frontend Setup
9. Running the System
10. API Reference
11. The Inference Engine
12. Security Architecture
13. Testing
14. Environment Variables
15. Docker Deployment
16. Database Schema
17. Knowledge Base
18. Troubleshooting
19. Contributing
20. Acknowledgements
---
## 1. Project Overview
The **Smart Health Expert System (SHES)** is a full-stack web application that provides AI-driven clinical decision support tailored to Kenya's healthcare context. It bridges the critical gap between patients and the severely overstretched healthcare system by offering instant, evidence-based medical guidance through a rule-based inference engine.
The system comprises:
- A **Django REST API backend** housing the clinical inference engine, drug interaction checker, chronic disease tracker, lab result interpreter, and mental health module.
- A **React + TypeScript frontend** providing an accessible, responsive interface for patients and healthcare providers.
- A **JSON-based Knowledge Base** encoding clinical rules drawn from the Kenya National Clinical Guidelines and WHO primary care protocols.
> ⚕️ **Disclaimer:** SHES is a clinical decision *support* tool. It does not replace professional medical diagnosis or treatment. All triage outputs are advisory only.
---
## 2. The Problem Being Solved
Kenya's healthcare system faces a severe resource crisis:
| Metric | Kenya | WHO Target |
|--------|-------|-----------|
| Doctor-to-patient ratio | 1 : 6,355 | 1 : 1,00 …