Governance en publicatie van de Belgische FHIR-IG's

Een implementatiegids (IG) legt vast hoe Belgische software de internationale standaard HL7 FHIR gebruikt; de verzameling Belgische gidsen staat op Belgische FHIR-implementatiegidsen. Deze pagina beschrijft hoe zo'n gids tot stand komt en wie ze publiceert. Werkgroepen van HL7 Belgium werken het datamodel en de profielen uit^[1], en een validatieteam van HL7 Belgium valideert de artefacten^[1]. Program Board B beslist vervolgens of een project uitmondt in een federale standaard die op de website van het eHealth-platform wordt gepubliceerd^[2]. Op dat ogenblik is de eHealth-implementatiegids een kopie van de HL7 Belgium-implementatiegids, waarvan het maturiteitsniveau volgens de regels stijgt^[2].

De stappen staan in het governancedocument FHIR Belgium Governance process (v2). Daarin is het FHIR Validation Team een formeel overleg met een voorzitter en een agenda^[2], dat een kwaliteitsreview van het projectvoorstel uitvoert om dat voorstel te valideren^[2]. Een ballotstap zoals bij internationale HL7-standaarden werd in dat document niet gevonden.

Stappen van ontwerp tot publicatie

Volgens de procesdocumentatie van HL7 Belgium is publicatie de laatste stap, nadat de CI-build in orde is, en volgt ze het HL7-proces 'Maintaining a FHIR IG Publication' (release-candidate, IG-historie, IG-register)^[3]. Een CI-build (continuous integration build) is een automatische bouw uit de broncode: de doorlopende build van BE Core op build.fhir.org is geen geautoriseerde publicatie en volgt de actuele inhoud van de GitHub-repository hl7-be/core^[4]. Het IG-portaal koppelt elke IG aan een git-repository in de GitHub-organisatie hl7-be^[5]. Belgische conformance-artefacten krijgen het prefix 'be-' en worden genoemd naar hun betekenis, niet naar het onderliggende FHIR-resourcetype^[6]. Voor feedback op BE Core verwijst het eHealth-platform naar een supportadres op be-ehealth-standards.atlassian.net^[7].

Federale en communitystandaarden

Er zijn twee publicatieniveaus: HL7-communitystandaard via HL7 Belgium en federale standaard via het eHealth-platform^[1]. De Way of Working van HL7 Belgium werkt dat uit in profielniveaus. Federale ('legal', de jure) profielen zoals BePatient en BePractitioner worden onderhouden en gepubliceerd door het eHealth-platform, volgens een proces van het eHealth-platform^[8]. Communityspecificaties (de facto) worden door HL7 Belgium onderhouden en gepubliceerd en bouwen waar mogelijk voort op de eHealth-specificaties, anders op de basis-FHIR-standaard^[8]. Projecten en leveranciers bouwen hun eigen profielen bovenop die Belgische specificaties^[8]. HL7 Belgium publiceert profielen bij voorkeur als FHIR-implementatiegids, met de resources ook op Simplifier.net^[8]. De Way of Working-IG zelf is uitdrukkelijk niet stabiel en voortdurend in ontwikkeling^[9].

Het IG-portaal gebruikt een kleurcode per type IG^[10]: 'Build' voor IG's in ontwikkeling^[10] en 'Federal' voor IG's die het eHealth-platform publiceert en als federale artefacten gevalideerd zijn^[10]. Er bestaat ook een categorie 'IG's Published by HL7Be'^[10].

Voorgeschiedenis. In 2021 stond op hl7belgium.org een door HL7 Belgium gepubliceerde versie 0.2.0 van de Medication-IG met het label 'Trial Use Ballot 1', de enige gevonden HL7 Belgium-publicatie buiten de CI-builds met een ballotlabel^[11]; ze was uitdrukkelijk een ontwikkelversie, nog niet gevalideerd door HL7 of door gebruikers en implementatoren^[11]. De oude HL7 Belgium Base IG op hl7-be.github.io noemt zichzelf niet juridisch bindend en verwijst voor de bindende specificaties naar de publicaties van het eHealth-platform^[12]. Sommige gidsen dragen die communityoorsprong nog: BE Medication is ontwikkeld door de HL7 Belgium-community^[13], en de vaccinatie-IG omschrijft zichzelf als specificaties ontwikkeld door 'onze community'^[14].

