Files

colinislit 983807d833 refactor(cortex): Epic 0 - Extract patient search hooks & components (E0.S1-S4)

DRY refactor: Extract reusable patient search logic from ZoekenBlock.

New files:
- lib/cortex/hooks/use-patient-search.ts (116 lines)
  Debounced patient search with abort controller
- lib/cortex/hooks/use-patient-selection.ts (98 lines)
  FHIR fetch + store update flow
- lib/fhir/patient-mapper.ts (109 lines)
  FHIR Patient to DB Patient mapping + utilities
- components/cortex/shared/patient-list-item.tsx (114 lines)
  Reusable patient list item with loading states

Refactored:
- ZoekenBlock: 349 -> 127 lines (-64%)

Documentation:
- docs/intent/patient-search/ux-analyse-patient-selectie.md
- docs/intent/patient-search/bouwplan-patient-selectie-v1.md

CLAUDE.md updated with Cortex architecture documentation.

Epic 0 complete: 4/4 stories (4 SP)

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

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

2026-01-03 11:40:23 +01:00

5.2 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Mini-EPD Prototype - A Dutch electronic patient dossier (EPD) system for healthcare providers. Built with Next.js 14 App Router, Supabase (PostgreSQL + Auth), and Tailwind CSS. Primary language is Dutch for UI text.

Development Commands

pnpm dev              # Development server at localhost:3000
pnpm build            # Production build (fails on type errors)
pnpm lint             # ESLint check
pnpm types:generate   # Regenerate Supabase types after schema changes

Environment Variables

Required in .env.local:

NEXT_PUBLIC_SUPABASE_URL - Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY - Supabase anonymous key
ANTHROPIC_API_KEY - Claude API for AI features
DEEPGRAM_API_KEY - Deepgram for speech-to-text

Architecture

Data Layer

Supabase for PostgreSQL database and authentication
FHIR-inspired data model: patients, observations, conditions, encounters
Row Level Security (RLS) on all tables - check policies before writing queries
Types generated to lib/supabase/database.types.ts
Server client: lib/auth/server.ts (for Server Components/API routes)
Client: lib/supabase/client.ts (for Client Components)

API Structure (`app/api/`)

/api/reports - Unified CRUD for all report types (verpleegkundig, observatie, incident, etc.)
/api/overdracht - Handover data: patients, patient details, AI summary generation
/api/verpleegrapportage - Patient data for nursing report views
/api/behandelplan - Treatment plan management
/api/cortex/* - Cortex AI command center APIs (classify, chat, agenda, patients)

API Route Pattern: All routes use Zod validation, return Dutch error messages, and get the current user via createClient() from lib/auth/server.ts.

EPD Modules (`app/epd/`)

/epd/dashboard - Main dashboard with Cortex command center
/epd/verpleegrapportage - Overdracht overzicht (patiënten met AI-samenvatting)
/epd/verpleegrapportage/rapportage - Rapportage invoer workspace (timeline view)
/epd/patients/[id] - Patient dossier with intakes, conditions, observations
/epd/agenda - Appointment calendar (FullCalendar)
/epd/clients - Client management

Cortex - AI Command Center (`lib/cortex/`, `components/cortex/`)

Three-layer architecture for natural language processing:

Layer 1 - Reflex Arc (reflex-classifier.ts): Fast local pattern matching for common intents. Escalates to AI when confidence < 0.7 or ambiguous.

Layer 2 - Orchestrator (orchestrator.ts): Claude-powered intent classification for complex cases (multi-intent, pronouns, relative time). Handles context-dependent resolution.

Layer 3 - Nudge (nudge.ts): Proactive suggestions after action completion.

Intent Types (defined in lib/cortex/types.ts):

type CortexIntent = 'dagnotitie' | 'zoeken' | 'overdracht' | 'agenda_query' |
                    'create_appointment' | 'cancel_appointment' |
                    'reschedule_appointment' | 'unknown';

UI Components (components/cortex/command-center/):

command-center.tsx - Main container with command input
command-input.tsx - Voice/text input with ⌘K focus, ⌘Enter submit
context-bar.tsx - Shows active patient/context
canvas-area.tsx - Displays action blocks based on classified intent

Key Patterns

Report Types (stored in reports table):

type ReportType = 'voortgang' | 'observatie' | 'incident' | 'medicatie' |
                  'contact' | 'crisis' | 'intake' | 'behandeladvies' |
                  'vrije_notitie' | 'verpleegkundig';

Verpleegkundig Categories (in structured_data.category):

type Category = 'medicatie' | 'adl' | 'gedrag' | 'incident' | 'observatie';

Shift Date Logic: Reports created before 07:00 are assigned to the previous day's shift.

Soft Delete: Reports use deleted_at timestamp, not hard delete.

AI Integration

Claude API for generating handover summaries (/api/overdracht/generate)
Claude API for Cortex intent classification (/api/cortex/classify)
Claude API for Cortex chat (/api/cortex/chat) - streaming SSE responses
Deepgram for speech-to-text (/api/deepgram)
AI responses validated with Zod schemas

UI Components

shadcn/ui components in components/ui/
Lucide React for icons
date-fns with Dutch locale for date formatting
Timeline views grouped by day and day-part (nacht/ochtend/middag/avond)
Zustand for state management (lib/stores/)

Database Migrations

Located in supabase/migrations/. Migration naming: YYYYMMDD_description.sql

After schema changes:

Create migration file in supabase/migrations/
Apply with Supabase CLI or dashboard
Run pnpm types:generate to update TypeScript types

Type System

lib/supabase/database.types.ts - Auto-generated from Supabase schema (do not edit)
lib/types/*.ts - Manual type definitions that extend/refine generated types

Documentation

Swift/Cortex specs in docs/swift/ (bouwplan, FO docs, implementation notes)
General specs in docs/specs/ organized by module
Release notes in docs/releasenotes/

5.2 KiB Raw Blame History