PLUGIN
0.7.0-public-consultation-1 - draft NL

PLUGIN - Local Development build (v0.7.0-public-consultation-1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## About

### Over deze Implementatiegids

Deze ImplementatieGids (IG) biedt een helpende hand bij deelname aan PLUGIN. De gids beschrijft daarvoor een Common Data Model (informatiestandaard) o.b.v. FHIR-Profielen.

### Interpretatie van Must Support (MS) flags

Binnen deze IG wordt gebruik gemaakt van de Must Support (MS) flag. Deze flags kunnen worden gedeinieerd voor attributen en worden in de profielen weergegeven met S.

Wanneer deze flag voor een attribuut gedefinieerd is, wordt verwacht dat dit attribuut …

1. Ondersteund wordt door de systemen die deze IG gebruiken
2. Bevolkt wordt indien de gegevens beschikbaar zijn.

Het tweede punt maakt het mogelijk/makkelijker om conclusies te verbinden aan de afwezigheid van gegevens. Neem bijvoorbeeld de resource Encounter. Hier heeft het attribuut period.end een Must Support flag. Als een resource wordt opgevraagd die nog loopt en geen (verwachte) einddatum heeft, mag `period.end` leeg blijven. Is er wél een (verwachte) einddatum, dan dient deze meegestuurd te worden.

### Versiebeheer & publicatie

De IG en bijbehorende packages worden gepubliceerd op https://plugin.healthcare/fhir. Hierbij verwijst https://plugin.healthcare/fhir naar de laatste (minor versie van de laatste) major release. Daaronder zijn de volgende subdirectories te vinden:

- `/ci-build`: Laatste build van de `main` branch.
- `/{major}`: Major versie `major`, de laatste release van `major.minor.patch`
- `/{major}.{minor}`: Versie `major.minor`; verwijst naar de laatste release van `major.minor.patch`
- `/{major}.{minor}.{patch}`: Versie `major.minor.patch`

Op de pagina https://plugin.healthcare/fhir/history.html is een overzicht te vinden van gepubliceerde versies.

De broncode van deze IG wordt gepubliceerd op GitHub. Ontwikkeling vindt plaats in de `main` branch. Na iedere push wordt de code (via GitHub Actions) geautomatiseerd gecompileerd en gepubliceerd op `/ci-build`.

Het gebruik van feature branches wordt aangemoedigd waar van toepassing. Wat een feature behelst, is ruim interpreteerbaar. Er kan, bijvoorbeeld, gedacht worden aan een branch waarin een use-case verder wordt uitgeschreven (e.g. `feature/use-case-nkr-item`) of aan een branch waarin specifiek aan medicatieprofielen wordt gewerkt (`feature/Medication`). Feature branches worden (nog) niet automatisch gepubliceerd na commit.

Voorafgaand aan een release van de IG/package, wordt een branch gemaakt met naam `release/{version}`. Bijvoorbeeld `release/1.1`. Hierin kan getest worden en worden eventuele (laatste) ontwikkelingen gedaan. Het kan, bijvoorbeeld, zijn dat eerst een (of meer) release candidate(s) wordt/worden uitgebracht (`1.1-alpha`, `1.1rc2`, …) voordat de definitieve versie van `1.1` wordt gepubliceerd. Tussen deze versies kunnen meerdere commits zitten.

Bij release/publicatie wordt een of meerdere tags gekoppeld aan de commit van de release: `version/{version}`. Bijvoorbeeld `version/1.1` of `version/2.3.1rc2`. Dit genereert automatisch een nieuwe build (via GitHub Actions) voor iedere tag. Deze builds worden eveneens automatisch geüpload. Hierbij wordt het versienummer van de tag de naam van de subdirectory met de versie. Met andere woorden: de tag `version/x.y.z` wordt geüpload naar `https://plugin.healthcare/fhir/x.y.z`. Er dient handmatig voor gezorgd worden dat een versie-tag op een hoger niveau wordt verplaatst. Bijvoorbeeld, als `version/1.2.3` wordt uitgebracht, moeten de tags `version/1` en `version/1.2` worden verplaatst.

Als laatste stap bij publicatie wordt de IG aangemeld/geüpdated bij de IG Registry via een pull request naar Github IG-Registry.

### Totstandkoming

Deze Implementatiegids is tot stand gekomen én wordt actief ontwikkeld dankzij participatie van meerdere organisaties. In alfabetische volgorde zijn dat: DHD, Health-RI, HL7 Nederland, IKNL, Expertisecentrum Zorgalgoritmen, openEHR Nederland, Pacmed, Radboudumc, Santeon, Stichting NICE, en UMCG.