# Aktuelle Doku-Prüfung: tibi-server und tibi-admin

**Stand:** 2026-10-17  
**Umfang:** `tibi-server`, `tibi-admin-nova` und die dazugehörigen Seiten, Screenshots und Prüfpläne in `tibi-docs`.  
**Ziel:** Restlücken, Darstellungsfehler und konkrete Verbesserungen nachvollziehbar prüfen und abarbeiten.

## Ergebnis in Kürze

Die Dokumentation ist umfangreich und deckt die zentralen Entwickler-, Betreiber-, Admin- und Anwenderabläufe ab. Die alten Auditlisten sind aber nicht überall auf dem aktuellen Stand: die Server-Systemrouten, Meta-Routen, Upload-Allowlist, Suchaggregate, Token-Scopes und Embedding-Gruppen sind inzwischen dokumentiert. Die Screenshots liegen überwiegend an der passenden Stelle. Zwei UI-Motive bleiben bewusst offen, weil sie sich mit dem erlaubten Mock-Projekt nicht erzeugen lassen.

„Alles erfasst“ lässt sich aus dem Coverage-Inventar allein nicht ableiten: Das Inventar ordnet 341 Elemente einer Doku-Seite zu, misst aber keine vollständige Verhaltenstiefe. Im aktuellen Report erreichen die Hook-Funktionen Stufe 4; Routen, MCP-Werkzeuge, Schemas, Komponenten und Test-Pläne stehen auf Zuordnungsstufe 2.

## Befunde und Abarbeitung

### Sprache und UI-Bezeichnungen

- [x] **Startseite verwendete die unpersönliche „man“-Form.** `src/content/docs/index.mdx` sagt jetzt „wie du damit baust“.
- [x] **„Schnellsuche“ als UI-Name entfernt.** Seitentitel, Überschrift und Querverweis heißen jetzt „Befehlspalette“. Der Suchbegriff bleibt nur als Alias in der Referenz.

### Struktur und Prüfbarkeit

- [x] **Lebenden Ausbauplan aktualisiert.** Veraltete Screenshot-/Coverage-Zahlen, doppelte offene Pakete und alte Abschluss-Checkboxen wurden bereinigt; Umfang und Tiefenhinweis sind aktualisiert.
- [x] **Struktur-Auditor präzisiert.** Er sucht jetzt nach konkreten redaktionellen Markern, nicht nach legitimen Begriffen wie „Platzhalter“ oder „noch nicht“.
- [x] **Coverage-Zuordnung als Zuordnung gekennzeichnet.** `plans/doku-ausbau.md` trennt Mapping von vollständiger Verhaltenstiefe.
- [x] **Embedding-Schema ergänzt.** `embedding.schema.json` ist im Coverage-Inventar zugeordnet, in die generierte Property-Referenz aufgenommen und in der Schema-Liste als Serverkonfiguration eingetragen.
- [x] **Schema-Zähler berichtigt.** Der Generator und die ausgegebene Referenz nannten noch 16 statt 17 Schemas; beide Angaben sind nun konsistent.
- [x] **Schema-Zähler in der Fähigkeitsmatrix berichtigt.** Die aktuelle Liste nennt 17 Schemas einschließlich `embedding`; die historische Prüfnachricht vermerkt den alten Stand 16.
- [x] **Stand des Ausbauplans aktualisiert.** Die Kopfzeile nennt jetzt den aktuellen Prüftag.

### Screenshots und Oberflächen

- [x] **Bestand geprüft:** Bilder unter `assets/admin/` und `assets/anwender/` liegen in den passenden Ordnern, haben Alt-Texte und sind kleiner als 200 KB. Keine UI-Aufnahme ist verwaist; Branding-Dateien sind keine Screenshots.
- [x] **Platzierung korrigiert:** Sieben Admin-Screenshots standen erst nach Fehlerabschnitten oder am Seitenende. Die sieben unterschiedlichen Dateien stehen jetzt bei ihren Themen: `admin-filter-voice` (Listenfilter/Mikrofon), `admin-medien` (Bildeditor), `admin-exporte` (Export-Dialog), `admin-eintrags-editor` (Pagebuilder-Editor), `admin-ki-funktionen` (Mikrofon im Chat), `admin-benutzer-rechte` (Benutzerverwaltung) und `admin-customizing` (eigene Exporte).
- [x] **Offene Motive bewertet:** Sitzungshinweis und Suchindex-Hinweisbanner bleiben als redaktionelle Notiz stehen, weil sie im erlaubten Mock-Projekt `corporate` nicht erzeugbar sind. Es gibt keinen Ersatz durch `t1` oder erfundene UI-Zustände.
- [x] **Mock-Änderungen berücksichtigt:** Die Referenzseiten für Aktionen und Custom-Exporte nennen den `corporate`-Mock-Commit `bff84be6`. Die uncommittete Änderung an der Suchindex-Anzeige blieb unangetastet.

