Files
triqura-ecd/docs/specs/screening-intake/implementatieplan-screening-intake.md
2025-11-23 10:13:00 +01:00

4.9 KiB
Raw Blame History

📆 Gefaseerd Implementatieplan — Screening & Intake

Dit plan bouwt voort op het Functioneel Ontwerp (fo-screening-intake-v1_0.md) en het bouwplan (bouwplan-screening-intake-v1.0.md). Elk faseblok beschrijft scope, deliverables, afhankelijkheden en validatie zodat duidelijk is wanneer een epic “Done” mag worden verklaard.


Fase 0 — Schema & Migratie Align (Week 0) 🟡 (plan klaar, uitvoering wacht op Supabase maintenance)

Scope: Repo en Supabase in sync brengen met de documentatie.

  • 🟢 Migreer docs/archive/migrations/20251122-supabase-scheme.sql naar echte SQL-migraties in supabase/migrations/.
  • 🟡 Voer migraties uit op alle omgevingen; documenteer eventuele datafixes (oude clientspatients).
  • 🟢 Update docs/migratie-clients-naar-patients.md met runbook + status (RLS tests, API-doc, console-checks).
  • 🟡 Valideer met supabase db diff en korte CRUD smoke-test op /api/intakes zodra maintenance voorbij is.

DoD: Schone installaties krijgen identiek schema, APIs werken lokaal, documentatie verwijst naar juiste migratiebestanden.


Fase 1 — Screening Module (E3) (Week 1) 🟢 (document upload + warning actief)

Scope: UI + opslag voor activiteitenlog, documentbeheer, hulpvraag en screeningsbesluit.

  • 🟢 Backend: CRUD server actions + /api/screenings endpoints volgens FO §4.3 en data model FO §10.210.4.
  • 🟢 Frontend: activiteitenlog, hulpvraag en document upload/delete live.
  • 🟢 Statuskoppeling van screeningsbesluit naar patients.status geïmplementeerd.
  • 🟢 UX-warning bij ontbrekende verwijsbrief vóór besluit.

DoD: Alle vier secties functioneel, bestanden worden opgeslagen, statusbadge in header verandert correct, manual test checklist items “Screening doorlopen” en “Besluit nemen” afgevinkt.


Fase 2 — Intake Details (E5) (Week 23) 🟢 (routing + CRUD opgezet)

Scope: Alle intake-subtabs uit FO §4.4.44.4.10 inclusief nieuwe tabroutes.

  • 🟢 Routing child routes (/contacts, /kindcheck, /risk, /anamnese, /onderzoeken, /rom, /diagnose, /behandeladvies).
  • 🟢 Contactmomenten UI/CRUD op encounters.
  • 🟢 Kindcheck & Risicotaxaties formulieren (JSONB + risk_assessments).
  • 🟢 Anamnese/Onderzoeken/ROM tabfunctionaliteit (gedeelde component + Supabase mutaties).
  • 🟢 Diagnoses (conditions) en Behandeladvies (intakes.treatment_advice).
  • 🟡 Intakekaart metrics (#contactmomenten, diagnoses, status “bezig/afgerond”).

DoD: Alle tabs renderen data uit DB, formulieren schrijven terug, status bezig/afgerond sluit aan op FO §8.3, manual checklist items “Intake starten”, “Contactmoment toevoegen” en “Intake afronden” geslaagd.


Fase 3 — Diagnose & Behandeladvies (E6) (Week 4) 🟡 (metadata + tiptap live, diagnose nog te doen)

Scope: DSM-5 diagnose registratie, behandeladvies en statuskoppeling.

  • 🔧 Diagnose tab: CRUD op conditions/diagnoses tabel met validatie (code + omschrijving + ernst). Ondersteun sortering/primair/secundair.
  • 🟢 Behandeladvies tab: TipTap editor + metadata-paneel (datum, psycholoog, afdeling, zorgprogramma, behandelaar).
  • 🟡 Afrondingsworkflow: checkbox “Intake afronden” + vervolgkeuze (in zorg / doorverwijzen / extra diagnostiek), automatisch einddatum zetten en intake-status -> afgerond.
  • 🟢 Koppeling naar behandelplan: button/link om advies door te zetten naar tab “Behandelplan”.
  • 🟢 Voorbereiding spraak-naar-tekst: editor accepteert vrije tekst + placeholders.

DoD: Diagnoses zichtbaar in intake-overzicht + diagnose tab, behandeladvies opslaan + locking, status-flow getest inclusief notifications/toasts.


Fase 4 — QA, Documentatie & Roll-out (Week 5) 🔵 (Nog te doen)

Scope: Validatie, handover en support.

  • Testmatrix: volledige regressie over cliëntenlijst, screening, intake tabs, diagnose & advies; documenteer in docs/testing/screening-intake-regressie.md.
  • Accessibility & contrast check via scripts/test-contrast.ts (voor nieuwe UI-blokken).
  • Bijwerken van FO/bouwplan/changelog met “v1.1” status + screenshots.
  • Training/handover: korte Loom of stappenplan voor behandelaars/secretaresses.

DoD: Alle open checkboxen in docs/migratie-clients-naar-patients.md en bouwplan test checklist afgevinkt; release notes vermeld live datum en bekende risicos.


Overkoepelende aandachtspunten

  • Data consistentie: Reuse Supabase RLS policies; voer supabase tests of handmatige RLS-checks per fase.
  • Roles & rechten (prototype): Houd basisrolstatus aan (secretaresse vult screening, psycholoog intake), maar focus op UX-flows; fijnmazige autorisatie volgt later.
  • Status uniformiteit: Gebruik overal dezelfde enumeraties (planned/active/finished/cancelled voor patiënten, bezig/afgerond voor intakes). Update UI-badges en APIs in Fase 1.
  • DX: Houd server actions/APIs symmetrisch (FHIR vs Custom) en documenteer nieuwe endpoints onder docs/api/.