Darstellung: Inline-Code-Chips fuer Dark Mode, 58 Seiten auf .mdx (Komponenten rendern jetzt)
Befund 1 (Nutzer): Inline-Code war im Dark Mode kaum lesbar.
- src/styles/custom.css: eigene Chip-Farben (--tibi-inline-*), Rahmen, nowrap in der ersten Tabellenspalte
- gemessen: Text/Chip 10,2:1 dunkel, 12,4:1 hell
Befund 2 (beim Nachmessen gefunden): 58 Seiten waren .md - Starlight-Komponenten wurden NICHT gerendert
(rohe <Aside>/<Steps>-Tags, import-Zeile als sichtbarer Text auf 57 Seiten).
- alle 58 Seiten auf .mdx umgestellt und MDX-konform gemacht (Imports, Block-Tags in eigenen Zeilen,
HTML-Kommentare -> {/* */}, geschweifte Klammern escaped)
- nachher: 428 Asides, 87 Steps, 158 Tab-Gruppen gerendert, 0 geleakte Imports
- fehlender Import in reference/hooks-daten ergaenzt
Regressionsschutz: audit-docs.mjs prueft jetzt Komponente-ohne-Import, .md-mit-Komponente,
geleakte Imports und rohe Tags im gebauten dist/. AGENTS.md 3 dokumentiert die .mdx-Regel.
Nebenfund: de.json mit ASCII-Umschreibungen -> Issue tibi-admin-nova #6
Build: 71 Seiten gruen, Audit 7 legitime Platzhalter-Marker
This commit is contained in:
apairon committed
1 parent
06c5f0d8ea
commit
dcdb6ee637
64 files changed
+246
-104
No files matched your search
+50
-50
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"generatedAt": "2026-10-17T13:19:19.983Z",
|
||||
"generatedAt": "2026-10-17T13:54:38.079Z",
|
||||
"stats": {
|
||||
"files": 70,
|
||||
"byDir": {
|
||||
@@ -27,60 +27,60 @@
|
||||
"emptyFenceLang": 0,
|
||||
"proseWalls": [],
|
||||
"asciiUmlauts": [
|
||||
"src/content/docs/admin/aktionen.md",
|
||||
"src/content/docs/anwender/aktionen.md",
|
||||
"src/content/docs/projekt/felder-widgets.md",
|
||||
"src/content/docs/projekt/mcp-nutzen.md",
|
||||
"src/content/docs/projekt/navigation-i18n.md",
|
||||
"src/content/docs/projekt/ssr-website.md",
|
||||
"src/content/docs/admin/aktionen.mdx",
|
||||
"src/content/docs/anwender/aktionen.mdx",
|
||||
"src/content/docs/projekt/felder-widgets.mdx",
|
||||
"src/content/docs/projekt/mcp-nutzen.mdx",
|
||||
"src/content/docs/projekt/navigation-i18n.mdx",
|
||||
"src/content/docs/projekt/ssr-website.mdx",
|
||||
"src/content/docs/reference/schema-properties.md"
|
||||
],
|
||||
"hollowMarkers": [
|
||||
"src/content/docs/admin/exporte.md:37 Platzhalter",
|
||||
"src/content/docs/anwender/seiten-bauen.md:45 Platzhalter",
|
||||
"src/content/docs/einstieg/neues-projekt.md:26 Platzhalter",
|
||||
"src/content/docs/einstieg/schnellstart.md:48 noch nicht",
|
||||
"src/content/docs/einstieg/schnellstart.md:21 Platzhalter",
|
||||
"src/content/docs/einstieg/was-ist-tibi.md:11 Platzhalter",
|
||||
"src/content/docs/projekt/deploy.md:26 Platzhalter"
|
||||
"src/content/docs/admin/exporte.mdx:37 Platzhalter",
|
||||
"src/content/docs/anwender/seiten-bauen.mdx:45 Platzhalter",
|
||||
"src/content/docs/einstieg/neues-projekt.mdx:26 Platzhalter",
|
||||
"src/content/docs/einstieg/schnellstart.mdx:48 noch nicht",
|
||||
"src/content/docs/einstieg/schnellstart.mdx:21 Platzhalter",
|
||||
"src/content/docs/einstieg/was-ist-tibi.mdx:11 Platzhalter",
|
||||
"src/content/docs/projekt/deploy.mdx:26 Platzhalter"
|
||||
],
|
||||
"t1Refs": [
|
||||
"src/content/docs/adr/0003-selbstlaeufer.md"
|
||||
],
|
||||
"tibiAdminRefs": [
|
||||
"src/content/docs/admin/aktionen.md (2×)",
|
||||
"src/content/docs/admin/ansichten-listen.md (2×)",
|
||||
"src/content/docs/admin/benutzer-rechte.md (7×)",
|
||||
"src/content/docs/admin/customizing.md (2×)",
|
||||
"src/content/docs/admin/eintrags-editor.md (2×)",
|
||||
"src/content/docs/admin/exporte.md (2×)",
|
||||
"src/content/docs/admin/ki-funktionen.md (3×)",
|
||||
"src/content/docs/admin/konzept.md (4×)",
|
||||
"src/content/docs/admin/medien.md (2×)",
|
||||
"src/content/docs/admin/setup.md (5×)",
|
||||
"src/content/docs/admin/aktionen.mdx (2×)",
|
||||
"src/content/docs/admin/ansichten-listen.mdx (2×)",
|
||||
"src/content/docs/admin/benutzer-rechte.mdx (7×)",
|
||||
"src/content/docs/admin/customizing.mdx (2×)",
|
||||
"src/content/docs/admin/eintrags-editor.mdx (2×)",
|
||||
"src/content/docs/admin/exporte.mdx (2×)",
|
||||
"src/content/docs/admin/ki-funktionen.mdx (3×)",
|
||||
"src/content/docs/admin/konzept.mdx (4×)",
|
||||
"src/content/docs/admin/medien.mdx (2×)",
|
||||
"src/content/docs/admin/setup.mdx (5×)",
|
||||
"src/content/docs/adr/0001-starlight.md (1×)",
|
||||
"src/content/docs/adr/0002-code-schlaegt-doku.md (2×)",
|
||||
"src/content/docs/adr/0003-selbstlaeufer.md (1×)",
|
||||
"src/content/docs/anwender/anmelden.md (5×)",
|
||||
"src/content/docs/anwender/benutzer-teams.md (1×)",
|
||||
"src/content/docs/anwender/exportieren.md (3×)",
|
||||
"src/content/docs/anwender/ki-nutzen.md (1×)",
|
||||
"src/content/docs/anwender/lesen-suchen-filtern.md (1×)",
|
||||
"src/content/docs/anwender/medien.md (1×)",
|
||||
"src/content/docs/anwender/orientierung.md (2×)",
|
||||
"src/content/docs/anwender/seiten-bauen.md (1×)",
|
||||
"src/content/docs/anwender/sichern.md (1×)",
|
||||
"src/content/docs/anwender/anmelden.mdx (5×)",
|
||||
"src/content/docs/anwender/benutzer-teams.mdx (1×)",
|
||||
"src/content/docs/anwender/exportieren.mdx (3×)",
|
||||
"src/content/docs/anwender/ki-nutzen.mdx (1×)",
|
||||
"src/content/docs/anwender/lesen-suchen-filtern.mdx (1×)",
|
||||
"src/content/docs/anwender/medien.mdx (1×)",
|
||||
"src/content/docs/anwender/orientierung.mdx (2×)",
|
||||
"src/content/docs/anwender/seiten-bauen.mdx (1×)",
|
||||
"src/content/docs/anwender/sichern.mdx (1×)",
|
||||
"src/content/docs/einstieg/begriffe.md (4×)",
|
||||
"src/content/docs/einstieg/neues-projekt.md (1×)",
|
||||
"src/content/docs/einstieg/schnellstart.md (1×)",
|
||||
"src/content/docs/einstieg/was-ist-tibi.md (3×)",
|
||||
"src/content/docs/projekt/audit-backup.md (2×)",
|
||||
"src/content/docs/projekt/jobs-actions.md (1×)",
|
||||
"src/content/docs/projekt/navigation-i18n.md (1×)",
|
||||
"src/content/docs/projekt/pagebuilder-dev.md (1×)",
|
||||
"src/content/docs/projekt/sammlungen-anlegen.md (1×)",
|
||||
"src/content/docs/projekt/suche.md (2×)",
|
||||
"src/content/docs/reference/tastatur-kurzbefehle.md (2×)"
|
||||
"src/content/docs/einstieg/neues-projekt.mdx (1×)",
|
||||
"src/content/docs/einstieg/schnellstart.mdx (1×)",
|
||||
"src/content/docs/einstieg/was-ist-tibi.mdx (3×)",
|
||||
"src/content/docs/projekt/audit-backup.mdx (2×)",
|
||||
"src/content/docs/projekt/jobs-actions.mdx (1×)",
|
||||
"src/content/docs/projekt/navigation-i18n.mdx (1×)",
|
||||
"src/content/docs/projekt/pagebuilder-dev.mdx (1×)",
|
||||
"src/content/docs/projekt/sammlungen-anlegen.mdx (1×)",
|
||||
"src/content/docs/projekt/suche.mdx (2×)",
|
||||
"src/content/docs/reference/tastatur-kurzbefehle.mdx (2×)"
|
||||
],
|
||||
"fm_hero": 1,
|
||||
"fm_template": 1
|
||||
@@ -92,43 +92,43 @@
|
||||
},
|
||||
"findings": [
|
||||
{
|
||||
"file": "src/content/docs/admin/exporte.md",
|
||||
"file": "src/content/docs/admin/exporte.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"Platzhalter\": Stehen im Export-Dialog eigene Reiter **vor** dem Standard-Tab, hat das Projekt fertige Berichte in `collectio",
|
||||
"line": 37
|
||||
},
|
||||
{
|
||||
"file": "src/content/docs/anwender/seiten-bauen.md",
|
||||
"file": "src/content/docs/anwender/seiten-bauen.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"Platzhalter\": Die kleine Vorschau benötigt nach der Bildauswahl einen Moment. Ein Platzhalterbild ist in dieser Phase normal",
|
||||
"line": 45
|
||||
},
|
||||
{
|
||||
"file": "src/content/docs/einstieg/neues-projekt.md",
|
||||
"file": "src/content/docs/einstieg/neues-projekt.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"Platzhalter\": ## 2. Platzhalter und Starter-Reste",
|
||||
"line": 26
|
||||
},
|
||||
{
|
||||
"file": "src/content/docs/einstieg/schnellstart.md",
|
||||
"file": "src/content/docs/einstieg/schnellstart.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"noch nicht\": - `project not found` → Projektdateien liegen da, aber das Projekt ist im laufenden tibi-server noch nicht reg",
|
||||
"line": 48
|
||||
},
|
||||
{
|
||||
"file": "src/content/docs/einstieg/schnellstart.md",
|
||||
"file": "src/content/docs/einstieg/schnellstart.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"Platzhalter\": ## 2. Platzhalter ersetzen",
|
||||
"line": 21
|
||||
},
|
||||
{
|
||||
"file": "src/content/docs/einstieg/was-ist-tibi.md",
|
||||
"file": "src/content/docs/einstieg/was-ist-tibi.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"Platzhalter\": - **Projekt-Website (aus `tibi-svelte-starter` geklont):** eigenständige Website auf Tibi-Basis — normale klei",
|
||||
"line": 11
|
||||
},
|
||||
{
|
||||
"file": "src/content/docs/projekt/deploy.md",
|
||||
"file": "src/content/docs/projekt/deploy.mdx",
|
||||
"kind": "hollow",
|
||||
"msg": "Marker \"Platzhalter\": Im Starter stehen Platzhalter (`__PROJECT_NAME__`, `_CUSTOMER_ID_`, `LIVE_URL=https://www`).",
|
||||
"line": 26
|
||||
|
||||
@@ -57,7 +57,7 @@ Jede Fähigkeit von tibi-server / tibi-admin braucht genau eine Dokustelle. Der
|
||||
| jobs (Cron) + actions | projekt/jobs-actions | ✅ |
|
||||
| snapshots + backup/restore | projekt/audit-backup | ✅ |
|
||||
| search (Textindex, RRF-Hybrid, Regenerate) | projekt/suche (+ projekt/sammlungen-anlegen für Index-YAML) | ✅ |
|
||||
| embedding + vectorindex | projekt/suche (Kurzüberblick) | ✅ |
|
||||
| embedding + vectorindex (inkl. Failover-Gruppen, Startprüfung/Quarantäne/Rückkehr, `goldenPath`, Status-Endpunkte) | server/konfiguration (Gruppen im Detail), server/betrieb (Status/Störungen), projekt/suche (Kurzüberblick) | ✅ |
|
||||
| rankfusion (RRF-Formel) | projekt/suche | ✅ |
|
||||
| permissions (public/user/token, Orgs/Teams-Matrix) | projekt/rechte-tokens | ✅ |
|
||||
| filecleanup (automatisch, keine Config-Fläche) | kein eigener Artikel — Einzeiler in server/betrieb prüfen (T-FINISH) | ⏳ |
|
||||
@@ -182,6 +182,7 @@ Vollständige Prüfung von Code und Doku, dann Abarbeitung in Wellen. Übersicht
|
||||
| F | P8 Meta (AGENTS.md, Werkzeuge, Issues) | ✅ |
|
||||
| — | P9 Repo-Hygiene: 5 Alt-Kopien gelöscht (~6,1 GB), 6 mit unpushed Commits behalten | ✅ |
|
||||
| H | Ton: Fehlerabschnitte auf Handbuch-Sprache (Regel in AGENTS.md §1, 12 Anwender-Seiten + 5 Stellen) | ✅ |
|
||||
| I | Darstellung: Inline-Code-Chips für Dark Mode, 58 Seiten auf `.mdx` (Komponenten rendern jetzt), Render-Prüfung im Audit-Skript | ✅ |
|
||||
| — | Issues in den Nachbar-Repos (13) | ✅ tibi-server #42–#48, tibi-admin-nova #2–#5, tibi-types #3/#4 |
|
||||
|
||||
**Neue Werkzeuge:** `scripts/audit-docs.mjs` (Struktur-/Link-/Bildprüfung, `plans/audit-report.json`),
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Offene Punkte in den Nachbar-Repos (bereit zum Anlegen als Issue)
|
||||
|
||||
Stand: 2026-10-17 · **alle 13 Issues sind angelegt** (Gitea, Repos `cms/tibi-server`, `cms/tibi-admin-nova`, `cms/tibi-types`); Nummer je Zeile in der ersten Spalte.
|
||||
Stand: 2026-10-17 · **alle 14 Issues sind angelegt** (Gitea, Repos `cms/tibi-server`, `cms/tibi-admin-nova`, `cms/tibi-types`); Nummer je Zeile in der ersten Spalte.
|
||||
|
||||
Stand: 2026-10-17 (erste Fassung). Alle Punkte sind am Code belegt und aus dem Doku-Audit entstanden
|
||||
(`plans/doku-audit.md`). Je Eintrag: Titel für das Issue, Repo, Beleg, Auswirkung, Vorschlag.
|
||||
@@ -26,6 +26,8 @@ Stand: 2026-10-17 (erste Fassung). Alle Punkte sind am Code belegt und aus dem D
|
||||
| A3 **#4** | Wiederherstellen-Dialog nur bei Änderungen sichtbar | `AuditRestoreDialog.svelte` — Feldauswahl erscheint nur bei ungespeicherten Änderungen, sonst „Keine Änderungen" | Doku muss den Sonderfall erklären; im Audit erwähnt | Hinweistext im UI prüfen |
|
||||
| A4 **#3** | Actions fehlen im Mock-Projekt `corporate` | `frontend/assets/mock/_config/corporate/config.yml` hatte keinen `actions`-Block (nur `t1`) | Screenshots/Reviews ohne aussagekräftiges Demo-Projekt (erledigt in der Doku-Arbeit, s. u.) | übernommen: `actions/reindex-search.yml` + `meta.exports` in `corporate` ergänzt |
|
||||
|
||||
| A5 **#6** | ASCII-Umschreibungen in UI-Texten | `frontend/src/lib/i18n/locales/de.json:178` („ausfuehrbare Methode fuer diese Aktion"), `:194` („vor dem Ausfuehren") | Rechtschreibfehler im deutschen UI; Doku zitiert die Texte wörtlich | Umlaute korrigieren (`ausführbare`, `für`, `Ausführen`) |
|
||||
|
||||
## tibi-types
|
||||
|
||||
| # | Titel | Beleg | Auswirkung | Vorschlag |
|
||||
|
||||
Reference in new issue
Block a user