GeraldOS — Radiology imaging operations platform with Botswana localization, DICOM/PACS integration, and AI-assisted workflow
# GeraldOS — AI-Native Diagnostic Imaging Operations Platform
Internal operations orchestration platform for Gerald Holdings Medical Diagnostic Imaging.
GeraldOS sits **above** the imaging stack: it orchestrates patients, schedules, workflow,
equipment, inventory, reporting and AI agents, while delegating DICOM storage to Orthanc,
image display to OHIF/Weasis, identity to Keycloak, automation to n8n and agent reasoning
to LangGraph.
## Architecture
```
┌──────────────────────────────────────────── GeraldOS (Next.js) ─┐
│ Dashboard · Reception · Scheduling · Workflow · Imaging │
│ Equipment · Inventory · Reporting · AI Agents · Settings │
├───────────────┬────────────────┬─────────────────┬───────────────┤
│ Keycloak │ Orthanc │ HAPI FHIR │ n8n │
│ OIDC + JWT │ DICOM/DICOMweb │ Patient/Imaging │ automation │
│ HMAC session │ REST proxy │ proxy API │ webhooks │
├───────────────┼────────────────┼─────────────────┼───────────────┤
│ LangGraph │ OHIF / Weasis │ Dicoogle │ MinIO · Redis │
│ agent runtime │ viewers │ search proxy │ storage/queue │
└───────────────┴────────────────┴─────────────────┴───────────────┘
```
## Module map
| Module | Route | API |
|---|---|---|
| Operations Command Centre | `/` | `/api/command-centre`, `/api/events`, `/api/analytics` |
| Reception | `/reception` | `/api/patients`, `/api/appointments` |
| Scheduling | `/scheduling` | `/api/appointments`, `/api/equipment`, `/api/staff` |
| Clinical Workflow | `/workflow` | `/api/workflow`, `/api/workflow/:id` |
| Imaging Workspace | `/imaging` | `/api/orthanc/*`, `/api/annotations`, `/api/bookmarks`, `/api/ai-review` |
| AI Review | `/review` | `/api/ai-review`, `/api/ai-review/:id` |
| Reporting Assistant | `/reporting` | `/api/reports`, `/api/reports/:id`, `/api/reports/assist`, `/api/reports/:id/versions`, `/api/reports/templates` |
| Knowledge Platform | `/knowledge` | `/api/knowledge`, `/api/knowledg …