42 lines
2.9 KiB
Markdown
42 lines
2.9 KiB
Markdown
# 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](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/project-manifest.md)** | Full file inventory, architectural decision record, and pre-flight deployment checklist. |
|
|
| **[Technical Operations](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/technical-operations-document.md)** | Complete system overview, traffic flow, request lifecycle, infrastructure components, security model, and operational runbooks for any DevOps engineer taking over the deployment. |
|
|
| **[Deployment Guide](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/deployment-guide.md)** | Step-by-step first deployment on Ubuntu 22.04, including the critical init script fix, nine mandatory acceptance tests, and subsequent image upgrade procedure. |
|
|
| **[Keycloak Setup](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/keycloak-setup.md)** | Creating the `fhir-admin` role, `fhir-admin-pipeline` client, vendor client template, `sending_facility` token mapper configuration, and token verification tests. |
|
|
| **[Adding Additional IGs](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/adding-additional-igs.md)** | How to load specialised IGs (MCCoD, IMCI) alongside BD Core IG — code changes, package loading, resource type registration, Gitea workflow updates, and upgrade checklist. |
|
|
| **[Version Upgrade Integration](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/version-upgrade-integration.md)** | Seven-step ICD-11 version upgrade procedure, Python integration code for `version_upgrade.py`, cache flush and post-flush verification, and rollback procedure. |
|
|
| **[Scaling Roadmap](https://git.dghs.gov.bd/riaz.somc/bd-fhir-national/src/branch/main/ops/scaling-roadmap.md)** | Phase 1→2→3 capacity thresholds, replica scaling steps, monthly audit partition maintenance cron, PostgreSQL monitoring queries, and IG upgrade procedure. |
|
|
|
|
---
|
|
|
|
## 🛠 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
|
|
|
|
---
|