Files
tibi-docs/plans/t-shots-arbeitsauftrag.md
T
apairon 761466dd63 Abschluss: 13 Issues in den Nachbar-Repos angelegt, Alt-Kopien aufgeraeumt, offene Motive als Hinweis
- Issues: tibi-server #42-#48, tibi-admin-nova #2-#5, tibi-types #3/#4 (mit Beleg und KI-Signatur)
- plans/offene-issues.md: Nummern eingetragen; plans/t-shots-arbeitsauftrag.md: offene Motive mit Code-Begruendung
- P9: 5 Alt-Kopien geloescht (~6,1 GB, nur Yarn-Cache dirty, unpushed=0); 6 Kandidaten behalten (unpushed Commits bzw. Quell-/Doku-Arbeit) - dokumentiert in plans/doku-audit.md 12.1a
- Build gruen, 0 tote Links/Anker/Bilder
2026-10-17 11:51:09 +00:00

4.1 KiB
Raw Blame History

T-SHOTS Arbeitsauftrag: Screenshots für die Anwender-Doku

Verbindlich für den Agenten, der T-SHOTS ausführt. Stand: 2026-10-16.

Eiserne Regeln

  • Mock-Projekt: corporate (Corporate Website). NIEMALS t1 (Test Core — Playwright-Minimalprojekt mit Quatsch-Daten) oder andere Test-Namespaces.
  • Anmeldung im Mock-Admin: admin / admin (siehe frontend/assets/mock/login.json).
  • Admin im Mock-Modus starten (siehe tibi-admin-nova/README.md, Docker-Stack mit Mock-Profil). Kein echter Server nötig.
  • Bilder nach tibi-docs/src/assets/anwender/, max 200 KB pro Datei (komprimieren, z. B. cwebp/pngquant), deutsche Alt-Texte direkt im Markdown (![Alt-Text](...)).
  • 1 Bild pro 3–4 Klicks, exakt an der Stelle des HTML-Kommentars <!-- Screenshot (T-SHOTS): ... --> in der jeweiligen Seite einfügen (Kommentar dabei entfernen).
  • Danach npm run build in tibi-docs — muss grün bleiben.

Warum corporate

frontend/assets/mock/project.json: corporate → „Corporate Website — Hauptwebsite der Firma mit Blog, Team-Seite und Kontaktformular". Sammlungen (_config/corporate/collections/): pages (mit Pagebuilder!), blog, team, navigation, medialib, downloads, redirects, settings. Eigene Block-Registry (corporate-blocks/registry.js + blocks.css) — echte Vorschaubilder statt Platzhalter.

Shot-Liste (je Anwender-Seite)

Seite Motive (in dieser Reihenfolge aufnehmen)
anmelden Login-Formular (leer) → Fehler nach falschem Passwort → eingeloggter Start (Corporate-Projekt sichtbar)
orientierung Start mit Projekt-Übersicht → geöffnetes Corporate-Projekt mit Menü → Schnellsuche (/) mit Ergebnis
lesen-suchen-filtern Corporate-Liste (Tabelle) → Suche mit Treffer → Filter-Popover offen → Karten-Ansicht
eintrag-bearbeiten Neu-Formular (Corporate-Blog) → ausgefülltes Formular → Speicher-Bestätigung → Pflichtfeld-Fehler (Stern)
medien Medien-Raster (Corporate-Bilder) → „Dateien hinzufügen"-Dialog → Upload-Fortschritt → Bildeditor
seiten-bauen Pagebuilder mit Corporate-Blöcken → Block-Auswahl → Vorschau (RowPreview) → veröffentlichte Seite
benutzer-teams „Mein Profil" mit Rolle → Benutzerverwaltung (falls Rolle es zeigt) → Team-Ansicht
exportieren Export-Dialog mit Formatwahl → Spaltenauswahl → fertige Datei
sichern Snapshot-Ansicht (Reiter Snapshots) → Details → Statistik
hilfe Keine Pflicht-Screenshots — nur wo sinnvoll (z. B. echte Fehlermeldung „Keine Berechtigung für diese Aktion")

Ablauf

  1. Mock-Admin starten, als admin/admin anmelden, Projekt Corporate Website wählen.
  2. Motive der Reihe nach aufnehmen (Browser-Screenshots, Desktop-Breite 1440, gleiche Fenstergröße für alle).
  3. Zuschneiden auf Inhalt (keine Browser-Chrome-Ränder außer wo nötig), komprimieren (<200 KB).
  4. In die Seiten einsetzen (Kommentar ersetzen), Alt-Texte deutsch („Anmeldemaske von tibi-admin mit ...").
  5. npm run build prüfen. Abnahme: Testleser erkennt jeden Schritt am Bild wieder.

Bewusst offene Motive (Hinweise für spätere Runden)

Stand 2026-10-17: Alle Anwender- und Admin-Seiten haben mindestens ein Bild (66 Bilder, alle aus corporate). Zwei Motive sind im Mock nicht darstellbar und bleiben als Kommentar-Hinweis in der jeweiligen Seite stehen — bitte nicht „irgendwie" aus t1 oder einem anderen Projekt erzeugen:

Seite Motiv Grund (am Code belegt)
anwender/anmelden.md Hinweisdialog „Sitzung läuft ab" frontend/src/lib/utils/inactivityTracker.ts:47 schaltet den Inaktivitäts-Tracker im Mock-Modus per isMockMode() auf No-op — der Dialog kann offline nie auslösen
anwender/lesen-suchen-filtern.md Hinweis „Suchindex wird aufgebaut" frontend/src/lib/mock/interceptor.ts:3073-3080 liefert _queue > 0 nur bei ngram/vector-Suche plus _searchPending; corporate hat keine search-Config (nur t1/products.json, verboten)

Weitere, inzwischen bebilderte Motive und ihre Belege stehen in plans/doku-audit.md §18 (Wellen E und G).