triqura-ecd/docs/datamodel/deelmodellen/model-intake-behandeladvies.md

Datamodelvoorstel — Intake en behandeladvies

Status: voorstel ter review — eerste entiteiten- en cardinaliteitenafleiding Datum: 19 juli 2026 Scope: Clinical Intake Assessment, Intake Contact, Child Safety Check, Treatment Advice, en een minimale hook voor MDT-bespreking bij het behandeladvies. Contactmoment-generalisatie naar een bredere consult-/afspraakstructuur blijft buiten scope (agenda-ronde). Kader: bouwt rechtstreeks op de bevestigde feitzinnen in ../feitenmodellen/feitenmodel-intake-behandeladvies.md, inclusief het gerichte LKS 4.0-onderzoek naar behandeladvies-uitkomsten en bevoegdheid. Dit is de stap "afleiding van entiteiten en cardinaliteiten" uit diens §7. Naamgeving: entiteiten en attributen zijn Engelstalig, conform besluit B20 — vervangt het oudere, Nederlandstalige model-intake.md, dat als historisch werkdocument blijft staan met verwijzingen hierheen. Autoriteit: ../besluiten/besluitenlog-datamodel-2026-07-18.md blijft leidend.

---

1. Entiteiten

1.1 clinical_intake_assessment

Doel: het onderzoekstraject voor één samenhangende zorgvraag binnen een zorgepisode, van gepland eerste contact tot behandeladvies (feitenmodel §2).

Attribuut	Type	Verplicht
clinical_care_episode_id	ref clinical_care_episode	ja
initiation_reason	waardelijst intake_initiation_reason (regulier/intern/crisis)	ja
department	waardelijst department (afdeling)	ja
status	waardelijst intake_status (gepland/bezig/afgerond/afgebroken)	ja (default gepland)
planned_at	tijdstip	ja
started_at	tijdstip	verplicht zodra status bezig of later
ended_at	tijdstip	verplicht zodra status afgerond of afgebroken
abort_reason	waardelijst intake_abort_reason	verplicht bij status afgebroken

Uniciteit: één stabiele identiteit; hangt aan precies één clinical_care_episode. Een episode kan nul, één of meerdere intakes hebben. "Maximaal één lopende intake per episode" is een aan/uit-zetbare bedrijfsregel, geen schemabeperking (een crisisintake kan naast een lopende reguliere intake nodig zijn). Statusovergangen: zie §4.

Relatie met instroom: clinical_care_episode_id vervangt de oudere, inmiddels onjuiste relatie met AANMELDING. De intake start op enig moment ná het acceptatiebesluit dat de episode liet ontstaan — mogelijk na een periode op de intakewachtlijst (referral_case.follow_up_route = intakewachtlijst, model-instroom.md §2.12). planned_at dekt precies dat interval.

1.2 intake_contact

Doel: een feitelijk contact binnen een clinical_intake_assessment (feitenmodel §3.2).

Attribuut	Type	Verplicht
clinical_intake_assessment_id	ref clinical_intake_assessment	ja
occurred_at	tijdstip	ja
contact_type	waardelijst intake_contact_type (intakegesprek/aanvullend_onderzoek/telefonisch_contact/huisbezoek/beeldcontact/overig)	ja
performed_by	ref medewerker	ja
notes	tekst	nee
planned_duration_minutes	geheel getal	nee

Uniciteit: geen — meerdere contacten van hetzelfde type op dezelfde dag zijn legitiem.

1.3 child_safety_check

Doel: de wettelijk verankerde kindcheck bij de intake (feitenmodel §3.3).

Attribuut	Type	Verplicht
clinical_intake_assessment_id	ref clinical_intake_assessment	ja
performed_at	tijdstip	ja
performed_by	ref medewerker	ja
responsible_for_minors	ja/nee	ja
minor_count	geheel getal	nee (alleen zinvol bij responsible_for_minors = ja)
minor_ages	tekst	nee (vrije tekst, bewust geen kindrecords — dataminimalisatie)
safety_concern	ja/nee	ja
safety_concern_notes	tekst	verplicht bij safety_concern = ja
action_taken	ja/nee	ja
action_taken_notes	tekst	verplicht bij action_taken = ja
pregnancy	ja/nee	ja (vierde vlag, KNMG-kindcheck — feitenmodel §3.3, te verifiëren tegen de meldcode-tekst)
notes	tekst	nee

