Wissensdatenbank

Die Wissensdatenbank (KB) speichert strukturiertes Wissen in Markdown-Artikeln und verknuepft sie mit Tickets.

Artikel

Jeder Artikel hat:

Feld	Beschreibung
title	Artikel-Titel
slug	URL-freundlicher Bezeichner (automatisch generiert)
content	Markdown-Inhalt
category	Kategorie (z. B. „Netzwerk", „Anleitungen")
tags	Array von Tags zum Filtern
visibility	internal (nur Agents) oder public (auch Kundenportal)
status	draft, published, archived

Sichtbarkeit

Intern (internal): Nur fuer angemeldete Agents sichtbar. Typisch fuer: Eskalationsverfahren, interne Checklisten, Passwortrichtlinien.

Oeffentlich (public): Erscheint auch im Kundenportal. Typisch fuer: Endbenutzer-Anleitungen, FAQ, bekannte Probleme.

Ticket-Verknuepfung

Artikel koennen mit Tickets verknuepft werden:

• „Known Issue" → referenziert alle betroffenen Incidents
• „How-To" → verknuepft mit dem Change, der die Anleitung erfordert

Verknuepfungen erscheinen:

• Im Wissensdatenbank-Tab des Tickets (alle verknuepften Artikel)
• Im Artikeldetail unter linked_ticket_ids

Suche

• Volltextsuche ueber Titel und Kategorie
• Filter: Status, Sichtbarkeit, Kategorie
• Im Portal: nur veroeffentlichte, oeffentliche Artikel

REST API

GET    /api/v1/kb/articles                    # Liste (filtern, paginieren, suchen)
POST   /api/v1/kb/articles                    # Erstellen
GET    /api/v1/kb/articles/:id                # Detail mit linked_ticket_ids
PUT    /api/v1/kb/articles/:id                # Aktualisieren
DELETE /api/v1/kb/articles/:id                # Loeschen (+ Verknuepfungen)
POST   /api/v1/kb/articles/:id/link/:ticketId # Mit Ticket verknuepfen
DELETE /api/v1/kb/articles/:id/link/:ticketId # Verknuepfung entfernen

Filter-Parameter

GET /api/v1/kb/articles?q=exchange&status=published&visibility=public&category=Netzwerk
GET /api/v1/kb/articles?linked_ticket_id=<uuid>  # Artikel zum Ticket