bd-fhir-national/README.md

BD FHIR National Repository & Validation Engine

This is the central interoperability gateway for the Directorate General of Health Services (DGHS), Bangladesh. It provides a high-performance FHIR R4 repository with mandatory validation against national clinical standards.

---

🚀 Quick Start

1. Configure Environment: cp .env.example .env (See Project Manifest for variable descriptions).
2. Initialize Database: Run postgres/fhir/init.sh and postgres/audit/init.sh on the host.
3. Deploy: docker compose up -d

---

📚 Operational Documentation

All technical and procedural guides are located in the ops/ directory. Refer to these before making changes to the production environment:

Guide	Description
Project Manifest	Full file inventory, architectural decisions, and pre-flight checklist.
Deployment Guide	Step-by-step setup for Ubuntu 22.04+ and nine mandatory acceptance tests.
Keycloak Setup	Instructions for realm roles, client mappers, and JWT authentication.
Adding Additional IGs	How to load specialized IGs (MCCoD, IMCI) without breaking the core.
Version Upgrade	Procedure for ICD-11 version updates and terminology cache flushing.
Scaling Roadmap	Thresholds for resource allocation and database partitioning.
Technical Ops	Runbooks for backup, recovery, and daily maintenance.

---

🛠 Tech Stack

• Engine: HAPI FHIR 7.2.0 (R4) on Spring Boot 3.2
• Database: PostgreSQL 15 + pgBouncer (Session Mode)
• Auth: Keycloak (HRIS Realm)
• CI/CD: Gitea Actions

---