Uniciteit: maximaal één child_safety_check per clinical_intake_assessment (uniek op clinical_intake_assessment_id). Een nieuwe intake binnen dezelfde episode krijgt een eigen, nieuwe kindcheck.

1.4 intake_mdt_review (minimale, voorlopige hook — zie §6)

Doel: vastleggen dát een behandeladvies in een multidisciplinair team is besproken, zonder de volledige MDO-workflow (B14-B15, nog een aparte ronde) hier te herhalen. Voor settings 3–8 is dit volgens LKS 4.0 een dwingende norm, voor setting 2 optioneel, voor vrijgevestigden niet van toepassing (feitenmodel §3.4).

Attribuut	Type	Verplicht
occurred_at	tijdstip	ja
participants	tekst	ja (vrije tekst voorlopig; structurering wacht op de MDO-ronde)
notes	tekst	nee

Uniciteit: geen eigen FK naar clinical_intake_assessment — wordt gekoppeld via treatment_advice.mdt_review_id (zie 1.5), zodat een MDT-bespreking pas telt zodra zij daadwerkelijk aan een vastgesteld advies hangt.

1.5 treatment_advice

Doel: het object dat een clinical_intake_assessment afrondt: draagt de uitkomst, het geadviseerde zorgprogramma en de toelichting (feitenmodel §2, §3.4).

Attribuut	Type	Verplicht
clinical_intake_assessment_id	ref clinical_intake_assessment	ja
decided_at	tijdstip	ja
decided_by	ref medewerker (indicerende regiebehandelaar)	ja
outcome	waardelijst treatment_advice_outcome (in_zorg/terugverwijzing/doorverwijzing/extra_diagnostiek)	ja
recommended_care_program	ref care_program	verplicht bij outcome in_zorg, anders optioneel
rationale	tekst	verplicht bij terugverwijzing/doorverwijzing/extra_diagnostiek, optioneel bij in_zorg
mdt_review_id	ref intake_mdt_review	nee (settingafhankelijk — zie §6, punt 1)
replaces_advice_id	ref treatment_advice (zelfreferentie)	nee
replacement_reason	tekst	verplicht als replaces_advice_id gevuld is

Uniciteit: precies één intake, beslisser, besluitdatum en uitkomst per advies. replaces_advice_id is uniek indien gevuld (voorkomt vertakking), onbeperkte kettingdiepte — zelfde constructie als care_acceptance_decision/professional_referral in model-instroom.md. Het geldige advies van een intake is het laatste, niet-vervangen advies in de keten.

doorverwijzing/terugverwijzing als volgtijdelijk paar: LKS 4.0 normeert eerst een inspanningsverplichting tot doorverwijzing, pas daarna terugverwijzing als dat niets oplevert. Dit wordt niet als aparte sequentie-constraint gemodelleerd, maar volgt vanzelf uit het vervangt-mechanisme: een terugverwijzing-advies dat een eerder doorverwijzing-advies vervangt, met de mislukte doorverwijzing als replacement_reason (feitenmodel §3.4, Route 2).

2. Relaties met cardinaliteit

Van	Naar	Cardinaliteit	Toelichting
clinical_care_episode	clinical_intake_assessment	1..0..n	een episode kan nog geen intake hebben (net ontstaan, wacht op intakewachtlijst)
clinical_intake_assessment	intake_contact	1..0..n	een geplande intake heeft nog geen contacten
clinical_intake_assessment	child_safety_check	1..0..1	"verplicht vóór afronden" is een nudge, geen schema-eis
clinical_intake_assessment	treatment_advice	1..0..n	0 zolang nog niet afgerond; n bij heroverweging (Route 4)
treatment_advice	treatment_advice	0..1 (self)	replaces_advice_id, optioneel en uniek indien gevuld — voorkomt vertakking
treatment_advice	intake_mdt_review	0..1..1	een MDT-bespreking hoort bij precies één advies zodra gekoppeld
treatment_advice	care_program	0..1	verplicht bij outcome in_zorg

3. Waardelijsten (startlijsten, te bevestigen)

