# Datamodelvoorstel — Aanmelding & instroombasis

**Status:** gesynchroniseerd 19 juli 2026 — AANMELDING/VERWIJZING/VERWIJSDOCUMENT/TOEWIJZING/ZORGEPISODE (§2.10–§2.13, §2.15) zijn vervangen door `model-instroom.md`; PERSOON/CLIENT/CLIENTRELATIE/VERWIJZER/PRAKTIJK_INSTELLING/CLIENT_HUISARTS/VERZEKERING/TOESTEMMING/CLIENTPORTAAL_ACCOUNT (§2.1–§2.9, §2.14, §2.16) blijven ongewijzigd geldig en worden door `model-instroom.md` hergebruikt, niet gedupliceerd  
**Datum:** 18 juli 2026, gesynchroniseerd 19 juli 2026
**Deelgebied (na sync):** PERSOON, CLIENT, CLIENTRELATIE, VERWIJZER, PRAKTIJK_INSTELLING, CLIENT_HUISARTS, VERZEKERING, TOESTEMMING, CLIENTPORTAAL_ACCOUNT
**Bronnen:** `datamodel-discovery.md`, onderzoek-proces, onderzoek-leveranciers, onderzoek-standaarden, onderzoek-rapportage (details in §8)

> **Let op:** dit document behandelde oorspronkelijk ook de instroomflow (AANMELDING, VERWIJZING, ZORGEPISODE). Die deelgebieden zijn na de FCO-IM-feitenronde van 19 juli 2026 volledig herzien en staan nu in `model-instroom.md` (feitzinnen: `../feitenmodellen/feitenmodel-instroom.md`; besluiten: B21–B30 in `../besluiten/besluitenlog-datamodel-2026-07-18.md`). De secties hieronder die nog AANMELDING/VERWIJZING/ZORGEPISODE beschrijven zijn behouden als historisch werkdocument, niet als actuele bron — gebruik ze 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) — **vervallen, zie `model-instroom.md`**

*(Feitzinnen 17–25 hieronder zijn vervangen door `../feitenmodellen/feitenmodel-instroom.md` en de entiteiten in `model-instroom.md` — Professional Referral, Municipal Care Assignment, Referral Case. Behouden als historisch werkdocument.)*

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) — **vervallen, zie `model-instroom.md`**

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 — **vervallen, zie `model-instroom.md`**

*(Feitzinnen 29–30 zijn achterhaald: de episode ontstaat sinds B22/B23 bij het acceptatiebesluit zelf, niet bij uitkomst "intake" — zie `model-instroom.md` §2.18 `clinical_care_episode`.)*

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 — **vervallen, zie `model-instroom.md`**

*(Vervangen door `referral_request` en `referral_case` in `model-instroom.md` §2.1, §2.6 — inclusief de daar herstelde velden `zpm_verwijstype`, `huisarts_geinformeerd_op` en `wettelijk_kader`. Behouden als historisch werkdocument; de waardelijsten `aanmeldkanaal`, `echelon`, `zpm_verwijstype` en `wettelijk_kader` in §4 hieronder blijven wel in gebruik.)*

**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)* — **vervallen, zie `model-instroom.md`**

*(Vervangen door `professional_referral` in `model-instroom.md` §2.14, inclusief het herstelde `heraanmelding`-veld en de vervangt-relatie voor correctie/aanvulling — zie B23.)*

**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 — **vervallen, zie `model-instroom.md`**

*(Vervangen door `submission_document` in `model-instroom.md` §2.3 — nu gekoppeld aan de submission die het document aanleverde, niet aan de aanmelding.)*

**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)* — **vervallen, zie `model-instroom.md`**

*(Vervangen door `municipal_care_assignment` in `model-instroom.md` §2.15 — zelfde minimale opzet, nu expliciet náást in plaats van in plaats van `professional_referral` gemodelleerd, met een vervangt-relatie voor herziene 301-berichten. Juridisch nog niet door een jurist bevestigd, zie B27.)*

**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 — **vervallen, zie `model-instroom.md`**