### Abgleich mit den Quell-Repositories

- [x] **Veraltete Audit-Befunde gegen den aktuellen Seitenbestand geprüft.** REST-Systemrouten, `_meta`, Upload-MIME-Allowlist, Aggregation, Token-Scopes und Embedding-Gruppen haben aktuelle Dokustellen.
- [x] **Aktuelle Arbeitskopie des Admin-Repos beachtet.** `SearchIndexBuildNotice.svelte` ist lokal geändert. Die Änderung betrifft das Polling bei nicht verfügbaren Sammlungen; sie ist nicht Teil des Commits und wurde nicht überschrieben.

## Arbeitsprotokoll

| Punkt | Ergebnis / Beleg |
|---|---|
| Quellstände | `tibi-server` HEAD `88118b8e`; `tibi-admin-nova` HEAD `bff84be6`. Admin-Arbeitskopie hat zusätzlich eine uncommittete Änderung an `SearchIndexBuildNotice.svelte`. |
| Coverage | Inventar um die 16 unterschiedlichen System-CRUD- und Meta-Pfadformen erweitert; das bisherige `setup.go`-Inventar ließ die DB-API-Routen aus. |
| Coverage-Schema | `embedding.schema.json` war das einzige nicht zugeordnete Schema; es ist nun `server/konfiguration` zugeordnet. |
| Abschlusstests | Coverage 341/341, Schema-Generator 17 Schemas/167 Properties und idempotent, Build 71 Seiten, Doku-Audit 0 Findings. |
| Review | Erstreview fand einen kosmetischen P2 zum Schema-Zähler; Generator und Ausgabe wurden korrigiert. Finalreview bestätigte danach keine offenen P1-/P2-Befunde sowie Screenshot-, Quellen- und Coverage-Angaben. |
| Server-Lücken gegengeprüft | System-CRUD und `_meta`: `reference/rest-system.mdx`; Upload-MIME-Regeln: `server/konfiguration.mdx`; Aggregation: `projekt/abfragen-lesen.mdx`; Token-Scopes: `projekt/rechte-tokens.mdx`; Embedding-Gruppen: `server/konfiguration.mdx` und `server/betrieb.mdx`. |
| Screenshot-Bestand | 67 Bildplatzierungen, 66 eindeutige WebP-Dateien: 17 Admin- und 49 Anwender-Bilder. Alle liegen im passenden Unterordner, haben Alt-Text und sind kleiner als 200 KB. `favicon.svg` und `admin-nova.png` sind keine UI-Screenshots. `seiten-bloecke.webp` wird in zwei passenden Abschnitten derselben Anwender-Seite wiederverwendet. |
| Screenshot-Platzierung | Sieben unterschiedliche Admin-Bilder an die thematisch passenden Abschnitte verschoben. Listen-Mikrofon (`admin-filter-voice`) und Chat-Mikrofon (`admin-ki-funktionen`) sind getrennte Screenshots; Anwender-Bilder standen bereits neben den zugehörigen Schritten. |
| Offene Screenshot-Motive | `anwender/anmelden.mdx`: Inaktivitätsdialog im Mock deaktiviert. `anwender/lesen-suchen-filtern.mdx`: Corporate-Mock hat keine Suchkonfiguration, die das Queue-Banner auslösen könnte. Beides bleibt als Kommentar markiert. |

## Abschluss

- [x] `npm run coverage` weist alle 341 inventarisierten Elemente zu.
- [x] `npm run gen:schemas` erzeugt 17 Schemas mit 167 Properties idempotent.
- [x] `npm run build` ist erfolgreich (71 Seiten).
- [x] `node scripts/audit-docs.mjs` meldet 0 Findings, keine defekten Links, Anker, Bilder, Tabellen oder MDX-Komponenten.
- [x] Änderungen wurden von einem unabhängigen Reviewer geprüft; keine P1-/P2-Befunde.