termbank.pdhc — Technical description

Bulk canonical terminology store for the PDHC platform. Substantive
content below; historical scaffolding note preserved for context.

Scaffold created 2026-04-24 per Phase 1.a. Phases 1–3 shipped; document
kept current thereafter per Rule 25.

Role in PDHC

Bulk canonical terminology store. Read-only over HTTP. Mutations via import CLI only.

Imports:
- Socialstyrelsen termbank (full XML release)
- LOINC (current release)
- ICD-10 / ICD-11
- ATC
- SNOMED CT International + SE subset

Owns the canonical URI namespace (https://termbank.pdhc.se/CodeSystem/<system>/<code>). plan.pdhc mirrors these URIs into its curated working set; rosetta.pdhc stores mappings that point to them. No other service mints canonical URIs.

Data model (target — see readme.md §1.b)

• Concept — primary row, keyed by canonical_uri.
• ConceptDesignation — localised displays.
• ConceptProperty — source-specific attributes.
• ImportRun — bookkeeping per import.
• AuditLog — Rule 24 log for imports.

APIs (target — see readme.md §3)

• GET /CodeSystem/:system/:code
• GET /Concept/:canonical_uri
• GET /search?q=&system=&limit=
• GET /fhir/metadata — CapabilityStatement
• GET /health

Ports

9010 reserved · 9011 Postgres · 9012 Flask · 9013 reserved.

Not-yet-implemented

See readme.md for the full plan. At 1.a close only the scaffold exists.