Registratie in de internationale registers

In het internationale FHIR IG-register dragen de Belgische registraties het eHealth-platform als autoriteit^[15]; BE Medication staat er als 'HL7 Belgium FHIR Implementation Guide' met categorie 'National Base'^[15]. Het Initiatives Registry van HL7 International (stand oktober 2023) noemt daarentegen HL7 Belgium als beherende organisatie van de Lab-IG en van Referral Prescription^[16][17].

Pakketindeling

Hoe profielen over aparte pakketten verdeeld worden (core, algemeen, use-case-specifiek), legt een HL7 Belgium-document van december 2024 vast^[18]. Volgens die voorgestelde regels is de HL7 Belgium FHIR Validation Group verantwoordelijk voor het aanmaken van IG's en technische pakketten^[18], en is voor elke IG precies één HL7 Belgium-werkgroep verantwoordelijk, al kan één werkgroep meerdere pakketten onder zich hebben^[18]. Zie HL7 Belgium-regels voor aparte FHIR-pakketten.

CareSets

Een CareSet van BeSafeShare wordt als Belgisch FHIR-profiel gepubliceerd in de IG voor softwareleveranciers^[19]; de CareSets op de eHealth-website werden gevalideerd via een nota aan het Beheerscomité volgens de FHIR Governance^[20]. Zie BIHR: CareSets en EHDS-roadmap.

Het traject is in gebruik: het validatieteam van HL7 Belgium komt momenteel tweewekelijks samen^[1], en de gepubliceerde Belgische gidsen staan alle met het eHealth-platform als autoriteit in het internationale IG-register^[15]. Ook de eerstvolgende kandidaat, Glucose Monitoring, wordt met het eHealth-platform als registerautoriteit voorbereid, en dus als federale en niet als communitygids^[21]; zie Versies en status van de Belgische FHIR-IG's voor de stand per gids. Een community-IG van HL7 Belgium na 2021 werd niet aangetoond.

• Federaal is geen plicht. Publicatie als federale standaard houdt niet automatisch een wettelijke verplichting in om ze meteen te implementeren^[1], maar het portaal vraagt implementatoren wel de gereleasete pakketten te gebruiken voor de recentste stabiele resources^[22].
• Een CI-build is geen publicatie. De doorlopende builds op build.fhir.org zijn geen geautoriseerde publicatie^[4]; ontwerpartefacten uit de werkgroepfase staan voorlopig op Simplifier of GitHub^[1].
• Eigen profielen bouwen voort op de Belgische. Projecten en leveranciers baseren hun profielen op de bestaande federale of communityspecificaties^[8].
• Aanbeveling: baseer een productiekoppeling op een federale release van het portaal en niet op een CI-build of een werkgroepontwerp; meld onduidelijkheden via het supportadres van de gids.

• Uitgever of beheerder? Het FHIR IG-register noemt het eHealth-platform als autoriteit^[15], terwijl het Initiatives Registry van HL7 International (oktober 2023) HL7 Belgium als beheerder van de Lab-IG en Referral Prescription noemt^[16][17]. De portaallegenda kent de categorie 'IG's Published by HL7Be'^[10] en de governance voorziet communitypublicatie^[1], maar een community-IG na 2021 werd niet aangetoond.
• Ontwerpstatus van de regels: de Way of Working-IG is niet stabiel^[9] en de pakketregels zijn een voorstel^[18]; of het governancedocument (v2) nog de geldende procesbeschrijving is, werd niet nagegaan.