Initial commit from Create Next App

docs/api-acces-mini-ecd.md

@@ -0,0 +1,74 @@
+## API‑toegang Mini‑ECD
+
+Laatste update: 2025‑11‑09 • Versie: 0.2 (MVP)
+
+### Overzicht
+De Mini‑ECD API biedt server‑side endpoints in Next.js voor AI‑functionaliteit (Claude / Anthropic). In de MVP is één endpoint beschikbaar.
+
+### Base URL
+- Ontwikkel (lokaal): `http://localhost:3000`
+- Productie: n.t.b. (Vercel)
+
+### Authenticatie
+- **MVP**: geen externe client‑auth; endpoints dienen alleen in trusted context gebruikt te worden (server‑side calls of demo‑omgeving).
+- Claude AI authenticatie verloopt server‑side via Anthropic API key.
+
+### Headers
+- `Content-Type: application/json`
+
+### Endpoints
+
+#### POST `/api/ai/summarize`
+- **Doel**: vat NL intake‑tekst samen in puntsgewijze bullets (max 6), neutraal en feitelijk.
+- **Request body**
+```json
+{
+  "text": "string (1..20000)",
+  "language": "string (optioneel, default: nl)"
+}
+```
+- **Voorbeeld (PowerShell)**
+```powershell
+Invoke-RestMethod -Uri http://localhost:3000/api/ai/summarize -Method POST -Body (@{ text = "Korte intake tekst" } | ConvertTo-Json) -ContentType "application/json"
+```
+- **Voorbeeld (curl)**
+```bash
+curl -X POST http://localhost:3000/api/ai/summarize \
+  -H "Content-Type: application/json" \
+  -d '{"text":"Korte intake tekst"}'
+```
+- **Response (200)**
+```json
+{
+  "summary": "- Bullet 1\n- Bullet 2\n..."
+}
+```
+- **Fouten**
+  - 400: ongeldige body (validatie faalt)
+  - 500: Claude AI fout of configuratie ontbreekt
+
+### Omgevingsvariabelen
+- **Claude AI**
+  - `ANTHROPIC_API_KEY` (bv. `sk-ant-...`) — vereist voor alle AI-endpoints
+- **Optioneel**
+  - `ANTHROPIC_MODEL` (default `claude-3-5-sonnet-20241022`)
+
+Voorbeeld in `.env.local` (lokaal): zie `/.env.example`.
+
+### Implementatiedetails
+- Server helper: `src/lib/server/claude.ts` initialiseert Claude client met API key.
+- Endpoint: `src/app/api/ai/summarize/route.ts` (Next.js Route Handler met Zod‑validatie, Claude API call).
+
+### Beveiliging (MVP)
+- Houd `ANTHROPIC_API_KEY` uit de client; uitsluitend server‑side gebruiken.
+- Gebruik Vercel Environment Variables in productie.
+
+### Roadmap (volgende endpoints)
+- `POST /api/ai/readability` – herschrijf naar B1‑niveau.
+- `POST /api/ai/extract` – extracteer categorie/severity uit intake.
+- `POST /api/ai/generate-plan` – genereer behandelplan (Doelen, Interventies, etc.).
+
+### Changelog
+- 0.2 (2025‑11‑09): Migratie naar Next.js + Claude AI (Anthropic); update van base URL naar :3000.
+- 0.1 (2025‑09‑02): Eerste versie met `summarize` endpoint en env‑richtlijnen.
+