Medbelkacem/healthafri

HealthAfri — secure, AI-powered digital healthcare operating system for Africa. FastAPI + HISN MedAI + Next.js + React Native. By HISN. # HealthAfri 🌍🏥 **Transforming African Healthcare Through Secure Digital Innovation.** HealthAfri is a secure, cloud-native, AI-powered **digital healthcare operating system** for Africa — connecting hospitals, clinics, pharmacies, laboratories, ambulances, ministries, insurers, patients, doctors, and medical devices inside one platform. Built by **HISN (حِصن)** — an Algerian deep-tech cybersecurity & AI company building secure digital infrastructure for Africa. > ⚠️ **Scope note (read this first).** HealthAfri is the scope of a multi-year effort by a large engineering organization. This repository is a **production-grade foundation**: a coherent monorepo with real, runnable core services (auth, RBAC/ABAC, multi-tenancy, patients, appointments, audit, hybrid post-quantum crypto), a design-system frontend, full infrastructure-as-code, and complete architecture/security/operations documentation. Every module in the vision is represented; the ones marked **✅ implemented** run today, the ones marked **🧱 scaffolded** ship with contracts, models, and stubs ready for a team to complete. See `docs/PROJECT_SPEC.md` and `docs/STATUS.md`. --- ## Table of contents - Architecture at a glance - Monorepo layout - Quick start - Core modules - Security posture - Technology stack - Documentation index - Contributing & governance --- ## Architecture at a glance ```mermaid flowchart TB subgraph Clients WEB[Web Portals Next.js] MOB[Mobile Apps iOS / Android] DEV[Medical IoT Devices] end subgraph Edge[Zero-Trust Edge] WAF[WAF + NGINX] GW[API Gateway AuthN/AuthZ + mTLS] end subgraph Services[Application Services] API[Core API FastAPI] AI[HISN MedAI AI Services] RT[Realtime / IoT Ingest] WORK[Async Workers] end subgraph Data[Data Plane — encrypted at rest] PG[(PostgreSQL multi-tenant)] REDIS[(Redis)] MQ[[RabbitMQ]] OBJ[(MinIO / S3 DICOM + files)] end WEB & MOB & DEV --> WAF --> GW GW --> API & AI & RT API --> PG & REDIS & OBJ RT --> MQ --> WORK --> PG AI --> PG & OBJ WORK --> OBJ …