myckhel/healthsphere-ai

HealthSphere AI is an AI-assisted virtual health centre platform for community clinics, with an initial focus on Nigeria and similar low-resource settings. # HealthSphere AI HealthSphere AI is an AI-assisted virtual health centre platform for community clinics, with an initial focus on Nigeria and similar low-resource settings. The project is designed around a simple principle: use software and narrowly scoped AI to improve clinic workflows without replacing clinical judgment. The current codebase already includes a working backend API, a React-based frontend, local development auth stubs, and core patient, triage, consultation, and record workflows. ## Product direction HealthSphere is intended to help clinics move from paper-heavy, reactive operations to structured, auditable, digitally assisted care. Core goals: - digitize paper records into structured patient data - reduce intake and routing bottlenecks - support clinicians during consultations without presenting AI as a diagnosis engine - automate safe follow-up workflows over channels patients already use - work reliably in low-bandwidth, intermittently connected environments - keep privacy, clinician review, and auditability first-class ## Current implementation What is working now: - FastAPI backend with versioned routes under `/api/v1` - PostgreSQL-backed data model and Alembic migrations - React 19 + TypeScript + Vite frontend for clinic workflows - local stub auth for development - patient registration and lookup flows - triage intake and queue views - consultation creation, editing, resume, and completion flows - record capture and review flows - deterministic triage guardrails for higher-risk cases What is planned but not fully wired yet: - Clerk-based production authentication - Calendly-backed appointment scheduling - OCR-assisted record digitization with human review - narrow healthcare agents built with the OpenAI Agents SDK - automated follow-up and outreach messaging - richer analytics and operational dashboards ## Architecture The repository is organized around healthcare workflows, not vendor SDKs. ```text health-centre/ ├── backend/ …