docs(swift): E5.S1 implementatie details toegevoegd aan bouwplan

Epic 5.S1 (AI-filtering psychiater) volledig uitgewerkt met Swift-specifieke implementatie.

Updates:
- Context: OverdrachtBlock is Swift artifact (niet EPD pagina)
- Role toggle UI: Verpleegkundige vs Psychiater selector
- API updates: filterForRole parameter in schema + route
- AI prompt: buildSystemPrompt(role) met psychiater filtering
- Filtering logic: 2-stage (server: include_in_handover, AI: behandelrelevantie)
- Deliverables checklist: 10 items
- Acceptatiecriteria: 7 criteria

Psychiater filtering rules:
✅ WEL: medicatie-issues, gedrag, risico, psychose, crisis, afwijkende vitals
❌ UIT: routine medicatie, ADL, sociale activiteiten, standaard observaties

Technische details:
- lib/types/overdracht.ts: GenerateOverdrachtSchema update
- lib/ai/overdracht-prompt.ts: buildSystemPrompt() functie
- app/api/overdracht/generate/route.ts: callClaudeAPI(context, role)
- components/swift/blocks/overdracht-block.tsx: filterRole state + toggle UI

Output verschil:
- Verpleegkundige: 5 aandachtspunten, 3 actiepunten (volledig)
- Psychiater: 2-3 aandachtspunten, 1-2 actiepunten (behandelrelevant)

Ready voor implementatie E5.S1 (5 SP).

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/swift/bouwplan-swift-v3.md

@@ -822,32 +822,259 @@ E4.S4 (Placeholder state) is geskipt omdat:
 
 **Technical Notes:**
 
