Knowledge Artifact Management

Domain that contains knowledge artifacts that support the function of Link including FHIR IGs, Profiles, dQMs, and Terminology.

Domain

Overview

The Knowledge Artifact Management domain represents the organizational and governance processes that support and surround the technical domains within the Link ecosystem.

This domain includes key artifacts such as:

  • FHIR Implementation Guides (IGs), including FHIR Profiles
  • Digital Quality Measures (dQMs)
  • Terminology Resources (CodeSystems, ValueSets, etc.)

These assets serve as foundational specifications that guide behavior, structure, and expectations across domains like Reporting, Data Ingestion, and Evaluation.

Rather than owning executable services, this domain captures the processes, standards alignment, and content lifecycle required to ensure consistency and reusability across the system.

Requirements

Roles:

  • Knowledge Artifact Administrator
  • System Administrator
  • Developer
  • Quality Assurance Tester

Stakeholder Requirements

RequirementCategory
As a knowledge artifact administrator (specialization of systems admin), I can manage persistence, access, relationship and other characteristics of knowledge artifacts so that dependent functionality operates appropriately.Process
As a knowledge artifact administrator, I can see what dependencies are missing for a loaded IG, so that I may find and load them and not have evaluation and/or validation fail at runtime.Process
As a system administrator, I want to load FHIR Implementation Guides (IGs) that include Measures, Profiles, and Terminology artifacts, so that the platform can support standards-based evaluation and validation.Process
As a quality assurance tester, I want to manage multiple versions of the same IG, to support testing changes to implementation guides without impacting other tenants and users.Version Management
As a system administrator, I want to manage multiple versions of the same IG, to support incremental release of implementation guide updates across all tenants.Version Management

System Requirements

RequirementCategory
As the system, I want to register FHIR IG artifacts in a shared repository, so that multiple dependent services can access them.Process
As the system, I want to retrieve version-specific Measure artifacts from the knowledge artifact repository, so that reporting requirements can be confirmed.Version Management
As the system, I want to access profile definitions from the loaded IGs, so that I can validate resource instances accurately.Process
As the system, I want to load and reference ValueSet and CodeSystem definitions from IGs, so that I can confirm inform other services on the terminology needed to accurately evaluate and validate.Process
As the system, I want to store IG version metadata and associate it with report evaluation records, so that report reconstruction uses the correct logic.Report Reproducibility
As the system, I want to ensure IG updates do not overwrite previously loaded versions, so that all versions remain available for historical processing.Version Management