Files

fs 25370a1a55 add composer-unused, comprehensive docs, and project restructure

- Add icanhazstring/composer-unused as dev dependency for dependency hygiene checks
- Add German documentation (docs/) covering architecture, conventions, workflows, and developer checklists
- Add API layer (ApiAuth, ApiBootstrap, ApiResponse), audit, scheduler, custom fields, and SSO services
- Add Microsoft OIDC SSO, API token management, and user lifecycle features
- Add swagger-ui vendor integration and OpenAPI spec
- Add production Docker setup and bin/ scripts
- Update composer dependencies, config, templates, and frontend assets throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-02-22 15:27:35 +01:00

1.1 KiB

Raw Blame History

REST-API (v1)

Letzte Aktualisierung: 2026-02-21

Single Source of Truth

Die API-Spezifikation wird zentral gepflegt in:

/docs/openapi.yaml

Diese Datei ist die verbindliche technische Referenz für:

Endpunkte
Request-/Response-Schemas
Statuscodes
Auth-Header

API-Doku im Admin

UI: /admin/api-docs
Zugriff: Permission api_docs.view
Quelle der UI: /docs/openapi.yaml
Swagger UI ist read-only (kein Try it out).

Warum diese Seite kurz ist

Diese Seite bleibt bewusst knapp, damit keine doppelte Pflege entsteht.

Alle fachlichen und technischen API-Details stehen nur in /docs/openapi.yaml.

Änderungsprozess (verbindlich)

API-Änderung immer zuerst in /docs/openapi.yaml pflegen.
/admin/api-docs öffnen und Rendering kurz prüfen.
API-Request per Client testen (z. B. Yaak/Postman/cURL).
Nur falls nötig hier in api.md organisatorische Hinweise ergänzen (keine Endpoint-Details).

1.1 KiB Raw Blame History