# Product Requirements Document (PRD) - Cortex Use Case: No Show Afhandeling

**Project:** Cortex Intent System (Mini-EPD Prototype)
**Focus:** Casus 2 (Journaliseren Consult - No Show)
**Datum:** Vandaag
**Auteur:** Colin Lit / Antigravity

---

## 1. Context & Doelstelling

**Probleem:**
In het huidige EPD-systeem vergt een relatief simpele gebeurtenis zoals een "No Show" (patiënt verschijnt niet op afspraak) veel handmatige, administratieve handelingen voor de regiebehandelaar (RB). De RB moet notities maken, de agenda handmatig updaten (vaak belangrijk in verband met inkoopvoorwaarden en declarabiliteit), een nieuwe afspraak inplannen, en eventueel openstaande correspondentie (zoals een huisartsbrief over de intake) aanpassen.

**Doelstelling:**
Cortex (in de hoedanigheid van AI-assistent of co-piloot) neemt de orkestratie van deze taken over op basis van één simpele verslaglegging ("cliënt is niet verschenen"). Cortex bewaakt de bedrijfsregels (declarabiliteit) en neemt proactief openstaande taken (brieven) mee in de flow.

---

## 2. Gebruikers en Behoeften

**Primaire Gebruiker:** Regiebehandelaar (RB) / Psycholoog / Arts
**Behoefte:** Focus op de zorg, niet op het navigeren door schermen. Verlaging van cognitieve belasting. Voorkomen van administratieve fouten (zoals onterecht declareren van een no-show).

## 3. User Stories

1. **Intentie Herkenning:** Als RB wil ik in mijn journaalveld (of tegen Cortex) kunnen typen/inspreken dat de cliënt een "no show" was, zodat Cortex direct mijn intentie herkent zonder dat ik specifieke knoppen hoef te zoeken.
2. **Business Rule Waarschuwing (Nudge):** Als RB wil ik proactief door Cortex erop gewezen worden wanneer de gemiste afspraak nog als 'declarabel' in de agenda staat, zodat ik kan voldoen aan inkoopvoorwaarden.
3. **1-Klik Actie:** Als RB wil ik met één goedkeuringsklik in de chat de afspraak annuleren als 'no show' en direct het inplannen van een nieuwe afspraak initiëren.
4. **Contextueel Meedenken (Brieven):** Als RB wil ik dat Cortex weet welke openstaande documenten er liggen (bijv. een concept huisartsbrief) en mij aanbiedt deze automatisch de updaten met de informatie dat de patiënt niet is komen opdagen, zodat ik niet dezelfde informatie op twee plekken hoef in te typen.
5. **Review en Verzending:** Als RB wil ik de door AI aangepaste huisartsbrief direct kunnen lezen in een duidelijke weergave (Artifact) en met één klik accorderen en verzendklaar maken.

---

## 4. Scope & Functionaliteiten

**In Scope (Prototype MVP):**
- **Nieuwe Intentie:** Herkenning van `register_no_show`.
- **Nudges Engine Integratie:** Het afvuren van een UI-nudge suggestion als de afspraak declarabel is.
- **Context Lookup:** Checken of er mock-data (concept huisartsbrief) bestaat voor de actieve patiënt.
- **Generatieve AI:** Een LLM (zoals in `app/api/cortex/chat`) gebruiken om een alinea over de "no show" correct te integreren in de bestaande tekst van de huisartsbrief.
- **Artifact View:** Het openen van de geüpdatete brief in de `Artifact` UI van de Cortex store.

**Out of Scope:**
- Volledige kalender-integratie voor het verzetten van de afspraak (we mocken het inplannen van de *nieuwe* afspraak of gebruiken een simpele toast dat deze 'in de kalender staat').
- Verzenden van de brief via echte Zorgmail-integratie (we updaten puur de status naar `ready_for_dispatch`).

---

## 5. Succescriteria

- **Flow Completion Time:** De gehele flow van "No Show" typen tot "Brief Verzonden" moet binnen 30 seconden kunnen worden doorlopen en gedemonstreerd.
- **Zero-Navigation:** De regiebehandelaar hoeft het actieve patiënt-dashboard of de journaal-view niet te verlaten; alle interactie verloopt via Cortex Chat en de dynamische pop-up (Artifacts).
- **Kwaliteit Brief:** De door de AI herschreven brief moet grammaticaal en contextueel logisch zijn (bijv. niet zomaar "Patiënt was een no show" aan het einde plakken, maar verweven op een professionele manier in relatie tot het vervolgtraject).
