RIVO-Noord Zorgviewer Implementation Guide
1.25.0 - master Netherlands flag

RIVO-Noord Zorgviewer Implementation Guide, published by RIVO-NN HL7NL. This guide is not an authorized publication; it is the continuous build for version 1.25.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/RIVO-Noord/zorgviewer-ig/ and changes regularly. See the Directory of published versions

IG Change History

Samenvatting Changes

🚀 Nieuw

  • Functionele Ontwerpen (FO's):
    • Behandelaanwijzingen-&-Wilsverklaringen.md: Nieuw FO waarin behandelaanwijzingen en wilsverklaringen zijn samengevoegd op één gecombineerd scherm.
    • Intoxicaties.md: Nieuw FO opgesteld ter vervanging van Middelengebruik; combineert ZIB's Alcohol-, Drugs- en Tabakgebruik met NHG-metingen uit huisartsgegevens.
    • Medicatiegegevens.md: Nieuw FO voor het gecombineerde overzicht van voorschriften, gebruik en toedieningen, inclusief LSP-medgeg integratie en een 12-maanden ophaalbeperking.
  • Testdata & FHIR Voorbeelden:
    • input/examples/: Nieuwe Nedap voorbeeld-resources toegevoegd voor AllergyIntolerance, Flag, LivingSituation en Patient.

🛠️ Gewijzigd

  • Functionele Ontwerpen (FO's):
    • Contacten-en-Afspraken.md: Datum- en tijdweergave samengevoegd (Start en Eind gecombineerd), screenshots bijgewerkt en testcase-terminologie aangepast naar 'entries'.
    • Gezondheidstoestand.md: Geïntegreerd met voeding en vocht naast mobiliteit, ontwerpbeslissingen toegevoegd en tijdlijnkaart voorlopig verwijderd.
    • Medische-hulpmiddelen.md: Herwerkt naar het nieuwste FO-template; sorteerregels voor vage datums en kaartontwerp voor de tijdlijn toegevoegd.
    • Patiëntcontext.md: Toelichtingen aangescherpt en nieuw basisschermvoorbeeld toegevoegd.
    • Vitale-gegevens.md: Work items bijgewerkt, ademhalingstestcase toegevoegd en testcasestabel vervangen door een directe link naar de IG.
  • FHIR Profiles & ViewDefinitions:
    • ViewDefinition-Appointment.json: Kolommen 'Begin' en 'Eind' samengevoegd tot één kolom 'Datum' (Period).
    • ViewDefinition-Condition.json & ViewDefinition-Probleemlijst.json: Filterversoepeling door verwijdering van de code.coding.display.exists() eis, zodat ook condities zonder display-tekst worden meegenomen.
    • ViewDefinition-Mobiliteit.json: Mappings en SNOMED-codes geactualiseerd voor Traplopen, Houding veranderen, Houding handhaven en Transfers.
    • StructureDefinition-EncounterReport.json: Status gewijzigd van draft naar active.
  • Scripts & Generatie:
    • script/updateviewmd.js: Ondersteuning toegevoegd voor Period-datatypes en formattering/sortering op basis van CET-tijdzone.
    • script/changelog.js: Logica bijgewerkt om ook diffs uit een tijdelijk FO-logbestand mee te nemen.

🧹 Onderhoud

  • Herstructurering FO-documentatie:
    • Oude/vervallen FO's (Behandelaanwijzing.md, Wilsverklaringen.md, Voeding-en-vocht.md, Medicatie.md) verplaatst naar respectievelijke Notities/ submappen.
    • Het oude bestand Middelengebruik.md verwijderd ten gunste van Intoxicaties.md.
    • Losse achtergrondbestanden (*-Background.md) hernoemd naar Notities.md over diverse FO-mappen (Contacten-en-Afspraken, PZP-ACP, Vaccinaties, Verrichtingen, Patiëntcontext, Vitale-gegevens).
    • Lege of overbodige .order- en achtergrondbestanden opgeruimd (Alerts-of-waarschuwingen, Correspondentie, Problemen).
  • Templates & Tooling:
    • Template-Functioneel-Ontwerp.md: Hernoemd (sterretje verwijderd) en uitgebreid met de sectie 'Ontwerpbeslissingen'.
    • skills/fo-generator/references/template.md: Referentietemplate synchroon gebracht met de nieuwe sectie 'Ontwerpbeslissingen'.
    • README.md: Handmatige stappen voor de Gemini FO-changelog verwijderd.
    • Automatisch hergegenereerde Markdown-bestanden (input/includes/ViewDefinition-*.md) bijgewerkt op basis van de nieuwste voorbeelddata.

Versies

Versie Datum Changes
1.25.0 current Detail wijzigingen
1.24.0 27-mei-2026 Detail wijzigingen
1.23.0 30-mar-2026 Detail wijzigingen
1.22.0 12-jan-2026 Detail wijzigingen
1.21.0-sprint70 28-okt-2025 Detail wijzigingen
1.20.0-sprint68 30-sep-2025 Detail wijzigingen
1.19.0-sprint67 15-sep-2025 Detail wijzigingen
* Probleemlijst, Vitale gegevens en Labuitslagen updates door toevoegen huisartsgegevens (n.b. FHIR R4)
* Wireframes uit ViewDefinitions en (Bundled) Examples en $lookup en $translate van codes
* Verschillende kleine verbeteringen en aanvullingen
1.18.0-sprint65 18-aug-2025 Detail wijzigingen
* Sanday (van alles) en Chipsoft (vitale gegevens) voorbeelden toegevoegd
* Mockup generatie script kan nu omgaan met Bundled voorbeelden
* Kleinere optimalisaties en Nexus foutje
1.17.0-sprint64 2-aug-2025 Detail wijzigingen
* Medicatie toegevoegd ivm medicatie vorm
* Vitale gegevens aanzet
1.16.0-sprint61 20-jun-2025 Detail wijzigingen
* Mainly minor corrections and Sanday comparison start
sprint59,60   No changes
1.15.0-sprint58 12-mei-2025 Detail wijzigingen
* Focus op Medicatie
* Start Afspraken en Contacten
1.14.0-sprint56 15-apr-2025 Detail wijzigingen
Focus op Medicatie en QA fixes
1.13.0-sprint55 1-apr-2025 Detail wijzigingen
1.12.0-sprint54 18-mrt-2025 Detail wijzigingen
1.11.0-sprint49 28-jan-2025 Detail wijzigingen
* Non Functional Requirements toegevoegd
* Enabled version compare
* Prepare for IG go-publish infrastructuur op fhir.hl7.nl
1.10.0-sprint48 27-dec-2024 Detail wijzigingen
* Canonical url aangepast voor werkende history page
1.9.1-sprint47 10-dec-2024 Detail wijzigingen
* Vaccinatie toegevoegd
* Spoedopname behandelaanwijzing toegevoegd
* Medicatie update
* DocumentReference status=current parameter toegevoegd
1.8.0-sprint46 25-nov-2024 Detail wijzigingen
* MedicatieGebruik en MedicatieAfspraak toegevoegd
* Design pagina's gesplitst
1.7.0-sprint45 12-nov-2024 Detail wijzigingen
1.6.0-sprint43 17-okt-2024 Detail wijzigingen
1.5.0-sprint40,41,42 30-sep-2024 Detail wijzigingen
1.4.0-sprint39 23-aug-2024 Detail wijzigingen
1.3.0-sprint38 6-aug-2024 Detail wijzigingen
1.2.0-sprint37 26-jul-2024 Detail wijzigingen
sprint36   Overgeslagen
1.1.0-sprint35 21-jun-2024 Detail wijzigingen
1.0.0-sprint33,0.26.0-sprint33 29-mei-2024 Detail wijzigingen
0.25.0-sprint32 13-mei-2024 Detail wijzigingen
sprint31   Overgeslagen
0.24.0-sprint30/MVP2 17-apr-2024 Detail wijzigingen
sprint29   Overgeslagen
0.23.0-sprint28 18-mrt-2024 Detail wijzigingen
0.22.0-sprint27 4-mrt-2024 Detail wijzigingen
0.21.0-sprint26 20-feb-2024 Detail wijzigingen
0.20.0-sprint25 5-feb-2024 Detail wijzigingen
0.19.0-sprint24 22-jan-2024 Detail wijzigingen
* Design rondom AuditLogging attributes
sprint23   Overgeslagen
0.18.0-sprint22 11-dec-2023 Detail wijzigingen
0.18.0-sprint21 17-nov-2023 Verwerkt in sprint 22
0.17.0-sprint20 13-nov-2023 Detail wijzigingen
* RIVO kleur toegepast
* Topicus behandelaanwijzing wijzigingen
sprint19   Overgeslagen
0.16.0-sprint18 18-okt-2023 Detail wijzigingen
* Epic Checklist update
* Topicus feedback
* new: Zorgviewer Services
0.15.0-sprint17 3-okt-2023 Detail wijzigingen
* Lab updates
* Patient.deceased added
0.14.0-sprint16 19-sep-2023 Detail wijzigingen
* Voornamelijk updates en fixes
0.13.0-sprint15 4-sep-2023 Detail wijzigingen
* Logging AuditEvent uitwerking
sprint14   Overgeslagen
0.12.0-sprint13 9-aug-2023 Detail wijzigingen
* UI Guidances detail updates/fixes
* Epic checklist uitgewerkt
0.11.0-sprint12 27-jul-2023 Detail wijzigingen
* Nog een lab voorbeeld toegevoegd
* UI Guidances gelijkgetrokken
* Structuur artifact pagina's gelijkgetrokken
0.10.1-sprint11 18-jul-2023 Detail wijzigingen
* Behandelaanwijzing mapping ivm VIPLive aansluiting
* Review en QA fixes
0.10.0-sprint11 12-jul-2023 Detail wijzigingen
* Kleine detail updates en QA
* AuditEvent draft
* UI guidance updates
0.9.0-sprint10 27-jun-2023 Detail wijzigingen
* Labuitslagen tweede draft
* Toestemming mappings van HL7 v2 CON
0.8.0-sprint9 14-jun-2023 Detail wijzigingen
* Alle UI Guidance updates
* Labuitslagen eerste draft
* Toestemming updates
* Technische QA fixes
0.7.0-sprint8 30-mei-2023 Detail wijzigingen
* Algemene UI Design aanpassingen kolom volgorde
* Leeswijzer update
* FHIR requests bijgesteld, DataTime vs Period
* Terminologie resources toegevoegd
* Kleine documentatie issues, plaatjes, missende links en wat vertalingen
0.6.0-sprint7 15-mei-2023 Detail wijzigingen
* Verrichtingen, Behandelaanwijzing - UI en voorbeeld updates
* Achtergrond Dokter Dokter - update
0.5.0-sprint6 2-mei-2023 Detail wijzigingen
* Verrichtingen UI Guidance en Profiel - new
* Patient naam algorithme
* Ontsluiten bronsysteem - update
* Behandelaanwijzing en Wilsverklaring UI Guidance en Profielen - concept
0.4.0-sprint5 17-apr-2023 Detail wijzigingen
* Design Background - new
* Probleem en Correspondentie UI Guidance - new
* Toestemming CapabilityStatement, Toestemming Consent, Endpoint - new
* Security Design update sequence diagram
* Dataset Toestemmingen - updates
0.3.0-sprint4 3-apr-2023 Detail wijzigingen
* Behandelaanwijzing (Consent) obv ACP - draft
* Sequence diagrammen bijgewerkt
* Bron zorgaanbieder meta tag
* Correspondentie - draft
0.2.0-sprint3 24-mar-2023 Detail wijzigingen
* Opstarten Zorgviewer - afgestemd
* Correspondentie onderdelen, o.a. DocumentReference - draft
* Security Design - draft
0.1.0-sprint1 tot 17-feb-2023 Wijzigingen sprint 1 en 2
* Initiele vulling
* Opstarten Zorgviewer draft
* Requirements review door productowner

Versienummering

Semantic Versioning

Vorm: (major).(minor).(rev)-(tag)

Voorbeelden:

  • 0.x.x-CIbuild - De "nightly" build
  • 0.1.0-sprint1 - De versie (sprint snapshot) ten behoeve van sprint #1
  • 0.2.0-sprint2 - De versie (sprint snapshot) ten behoeve van sprint #2
  • 0.2.20-sprint2 - sprint #2 met verdere verduidelijking of foutjes adhv vragen
  • 1.0.x-mvp2 - De eerste productie versie 1.0

Review Workflow

  • Ronde 1. Als de schrijvers van de IG een gedeelte klaar hebben dan volgt er eerst een interne review.
  • Ronde 2. Daarna wordt het gedeelte aangeboden aan het bouwteam voor review.
  • Ronde 3. Vervolgens kan de product owner een review uitvoeren.
  • Ronde 4. Als daarmee de interne zorgviewer review is geweest kan het gedeelte nog worden aangeboden ter review aan de RIVO-Noord architecten.

Weergave van alle reviews die tot nu toe zijn uitgevoerd:

Versie Onderdeel te reviewen Ronde 1 (IG) Ronde 2 (Bouw) Ronde 3 (PO) Ronde 4 (Extern)
0.1.0-sprint1 Requirements en uitgangspunten alle paragrafen Gereed Niet gevraagd Gereed Niet gevraagd
           
Conceptwerken in master branchCI Build(1) WG reviewwerkgroepen IG en Bouw reviewlaatste tag(2) PO reviewproduct owner reviewlaatste tag(3) Publicatiebreed review o.a. RIVO Architectensnapshot releasenew minor0.m.0tag release[comments]new revision0.m.r+1[no comments][comments]new revision0.m.r+1[no comments]snapshot release0.m.rvolgende iteratie0.m+1.0[comments]op laatste revision