colin/triqura-ecd
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4caab6a8ca9c5538fe92fd39bc45358e34218cfb
triqura-ecd/docs/specs/screening-intake/bouwplan-screening-intake-v1.0.md
colinislit 4caab6a8ca feat: screening & intake database schema (Epic 1) 
Implements complete database schema for screening and intake workflow:

Database additions:
- 7 new tables: screenings, screening_activities, screening_documents,
  intakes, anamneses, examinations, risk_assessments
- Extended patients table with status (episode_status) and is_john_doe
- Extended encounters table with intake_id for linking
- Extended care_plans with intake reference columns

Architecture:
- Separate tables for reusable content (anamneses, examinations, risk_assessments)
- JSONB fields for context-bound data (kindcheck_data, treatment_advice)
- RLS policies, indexes, and updated_at triggers on all new tables
- Helper view: active_intakes_overview

Generated TypeScript types from schema for type-safe database access.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-22 13:45:37 +01:00

6.5 KiB
Raw Blame History

🚀 Mission Control — Bouwplan Screening & Intake

💡 Tip: Dit document is opgesteld op basis van fo-screening-intake-v1_0.md.

Projectnaam: AI Speedrun - Mini EPD v1.2 Versie: v1.0 Datum: 22-11-2025 Auteur: Antigravity (i.s.m. Colin)

1. Doel en context

🎯 Doel: Het realiseren van de volledige screening- en intakeflow voor GGZ-professionals, van aanmelding tot behandeladvies. 📘 Toelichting: Dit bouwplan vertaalt het Functioneel Ontwerp (FO) naar concrete ontwikkelstappen. De focus ligt op het bouwen van de fundering (zonder AI in eerste instantie) zodat cliënten kunnen worden geregistreerd, gescreend en geïntaked volgens de specificaties.

2. Uitgangspunten

2.1 Technische Stack

  • Frontend: Next.js (App Router) + Tailwind CSS + Lucide Icons
  • Backend: Supabase (PostgreSQL + Auth)
  • State Management: React Query / Server Actions
  • UI Library: shadcn/ui (of vergelijkbaar)

2.2 Projectkaders

  • Scope: Zoals beschreven in FO v1.0 (MVP).
  • Data: Gebruik van Supabase voor persistentie.
  • AI: Nog niet in scope voor deze fase (komt in latere iteratie).

2.3 Programmeer Uitgangspunten

  • DRY & SOC: Strikte scheiding tussen UI en data-fetching (Server Actions / Services).
  • Types: Volledig getypeerd met TypeScript (Database types genereren uit Supabase).
  • Componenten: Herbruikbare componenten voor veelvoorkomende patronen (bijv. SectionCard, StatusBadge).

3. Epics & Stories Overzicht

Epic ID Titel Doel Status Stories
E1 Database & Types Datamodel implementeren in Supabase ✅ Done 3
E2 Cliëntenbeheer Lijstweergave en aanmaken cliënten ⏳ To Do 3
E3 Screening Module Screening tab en functionaliteit ⏳ To Do 4
E4 Intake Core Intake overzicht en navigatie ⏳ To Do 3
E5 Intake Details Specifieke tabbladen (Contact, Risico, etc.) ⏳ To Do 5
E6 Diagnose & Advies Diagnose stelling en behandeladvies ⏳ To Do 3

4. Epics & Stories (Uitwerking)

Epic 1 — Database & Types

Doel: Een solide datamodel in Supabase dat voldoet aan de eisen uit het FO.

Story ID Beschrijving Acceptatiecriteria
E1.S1 Tabellen aanmaken ✅ Migration 20251122_screening_intake_schema.sql aangemaakt met:
- Patient status kolom (episode_status enum)
- Screening module (3 tabellen: screenings, screening_activities, screening_documents)
- Intake module (4 tabellen: intakes, anamneses, examinations, risk_assessments)
- encounters tabel uitgebreid met intake_id kolom
- care_plans uitgebreid met intake referenties
E1.S2 Migration toepassen Migration succesvol toegepast op Supabase database met:
- Foreign keys en constraints
- RLS policies voor alle nieuwe tabellen
- Indexes voor performance
- Triggers voor updated_at timestamps
E1.S3 TypeScript Types genereren Types gegenereerd met supabase gen types en geëxporteerd naar lib/supabase/database.types.ts