-**E5.S1 - AI-filtering:**
+**E5.S1 - AI-filtering psychiater (Swift OverdrachtBlock):**
+
+**Context:**
+- OverdrachtBlock is een Swift artifact (geopend via chat)
+- Toont patient lijst met AI samenvattingen
+- Gebruikt bestaande `/api/overdracht/generate` endpoint
+- Verpleegkundigen hebben items gemarkeerd met `include_in_handover = true`
+
+**Implementatie - Role Toggle in OverdrachtBlock:**
+```tsx
+// components/swift/blocks/overdracht-block.tsx
+
+export function OverdrachtBlock({ prefill }: OverdrachtBlockProps) {
+  const [period, setPeriod] = useState<PeriodValue>('1d');
+  const [filterRole, setFilterRole] = useState<'verpleegkundige' | 'psychiater'>('verpleegkundige'); // 🆕
+
+  // Update generateSummary to include filterRole
+  const generateSummary = useCallback(async (patientId: string) => {
+    const response = await retryFetch(
+      () => safeFetch(
+        '/api/overdracht/generate',
+        {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            patientId,
+            period,
+            filterForRole: filterRole // 🆕 Add role parameter
+          }),
+        },
+        { operation: 'Overdracht genereren' }
+      ),
+      3,
+      1000
+    );
+    // ...
+  }, [period, filterRole]); // 🆕 Add filterRole dependency
+
+  return (
+    <BlockContainer title={config.title} size={config.size}>
+      <div className="space-y-6">
+        {/* 🆕 Role Selector - NIEUW */}
+        <div className="space-y-2">
+          <label className="text-sm font-medium text-slate-700">Voor wie is deze overdracht?</label>
+          <div className="grid grid-cols-2 gap-2">
+            <button
+              type="button"
+              onClick={() => setFilterRole('verpleegkundige')}
+              className={cn(
+                'px-3 py-2 rounded-lg text-sm font-medium transition-colors',
+                filterRole === 'verpleegkundige'
+                  ? 'bg-slate-900 text-white border-2 border-slate-700'
+                  : 'bg-slate-50 text-slate-600 border border-slate-200 hover:bg-slate-100'
+              )}
+            >
+              Verpleegkundige
+            </button>
+            <button
+              type="button"
+              onClick={() => setFilterRole('psychiater')}
+              className={cn(
+                'px-3 py-2 rounded-lg text-sm font-medium transition-colors',
+                filterRole === 'psychiater'
+                  ? 'bg-violet-600 text-white border-2 border-violet-700'
+                  : 'bg-slate-50 text-slate-600 border border-slate-200 hover:bg-slate-100'
+              )}
+            >
+              Psychiater
+            </button>
+          </div>
+          <p className="text-xs text-slate-500">
+            {filterRole === 'psychiater'
+              ? 'Alleen behandelrelevante informatie (medicatie, risico\'s, gedrag)'
+              : 'Volledige overdracht voor collega verpleegkundige'
+            }
+          </p>
+        </div>
+
+        {/* Period Selector - blijft hetzelfde */}
+        {/* ... */}
+      </div>
+    </BlockContainer>
+  );
+}
+```
+
+**API Schema Update:**
+```typescript
+// lib/types/overdracht.ts
+export const GenerateOverdrachtSchema = z.object({
+  patientId: z.string().uuid('Patient ID moet een geldige UUID zijn'),
+  period: z.enum(['1d', '3d', '7d', '14d']).optional().default('1d'),
+  filterForRole: z.enum(['psychiater', 'verpleegkundige']).optional().default('verpleegkundige'), // 🆕
+});
+
+export type GenerateOverdrachtInput = z.infer<typeof GenerateOverdrachtSchema>;
+```
+
+**API Route Update:**
 ```typescript
 // app/api/overdracht/generate/route.ts
-// Uitbreiden met filtering parameter
+
-interface GenerateOverdrachtRequest {
+export async function POST(request: NextRequest) {
-  shift: ShiftType;
+  const body = await request.json();
-  filterForRole?: 'psychiater' | 'verpleegkundige';
+  const result = GenerateOverdrachtSchema.safeParse(body);
+
+  const { patientId, period, filterForRole } = result.data; // 🆕 Extract filterForRole
+
+  // Load context (data loading blijft HETZELFDE - altijd include_in_handover=true)
+  const context = await loadOverdrachtContext(supabase, patientId, period);
+
+  // Call Claude API with role-specific prompt
+  const aiResult = await callClaudeAPI(context, filterForRole); // 🆕 Pass role
+
+  // ...
 }
 
-// AI prompt voor filtering
+// 🆕 Update callClaudeAPI signature
-const FILTER_PROMPT = `
+async function callClaudeAPI(
-Analyseer deze verpleegkundige notities en selecteer ALLEEN behandelrelevante informatie voor de psychiater:
+  context: OverdrachtContext,
+  role: 'psychiater' | 'verpleegkundige' = 'verpleegkundige' // 🆕 Add parameter
+): Promise<{
+  samenvatting: string;
+  aandachtspunten: Aandachtspunt[];
+  actiepunten: string[];
+}> {
+  const systemPrompt = buildSystemPrompt(role); // 🆕 Role-specific prompt
+  const userPrompt = buildOverdrachtUserPrompt(context); // Blijft hetzelfde
 
-WEL relevant:
+  const response = await fetch('https://api.anthropic.com/v1/messages', {
-- Medicatie-issues (weigering, bijwerkingen)
+    method: 'POST',
-- Stemming/gedrag veranderingen
+    headers: {
-- Risico-signalen (suïcidale uitingen, agressie)
+      'Content-Type': 'application/json',
-- Psychotische symptomen
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+    },
+    body: JSON.stringify({
+      model: 'claude-sonnet-4-20250514',
+      max_tokens: 2048,
+      temperature: 0.3,
+      system: systemPrompt, // 🆕 Role-specific
+      messages: [{ role: 'user', content: userPrompt }],
+    }),
+  });
 
-NIET relevant:
+  // ... rest blijft hetzelfde
-- Routine medicatie ("volgens schema")
+}
-- ADL activiteiten ("gedoucht", "ontbijt")
-- Standaard observaties ("rustige dag")
-`;
 ```
 
