triqura-ecd/docs/datamodel/deelmodellen/model-aanmelding.md

Datamodelvoorstel — Aanmelding & instroombasis

Status: herziening nodig — structureel deels achterhaald door ../besluiten/besluitenlog-datamodel-2026-07-18.md
Datum: 18 juli 2026 Deelgebied: PERSOON, CLIENT, VERWIJZER, PRAKTIJK_INSTELLING, AANMELDING, ZORGEPISODE, CLIENTPORTAAL_ACCOUNT + aanvullingen voor een volwassen instroommodel Bronnen: datamodel-discovery.md, onderzoek-proces, onderzoek-leveranciers, onderzoek-standaarden, onderzoek-rapportage (details in §8)

Let op: het besluitenlog splitst de huidige AANMELDING in AANMELDSIGNAAL en AANMELDINGSTRAJECT. De ZORGEPISODE ontstaat bij formele acceptatie en heeft een onafhankelijke levenscyclus. Gebruik de huidige entiteiten, cardinaliteiten en statusmachines daarom nog niet als basis voor SQL.

Conventies (gelden voor alle entiteiten, niet per entiteit herhaald):

• Elke entiteit heeft id (UUID, stabiel — spelregel 3.1 #5), created_at, updated_at, deleted_at (soft delete — spelregel 3.1 #4) en auditvelden conform spelregel 3.1 #3.
• Elke waardelijst is een referentietabel (spelregel 3.1 #1) met per rij: code, omschrijving, optioneel externe_code + codesysteem (FHIR/NZa-koppelbaarheid), geldig_van, geldig_tot, actief. De geldigheidsperiode per waarde is een les uit de NZa-codelijsten bij Nedap (onderzoek-leveranciers §2.2, §7.1).
• "Wie mag zetten" is overal rollenronde (discovery §5.1 besluit 6), tenzij anders vermeld.

---

1. Feitzinnen (nieuw en gewijzigd t.o.v. discovery §5.1)

Persoon, contactgegevens en adres

1. (gewijzigd t.o.v. §5.1 feitzin 1) Persoon Jan de Vries heeft naamdelen: achternaam "Vries", voorvoegsel "de", voornamen "Jan Willem", initialen "J.W.", roepnaam "Jan". (gestructureerde naam i.p.v. één naamveld — zib Patient)
2. Persoon Jan de Vries heeft geslacht "man" (uit waardelijst).
3. Persoon Jan de Vries heeft genderidentiteit "man" (optioneel, uit waardelijst — GGZ-relevant, zib Patient v4.3).
4. Persoon Jan de Vries heeft BSN 123456782. (optioneel op PERSOON — discovery §5.1 besluit 1; versleuteld — spelregel 3.1 #6)
5. Persoon Jan de Vries is overleden op 3 maart 2071. (optioneel expliciet feit — zib Patient)
6. Persoon Jan de Vries heeft een adres van type "woonadres": Dorpsstraat 1, 1234 AB Ons Dorp, geldig sinds 1 januari 2020.
7. Persoon Jan de Vries heeft contactgegeven van type "telefoon", soort "mobiel privé", waarde "06-12345678", met voorkeursmarkering.
8. Persoon Jan de Vries heeft contactgegeven van type "e-mail", waarde "jan@example.nl".

Contactpersonen en wettelijk vertegenwoordiger (relatie via PERSOON)

9. Persoon Maria de Vries staat tot cliënt Jan de Vries in relatie "partner" en vervult daarbij de rol "eerste contactpersoon", sinds 14 juli 2026.
10. Persoon K. Bos vervult voor cliënt Jan de Vries de rol "wettelijk vertegenwoordiger" met vertegenwoordigingsgrond "mentor", sinds 1 februari 2026.
11. De relatie van Maria de Vries tot cliënt Jan de Vries is op 1 mei 2027 beëindigd.

Vaste huisarts

12. Cliënt Jan de Vries heeft huisarts-situatie "huisarts bekend" (alternatieven: "geen huisarts", "cliënt staat correspondentie met huisarts niet toe" — ZPM-verwijstype 04/05, onderzoek-proces §2.8).
13. Cliënt Jan de Vries heeft als vaste huisarts P. Pietersen, verbonden aan Huisartsenpraktijk De Vries & Pietersen, sinds 14 juli 2026. (vaste huisarts ≠ incidentele verwijzer; kan dezelfde persoon zijn)

Verzekering en financiering per wettelijk kader

14. Cliënt Jan de Vries is verzekerd bij zorgverzekeraar met UZOVI-code 3311 onder polisnummer 987654, geldig vanaf 1 januari 2026.
15. De verzekering van Jan de Vries is op 14 juli 2026 geverifieerd via een COV-controle.
16. Bij de aanmelding van 14 juli 2026 onder wettelijk kader "Jeugdwet" hoort gemeentelijke toewijzing 301-20260714-001 van gemeente Utrecht (gemeentecode 0344), met periode 1 augustus 2026 t/m 31 januari 2027. (alleen bij kader Jeugdwet/Wmo — iJw/iWmo, onderzoek-standaarden §7)

Verwijzing (verrijking van de aanmelding)

17. (verfijnt §5.1 feitzin 8) Bij de aanmelding van 14 juli 2026 hoort een verwijzing, afgegeven op 1 juli 2026 door verwijzer P. Pietersen. (verwijsdatum ≠ aanmelddatum; 275-dagentoets en per 2026 verplicht op de declaratie — onderzoek-proces §2.3/§2.10)
18. De verwijzing vermeldt echelon "gespecialiseerde ggz".
19. De verwijzing vermeldt een vermoeden van een DSM-benoemde psychische stoornis: "depressieve klachten".
20. De verwijzing betreft een heraanmelding: nee.
21. De aanmelding van 14 juli 2026 heeft ZPM-verwijstype "01 — verwijzing aanwezig". (afleidbaar, maar overschrijfbaar registreerbaar — onderzoek-standaarden §6.3)
22. De aanmelding van 14 juli 2026 volgt doorverwijsroute "doorverwijzing tussen ggz-aanbieders". (optioneel; alleen bij één van de vijf erkende routes — onderzoek-proces §2.7)
23. Voor de aanmelding van 15 juli 2026 zonder verwijzing (crisis) is de huisarts op 20 juli 2026 geïnformeerd. (60-dagentermijn — onderzoek-proces §2.6)

Aanmelding (aanvullingen)

24. De aanmelding van 14 juli 2026 is ontvangen via aanmeldkanaal "ZorgDomein".
25. (verfijnt §5.1 besluit 5) De aanmelding van 14 juli 2026 heeft uitkomst "intake", vastgesteld op 17 juli 2026. (uitkomst + uitkomstdatum als aparte feiten naast de status)

Toestemmingen (WGBO/AVG)

26. Cliënt Jan de Vries heeft op 14 juli 2026 toestemming van type "correspondentie met huisarts/verwijzer" verleend, vastgelegd door K. Jansen, wijze "mondeling".
27. Cliënt Jan de Vries heeft op 1 september 2026 de toestemming van type "vermelding DSM-hoofdgroep op factuur" geweigerd.
28. Cliënt Jan de Vries heeft de toestemming van type "correspondentie met huisarts/verwijzer" op 1 december 2026 ingetrokken.

Zorgepisode

29. Voor cliënt Jan de Vries is op 17 juli 2026 een zorgepisode gestart, voortkomend uit de aanmelding van 14 juli 2026. (ontstaat bij uitkomst "intake" — zie §5 en besluitpunt 1)
30. De zorgepisode van Jan de Vries is op 15 maart 2027 afgesloten met reden "behandeling afgerond".

---

2. Entiteiten

2.1 PERSOON

Doel: draagt de identiteit van een natuurlijk persoon, onafhankelijk van rollen (cliënt, contactpersoon, vertegenwoordiger, later medewerker). Discovery §5.1 besluit 1.

Attribuut	Type	Verplicht
achternaam	tekst	ja
voorvoegsels	tekst	nee
voornamen	tekst	nee
initialen	tekst	nee
roepnaam	tekst	nee
geboortedatum	datum	ja
geslacht	waardelijst geslacht	ja
genderidentiteit	waardelijst genderidentiteit	nee
bsn	tekst, versleuteld (pgcrypto), inzage gelogd	nee (rolgebonden eis via nudge — §5.1 besluit 1)
overleden	ja/nee	ja (default nee)
overlijdensdatum	datum	nee

Uniciteit: BSN uniek indien gevuld (op hash-index over de versleutelde waarde). Geen andere harde uniciteitsregel — naam+geboortedatum-duplicaten worden een nudge ("mogelijke dubbele persoon"), geen constraint.

2.2 ADRES

Doel: 0..n adressen per persoon (zib Patient: meerdere adressen mogelijk).

Attribuut	Type	Verplicht
persoon_id	ref PERSOON	ja
adrestype	waardelijst adrestype	ja
straat	tekst	ja
huisnummer	tekst	ja
huisnummertoevoeging	tekst	nee
postcode	tekst	ja
plaats	tekst	ja
land	tekst (default NL)	ja
geldig_van	datum	nee
geldig_tot	datum	nee

Uniciteit: max één actueel (geldig_tot leeg) adres per persoon per adrestype.

2.3 CONTACTGEGEVEN

Doel: telefoonnummers en e-mailadressen per persoon.

Attribuut	Type	Verplicht
persoon_id	ref PERSOON	ja
contacttype	waardelijst contactgegeven_type (telefoon/e-mail)	ja
soort	waardelijst contactgegeven_soort (mobiel privé/vast privé/werk/…)	nee
waarde	tekst	ja
voorkeur	ja/nee	ja (default nee)

Uniciteit: max één voorkeursgegeven per persoon per contacttype.

2.4 CLIENT

Doel: rol op PERSOON: dit persoon is cliënt bij de instelling. Discovery §5.0 besluit 2 + §5.1 besluit 1.

Attribuut	Type	Verplicht
persoon_id	ref PERSOON	ja
clientnummer	geheel getal (reeks per instelling)	ja
client_sinds	datum	ja
huisarts_situatie	waardelijst huisarts_situatie	ja (default "onbekend")

Uniciteit: max één CLIENT-rol per PERSOON; clientnummer uniek. Nudge (geen constraint): "cliënt zonder BSN" (Wabvpz — §5.1 besluit 1).

2.5 CLIENTRELATIE

Doel: contactpersonen en (wettelijk) vertegenwoordigers als relatie tussen een CLIENT en een PERSOON — twee gescheiden assen relatie en rol, conform zib Contactpersoon (onderzoek-standaarden §2.2). Dekt ook gezaghebbende ouders (jeugd) en mentoren/curatoren (Wvggz/WGBO — onderzoek-proces §8).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
persoon_id	ref PERSOON	ja
relatie	waardelijst relatie (partner, ouder, kind, …)	nee
rol	waardelijst relatierol (eerste contactpersoon, wettelijk vertegenwoordiger, …)	ja
vertegenwoordigingsgrond	waardelijst vertegenwoordigingsgrond	nee (alleen bij rol wettelijk vertegenwoordiger)
geldig_van	datum	ja
geldig_tot	datum	nee
toelichting	tekst	nee

Uniciteit: max één actuele rij per (client, persoon, rol). Meerdere rollen per persoon mogelijk (moeder = ouder + gezaghebbend + eerste contactpersoon = drie assen, twee rijen: rol "gezaghebbende ouder" en rol "eerste contactpersoon", beide relatie "ouder"). Zelfrelatie (persoon = cliënt-persoon) niet toegestaan. Leeftijdsafhankelijke rechten (12/16-grenzen WGBO) zijn autorisatie, geen schema — rollenronde.

2.6 VERWIJZER

Doel: persoon of functionaris die verwijst. Eigen begrip (discovery §5.0 besluit 3), los van PRAKTIJK_INSTELLING (§5.1 besluit 2). Wordt óók gebruikt als referent voor de vaste huisarts (zie CLIENT_HUISARTS en besluitpunt 3).

Attribuut	Type	Verplicht
naam	tekst	ja
verwijzertype	waardelijst verwijzertype	ja
agb_code	tekst (vrije invoer — §5.1 besluit 4)	nee (nudge indien agb_verplicht op het type — §5.1 besluit 3)
praktijk_instelling_id	ref PRAKTIJK_INSTELLING	nee
telefoon	tekst	nee
e-mail	tekst	nee

Uniciteit: agb_code uniek indien gevuld. Verwijzer kan zonder praktijk bestaan (gemeente-ambtenaar).

2.7 PRAKTIJK_INSTELLING

Doel: organisatie waaraan verwijzers/huisartsen verbonden zijn. Discovery §5.1 besluit 2.

Attribuut	Type	Verplicht
naam	tekst	ja
soort	waardelijst praktijk_soort (huisartsenpraktijk, ziekenhuis, ggz-instelling, gemeente, arbodienst, overig)	nee
agb_code	tekst	nee
adres/plaats	tekst	nee
telefoon	tekst	nee

Uniciteit: agb_code uniek indien gevuld.

2.8 CLIENT_HUISARTS

Doel: de vaste huisarts van de cliënt, los van de incidentele verwijzer. Nodig omdat de huisarts ook informatie-ontvanger is wanneer hij níet de verwijzer is (intakebrief, beloopsbrief, 60-dagenmelding — onderzoek-proces §2.9, §10.2).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
verwijzer_id	ref VERWIJZER (type huisarts)	nee
praktijk_instelling_id	ref PRAKTIJK_INSTELLING	nee
geldig_van	datum	ja
geldig_tot	datum	nee

Uniciteit: max één actuele registratie per cliënt. Minstens één van verwijzer_id/praktijk_instelling_id gevuld (soms is alleen de praktijk bekend). De situatie "geen huisarts"/"geen toestemming" staat op CLIENT.huisarts_situatie, niet hier.

2.9 VERZEKERING

Doel: Zvw-verzekeringsgegevens van de cliënt (financieringskant bij kader Zvw). Historisch, want verzekeraars wisselen per jaar.

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
uzovi_code	tekst	ja
verzekeraar_naam	tekst	nee
polisnummer	tekst	nee
geldig_van	datum	ja
geldig_tot	datum	nee
cov_gecontroleerd_op	datum	nee

Uniciteit: max één actuele verzekering per cliënt. Nudge: "Zvw-aanmelding zonder actuele COV-controle". Wlz-indicatie en forensische titel: declaratie-ronde (besluitpunt 7).

2.10 AANMELDING

Doel: de binnenkomst-gebeurtenis (discovery §5.1 besluit 9). Draagt aanmelddatum (wettelijk controleerbaar gegeven — onderzoek-proces §2.3), kanaal, kader, hulpvraag, status en uitkomst. Screening en aanmeldwachttijd hangen hieraan (§5.2, §5.3).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
aanmelddatum	datum	ja
aanmeldkanaal	waardelijst aanmeldkanaal	nee
wettelijk_kader	waardelijst wettelijk_kader	ja (§5.0 besluit 4)
hulpvraag	tekst	ja
status	waardelijst aanmelding_status	ja (default "nieuw")
uitkomst	waardelijst aanmelding_uitkomst	nee (verplicht bij status "besloten")
uitkomst_datum	datum	nee (verplicht bij uitkomst)
zpm_verwijstype	waardelijst zpm_verwijstype	nee (afleidbaar uit verwijzing/toestemmingen, overschrijfbaar; verplicht richting declaratie bij Zvw)
doorverwijsroute	waardelijst doorverwijsroute	nee
huisarts_geinformeerd_op	datum	nee (instroom zonder verwijzing; nudge harde termijn 60 dagen)
toelichting	tekst	nee

Uniciteit: geen harde beperking op parallelle aanmeldingen; "max één actieve aanmelding per cliënt" is een aan/uit-zetbare bedrijfsregel (§5.0 besluit 5) — in TIP/Nudge, niet in schema.

2.11 VERWIJZING (nieuw — besluitpunt 2)

Doel: de verwijzing als eigen registratie-object bij de aanmelding. Verfijnt §5.1 feitzin 8: "ontvangen via verwijzer X" blijft waar, maar de verwijzing draagt eigen wettelijk relevante feiten die niet op de aanmelding of de verwijzer thuishoren: verwijsdatum (275-dagentoets; per 1-1-2026 verplicht op elke declaratie), echelon, DSM-vermoeden, heraanmelding-vlag (onderzoek-proces §2, onderzoek-standaarden §8). Een zelfaanmelding heeft géén verwijzing.

Attribuut	Type	Verplicht
aanmelding_id	ref AANMELDING	ja
verwijzer_id	ref VERWIJZER	ja
verwijsdatum	datum	ja
echelon	waardelijst echelon	nee (ontbreekt op verwijzing → aanbieder kiest zelf, onderzoek-proces §2.5)
vermoeden_dsm_stoornis	tekst	nee
heraanmelding	ja/nee	ja (default nee)
toelichting	tekst	nee

Uniciteit: max één verwijzing per aanmelding. Geldigheidstoets (aanmelddatum − verwijsdatum ≤ 275 dagen) is een nudge, geen constraint (onvolledige/late verwijzing mag — inspanningsverplichting, onderzoek-proces §2.5).

2.12 VERWIJSDOCUMENT

Doel: ontvangen documenten bij de aanmelding, getypeerd (verwijsbrief, beschikking, …) — discovery §5.1 besluit 7.

Attribuut	Type	Verplicht
aanmelding_id	ref AANMELDING	ja
documenttype	waardelijst verwijsdocument_type	ja
document_referentie	ref documentopslag (UUID)	ja
ontvangen_op	datum	ja

Uniciteit: geen (meerdere documenten per aanmelding toegestaan).

2.13 TOEWIJZING (nieuw — gemeentelijk kader)

Doel: bij kader Jeugdwet/Wmo is de "verwijzing" feitelijk een gemeentelijke beschikking/toewijzing met eigen sleutelgegevens (iWmo/iJw 301-bericht) — meer structuur dan een document alleen (onderzoek-standaarden §7). Minimale variant nu; productcodes/volume volgen in de declaratie-ronde (besluitpunt 6).

Attribuut	Type	Verplicht
aanmelding_id	ref AANMELDING	ja
gemeentecode	tekst (CBS-code)	ja
gemeente_naam	tekst	nee
toewijzingsnummer	tekst	ja
ingangsdatum	datum	ja
einddatum	datum	nee

Uniciteit: toewijzingsnummer uniek per gemeentecode.

2.14 TOESTEMMING (nieuw — besluitpunt 4)

Doel: één generieke toestemmingsentiteit (WGBO/AVG). Toestemmingen duiken in de instroom al op drie plekken op: correspondentie huisarts/verwijzer (verwijstype 04!), DSM-hoofdgroep op factuur (opt-in sinds 2025), privacyverklaring zorgvraagtypering (onderzoek-standaarden §9.5; onderzoek-proces §2.8/§7). Cliëntakkoord op het behandelplan blijft een apart feit bij het behandelplan (deelgebied §5.5), geen TOESTEMMING-rij.

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
toestemmingstype	waardelijst toestemming_type	ja
status	waardelijst toestemming_status	ja
datum	datum	ja
wijze	waardelijst toestemming_wijze	nee
vastgelegd_door	ref medewerker (rollenronde)	ja
geldig_tot	datum	nee
ingetrokken_op	datum	nee
scope_aanmelding_id / scope_episode_id	ref (optioneel)	nee (default: cliëntbreed)
toelichting	tekst	nee

Uniciteit: max één actuele (niet-ingetrokken) rij per (client, toestemmingstype, scope). Intrekken = nieuw statusfeit, historie blijft (append-only audit).

2.15 ZORGEPISODE

Doel: de periode van zorg (discovery §5.1 besluit 9). Draagt intakes, diagnoses, behandelplannen, behandelwachttijd, zorgvraagtypering (latere ronde). Klinisch object, niet het ZPM-zorgtraject — verwant, gekoppeld, geen 1-op-1 (onderzoek-standaarden §6.1; onderzoek-leveranciers §2.3).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
aanmelding_id	ref AANMELDING (herkomst)	ja
startdatum	datum	ja
status	waardelijst episode_status	ja (default "lopend")
echelon_actueel	waardelijst echelon	nee (kan wijzigen door op-/afschalen — besluitpunt 5)
einddatum	datum	nee
einde_reden	waardelijst episode_einde_reden	nee (verplicht bij afsluiten; startlijst te bevestigen, sluit t.z.t. aan op iStd-redenen)
zorgtrajectnummer	tekst	nee (gereserveerd; invulling declaratie-ronde)

Uniciteit: max één episode per aanmelding (een aanmelding met uitkomst "intake" leidt tot precies één episode; afgewezen/doorverwezen aanmeldingen hebben er nooit één — §5.1 besluit 9). Meerdere episodes per cliënt door de tijd. Ontstaansmoment: bij uitkomst "intake", niet bij "wachtlijst" — zie §5 en besluitpunt 1.

2.16 CLIENTPORTAAL_ACCOUNT

Doel: relatie-placeholder (discovery §5.1 besluit 8). Wettelijke basis: elektronische inzage Wabvpz (onderzoek-proces §8).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja

Uniciteit: max één account per CLIENT (1-op-0..1). Authenticatiedetails en statussen: auth/ADM-ronde. Portaaltoegang voor vertegenwoordigers (ouders, 12–16-regels) raakt CLIENTRELATIE — ook auth-ronde.

---

3. Relaties met cardinaliteit

Van	Naar	Cardinaliteit	Toelichting
PERSOON	ADRES	1 — 0..n	max 1 actueel per adrestype
PERSOON	CONTACTGEGEVEN	1 — 0..n
PERSOON	CLIENT	1 — 0..1	rol; één cliëntrol per persoon
CLIENT	CLIENTRELATIE	1 — 0..n	contactpersonen/vertegenwoordigers
PERSOON	CLIENTRELATIE	1 — 0..n	de relatie-persoon
VERWIJZER	PRAKTIJK_INSTELLING	0..n — 0..1	verwijzer kan zonder praktijk
CLIENT	CLIENT_HUISARTS	1 — 0..n	max 1 actueel
CLIENT_HUISARTS	VERWIJZER / PRAKTIJK_INSTELLING	— 0..1 / 0..1	minstens één gevuld
CLIENT	VERZEKERING	1 — 0..n	max 1 actueel
CLIENT	AANMELDING	1 — 0..n	episodisch (§5.0 besluit 2)
AANMELDING	VERWIJZING	1 — 0..1	zelfaanmelding: geen
VERWIJZING	VERWIJZER	0..n — 1
AANMELDING	VERWIJSDOCUMENT	1 — 0..n
AANMELDING	TOEWIJZING	1 — 0..n	alleen kader Jeugdwet/Wmo
AANMELDING	ZORGEPISODE	1 — 0..1	alleen bij uitkomst "intake"
CLIENT	ZORGEPISODE	1 — 0..n
CLIENT	TOESTEMMING	1 — 0..n
CLIENT	CLIENTPORTAAL_ACCOUNT	1 — 0..1

Naar andere deelgebieden:

Van	Naar (deelgebied)	Cardinaliteit
AANMELDING	SCREENING (§5.2)	1 — 0..1
AANMELDING	WACHTLIJSTPLAATSING soort "aanmeld" (§5.3)	1 — 0..n
ZORGEPISODE	INTAKE (§5.2)	1 — 0..n (regulier + intern)
ZORGEPISODE	WACHTLIJSTPLAATSING soort "behandel" (§5.3)	1 — 0..n
ZORGEPISODE	DIAGNOSE (§5.4)	1 — 0..n
ZORGEPISODE	BEHANDELPLAN (§5.5)	1 — 0..n (versies)
ZORGEPISODE	ZORGVRAAGTYPERING (latere ronde)	1 — 0..n
ZORGEPISODE	regiebehandelaar-toewijzing (rollenronde)	1 — 0..n
TOESTEMMING	correspondentie-verplichtingen (latere ronde: intakebrief, beloopsbrief)	grondslag per verstrekking

---

4. Waardelijsten

Alle lijsten volgen het conventie-patroon (code, omschrijving, externe code, geldigheid). Startwaarden:

1. geslacht — man, vrouw, anders, onbekend (externe code: HL7 AdministrativeGender)
2. genderidentiteit — man, vrouw, non-binair, anders, zegt_het_niet (zib Patient v4.3)
3. adrestype — woonadres, postadres, tijdelijk_verblijf
4. contactgegeven_type — telefoon, email
5. contactgegeven_soort — mobiel_prive, vast_prive, werk, overig
6. relatie — partner, ouder, kind, broer_zus, familielid_overig, vriend_kennis, professional, overig
7. relatierol — eerste_contactpersoon, wettelijk_vertegenwoordiger, gezaghebbende_ouder, mantelzorger, naaste (twee assen relatie × rol — zib Contactpersoon)
8. vertegenwoordigingsgrond — curator, mentor, schriftelijk_gemachtigde, ouder_voogd, partner_familie (WGBO-volgorde, onderzoek-proces §8)
9. huisarts_situatie — bekend, geen_huisarts, geen_toestemming_correspondentie, onbekend (voedt ZPM-verwijstype 04/05)
10. verwijzertype — met attribuut agb_verplicht (ja/nee), §5.1 besluit 3. Startwaarden (discovery §5.0 besluit 3 + Verwijsafspraken GGZ, onderzoek-proces §2.2):

code	agb_verplicht
huisarts	ja
medisch_specialist	ja
straatdokter	ja
bedrijfsarts	ja
regiebehandelaar	ja
ggz_instelling	ja
gemeente	nee
zelfaanmelding	nee
crisis	nee

11. praktijk_soort — huisartsenpraktijk, ziekenhuis, ggz_instelling, gemeente, arbodienst, overig
12. wettelijk_kader — met attribuut verwijsnudge_severity (§5.1 besluit 7): zvw (blokkade), jeugdwet (signaal), wmo (signaal), wlz (waarschuwing), forensisch (waarschuwing) (severity-startwaarden te bevestigen in de nudge-ronde; NB bij Zvw zonder spoed/Wvggz is ontbrekende verwijzing feitelijk declaratie-blokkerend — onderzoek-proces §10.3)
13. aanmeldkanaal — zorgdomein, brief_post, e_mail, telefonisch, clientportaal, crisis, intern, overig
14. aanmelding_status — nieuw, in_screening, besloten (§5.1 besluit 5)
15. aanmelding_uitkomst — intake, afgewezen, doorverwezen, wachtlijst (§5.1 besluit 5)
16. verwijsdocument_type — verwijsbrief, beschikking, wlz_indicatiebesluit, huisartsmelding_60dagen, medische_verklaring_wvggz, overig (§5.1 besluit 7, uitgebreid)
17. echelon — gb_ggz, g_ggz, onbekend
18. zpm_verwijstype — 01 t/m 07 conform ZPM-veldafspraken (externe code = Vektis/ZPM-code; onderzoek-standaarden §6.3): 01 verwijzing_aanwezig, 02 doorverwijzing_regiebehandelaar, 03 geen_verwijzing_verlate_correspondentie, 04 geen_verwijzing_correspondentie_niet_toegestaan, 05 geen_verwijzing_niet_declarabel, 06 geen_verwijzing_andere_grond_fz, 07 verwijzing_zonder_agb
19. doorverwijsroute — justitieel_traject, einde_wlz_indicatie, overgang_jeugdwet, vervolg_acute_ggz, ggz_naar_ggz (de vijf erkende routes; moet uit het dossier blijken — onderzoek-proces §2.7)
20. toestemming_type — met attribuut grondslag (tekst): correspondentie_huisarts_verwijzer (WGBO/verwijsafspraken), dsm_hoofdgroep_op_factuur (Stcrt. 2025-11955, opt-in), privacyverklaring_zorgvraagtypering (NZa), gegevensdeling_derden (AVG), inzage_naasten (WGBO)
21. toestemming_status — verleend, geweigerd, ingetrokken
22. toestemming_wijze — mondeling, schriftelijk, portaal
23. episode_status — lopend, afgesloten
24. episode_einde_reden — behandeling_afgerond, doorverwezen, client_beeindigt, geen_contact, overleden, overig (startlijst; mapping op iStandaarden-redenen in de declaratie-ronde)

---

5. Statusmachine

AANMELDING

Statussen: nieuw → in_screening → besloten. Flexibel, geen eenrichtingsflow (§5.1 besluit 5).

Van	Naar	Voorwaarde
nieuw	in_screening	—
nieuw	besloten	direct besluit toegestaan (bijv. evidente doorverwijzing)
in_screening	besloten	uitkomst + uitkomst_datum verplicht
besloten	in_screening	heropening; uitkomst en uitkomst_datum worden gearchiveerd in de audit, velden leeg

Regels in het model (spelregel 3.1 #7/#9): check-constraint "status = besloten ⇒ uitkomst en uitkomst_datum gevuld"; overgangen in een referentietabel statusovergang (entiteit, van, naar), niet in schermcode. Bij uitkomst intake: ZORGEPISODE wordt aangemaakt (zie hieronder). Bij uitkomst wachtlijst: WACHTLIJSTPLAATSING soort "aanmeld" aan de AANMELDING — geen episode.

Wie mag zetten: rollenronde (§5.1 besluit 6). Kandidaat-inperking om daar te toetsen: besloten alleen door een rol met indicatiebevoegdheid (LKS: indicerende rol regiebehandelaar).

ZORGEPISODE

Statussen: lopend → afgesloten.

Van	Naar	Voorwaarde
lopend	afgesloten	einddatum + einde_reden verplicht
afgesloten	lopend	heropening bij administratieve fout; terugval krijgt een nieuwe episode (besluitpunt 8)

Ontstaansregel (beantwoording open detail §5.1 besluit 9): de episode ontstaat op het moment dat de aanmelding uitkomst "intake" krijgt; startdatum = uitkomst_datum. Bij uitkomst "wachtlijst" ontstaat géén episode. Onderbouwing: de NZa-behandelwachttijd loopt vanaf de intake en de verantwoordelijkheidsoverdracht van verwijzer naar aanbieder ligt ná de intake bij de regiebehandelaar (LKS 4.0; onderzoek-proces §1, §4.2, §10.3 — "episode pas bij intake, aanmeldwachttijd op de aanmelding"). De aanmeldwachtlijst hangt aan de AANMELDING (§5.3-besluit), dus er gaat niets verloren. Komt de cliënt van de aanmeldwachtlijst alsnog naar intake, dan wordt de uitkomst bijgewerkt naar "intake" (heropening → besloten) en ontstaat de episode alsnog. Wie mag zetten: rollenronde.

Overige entiteiten

PERSOON, CLIENT, VERWIJZER, PRAKTIJK_INSTELLING, VERWIJZING, TOEWIJZING, CLIENT_HUISARTS, VERZEKERING: geen statusmachine — levenscyclus via geldigheidsperioden en soft delete. TOESTEMMING: verleend/geweigerd → ingetrokken (eenrichting; nieuwe toestemming = nieuwe rij). CLIENTPORTAAL_ACCOUNT: statusmachine in de auth/ADM-ronde.

---

6. ECD/TIP-eigenaarschap en events richting TIP

Eigenaarschap: alle entiteiten in dit deelgebied zijn leidend in het ECD (klinische/administratieve feiten — discovery §3.3). TIP houdt de proces-state: screeningstaken, termijnbewaking, wachtlijst-nudges, "max één actieve aanmelding"-bedrijfsregel.

Events naar TIP (mutatie-events, zelfde mechanisme als her-embedding — §3.3 koppelafspraak; payload bevat UUID + content-hash, nooit BSN — spelregel 3.1 #6):

Event	Trigger	Waarvoor TIP het nodig heeft
client_geregistreerd	nieuwe CLIENT	workspace/dossiercontext aanmaken
aanmelding_geregistreerd	nieuwe AANMELDING	screeningstaak starten; Treeknorm-klok aanmeldwachttijd (4 wkn); 275-dagentoets als verwijzing volgt
aanmelding_status_gewijzigd	statusovergang	procesbewaking, heropening detecteren
aanmelding_besloten	status besloten (incl. uitkomst)	vervolgacties: intake plannen / wachtlijst / terugverwijsbrief
verwijzing_geregistreerd	nieuwe/gewijzigde VERWIJZING	275-dagen-geldigheidsnudge; "verwijzing onvolledig"-inspanningsnudge
verwijzing_ontbreekt	aanmelding zonder VERWIJZING onder Zvw	nudge met severity per wettelijk kader (§5.1 besluit 7); 60-dagen-huisartsmelding-termijn
toewijzing_geregistreerd	nieuwe TOEWIJZING	iWmo/iJw-startberichten (305) t.z.t.
zorgepisode_gestart	nieuwe ZORGEPISODE	Treeknorm-klok behandelwachttijd (10 wkn); regiebehandelaar-toewijzing agenderen
zorgepisode_afgesloten	status afgesloten	afrondingsbrief-taak; terugval-venster 1 jaar (ZPM) bewaken
toestemming_gewijzigd	TOESTEMMING-mutatie	correspondentie-taken blokkeren/vrijgeven (intakebrief vereist toestemming)
clientrelatie_gewijzigd	CLIENTRELATIE-mutatie	vertegenwoordiger-afhankelijke rechten/portaal
huisarts_gewijzigd	CLIENT_HUISARTS / huisarts_situatie	correspondentie-adressering; verwijstype-afleiding

TIP-snapshots van deze data zijn doelgebonden auditkopieën met herkomst (afstemming Joshua, discovery §3.3) — het ECD blijft bron.

---

7. Open besluitpunten voor Colin

1. Ontstaansmoment ZORGEPISODE — ter bekrachtiging. Voorstel: episode ontstaat bij uitkomst "intake", niet bij "wachtlijst" (onderbouwing §5). Advies: bekrachtigen — alle bronnen (LKS-verantwoordelijkheidsoverdracht, NZa-wachttijddefinities) wijzen dezelfde kant op, en de aanmeldwachtlijst hangt toch al aan de AANMELDING.
2. VERWIJZING als eigen entiteit tussen AANMELDING en VERWIJZER (verwijsdatum, echelon, DSM-vermoeden, heraanmelding). Advies: ja — de verwijsdatum is per 2026 verplicht op elke declaratie en de 275-dagentoets vereist verwijsdatum ≠ aanmelddatum; dat hoort niet als los veld op de aanmelding (zelfaanmelding heeft er geen) en niet op de verwijzer (die verwijst vaker).
3. Vaste huisarts via hergebruik van VERWIJZER/PRAKTIJK_INSTELLING (CLIENT_HUISARTS verwijst ernaar) of een aparte generalisatie EXTERNE_ZORGVERLENER. Advies: hergebruik nu — een huisarts is per definitie een potentiële verwijzer; generaliseren pas als er meer externe rollen bijkomen (ketenpartners, apotheek). Semantische scheefheid ("verwijzer die nooit verwees") accepteren als bekende schuld.
4. TOESTEMMING nu al als generieke entiteit opnemen (i.p.v. uitstellen naar een latere ronde zoals onderzoek-standaarden §9.5 suggereert). Advies: nu opnemen met kleine startwaardelijst — verwijstype 04 en de intakebrief maken toestemming al in de instroomflow nodig; uitstellen betekent losse vlaggen die later gemigreerd moeten worden.
5. Echelon op twee plekken: bron-echelon op VERWIJZING én actueel echelon op ZORGEPISODE (op-/afschalen binnen één aanbieder is geen doorverwijzing). Advies: beide, episode-veld optioneel — nodig voor wachttijd-uitsplitsing en factuurinhoud (g-ggz vs gb-ggz).
6. TOEWIJZING minimaal nu (gemeente, nummer, periode) en productcategorie/-code/volume in de declaratie-ronde. Advies: akkoord met minimale variant — het toewijzingsnummer is de sleutel die alle latere iWmo/iJw-berichten nodig hebben; de rest is declaratie-detail.
7. Financieringsdetail Wlz/forensisch (indicatiebesluit, strafrechtelijke titel) doorschuiven naar de declaratie-ronde; nu alleen VERZEKERING (Zvw) en TOEWIJZING (gemeentelijk). Advies: doorschuiven — het wettelijk kader zelf staat al op de aanmelding; de bronnen geven voor Wlz/fz nog te weinig structuurzekerheid.
8. Terugval binnen 1 jaar: nieuwe ZORGEPISODE met hergebruik van het ZPM-zorgtrajectnummer, of heropening van de oude episode? Advies: nieuwe episode — klinisch is het een nieuwe zorgperiode; het trajectnummer-hergebruik (NZa-regel) is een declaratie-koppeling, geen reden om episodes samen te smelten. Definitief te maken in de declaratie-ronde (episode ↔ zorgtraject niet 1-op-1).
9. Huisarts-informeren als attribuut (huisarts_geinformeerd_op op AANMELDING) of als onderdeel van een toekomstige CORRESPONDENTIE-entiteit (intakebrief, beloopsbrief, afrondingsbrief). Advies: attribuut nu, CORRESPONDENTIE-entiteit in de rapportage-ronde — de 60-dagentermijn is een hard wettelijk feit dat nu al een nudge nodig heeft; de brievenstroom is een groter onderwerp dat een eigen ronde verdient (onderzoek-proces §10.3 verrijking 9).
10. Startwaarden verwijsnudge_severity per wettelijk kader (waardelijst 12): bij Zvw is ontbrekende verwijzing zonder spoed/Wvggz-grond feitelijk declaratie-blokkerend — is blokkade daar de juiste severity, en welke voor Wlz/forensisch? Advies: vaststellen in de nudge-/declaratie-ronde, waardelijst-attribuut staat er klaar voor.

---

8. Bronverwijzingen

Onderdeel	Bron
PERSOON/CLIENT-splitsing, BSN optioneel	discovery §5.1 besluit 1; spelregel 3.1 #6
Gestructureerde naam, meerdere adressen, geslacht/genderidentiteit, overlijden	onderzoek-standaarden §2.2 (zib Patient v4.3), §8
CLIENTRELATIE met twee assen relatie × rol	onderzoek-standaarden §2.2 (zib Contactpersoon v5.0); onderzoek-leveranciers §2.2 (Nedap ClientContactRelation + Type)
Vertegenwoordiging, leeftijdsgrenzen 12/16	onderzoek-proces §8 (WGBO/KNMG)
Vaste huisarts als informatie-ontvanger, huisarts onbekend/geen toestemming	onderzoek-proces §2.8–§2.9
VERWIJZING: verwijsdatum, 275 dagen, echelon, heraanmelding, DSM-vermoeden	onderzoek-proces §2.3–§2.5, §2.10 (Verwijsafspraken GGZ, NHG-richtlijn, NR/REG-2616a); onderzoek-standaarden §2.2, §8
ZPM-verwijstypen 01–07, zorglabels	onderzoek-standaarden §6.3 (ZPM-veldafspraken jan 2022)
Doorverwijsroutes (5 erkende)	onderzoek-proces §2.7
60-dagen-huisartsmelding	onderzoek-proces §2.6
Referral-decompositie marktconform	onderzoek-leveranciers §2.2 (Nedap Referral)
TOEWIJZING (iWmo/iJw 301, woonplaatsbeginsel)	onderzoek-standaarden §7
VERZEKERING/COV	onderzoek-proces §10.1 stap 2; iStandaarden/Vecozo-praktijk
TOESTEMMING generiek (drie vindplaatsen)	onderzoek-standaarden §9.5; onderzoek-proces §2.8, §7 (opt-in DSM, privacyverklaring)
Episode-ontstaan bij intake	onderzoek-proces §1 (LKS-verantwoordelijkheidsoverdracht), §4.1–§4.2 (Treeknorm/NZa-definities), §10.3
Episode ≠ ZPM-zorgtraject, trajectnummer-hergebruik	onderzoek-standaarden §6.1; onderzoek-leveranciers §2.3
Statusmachine expliciet, regels in model	spelregels 3.1 #7/#9; discovery §5.1 besluiten 5–6
Waardelijsten met geldigheidsperioden en externe codes	onderzoek-leveranciers §2.2/§7.1; onderzoek-standaarden §8
TIP-grensvlak, events, snapshots	discovery §3.3 (afstemming Joshua 17-7-2026)
Wachtlijst aan aanmelding/episode	discovery §5.3-besluit; onderzoek-proces §4