53 lines
4.1 KiB
Markdown
53 lines
4.1 KiB
Markdown
# 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 (``).
|
||
- 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`; Aktionen/Exporte im Mock seit `tibi-admin-nova` bff84be6). 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).
|