OpenAPI Spec — Luecken

AUDIT-FIX: L-10 — Endpunkte, die im Code vorhanden sind, aber in docs/api/openapi.yaml fehlen oder veraltet sind.

Spec-Version: 0.3.2 (Tags aktualisiert, einzelne Endpunkt-Definitionen noch ausstehend)

---

Fehlende Endpunkte

Tickets

Methode	Pfad	Hinweise
GET	/api/v1/tickets/stats/timeline	Nach Spec hinzugefuegt
GET	/api/v1/tickets/stats/by-customer	Nach Spec hinzugefuegt
GET	/api/v1/tickets/categories	Kategorie-CRUD
POST	/api/v1/tickets/categories	Kategorie-CRUD
PUT	/api/v1/tickets/categories/{id}	Kategorie-CRUD
DELETE	/api/v1/tickets/categories/{id}	Kategorie-CRUD
PATCH	/api/v1/tickets/{id}/archive	Archiv-Endpunkt
GET	/api/v1/tickets/{id}/children	Eltern-/Kind-Tickets

Assets

Methode	Pfad	Hinweise
GET	/api/v1/assets/graph	Vollstaendiger CMDB-Graph

Workflows

Methode	Pfad	Hinweise
POST	/api/v1/workflows/templates/{id}/steps	Schrittverwaltung
DELETE	/api/v1/workflows/templates/{id}/steps/{sid}	Schrittverwaltung
PUT	/api/v1/workflows/templates/{id}/steps/reorder	Schritt-Neuordnung
GET	/api/v1/workflows/templates/{id}/instances	Vorlagen-Instanzen
GET	/api/v1/workflows/ticket/{ticketId}	Workflow fuer Ticket

SLA (gesamtes Modul fehlt in der Spec)

Methode	Pfad	Hinweise
GET	/api/v1/sla/definitions	SLA-Definition CRUD
POST	/api/v1/sla/definitions
PUT	/api/v1/sla/definitions/{id}
DELETE	/api/v1/sla/definitions/{id}
GET	/api/v1/sla/assignments	SLA-Zuweisung CRUD
POST	/api/v1/sla/assignments
DELETE	/api/v1/sla/assignments/{id}
GET	/api/v1/sla/resolve	SLA-Aufloesung

---

Endpunkte in Spec, aber nicht implementiert

Methode	Pfad	Hinweise
POST	/api/v1/auth/refresh	Token-Refresh nicht implementiert (stateless JWT)
GET	/api/v1/auth/oidc/login	OIDC noch nicht implementiert
GET	/api/v1/auth/oidc/callback	OIDC noch nicht implementiert
GET	/api/v1/assets/search	In GET /assets mit q-Parameter zusammengefuehrt
GET	/api/v1/assets/types	Nicht als separater Endpunkt implementiert

---

Empfehlung

1. Spec-Version auf 0.2.0 erhoehen, um dem Code zu entsprechen
2. Alle fehlenden Endpunkte hinzufuegen
3. Nicht implementierte Endpunkte als x-not-implemented markieren
4. npm run generate-api-docs nach Aktualisierung ausfuehren (sofern Skript funktioniert)