# GLPI-Knowledgebase-Ingest

Die GLPI-Integration ist read-only. Sie verwendet OAuth-Passwortfluss und die konfigurierte GLPI-API-Version. Sichtbarkeit und Entitätsrechte werden vom verwendeten GLPI-Service-Account durchgesetzt.

## Datenmodell

Jeder GLPI-Beitrag wird zu einem `knowledge`-Node:

```text
GLPI-KB-Beitrag
├── categorized_as ─► GLPI/ITIL-Themenbereich
└── derived_from ───► GLPI Knowledge Base
```

Metadaten enthalten GLPI-ID, KB-Kategorie-IDs, Sprache und Änderungszeit. HTML-Inhalt wird für Embedding und Analyse in Text überführt; der produktive GLPI-Beitrag wird nicht verändert.

## OpenAPI-Pfaderkennung

Mit `GLPI_KB_PATH=auto` wird `/api.php/doc.json` gelesen und die am besten passende lesbare `KnowbaseItem`-Collection gewählt. Für Installationen mit abweichender Route kann ein absoluter API-Pfad gesetzt werden.

## Cache

Der normalisierte GLPI-Teilgraph wird unter `BRAIN_DATA_DIR/glpi-kb-cache.json` gepuffert. Beim Start kann er sofort geladen werden. Aktualisierungen werden über denselben gebündelten Persistenzmechanismus wie der Graph geschrieben.