Quality & Provenance

Six computable quality metrics with FHIR Observations and provenance-anchored transformation lineage.

6 Quality Metrics Provenance Chain 11 Extensions DRAFT

Quality Metrics

Each metric is represented as a FHIR R4 Observation resource using the hitc-quality-metric CodeSystem. Metrics are computed against target FHIR resources after transformation and measure different dimensions of data quality.

Field Fill Rate

FFR

Proportion of required and expected fields populated in the target FHIR resource.

Download Example Observation View in CodeSystem

Code System Conformance

CSC

Proportion of coded elements using required code systems.

Download Example Observation View in CodeSystem

Reference Integrity Rate

RIR

Proportion of internal and external FHIR references that resolve.

Download Example Observation View in CodeSystem

Temporal Consistency

TC

Temporal logic checks across dates, periods, and effective times.

Download Example Observation View in CodeSystem

Mapping Success Rate

MSR

Proportion of source fields successfully mapped to target FHIR elements.

Download Example Observation View in CodeSystem

Terminology Coverage Rate

TCR

Proportion of source terminology values successfully standardized.

Download Example Observation View in CodeSystem

Provenance Chain

Every transformed FHIR resource is linked to its source through a verifiable provenance chain. Each step is recorded as a Provenance resource that captures the transformation activity, agent, and a cryptographic digest rooted in a Merkle tree for tamper-evident lineage.

Source Document
HL7 v2 / C-CDA / FHIR
→
Transformation Activity
StructureMap execution
→
Generated FHIR Resource
Profiled output
→
Provenance Record
Provenance resource
→
Transformation Steps
Step-by-step log
→
Merkle Root
Cryptographic digest
View Provenance Profile View Example Provenance View Merkle Root Extension

Extensions

The framework defines 11 extensions that extend base FHIR resources with quality measurement, provenance tracking, and transformation metadata. These extensions are defined as StructureDefinition resources with the extension kind.

ID URL Description View
hitc-mapping-confidence https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-mapping-confidence Confidence score (0–1) assigned to a mapping result based on source data completeness and mapping rule certainty. View JSON
hitc-mapping-reviewer https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-mapping-reviewer Reference to the Practitioner or device that reviewed and approved a mapping transformation. View JSON
hitc-mapping-strategy https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-mapping-strategy Coded value indicating the mapping strategy used (e.g., direct, rule-based, ML-assisted). View JSON
hitc-merkle-root https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-merkle-root Merkle tree root hash that cryptographically anchors the transformation lineage for tamper-evident provenance. View JSON
hitc-original-code https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-original-code Preserves the original source code value before terminology standardization or code system mapping. View JSON
hitc-quality-denominator https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-quality-denominator Denominator count for a quality metric observation, representing the total number of elements evaluated. View JSON
hitc-quality-numerator https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-quality-numerator Numerator count for a quality metric observation, representing the number of elements that passed the check. View JSON
hitc-source-format https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-source-format Identifies the original source format of the data (e.g., HL7 v2, C-CDA, FHIR) before transformation. View JSON
hitc-source-system https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-source-system Identifies the source system or application that originated the data before transformation. View JSON
hitc-transformation-step https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-transformation-step Records an individual step within a multi-step transformation pipeline, including inputs, outputs, and parameters. View JSON
hitc-validation-stage https://hitc.nousresearch.com/fhir/StructureDefinition/hitc-validation-stage Indicates the validation stage at which a quality check or mapping assessment was performed (e.g., pre-transform, post-transform). View JSON