One Health — Documentation
Patient-centric care network with HIPAA-first design and research-grade AI. Public site: onehealth.s4ai.com · Repo: raviraghu1/PatientRx
This is the engineering + functional documentation portal. Source of truth lives in the repo at docs/ and specs/; this site presents a curated navigable view with architecture diagrams.
Start here
| If you are a… | Start at |
|---|---|
| Stakeholder / new team member wanting the big picture | Architecture → System |
| Clinician / PM asking "what does it do?" | Functional → Overview |
| New developer ready to code | Technical → Development workflow |
| Security / compliance reviewer | HIPAA → Overview |
| ML / AI researcher | Research AI → Overview |
What this project is
A patient-centric care network built on three design commitments:
- Patient timeline, not EHR fragments. One place — patient, primary care, specialists, labs, imaging, family history, referrals — with the patient in control of consent.
- AI that cites its sources. Hybrid knowledge-graph + BM25 retrieval, 5-agent research pipeline, dual-LLM fallback, FDA CDS-exemption metadata on every output. The clinician reviews; the AI never acts autonomously.
- HIPAA by construction. Envelope encryption, hash-chained audit, consent-first access, fail-closed services, BAA-gated vendors. Enforcement is in the code patterns + CI gates, not a later checklist.
System at a glance
What's in this site
- Architecture — system diagrams, research AI block diagram, auth + consent flows, audit chain, data model
- Functional — what patients, providers, and care teams see
- Technical — services, tech stack, data flows, development workflow
- Research AI — knowledge graph, hybrid retrieval, 5 agents, orchestrator, benchmark
- HIPAA Compliance — 5 principles, 17 Phase-4 rules, audit chain, consent model, BAA
What's not in this site
- Per-spec detail — the 61 specs in
specs/<NNN>/stay authoritative for their phase artifacts - Dev-workflow tactical playbooks — the root
README.mdis first-day setup + skill decision tree + 7 path playbooks - Per-file API reference — generated from source code on demand
Last session (2026-04-23): 23 PRs merged · 14 specs shipped · SPEC-01..07 all on main · public landing live at onehealth.s4ai.com · contracts-v1.0.0 published · mandatory hook enforcement active.