Epic 2 — Cliëntenbeheer (Level 1)

Doel: Behandelaars kunnen cliënten vinden en nieuwe cliënten aanmaken.

Story ID Beschrijving Acceptatiecriteria
E2.S1 Cliëntenlijst Tabel met zoekfunctie, filters en status badges.
E2.S2 Nieuwe Cliënt Flow Formulier voor aanmaken cliënt (incl. John Doe logica).
E2.S3 Cliënt Header & Nav Context-aware header en sidebar navigatie (Level 2).

Epic 3 — Screening Module (Level 2)

Doel: Faciliteren van het screeningsproces.

Story ID Beschrijving Acceptatiecriteria
E3.S1 Activiteitenlog Tijdlijn component met toevoeg-functionaliteit.
E3.S2 Documenten & Hulpvraag Upload functionaliteit en tekstveld voor hulpvraag.
E3.S3 Screeningsbesluit Formulier voor besluit (geschikt/niet geschikt) + status update logica.
E3.S4 Basisgegevens Tab Read-only weergave met edit-modus voor NAW gegevens.

Epic 4 — Intake Core (Level 2)

Doel: Beheer van intakes (meerdere per cliënt mogelijk).

Story ID Beschrijving Acceptatiecriteria
E4.S1 Intake Overzicht Kaartweergave van alle intakes per cliënt.
E4.S2 Nieuwe Intake Modal/page voor starten nieuwe intake.
E4.S3 Intake Layout Sub-navigatie (tabs) binnen een specifieke intake.

Epic 5 — Intake Details (Tabs)

Doel: Inhoudelijke registratie van de intake.

Story ID Beschrijving Acceptatiecriteria
E5.S1 Tab Algemeen Overzicht van intake details, status en notities.
E5.S2 Tab Contactmomenten CRUD voor contactmomenten (datum, type, verslag).
E5.S3 Tab Kindcheck Formulier voor kindcheck registratie.
E5.S4 Tab Risicotaxatie Formulier voor risico-inschatting.
E5.S5 Tabs Anamnese, Onderzoek, ROM Generieke of specifieke formulieren voor deze onderdelen.

Epic 6 — Diagnose & Advies

Doel: Afronding van de intake met diagnose en advies.

Story ID Beschrijving Acceptatiecriteria
E6.S1 Diagnose Tab Toevoegen DSM-5 diagnoses (code, ernst, toelichting).
E6.S2 Behandeladvies Tab Rich text editor voor advies + doorzet-logica.
E6.S3 Intake Afronding Status transitie naar 'Afgerond' en update cliënt status.

5. Kwaliteit & Testplan

Test Types

  • Unit Tests: Voor complexe validatielogica (bijv. BSN check).
  • Manual Testing: Doorlopen van de volledige flow van 'Nieuwe Cliënt' tot 'Intake Afgerond'.

Manual Test Checklist

  • Nieuwe cliënt aanmaken (John Doe & Regulier).
  • Screening doorlopen en besluit nemen.
  • Intake starten en contactmoment toevoegen.
  • Diagnose toevoegen en behandeladvies opstellen.
  • Intake afronden en controleren of status update.

6. Risico's & Mitigatie

Risico Mitigatie
Complexiteit datamodel Starten met strikte types en ERD validatie.
Navigatie diepte (Level 3?) Duidelijke breadcrumbs en 'terug' knoppen implementeren.
Performance bij veel data Paginering op lijsten en lazy loading van tabs.
Reference in New Issue View Git Blame Copy Permalink