# šŸš€ 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. | ---