*(Vervangen door `clinical_care_episode` in `model-instroom.md` §2.18 — belangrijkste wijziging: ontstaat bij het acceptatiebesluit zelf (of een Wvggz-mandaat), niet meer bij uitkomst "intake". Alleen ontstaan/einde zijn daar uitgewerkt; het volledige episodemodel — programma-/organisatiebetrokkenheid, zorgteam — blijft een apart deelgebied.)*

**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

**Geldig (PERSOON/CLIENT-laag):**

| 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 | TOESTEMMING | 1 — 0..n | |
| CLIENT | CLIENTPORTAAL_ACCOUNT | 1 — 0..1 | |

**Vervallen (AANMELDING/VERWIJZING/VERWIJSDOCUMENT/TOEWIJZING/ZORGEPISODE) —
zie `model-instroom.md` §3 voor de actuele cardinaliteitentabel
van `referral_request`/`referral_submission`/`referral_case`/
`professional_referral`/`municipal_care_assignment`/`clinical_care_episode`:**

| Van | Naar | Cardinaliteit | Toelichting |
|---|---|---|---|
| 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 | |

**Naar andere deelgebieden** *(AANMELDING/ZORGEPISODE hieronder zijn de oude
ankers; lees deze als `referral_case`/`clinical_care_episode` totdat
screening/wachtlijst/intake/diagnose/behandelplan zelf zijn gesynchroniseerd)*:

| 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:

*(Nummering ongewijzigd gelaten — `model-instroom.md` §4 verwijst naar 12, 17 en 18 hieronder. Items 13–16, 19, 23 zijn vervallen ten gunste van waardelijsten in `model-instroom.md`; zie annotaties per item.)*

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 *(vervallen — komt terug als `submission_channel` in `model-instroom.md` §4, met vergelijkbare waarden)*
14. **aanmelding_status** — nieuw, in_screening, besloten *(vervallen — `referral_case` heeft geen statusveld meer, zie B25 en `model-instroom.md` §5)*
15. **aanmelding_uitkomst** — intake, afgewezen, doorverwezen, wachtlijst *(vervallen — vervangen door de gesplitste `decision_outcome`/`follow_up_route` in `model-instroom.md` §4, zie B22)*
16. **verwijsdocument_type** — verwijsbrief, beschikking, wlz_indicatiebesluit, huisartsmelding_60dagen, medische_verklaring_wvggz, overig *(vervallen — komt terug als `document_type` in `model-instroom.md` §4; de Wvggz-waarde hoort inmiddels bij `legal_mandate.medical_statement_reference`)*
17. **echelon** — gb_ggz, g_ggz, onbekend *(blijft in gebruik — hergebruikt door `professional_referral` in `model-instroom.md`)*
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 *(blijft in gebruik — hergebruikt door `referral_case.zpm_verwijstype` in `model-instroom.md`)*
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)* **— nog niet geïntegreerd in `model-instroom.md`.** Dit is reële, niet-gedekte inhoud: `model-instroom.md` heeft alleen de grovere `follow_up_route`-waarde `doorverwijzen`, niet welke van de vijf erkende routes. Op te pakken bij de volgende instroom-ronde, niet stilzwijgend laten vervallen.
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 *(vervallen — `clinical_care_episode` heeft geen statusveld, status volgt uit `ended_at`/`end_reason`, zie `model-instroom.md` §2.18)*
24. **episode_einde_reden** — behandeling_afgerond, doorverwezen, client_beeindigt, geen_contact, overleden, overig *(startlijst; mapping op iStandaarden-redenen in de declaratie-ronde)* *(komt terug als `episode_end_reason` in `model-instroom.md` §4, aangevuld met `ingetrokken_door_client`/`acceptatiebesluit_herzien`, zie B24)*

---

## 5. Statusmachine

### AANMELDING — **vervallen, zie `model-instroom.md`**

*(`referral_case` heeft bewust geen statusveld meer — de actuele stand wordt afgeleid uit een gebeurtenistijdlijn, zie B25 en `model-instroom.md` §1/§5. Behouden als historisch werkdocument.)*

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 — **vervallen, zie `model-instroom.md`**

