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 MongoDB
• Conversion 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
• Error Handling — Error strategies for upstream failures, partial syncs, client errors, and monitoring