System Documentation

Internal documentation for developers working on the Nompd system.

Contents

• Architecture — High-level system overview, component diagram, and key design decisions
• Sync Pipeline — How upstream FHIR data is fetched, converted, versioned, and stored in Postgres
• Data model mapping — Field-by-field mapping from FHIR resources to output models:
  • TreatmentGroup
  • ReimbursementGroup
• Configuration — All configuration keys, environment variables, and secrets handling
• Deployment — Local Docker Compose setup, Kubernetes deployment, and Dockerfile details
• Database Backup and Restore — The db-backup Helm chart: scheduled pg_dumpall dumps, Trident snapshot retention, and the step-by-step restore process
• Error Handling — Error strategies for upstream failures, partial syncs, client errors, and monitoring
• HelseID Security Profile — Compliance — How the API satisfies the HelseID security profile (DPoP, token validation, crypto, secrets), mapped to the implementation. Basis for the integration code review.
• OpenBao Setup — AppMarket installs (k8sApiBridge, CSI driver, provider), Kubernetes auth, and Helm integration to sync OpenBao KV entries into K8s Secrets