*(`clinical_care_episode` ontstaat bij het acceptatiebesluit zelf — ook tijdens de intakewachtlijst — niet meer bij uitkomst "intake"; zie B22 en `model-instroom.md` §2.18. Behouden als historisch werkdocument.)*

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, 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

> **Vervallen voor het instroomdeel, nog niet opnieuw uitgewerkt.** De events hieronder (`aanmelding_*`, `verwijzing_*`, `toewijzing_*`, `zorgepisode_*`) verwijzen naar entiteiten die niet meer bestaan. `model-instroom.md` bevat nog geen TIP-event-ontwerp — dat vereist een eigen ontwerpstap (welke gebeurtenis uit de nieuwe tijdlijn-aanpak een TIP-event triggert), niet alleen een naamsvervanging. Behouden als historisch werkdocument en als checklist van wat opnieuw moet worden doordacht. De rijen voor CLIENT/CLIENTRELATIE/CLIENT_HUISARTS/TOESTEMMING blijven wel geldig.

**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

**Status per punt na de instroom-sync (19 juli 2026):**

1. **Ontstaansmoment ZORGEPISODE.** **Herzien, niet bekrachtigd zoals hier geadviseerd.** De uiteindelijke beslissing (B22) is dat de episode ontstaat bij het acceptatiebesluit zelf, óók bij vervolgroute intakewachtlijst — niet pas bij uitkomst "intake" zoals hier geadviseerd. Zie `model-instroom.md` §2.18.
2. **VERWIJZING als eigen entiteit.** **Bevestigd zoals geadviseerd**, nu `professional_referral` (`model-instroom.md` §2.14), met als aanvulling een vervangt-relatie voor correctie/aanvulling (B23) die hier nog niet was voorzien.
3. **Vaste huisarts via hergebruik van VERWIJZER/PRAKTIJK_INSTELLING.** **Al verwerkt** — CLIENT_HUISARTS (§2.8) gebruikt deze opzet al, geen open vraag meer. Blijft ongewijzigd bij de sync.
4. **TOESTEMMING nu al als generieke entiteit.** **Al verwerkt** — TOESTEMMING (§2.14) bestaat al met deze opzet, geen open vraag meer. Blijft ongewijzigd bij de sync; `model-instroom.md` hergebruikt deze entiteit voor correspondentietoestemming.
5. **Echelon op twee plekken.** **Deels opgelost.** Bron-echelon staat op `professional_referral.echelon`. Een "actueel echelon" op de episode zelf (voor op-/afschalen na de instroom) is niet meegenomen — `clinical_care_episode` in `model-instroom.md` is bewust beperkt tot ontstaan/einde; dit hoort bij het bredere, nog te ontwerpen episodemodel.
6. **TOEWIJZING minimaal nu.** **Verder uitgewerkt dan hier geadviseerd.** `municipal_care_assignment` (`model-instroom.md` §2.15) bevat, op basis van juridisch onderzoek naar het WMO301/iJw301-bericht, al productcategorie/-code/volume/eenheid — verder dan de hier voorgestelde minimale variant.
7. **Financieringsdetail Wlz/forensisch.** **Nog steeds open** — niet opgepakt in de instroom-ronde. `wettelijk_kader` kent de waarden wlz/forensisch al (waardelijst 12), maar een indicatiebesluit- of titel-registratie ontbreekt nog.
8. **Terugval binnen 1 jaar.** **Bevestigd (nieuwe episode), met een aanvulling.** `possible_continuation_of_episode_id` (`model-instroom.md` §2.18) legt optioneel een zorginhoudelijke continuïteitsrelatie tussen de oude en nieuwe episode, expliciet **geen** autoritatieve trajectnummer-toets — die blijft, zoals hier al voorzien, bij de declaratie-ronde.
9. **Huisarts-informeren als attribuut.** **Bevestigd zoals geadviseerd**, nu op `referral_case.huisarts_geinformeerd_op` (`model-instroom.md` §2.6) in plaats van op AANMELDING.
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? **Nog steeds open** — niet opgepakt in de instroom-ronde; **advies blijft: 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 |
