Open by default
Every public artifact, decision, and review note is published under CC-BY-4.0. External reuse is welcomed with attribution and governance context.
Governance
Recognition through work, not the other way around.
VN Core FHIR is not yet an HL7 Affiliate. We are building the substantive groundwork — credible IG, review-eligible pilots, working group structure, and conformance evidence — before any Affiliate filing with HL7 International. This is transparent by design.
Operating principles
Legal traceability
Every CodeSystem, extension, and constraint must point back to a Vietnamese regulation (TT/QĐ/NĐ/Luật) or an explicit clinical need.
Additive, not replacement
VN Core does not aim to replace existing local standards (XML 4210, ePrescription). It bridges them to FHIR R4 so systems can interoperate.
Fast on legal change
Vietnamese health regulations change quickly (NQ 202/2025/QH15, TT 13/2025/TT-BYT, Luật 91/2025/QH15). The release cadence tracks legal changes within one release cycle.
Roles
| Role | Who | Scope |
|---|---|---|
| Maintainer | Omi HealthTech | Editorial, release engineering, IG build, contribution intake, publishing infrastructure. |
| Technical steering | Pending — open call | Profile design decisions, breaking change votes, IG architecture. |
| Legal advisor | Pending — open call | Reviews each release for legal accuracy before publication. |
| Contributors | Open | Evidence-backed proposals, terminology curation, example data, implementation reports. |
How to contribute
- 1
Read the IG
Get familiar with VN Core profiles and CodeSystems at fhir.hl7.org.vn.
- 2
Find a gap
A missing extension, a stale legal reference, a missing example, a profile mismatch with hospital workflow.
- 3
Send a structured proposal
Until public workflow is approved, email the maintainer with scope, affected artifact, and evidence.
- 4
Review and release
The maintainer triages the proposal, records the evidence, validates the change, and schedules it for release when accepted.
Versions, releases & package layering
VN Core is at v0.8.0, released as 6 modular packages (core.base, bhyt.submission, terminology.clinical, terminology.traditional-medicine, device, and the aggregate core package). Versioning follows SemVer in the 0.x phase, with three classes of change:
Patch (0.6.x)
Narrative, example, typo and metric-sync fixes. No change to artifact meaning, no migration required.
Additive (0.x.0)
Adds a new profile/extension/ValueSet/CodeSystem or relaxes a constraint. Backward-compatible with the previous release.
Breaking (0.X.0 → 1.0.0)
Tightens cardinality, changes binding strength, or renames/removes a canonical. A migration note is mandatory; a retired code is never reused for a different meaning.
Technical governance documents (IG)
Path to HL7 Affiliate
Active 2026
Trial-use draft
VN Core is being built openly as a trial-use contribution by Omi HealthTech. Not yet recognised as an HL7 Affiliate.
Planned 2026 – 2027
Working group formalisation
Prepare disclosed or review-eligible pilots, a technical steering structure, conformance testing infrastructure, and the evidence needed before any Affiliate filing.
Future 2027+
Affiliate preparation
Prepare an HL7 Vietnam Affiliate filing with HL7 International if governance conditions and stakeholder alignment are met.
"HL7®" and "FHIR®" are trademarks of Health Level Seven International. VN Core FHIR is a trial-use open contribution by Omi HealthTech and has not been authorised by HL7 International as the official Vietnam Affiliate. Contact info@hl7.org.vn for governance questions.