Voegt de discovery- en besluitvormingsronde van 18-19 juli toe (besluitenlog, begrippenlijst, feitenmodel-instroom met scenariotoetsen, terminologie- en leveranciersonderzoek) en synchroniseert feitenmodel-instroom.md met de screening=acceptatie-beslissing (§5). Herstructureert docs/datamodel/ naar submappen per documentsoort (besluiten/sessielogs/feitenmodellen/deelmodellen/ onderzoek/entiteitenkaarten) zodat toekomstige besluitenlogs en feitenrondes per deelgebied een vaste plek krijgen.
26 KiB
Datamodelvoorstel — deelgebied Diagnose
Status: voorstel ter review (bouwt voort op datamodel-discovery.md §5.4)
Datum: 18 juli 2026
Modelleur: Claude (deelgebied-agent "diagnose")
Kader: genomen besluiten uit de discovery zijn niet teruggedraaid. Uitgangspunten: DSM-5-TR primair met ICD-10-mapping als entiteit (besluit §5.4 #1), diagnose aan de ZORGEPISODE met intake als optionele herkomst (besluit §5.4 #2), spelregels §3.1 (waardelijsten als data, provenance, soft delete, statusmachines expliciet, regels in het model).
1. Feitzinnen (nieuw en gewijzigd t.o.v. discovery §5.4)
Gewijzigd betekent: de startlijst-feitzin is herschreven naar DSM-bronregistratie en de twee status-assen. Nieuw betekent: het feit ontbrak in de discovery.
- (gewijzigd, was §5.4 #1) Voor de zorgepisode van Jan de Vries is op 24 juli 2026 een diagnose geregistreerd met DSM-5-TR-classificatie "depressieve stoornis, eenmalige episode, matig" door psycholoog M. de Boer.
- (gewijzigd, was deel van §5.4 #1) De diagnose is gesteld tijdens de intake van 22 juli 2026. (herkomst, optioneel — een diagnose kan ook tijdens de behandeling worden geregistreerd)
- (nieuw) Uit de DSM-classificatie van de diagnose is via mappinglijstversie "WHO-FIC 2026-01" de ICD-10-code F32.1 afgeleid.
- (ongewijzigd, §5.4 #3) De diagnose heeft ernst "matig".
- (gewijzigd, was §5.4 #4) De diagnose heeft verificatiestatus "werkdiagnose".
- (gewijzigd, was §5.4 #4) De diagnose is op 30 juli 2026 definitief vastgesteld door regiebehandelaar S. el Amrani.
- (gewijzigd, was §5.4 #5/#6) De diagnose heeft klinische status "actief". / De diagnose is op 1 december 2026 in remissie verklaard door M. de Boer.
- (gewijzigd, was §5.4 #2) De diagnose "depressieve stoornis, eenmalige episode, matig" is sinds 30 juli 2026 de hoofddiagnose van de zorgepisode van Jan de Vries. (hoofddiagnose-zijn is een feit met een geldigheidsperiode, geen vaste eigenschap van het diagnoserecord)
- (nieuw) Per 15 oktober 2026 is de diagnose "bipolaire-I-stoornis" de hoofddiagnose van de zorgepisode; de eerdere hoofddiagnose-aanwijzing is per die datum beëindigd.
- (nieuw, comorbiditeit) Voor de zorgepisode van Jan de Vries is daarnaast de diagnose "gegeneraliseerde-angststoornis" geregistreerd; deze is geen hoofddiagnose (nevendiagnose).
- (nieuw) De diagnose X is op 2 september 2026 vervallen verklaard met reden "foutregistratie" en vervangen door diagnose Y.
- (nieuw, zorgvraagtypering) Voor de zorgepisode van Jan de Vries is op 30 juli 2026 een HoNOS+-afname gedaan door M. de Boer; item 2 "opzettelijke zelfverwonding" heeft score 1.
- (nieuw) Op basis van de HoNOS+-afname van 30 juli 2026 adviseerde de NZa-zorgvraagtyperingstool (algoritmeversie 3.2) zorgvraagtype 4; behandelaar M. de Boer heeft op 30 juli 2026 zorgvraagtype 4 gekozen.
- (nieuw) De zorgvraagtypering van de zorgepisode is voor het laatst vastgesteld op 30 juli 2026. (basis voor de nudge "hertypering minimaal jaarlijks")
- (nieuw, registratiefeit) Cliënt Jan de Vries heeft op 5 augustus 2026 een privacyverklaring afgegeven tegen aanlevering van zorgvraagtyperingsgegevens aan de NZa. (structuur volgt in de toestemmings-ronde; zie open besluit 7)
2. Entiteiten
2.1 DIAGNOSE
Doel: één klinische diagnose van een cliënt binnen een zorgepisode, geregistreerd in DSM-5-TR-termen (bronregistratie), met afgeleide ICD-10-code en twee onafhankelijke status-assen (verificatie + klinisch).
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | stabiele identiteit (spelregel §3.1 #5) |
| zorgepisode_id | uuid → ZORGEPISODE | ja | eigenaar van de diagnose (besluit §5.4 #2) |
| dsm_classificatie_id | uuid → DSM_CLASSIFICATIE | ja | de DSM-5-TR-classificatie (bronregistratie) |
| afgeleide_icd10_code | tekst | nee | automatisch afgeleid via DSM_ICD10_MAPPING; leeg als de mapping (nog) geen resultaat geeft → nudge |
| mapping_lijstversie | tekst | nee | versie van de WHO-FIC-codelijst waarmee de afleiding is gedaan (reproduceerbaarheid bij controle/herdeclaratie) |
| ernst | waardelijst diagnose_ernst |
nee | zie open besluit 5 (deels redundant met DSM-specificatie) |
| verificatiestatus | waardelijst diagnose_verificatiestatus |
ja | default werkdiagnose |
| definitief_op | datum | nee | gezet bij overgang naar definitief |
| definitief_door | uuid → MEDEWERKER | nee | idem; rolvereiste volgt in de rollenronde |
| klinische_status | waardelijst diagnose_klinische_status |
ja | default actief |
| klinische_status_sinds | datum | ja | ingangsdatum van de huidige klinische status |
| begindatum_aandoening | datum | nee | klinisch begin (onset), kan vóór de registratie liggen (zib Diagnose) |
| wijze_van_vaststellen | waardelijst wijze_van_vaststellen |
nee | zib Diagnose-element |
| gesteld_tijdens_intake_id | uuid → INTAKE | nee | herkomst, geen eigenaar (besluit §5.4 #2) |
| geregistreerd_op | timestamp | ja | |
| geregistreerd_door | uuid → MEDEWERKER | ja | |
| toelichting | tekst | nee | vrije tekst (AI-voorbereiding §3.2: structuur + tekst in één record) |
| vervalreden | waardelijst diagnose_vervalreden |
nee | verplicht zodra verificatiestatus vervallen is |
| vervangen_door_diagnose_id | uuid → DIAGNOSE | nee | correctieketen: vervallen record wijst naar zijn opvolger |
| auteur_type, ai_model, ai_bronnen, content_hash | provenance-velden | ja (patroon) | spelregel §3.1 #2; content_hash triggert her-embedding en het TIP-mutatie-event |
| deleted_at | timestamp | nee | soft delete (spelregel §3.1 #4) |
Uniciteitsregels:
iduniek.- Binnen één zorgepisode maximaal één niet-vervallen, niet-verwijderde diagnose per DSM-classificatie (partiële unieke index op
(zorgepisode_id, dsm_classificatie_id)waarverificatiestatus <> 'vervallen' and deleted_at is null). Dezelfde classificatie mag wél terugkomen nadat een eerder record is vervallen. vervalredenis verplicht ⇔verificatiestatus = 'vervallen'(check-constraint).- Na
definitief:dsm_classificatie_idis onveranderbaar (correctie = vervallen + nieuw record, zie statusmachine). Vergelijk Nedapsimmutable-vlag.
2.2 DSM_CLASSIFICATIE (referentietabel, geïmporteerd)
Doel: de DSM-5-TR-classificaties als versioneerde referentiedata (import-patroon uit onderzoek-standaarden §8) — niet door behandelaars muteerbaar, nooit hardcoded.
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| dsm_code | tekst | ja | code volgens de gebruikte DSM-uitgave/codelijst |
| omschrijving | tekst | ja | let op licentie Boom/APA (open besluit 2) |
| dsm_hoofdgroep_id | uuid → DSM_HOOFDGROEP | ja | t.b.v. factuur (g-ggz) en NZa-wachttijduitsplitsing per hoofddiagnosegroep |
| selecteerbaar | boolean | ja | niet elke rij is een registreerbare einddiagnose (Nedap-patroon selecteerbaar) |
| lijstversie | tekst | ja | importversie |
| geldig_van / geldig_tot | datum | ja / nee | geldigheidsperiode per waarde (les uit Nedap-codetabellen) |
Uniciteit: (dsm_code, lijstversie) uniek.
2.3 DSM_HOOFDGROEP (referentietabel)
Doel: NZa-diagnosehoofdgroepen; afleidbaar gegeven voor factuur en wachttijdrapportage. Attributen: id, code, omschrijving, geldig_van/geldig_tot. Uniciteit: (code) uniek binnen geldigheidsperiode.
2.4 DSM_ICD10_MAPPING (referentietabel, geïmporteerd — de mappingtabel als entiteit)
Doel: de officiële "Codelijst DSM-5(-TR) met ICD-10 afleidingen" (WHO-FIC CC Nederland/RIVM) als versioneerde m:n-mappingtabel. Eén DSM-classificatie kan naar meerdere ICD-10-codes leiden en omgekeerd — daarom een eigen entiteit, geen kolom met uniciteitsaanname (onderzoek-standaarden §5, checklistpunt 3).
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| dsm_classificatie_id | uuid → DSM_CLASSIFICATIE | ja | |
| icd10_code | tekst | ja | ICD-10 zoals in NL gebruikt |
| icd10_omschrijving | tekst | nee | |
| voorkeur | boolean | ja | bij meerdere afleidingen: welke is de standaard voor declaratie |
| lijstversie | tekst | ja | bijv. "publicatie 15-12-2023, geldig per 1-1-2024" |
| geldig_van / geldig_tot | datum | ja / nee | de lijst wisselt periodiek; op het diagnoserecord staat vastgelegd met welke versie is afgeleid |
Uniciteit: (dsm_classificatie_id, icd10_code, lijstversie) uniek; maximaal één voorkeur = true per (dsm_classificatie_id, lijstversie).
2.5 HOOFDDIAGNOSE_AANWIJZING
Doel: het tijdgebonden feit "diagnose X is de hoofddiagnose van episode E van datum A tot datum B". Hiermee is "max één hoofddiagnose" een database-constraint (spelregel §3.1 #7) én blijft de historie behouden — nodig omdat de hoofddiagnose op de factuur en in de NZa-wachttijdrapportage per periode reproduceerbaar moet zijn. Alle overige actuele diagnoses van de episode zijn daarmee per definitie nevendiagnoses (comorbiditeit): geen apart type-veld nodig.
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| zorgepisode_id | uuid → ZORGEPISODE | ja | redundant met diagnose→episode, maar nodig voor de uniciteitsconstraint |
| diagnose_id | uuid → DIAGNOSE | ja | |
| geldig_van | datum | ja | |
| geldig_tot | datum | nee | leeg = actueel |
| aangewezen_door | uuid → MEDEWERKER | ja | |
| aangewezen_op | timestamp | ja |
Uniciteitsregels:
- Geen overlappende geldigheidsperiodes binnen één zorgepisode (PostgreSQL exclusion-constraint op
(zorgepisode_id, daterange(geldig_van, geldig_tot))) — dit ís het besluit "max één hoofddiagnose per moment in de tijd" (zie open besluit 1). diagnose_idmoet bij dezelfdezorgepisode_idhoren (constraint/trigger).- Alleen een niet-vervallen diagnose kan als hoofddiagnose worden aangewezen; vervalt de diagnose, dan wordt de lopende aanwijzing beëindigd (
geldig_totgezet).
2.6 HONOS_AFNAME
Doel: één afname van de HoNOS+-vragenlijst (19 items, score 0–4) voor een zorgepisode. Generiek meetinstrument-patroon; HoNOS+ is de eerste invulling (onderzoek-standaarden §6.4).
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| zorgepisode_id | uuid → ZORGEPISODE | ja | |
| instrument | tekst | ja | vast HoNOS+ met versie, t.b.v. toekomstige instrumentwissel |
| afgenomen_op | datum | ja | |
| afgenomen_door | uuid → MEDEWERKER | ja | |
| toelichting | tekst | nee | |
| deleted_at | timestamp | nee |
Uniciteit: geen beperking op aantal afnames per episode (herhaalde metingen zijn de bedoeling).
2.7 HONOS_ITEMSCORE
Doel: de score per HoNOS+-item van één afname, als gestructureerde data (geen JSON-blob — spelregel §3.1 #1 en AI-voorbereiding: scores moeten filterbaar/regelbaar zijn).
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| honos_afname_id | uuid → HONOS_AFNAME | ja | |
| honos_item_id | uuid → waardelijst honos_item |
ja | |
| score | geheel getal | ja | 0–4, of 9 = "onbekend/niet van toepassing" (HoNOS-conventie); check-constraint |
Uniciteit: (honos_afname_id, honos_item_id) uniek.
2.8 ZORGVRAAGTYPERING
Doel: het aanpalende record naast de diagnose (ZPM-verplichting g-ggz/fz): op basis van een HoNOS+-afname adviseert de NZa-tool een zorgvraagtype, de behandelaar kiest. Advies ≠ keuze: twee vastgelegde feiten met eigen herkomst — schoolvoorbeeld van het provenance-patroon (algoritme-advies vs. menselijke keuze, spelregel §3.1 #2).
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| zorgepisode_id | uuid → ZORGEPISODE | ja | |
| honos_afname_id | uuid → HONOS_AFNAME | ja | de afname waarop advies en keuze rusten |
| soort | waardelijst zorgvraagtypering_soort |
ja | initieel / hertypering |
| algoritmeversie | tekst | ja | versie van de NZa-zorgvraagtyperingstool (reproduceerbaarheid) |
| gekozen_zorgvraagtype_id | uuid → waardelijst zorgvraagtype |
ja | de keuze van de behandelaar (komt op de factuur) |
| gekozen_door | uuid → MEDEWERKER | ja | |
| gekozen_op | datum | ja | basis voor de jaarlijkse-hertypering-nudge |
| afwijking_toelichting | tekst | nee | aanbevolen in te vullen als de keuze afwijkt van het advies |
| deleted_at | timestamp | nee |
Uniciteit: maximaal één typering per HoNOS-afname (honos_afname_id uniek); meerdere typeringen per episode door de tijd (hertypering).
2.9 ZORGVRAAGTYPE_ADVIES
Doel: de door het algoritme geadviseerde zorgvraagtypes (de tool kan meerdere kandidaten met rangorde geven) — apart van de keuze vastgelegd.
| Attribuut | Type | Verplicht | Toelichting |
|---|---|---|---|
| id | uuid | ja | |
| zorgvraagtypering_id | uuid → ZORGVRAAGTYPERING | ja | |
| zorgvraagtype_id | uuid → waardelijst zorgvraagtype |
ja | |
| rangorde | geheel getal | ja | 1 = eerste advies |
Uniciteit: (zorgvraagtypering_id, zorgvraagtype_id) uniek en (zorgvraagtypering_id, rangorde) uniek.
3. Relaties met cardinaliteit
| Relatie | Cardinaliteit | Toelichting |
|---|---|---|
| ZORGEPISODE — DIAGNOSE | 1 — 0..n | besluit §5.4 #2; een episode zonder diagnose kan (vroege fase) |
| INTAKE — DIAGNOSE | 0..1 — 0..n | herkomst, optioneel (besluit §5.4 #2); intake uit deelgebied §5.2 |
| DSM_CLASSIFICATIE — DIAGNOSE | 1 — 0..n | bronregistratie |
| DSM_CLASSIFICATIE — DSM_HOOFDGROEP | n — 1 | afleiding factuur/wachttijden |
| DSM_CLASSIFICATIE — ICD-10-code (via DSM_ICD10_MAPPING) | m — n, per lijstversie | mappingtabel als entiteit (besluit §5.4 #1) |
| ZORGEPISODE — HOOFDDIAGNOSE_AANWIJZING | 1 — 0..n | max 1 met overlappende geldigheid (constraint) |
| DIAGNOSE — HOOFDDIAGNOSE_AANWIJZING | 1 — 0..n | dezelfde diagnose kan meerdere periodes hoofddiagnose zijn |
DIAGNOSE — DIAGNOSE (vervangen_door) |
0..1 — 0..1 | correctieketen na vervallen |
| ZORGEPISODE — HONOS_AFNAME | 1 — 0..n | |
| HONOS_AFNAME — HONOS_ITEMSCORE | 1 — 19 (bij volledige afname) | itemlijst uit waardelijst |
| HONOS_AFNAME — ZORGVRAAGTYPERING | 1 — 0..1 | niet elke afname leidt tot (her)typering |
| ZORGEPISODE — ZORGVRAAGTYPERING | 1 — 0..n | initieel + hertyperingen |
| ZORGVRAAGTYPERING — ZORGVRAAGTYPE_ADVIES | 1 — 0..n | algoritme-advies |
| MEDEWERKER — DIAGNOSE / HONOS_AFNAME / ZORGVRAAGTYPERING / HOOFDDIAGNOSE_AANWIJZING | 1 — 0..n | registrerende/kiezende medewerker; rolvereisten volgen in de rollenronde |
| BEHANDELPLAN — DIAGNOSE | m — n | "het plan adresseert diagnose X" (§5.5 feitzin 3); relatie wordt in deelgebied behandelplan uitgewerkt, hier alleen benoemd |
4. Waardelijsten
Conform spelregel §3.1 #1 als referentietabellen, met per rij optioneel externe_code, codesysteem_uri en geldig_van/geldig_tot (patroon uit onderzoek-standaarden §8).
| Waardelijst | Startwaarden | Extra attributen |
|---|---|---|
diagnose_verificatiestatus |
werkdiagnose, definitief, vervallen |
— |
diagnose_klinische_status |
actief, in_remissie, hersteld |
— (prototype-waarde inactive vervalt, zie open besluit 4) |
diagnose_ernst |
licht, matig, ernstig |
— |
diagnose_vervalreden |
foutregistratie, diagnose_herzien, ontkracht_na_onderzoek, overig |
vervanger_verplicht (ja/nee): bij diagnose_herzien is een vervangend record verplicht — zelfde patroon als agb_verplicht |
wijze_van_vaststellen |
klinisch_onderzoek, gestructureerd_interview, psychodiagnostisch_onderzoek, heteroanamnese, overgenomen_van_verwijzer, overig |
— (zib Diagnose; "overig" met specificatieveld, zib-patroon "anders") |
honos_item |
de 19 HoNOS+-items: 1–12 (klassieke HoNOS), 13, A–E, Q | volgnummer, omschrijving; instrumentversie via geldigheidsperiode |
zorgvraagtype |
NZa-zorgvraagtypes ggz (import uit NZa-codetabel, versioneerd) | externe_code (NZa), geldig_van/geldig_tot |
zorgvraagtypering_soort |
initieel, hertypering |
— |
DSM_CLASSIFICATIE, DSM_HOOFDGROEP en DSM_ICD10_MAPPING zijn geen waardelijsten maar geïmporteerde, versioneerde referentiedata (zelfde importmechanisme als NZa-prestatietabellen; onderzoek-standaarden §8, rij "Referentiedata-import").
5. Statusmachine
Twee onafhankelijke assen op DIAGNOSE (bevestigt de voorlopige modellering uit discovery §5.4 "nog open" — Nedap certainty + status en FHIR verificationStatus + clinicalStatus tonen dat dit staande praktijk is). Hoofddiagnose-zijn is bewust geen status maar een tijdgebonden aanwijzing (entiteit 2.5).
5.1 Verificatiestatus
| Van | Naar | Voorwaarde | Wie mag zetten |
|---|---|---|---|
| — | werkdiagnose |
registratie | behandelaar (rollenronde) |
werkdiagnose |
definitief |
— | regiebehandelaar, indicerende rol (LKS 4.0: verantwoordelijk voor het (doen) vaststellen van de diagnose) — precieze rolafdwinging in de rollenronde; tot die tijd wordt definitief_door wel vastgelegd |
werkdiagnose |
vervallen |
vervalreden verplicht | behandelaar (rollenronde) |
definitief |
vervallen |
vervalreden verplicht; bij reden diagnose_herzien ook vervangen_door_diagnose_id |
regiebehandelaar (rollenronde) |
Geen overgang definitief → werkdiagnose: een definitieve diagnose wordt niet "teruggezet" maar vervalt en krijgt een opvolger (correctieketen). Na definitief is de DSM-classificatie onveranderbaar; de klinische status en toelichting blijven muteerbaar (met audit).
5.2 Klinische status
| Van | Naar | Wie mag zetten |
|---|---|---|
actief |
in_remissie |
behandelaar (rollenronde) |
in_remissie |
actief |
behandelaar (terugval) |
actief / in_remissie |
hersteld |
behandelaar |
hersteld |
actief |
behandelaar (heropleving binnen dezelfde episode); bij een nieuwe episode hoort een nieuw diagnoserecord |
De klinische status is alleen betekenisvol op niet-vervallen diagnoses; bij vervallen wordt de klinische as bevroren.
5.3 Toegestane overgangen als data
Conform spelregel §3.1 #9 worden de overgangen vastgelegd in een referentietabel status_overgang (entiteit, as, van, naar, rol-eis) — dezelfde structuur die de aanmelding-statussen (§5.1 besluit 5) gaan gebruiken. De rol-kolom blijft leeg tot de rollenronde.
6. ECD/TIP-eigenaarschap en events richting TIP
Eigenaarschap: alle entiteiten in dit deelgebied zijn leidend in het ECD (klinische feiten, bron van waarheid — §3.3). TIP houdt geen eigen diagnose-administratie; TIP maakt doelgebonden snapshots van de data waarop een intentie/nudge rust (afstemming Joshua §3.3 #2) en mag als longitudinaal informatie-element o.a. hoofddiagnose en zorgvraagtype door de tijd bijhouden (§3.3 #3).
Events van ECD naar TIP (zelfde mutatie-eventmechanisme als her-embedding, §3.2/§3.3 #4; payload met record-UUID + content-hash, nooit BSN):
| Event | Trigger | Waarvoor TIP het nodig heeft |
|---|---|---|
diagnose_geregistreerd |
nieuw DIAGNOSE-record | bestaat al als regeltrigger in de ZPM-regelengine (diagnose_geregistreerd); start nudges "zorgvraagtypering ontbreekt", "behandelplan ontbreekt" |
diagnose_definitief_vastgesteld |
verificatiestatus → definitief |
HoNOS+ moet ná de DSM-diagnose worden ingevuld; factuur-/opt-in-checks |
diagnose_vervallen |
verificatiestatus → vervallen |
koppelafspraak §3.3 #4: TIP-kopieën en lopende nudges op basis van dit record verouderen |
hoofddiagnose_gewijzigd |
nieuwe of beëindigde HOOFDDIAGNOSE_AANWIJZING | wachttijd-uitsplitsing per hoofddiagnosegroep; declaratiecontext |
diagnose_klinische_status_gewijzigd |
klinische status-overgang | trendbewaking, evaluatie-nudges |
honos_afname_geregistreerd |
nieuw HONOS_AFNAME-record | longitudinale IE's (trend itemscores) |
zorgvraagtypering_vastgesteld |
nieuw ZORGVRAAGTYPERING-record | reset van de jaarlijkse hertyperings-termijn |
diagnose_gewijzigd (generiek mutatie-event) |
content-hash wijzigt | her-embedding + verversen TIP-snapshots |
Kandidaat-nudges (TIP/Nudge Engine, geen schema-eisen): hertypering ouder dan 12 maanden (waarschuwing; NZa: minimaal jaarlijks); definitieve diagnose zonder zorgvraagtypering in g-ggz (waarschuwing); werkdiagnose ouder dan X weken zonder definitieve vaststelling (signaal); diagnose zonder afgeleide ICD-10-code doordat de mappingversie geen resultaat geeft (signaal); DSM-hoofdgroep op factuur zonder opt-in-toestemming (blokkade — declaratieronde).
7. Open besluitpunten voor Colin
- Hoofddiagnose: per episode of per moment in de tijd? — Advies: per moment in de tijd, gemodelleerd als HOOFDDIAGNOSE_AANWIJZING met geldigheidsperiode en een exclusion-constraint (geen overlap per episode). Zo is spelregel §3.1 #7 een echte database-constraint, kan de hoofddiagnose tijdens de behandeling verschuiven (klinische realiteit; prototype ondersteunde dit niet) én blijft reproduceerbaar welke hoofddiagnose gold op elk declaratie-/rapportagemoment (NZa-wachttijden per hoofddiagnosegroep, DSM-hoofdgroep op factuur). "Max één per episode ooit" zou herziening onmogelijk maken zonder geschiedenis te wissen.
- DSM-licentie en actuele mappingversie. Gebruik van DSM-5-TR-omschrijvingen in een commercieel ECD vereist vermoedelijk een licentie bij Boom/APA; de WHO-FIC-codelijst is alleen vrijgegeven voor NZa-doeleinden, en de versie van 15-12-2023 is per 1-1-2026 vervallen. — Advies: vóór de bouw van de diagnosemodule uitzoeken (licentie + geldige opvolgerversie); het model is er niet van afhankelijk — referentietabellen blijven identiek, alleen de importbron/licentievorm verschilt.
- Correctiepatroon na definitieve vaststelling. — Advies: vervallen + nieuw record met
vervangen_door-keten (geen mutatie van de DSM-code op een definitief record). Past bij de append-only-geest (§3.1 #3), het Nedap-immutable-patroon en de WGBO-correctiesystematiek; de keten houdt herleidbaar wat wanneer gold. - Startlijst klinische status bevestigen:
actief/in_remissie/hersteld. — Advies: prototype-waardeinactivelaten vervallen — hij overlapt semantisch met zowel remissie als hersteld en niemand kan uitleggen wanneer welke geldt (het labels-vs-codes-probleem in het klein). Terugval binnen de episode =hersteld→actief; een nieuwe zorgvraag na afsluiting = nieuwe episode met nieuw diagnoserecord. - Ernst-veld behouden naast de DSM-classificatie? DSM-5-TR codeert ernst bij sommige stoornissen ín de classificatie (de matige depressieve episode uit de feitzin), bij andere niet. — Advies: behouden als optioneel veld; waar de classificatie de ernst al draagt is het veld afleidbaar/redundant — eventueel later een consistentie-nudge ("ernst wijkt af van classificatie").
- Zorgvraagtypering ook voor gb-ggz? De HoNOS+-verplichting geldt g-ggz/fz; de basis-ggz kent een eigen profiel op de factuur. — Advies: de entiteiten generiek houden (afname + typering) en het gb-ggz-profiel pas in de declaratieronde toevoegen; niets in dit model blokkeert dat.
- Privacyverklaring/opt-in als generieke TOESTEMMING-entiteit. Toestemmingsfeiten duiken op drie plekken op (DSM-hoofdgroep op factuur, huisarts-correspondentie verwijstype 04, privacyverklaring zorgvraagtypering). — Advies: één generieke TOESTEMMING-entiteit in een latere ronde (zoals onderzoek-standaarden §9.5 voorstelt); tot die tijd dit deelgebied niet belasten met een eigen toestemmingsveld — wel feitzin 15 als geregistreerd feit erkennen.
- Wie mag een diagnose definitief vaststellen blijft, conform discovery §5.4, expliciet voor de rollenronde (LKS: regiebehandelaar, indicerende rol; in settings 3–8 moet bovendien de bij diagnostiek betrokken discipline in het dossier worden vastgelegd — dat laatste veld toevoegen in de rollenronde). Geen besluit nodig nu; genoemd zodat het niet wegvalt.
8. Bronverwijzingen
- Discovery:
datamodel-discovery.md§3.1 (spelregels #1, #2, #4, #5, #7, #9), §3.2 (structuur + tekst, content-hash), §3.3 (TIP-grensvlak, afstemming Joshua), §5.1 #9 (ZORGEPISODE), §5.4 (besluiten DSM-primair + episode-eigenaarschap; open vragen verificatiestatus, hoofddiagnose, rollen). - Onderzoek proces (
scratchpad/onderzoek-proces.md): §5 (regiebehandelaar indicerende rol, LKS 4.0), §6.2 (DSM-5-classificatie verplicht voor alle ggz; betrokken discipline als dossiereis), §7 (zorgvraagtypering HoNOS+ na DSM-diagnose, hertypering minimaal jaarlijks, privacyverklaring als registratiefeit), §10.1 rij 8–9. - Onderzoek leveranciers (
../onderzoek/onderzoek-leveranciers.md): §2.3 (DiagnoseToekenning metprimair-boolean en NZa-codetabel met ICD-10-mapping als data), §2.4 (Nedapcertainty+ status = twee assen;immutablena vaststelling; waarschuwing GAF/DSM-IV-erfgoed), §7.5. - Onderzoek standaarden (
../onderzoek/onderzoek-standaarden.md): §2.2 (zib Diagnose v2.0: code-systeem-display-drieluik, steller, datum, wijze van vaststellen; DSM-5 erkend codesysteem), §3 (FHIR ConditionclinicalStatus/verificationStatus), §5 (WHO-FIC-codelijst, m:n-mapping, lijstversie op het record, DSM-hoofdgroep, opt-in, licentierisico), §6.4 (HoNOS+ 19 items 0–4, zorgvraagtyperingstool met algoritmeversie, advies ≠ keuze), §8 (checklist DIAGNOSE-rij, referentiedata-importpatroon), §9 (open punten 1, 2, 5, 6). - Onderzoek rapportage (
../onderzoek/onderzoek-rapportage.md): §1.1 (WGBO-correctiesystematiek: feitelijke onjuistheden vs. klinische conclusies — onderbouwing correctieketen i.p.v. stille mutatie). - Standaarden/regelgeving: LKS GGZ 4.0 (zorginzicht.nl); Codelijst DSM-5(-TR) met ICD-10-afleidingen (whofic.nl); NZa V&A zorgvraagtypering en Handleiding zorgvraagtypering (zorgprestatiemodel.nl); zib Diagnose v2.0 (zibs.nl); FHIR nl-core Condition (Nictiz R4 zib2020).