Waardelijst	Voorlopige waarden
intake_initiation_reason	regulier, intern, crisis
intake_status	gepland, bezig, afgerond, afgebroken
intake_abort_reason	client_trekt_terug, geen_contact_meer, overleden, overig
intake_contact_type	intakegesprek, aanvullend_onderzoek, telefonisch_contact, huisbezoek, beeldcontact, overig
treatment_advice_outcome	in_zorg, terugverwijzing, doorverwijzing, extra_diagnostiek
department	over te nemen uit model-aanmelding.md/instellingsconfiguratie (afdeling, instellingsconfigureerbaar)
care_program	over te nemen uit bestaande zorgprogramma-waardelijst (model-instroom.md program_context)

Alle waardelijsten volgen het bestaande patroon (referentietabel met code, omschrijving, geldig_van/geldig_tot, actief — spelregel 3.1 #1) en zijn hier nog geen definitieve besluiten.

4. Statusmachine clinical_intake_assessment

Statussen: gepland → bezig → afgerond/afgebroken, met heropening.

Van	Naar	Voorwaarde
—	gepland	intake aangemaakt
gepland	bezig	eerste intake_contact geregistreerd
gepland	afgebroken	abort_reason verplicht
bezig	afgerond	een niet-vervangen treatment_advice verplicht
bezig	afgebroken	abort_reason verplicht
afgerond	bezig	heropening, audit-event verplicht
afgebroken	bezig	heropening (cliënt meldt zich alsnog), audit-event verplicht

Niet toegestaan: gepland → afgerond rechtstreeks (afronden zonder geregistreerd contact); afgerond ↔ afgebroken rechtstreeks. Regels in het model als check-constraints en een referentietabel voor overgangen, consistent met spelregel 3.1 #7/#9.

5. Buiten scope van dit document

• Het volledige MDO-workflowmodel (casusinbreng, triage, agendering, formele uitkomsttypen) — intake_mdt_review is een minimale hook, geen vervanging van B14-B15.
• Contactmoment-generalisatie naar een bredere consult-/afspraakstructuur — agenda-ronde.
• De volledige bevoegdheidsmatrix per setting (welke settings exact MDT-bespreking vereisen, en de rolinvulling) — bevoegdheidsronde (B16).
• ZPM-consultregistratie (planning versus geleverde prestatie) — hangt aan intake_contact maar wordt in de declaratie-ronde uitgewerkt.

6. Open punten voor Colin

1. intake_mdt_review als verplicht of optioneel veld op treatment_advice? Voorstel hierboven: optioneel op schemaniveau (mdt_review_id nee), met een nudge/constraint die per setting bepaalt of afronden zonder MDT-koppeling is toegestaan — settings 3–8 volgens LKS 4.0 in principe niet. Dit vereist een settingregistratie die nu nog niet bestaat in het model (welke setting geldt voor deze episode/case); zonder die registratie kan de regel niet worden afgedwongen, alleen als nudge worden voorgesteld.
2. Is extra_diagnostiek altijd een nieuw, vervangend treatment_advice zodra het vervolgonderzoek is afgerond, of kan de intake ook gewoon "bezig" blijven zonder tussentijdse afronding? Beide zijn nu schema-technisch mogelijk (heropening bestaat); welke de praktijk prefereert is niet getoetst.
3. pregnancy-vlag op child_safety_check is toegevoegd op basis van algemene domeinkennis (KNMG-meldcode), niet uit de eerder verzamelde onderzoeksrapporten — te verifiëren.
4. Startwaarden van de waardelijsten — met name intake_contact_type en intake_abort_reason zijn overgenomen uit het oudere model-intake.md zonder nieuwe validatie.

7. Bronverwijzingen

Onderdeel	Bron
Alle feitzinnen, besloten regels, scenario's	../feitenmodellen/feitenmodel-intake-behandeladvies.md
LKS 4.0-onderzoek behandeladvies-uitkomsten en bevoegdheid	zie onderzoeksresultaat verwerkt in feitenmodel §3.4
Intake aan zorgepisode, meerdere intakes, aanleiding-waardelijst (basis)	model-intake.md §1/§2 (ouder, Nederlandstalig, episode-timing gecorrigeerd)
Instroom-precedenten (vervangt-mechanisme, tijdlijn-principe)	model-instroom.md
Engelstalig technisch model	besluit B20, ../besluiten/besluitenlog-datamodel-2026-07-18.md §9