major update

docs/07-api-erweitern.md

@@ -0,0 +1,32 @@
+# API erweitern
+
+Letzte Aktualisierung: 2026-02-24
+
+## Ziel
+
+API-Änderungen konsistent ausrollen (Code + Spec + Test).
+
+## Ablauf
+
+1. Endpoint in `pages/api/v1/**` anpassen.
+2. Service/Repository bei Bedarf erweitern.
+3. OpenAPI in `/docs/openapi.yaml` im selben Change aktualisieren.
+4. Endpoint per cURL/Postman gegenprüfen.
+
+## API-Regeln
+
+- UUID-first nach außen
+- Einheitliche Fehlerstruktur (`error`, optional `errors`)
+- Auth/Scope-Regeln unverändert einhalten
+
+## Minimaltest
+
+```bash
+curl -H "Authorization: Bearer <TOKEN>" \
+  http://localhost:8080/api/v1/me
+```
+
+## Vertiefung
+
+- API-Referenz: `/docs/api.md`
+- Sicherheitsdetails: `/docs/sicherheitsmodell.md`