+**AI Prompt - Role-specific Filtering:**
+```typescript
+// lib/ai/overdracht-prompt.ts
+
+// 🆕 New function for role-specific prompts
+export function buildSystemPrompt(role: 'psychiater' | 'verpleegkundige'): string {
+  const basePrompt = OVERDRACHT_SYSTEM_PROMPT; // Bestaande prompt voor verpleegkundige
+
+  if (role === 'psychiater') {
+    return `${basePrompt}
+
+## PSYCHIATER FILTERING
+Je maakt overdracht voor een PSYCHIATER. Filter STRIKT op behandelrelevantie.
+
+De verpleegkundige heeft al items geselecteerd (include_in_handover=true), maar jij moet VERDER FILTEREN.
+
+✅ WEL RELEVANT (include in samenvatting):
+- Medicatie-issues: weigering, bijwerkingen, dosisaanpassingen, therapietrouw
+- Stemming/gedrag: veranderingen van baseline, afwijkend gedrag, agitatie
+- Risico-signalen: suïcidale uitingen, automutilatie, agressie
+- Psychotische symptomen: wanen, hallucinaties, desorganisatie, paranoia
+- Crisis/dwang: separatie, fixatie, dwangmedicatie, vrijheidsbeperkende maatregelen
+- Afwijkende vitals: HH (kritiek hoog), LL (kritiek laag) met behandelimpact
+
+❌ FILTER UIT (niet in samenvatting):
+- Routine medicatie: "medicatie volgens schema", "zonder problemen", "ingenomen conform afspraak"
+- ADL activiteiten: douchen, aankleden, eten, drinken (tenzij significant afwijkend/weigering)
+- Sociale activiteiten: "deelgenomen aan groepstherapie", "gesprek gehad", "koffie gedronken"
+- Standaard observaties: "rustige dag", "geen bijzonderheden", "normaal functioneren"
+- Routine vitals: bloeddruk/pols binnen normaalwaarden (N interpretatie)
+- Dagstructuur: "dagprogramma gevolgd", "aanwezig bij activiteit"
+
+VUISTREGEL: Include ALLEEN als een psychiater op basis van deze info een BEHANDELBESLISSING kan nemen.
+
+Beperkingen:
+- Maximum 3 aandachtspunten (ALLEEN behandelrelevant, geen routine items)
+- Maximum 2 actiepunten (ALLEEN actionable voor psychiater)
+- Bij twijfel of iets relevant is → FILTER UIT
+
+Voorbeelden:
+✅ INCLUDE: "Jan weigerde haloperidol, zegt dat medicatie hem controleert" → Medicatie-compliance issue
+✅ INCLUDE: "Marie uitte suïcidale gedachten tijdens gesprek" → Risicosignaal, urgent
+✅ INCLUDE: "Piet verbaal en fysiek agressief, separatie 30 min" → Crisis, gedragsverandering
+❌ FILTER: "Jan heeft goed gegeten, ontbijt en lunch zonder problemen" → Routine ADL
+❌ FILTER: "Marie deelgenomen aan groepstherapie" → Sociale activiteit, geen issues
+❌ FILTER: "Piet heeft medicatie ingenomen volgens schema" → Routine medicatie
+
+Geef je antwoord als PURE JSON, zonder markdown code blocks.`;
+  }
+
+  // Verpleegkundige gebruikt bestaande prompt (geen filtering)
+  return basePrompt;
+}
+
+// Bestaande OVERDRACHT_SYSTEM_PROMPT blijft voor verpleegkundige view
+export const OVERDRACHT_SYSTEM_PROMPT = `Je bent een ervaren verpleegkundige die overdrachten maakt in een GGZ-instelling.
+...`; // Blijft hetzelfde
+```
+
+**Filtering Logic:**
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Report Filtering Flow                     │
+└─────────────────────────────────────────────────────────────┘
+
+Stap 1 (Server - ALTIJD):
+  ├─ Filter: include_in_handover = true
+  └─ Result: Alleen aangevinkte items (bijv. 8 reports)
+
+Stap 2 (AI - Role-afhankelijk):
+  ├─ Verpleegkundige: Geen extra filtering (toon alle 8 reports)
+  └─ Psychiater: Filter op behandelrelevantie (bijv. 3 relevante reports)
+
+Output:
+  ├─ Verpleegkundige: 5 aandachtspunten, 3 actiepunten (volledige context)
+  └─ Psychiater: 2-3 aandachtspunten, 1-2 actiepunten (behandelrelevant)
+```
+
+**Deliverables (E5.S1):**
+- [ ] `lib/types/overdracht.ts` — Update GenerateOverdrachtSchema met filterForRole
+- [ ] `lib/ai/overdracht-prompt.ts` — buildSystemPrompt(role) functie met psychiater filtering
+- [ ] `app/api/overdracht/generate/route.ts` — callClaudeAPI met role parameter
+- [ ] `components/swift/blocks/overdracht-block.tsx` — Role toggle UI (Verpleegkundige/Psychiater)
+- [ ] API call updated met filterForRole in request body
+- [ ] Psychiater prompt: max 3 aandachtspunten, 2 actiepunten, strict filtering
+- [ ] Verpleegkundige prompt: blijft hetzelfde (geen filtering)
+- [ ] UI: Role selector met beschrijving per rol
+- [ ] Build succesvol zonder errors
+- [ ] Test: verpleegkundige view toont alle items, psychiater view toont alleen behandelrelevante items
+
+**Acceptatiecriteria:**
+1. ✅ Role toggle zichtbaar in OverdrachtBlock (boven period selector)
+2. ✅ Default role = "verpleegkundige" (backwards compatible)
+3. ✅ Psychiater view filtert op behandelrelevantie (medicatie-issues, gedrag, risico)
+4. ✅ Psychiater view filtert UIT: routine medicatie, ADL, sociale activiteiten
+5. ✅ Verpleegkundige view blijft werken zoals voorheen (alle aangevinkte items)
+6. ✅ AI prompt duidelijk onderscheid tussen WEL/NIET relevant voor psychiater
+7. ✅ Build succesvol, geen type errors
+
+**Git Commits:**
+- (to be committed) — E5.S1 (AI-filtering psychiater in OverdrachtBlock)
+
+---
+
 **E5.S2 - Linked evidence:**
 ```tsx
 // components/swift/shared/linked-evidence.tsx