25 Commits

Author SHA1 Message Date
schalli e0d4532327 docs: Version 1.1.0 freigegeben — Unveröffentlicht -> 1.1.0 (2026-09-16), neuer leerer Abschnitt Unveröffentlicht
Tessera CI/CD / Build & Publish Images (push) Successful in 3m6s
Tessera CI/CD / Lint & Type Check (push) Successful in 50s
Tessera CI/CD / Tests (push) Successful in 1m0s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 12:02:35 +02:00
schalli 75ff8bb6f1 docs(quick-260916-dcz): Aenderungsliste abgeschlossen, verifiziert 8/8 und im Browser bewiesen — Zusammenfassung, Verifikation, Aktenstand
Tessera CI/CD / Lint & Type Check (push) Successful in 47s
Tessera CI/CD / Tests (push) Successful in 1m2s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m44s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:43:41 +02:00
schalli c3d8e16eb3 fix(web): fehlende Uebersetzungen — Kalenderquellen-Formular (18 Schluessel), Kalender-Einstellungen (2), Marktplatz (1) in de/en nachgetragen; Changelog Behoben
Tessera CI/CD / Lint & Type Check (push) Successful in 51s
Tessera CI/CD / Tests (push) Successful in 1m41s
Tessera CI/CD / Build & Publish Images (push) Successful in 3m16s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:34:09 +02:00
schalli c5f4adeeed docs(quick-260916-dcz): Betriebshandbuch Kapitel 9 (Changelog-Schritt, Gitea-Release, Seite Was ist neu), Anwender-, Entwicklungs- und CI-Handbuch
Tessera CI/CD / Lint & Type Check (push) Successful in 45s
Tessera CI/CD / Tests (push) Successful in 1m0s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m51s
- Betrieb Kapitel 9: Vorschritt CHANGELOG.md vor dem Tag, automatischer Gitea-Release samt Verhalten bei fehlendem Abschnitt, Erstfreigabe v1.0.0 in der Vergangenheit, vierter Erkennungsweg "Was ist neu"
- Anwender: Satz zur Versionszeile in "Aufbau der Oberflaeche", neuer Abschnitt "Was ist neu" vor den Stolpersteinen, Inhaltsverzeichnis; Abschnitt "Dashboard" (dyv) unangetastet
- Entwicklung: Regel "Aenderungsliste" unter Konventionen und Fallstricke (Bauzeit-Einbettung, Importdisziplin, Kanalregel, Release-Skript)
- CI-Setup (ASCII): REGISTRY_TOKEN mit repository: write, vier Schritte im Job publish, Release je Tag, API-Basis im Job-Container

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:25:10 +02:00
schalli 6940bd05a1 ci(quick-260916-dcz): Gitea-Release je Freigabe-Tag aus CHANGELOG.md (publish-release.sh, idempotent, --dry-run), Schritt in ci.yml
- publish-release.sh: POSIX sh, Entscheidung anhand GITHUB_REF wie publish-images.sh, --tag/--dry-run, Abschnitt per awk, JSON nur per jq --arg, Token nur aus GITEA_TOKEN ueber Header-Datei, GET/tags -> PATCH oder POST, Exit 1 ohne Abschnitt
- ci.yml: vierter Schritt im Job publish mit GITEA_TOKEN aus secrets.REGISTRY_TOKEN ueber env
- Bewiesen: dry-run v1.0.0 (Body 2227 Zeichen), v9.9.9 Exit 1, main nichts zu tun, API-Basis aus GITHUB_SERVER_URL; Docker-Abbild traegt den Changelog nur im Server-Bundle (1/0); Release Tessera 1.0.0 (id 1) angelegt, zweiter Lauf PATCH, genau ein Release

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:24:20 +02:00
schalli ba06db98c5 feat(quick-260916-dcz): CHANGELOG.md, Seite "Was ist neu" mit Kanalfilter, Versionszeile als Link, Bauzeit-Einbettung
- CHANGELOG.md (Wurzel): Unveroeffentlicht (bwo + dyv + diese Seite, 8 Punkte) und 1.0.0 – 2026-09-15 (11 Punkte aus den Handbuechern), Alltagssprache, echte Umlaute
- next.config.ts liest CHANGELOG.md zur Bauzeit nach env.TESSERA_CHANGELOG_MD; .dockerignore-Ausnahme !CHANGELOG.md und COPY-Zeile im Web-Dockerfile
- lib/changelog.ts: filterChangelogForChannel (live ohne Unveroeffentlicht, beta/dev mit "Noch nicht freigegeben (Beta)", leerer Abschnitt ausgeblendet), 10 Tests
- Server-Seite /changelog (MDEditor.Markdown + rehype-sanitize, Hinweis auf Beta, Leer-Text), 3 Tests; Versionszeile ist Link mit aria-label, 2 Tests
- de/en: sidebar.whatsNew und Namensraum changelog; Web-Suite 49/309, tsc 0

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:20:22 +02:00
schalli 0db21627f5 docs(quick-260916-dcz): Plan revidiert (Runde 1) — Bezugspunkt 963fa36, Nachbesserung 260916-dyv in Unveroeffentlicht
Bezugs-Commit aller git-diff-Gates 7a6f42e -> 963fa36; Baseline Web 46/286 -> 47/294
(frisch gemessen), Zielzahlen 48/301 -> 49/309; Unveroeffentlicht = bwo + dyv + Seite
"Was ist neu" als eine Liste (2 Neu + 6 Geaendert) mit eigenem Zaehl-Gate; Hinweis,
dass der dyv-Stand des Dashboard-Abschnitts im Anwenderhandbuch unangetastet bleibt.
Von den 19 Plan-Dateien hat dyv nur de.json/en.json (dragHint) und
anleitung-anwender.md (Abschnitt Dashboard) beruehrt — Einfuegepunkte bleiben gueltig.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:07:09 +02:00
schalli 963fa36cd7 docs(quick-260916-dyv): Nachbesserung abgeschlossen, verifiziert und im Browser bewiesen (Rechner-Minimum korrigiert) — Zusammenfassung, Verifikation, Aktenstand, Ledger #39 fixed
Tessera CI/CD / Lint & Type Check (push) Successful in 48s
Tessera CI/CD / Tests (push) Successful in 1m7s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m43s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 11:03:42 +02:00
schalli 8792819e34 fix(quick-260916-dyv): Rechner-Mindesthoehe 10 statt 9 Zeilen — sechs Tastenreihen, unterste Reihe war bei 9 um 25 px abgeschnitten (Browser-Messung)
Tessera CI/CD / Lint & Type Check (push) Successful in 54s
Tessera CI/CD / Tests (push) Successful in 1m1s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m58s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 10:57:55 +02:00
schalli cf97b5b64b docs(quick-260916-dyv): Anwenderhandbuch — Bearbeiten-Schalter unten rechts, ganze Kachel ziehbar, Mindestgroessen
Tessera CI/CD / Lint & Type Check (push) Successful in 48s
Tessera CI/CD / Tests (push) Successful in 56s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m52s
- Abschnitt Dashboard: Stift-Schalter unten rechts, Haekchen "Aenderungen
  speichern" und "Widget hinzufuegen" daneben
- Ziehen an beliebiger Stelle der Kachel (Eingabefelder, Knoepfe, Links
  ausgenommen), grauer Griff am oberen Rand, Ablegen nur auf freiem Platz
- Mindestgroesse = gerade noch bedienbar; Entfernen-Symbol rechts im Griff

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 10:43:01 +02:00
schalli dbbd54f5a1 feat(quick-260916-dyv): Bearbeiten-Schalter unten rechts (Rand oben 28 px), ganze Kachel als Griff mit Kopfleiste, cancel-Selektor, kein Ueberlappen beim Ablegen
- page.tsx: feste Aktionsleiste `fixed bottom-6 right-6 z-20` mit "Widget
  hinzufuegen" (nur Bearbeitungsmodus) links neben dem Stift/Haekchen; Block
  oben rechts und mt-8-Wrapper entfernt, Grid direkt im Container p-2
  (12 + 8 + 8 = 28 px statt 60 px); page.test.tsx NEU mit 3 Tests
- widget-wrapper.tsx: Karte ist im Bearbeitungsmodus der Griff (cursor-grab),
  20-px-Overlay-Kopfleiste mit Griff-Symbol und Tooltip dragHint, Loesch-Knopf
  in der Kopfleiste mit data-no-drag; Rumpf h-full unveraendert (Hoehenkette)
- dashboard-grid.tsx: WIDGET_DRAG_HANDLE_SELECTOR, WIDGET_DRAG_CANCEL_SELECTOR
  (input, textarea, select, button, a, [contenteditable], [data-no-drag],
  .widgetNoDrag), threshold 3; FREE_PLACEMENT_COMPACTOR = noCompactor +
  preventCollision: true (freie Platzierung bleibt, Commit c8f3361)
- dashboard-grid.test.tsx: Mock per importOriginal (echter noCompactor),
  Tests 6-8 (dragConfig-Pin, Compactor-Pin, cancel/handle-Semantik im DOM)
- edit-mode-toggle.tsx: schwebend (shadow-lg, inaktiv border + bg-card)
- de.json/en.json: widgets.dragHint

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 10:41:49 +02:00
schalli dc992c9bc6 fix(quick-260916-dyv): Mindestgroessen inhaltsgetrieben (kleinste bedienbare Kachel je Typ), gespeicherte Minima ueberschrieben, Stoppuhr-Bedienleiste kompakt
- WIDGET_CONSTRAINTS: Minima aus dem Innenaufbau gerechnet (clock 2/2, search 6/2,
  calendar 3/3, note 4/4, calculator 3/9, favorites 3/3, link 3/2, stopwatch 4/3),
  Vorgaben unveraendert; Test A pinnt alle 32 Werte per toEqual
- dashboard-grid.tsx: effectiveLayouts (useMemo) ueberschreibt minW/minH jedes
  gespeicherten Eintrags in jedem Breakpoint aus den Konstanten und hebt zu
  kleine w/h auf das Minimum an — RGL 2.2.3 nimmt gespeicherte Eintraege
  woertlich (synchronizeLayoutWithChildren) und liest data-grid nur ohne Eintrag
- dashboard-grid.test.tsx: Test 5 angepasst, Test 9 (Ueberschreibung je
  Breakpoint, unbekannter Typ unveraendert) und Test 9b (h 8 -> 9, w >= minW bleibt)
- stopwatch-widget.tsx: Bedienleiste px-2 py-1 text-xs, Zeile gap-1 py-1, damit
  Stop + Runde + Reset in 4 Spalten passen und die Kachel auf 4x3 schrumpfen kann

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 10:37:55 +02:00
schalli ec1b0ce582 docs(quick-260916-dyv): Plan — Dashboard-Nachbesserung: Mindestgroessen inhaltsgetrieben, Schalter unten rechts (Rand 28 px), ganze Kachel als Griff, kein Ueberlappen
Drei Aufgaben, 12 Dateien ausserhalb .planning. Gemessene Abweichungen vom
Auftrag: react-grid-layout 2.2.3 nimmt gespeicherte Layout-Eintraege woertlich
inklusive minW/minH und ignoriert data-grid (zweiter Grund fuer "nicht klein
genug" — Ueberschreibung beim Rendern noetig); die alten 12-Spalten-Minima sind
im feinen Raster nur fuer Uhr/Kalender brauchbar, Suche braucht 6 Spalten,
Rechner 9 Zeilen (heute bei 8 unten abgeschnitten), Stoppuhr nur mit kompakter
Bedienleiste; noCompactor ohne preventCollision springt bei Kollision und laesst
Ueberlappungen stehen (auch beim Vergroessern); cancel gewinnt in react-draggable
4.7.0 auch innerhalb des Griffs; widgetNoDrag ist ein toter Marker aus Phase 8.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 10:29:11 +02:00
schalli df16f4682a docs(quick-260916-dcz): Plan — CHANGELOG.md in Alltagssprache, Seite "Was ist neu" mit Kanalfilter, Gitea-Release je Freigabe-Tag, Handbuecher
Drei Aufgaben, 19 Dateien ausserhalb .planning. Gemessene Abweichungen vom
Auftrag: .dockerignore schliesst Wurzel-*.md aus (Ausnahme !CHANGELOG.md noetig);
localhost:3002 ist aus dem CI-Job-Container nicht erreichbar (API-Basis aus
GITHUB_SERVER_URL); vier Module statt zwei in den Handbuechern. Bauweg per
env.TESSERA_CHANGELOG_MD in next.config.ts (webpack + Turbopack, Server-Bundle-only).
COVERAGE.md: Gitea-Release-API (POST/GET-by-tag/PATCH integriert, Rest begruendet aus).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 10:03:06 +02:00
schalli 7a6f42ea74 docs(quick-260916-bwo): Dashboard-Umbau abgeschlossen, verifiziert 8/8 und im Browser bewiesen — Zusammenfassung, Verifikation, Aktenstand
Tessera CI/CD / Lint & Type Check (push) Successful in 48s
Tessera CI/CD / Tests (push) Successful in 1m6s
Tessera CI/CD / Build & Publish Images (push) Successful in 3m3s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:36:50 +02:00
schalli 1aefaa36c1 docs(quick-260916-bwo): Anwenderhandbuch — feines Raster, Uhrzeit skaliert mit der Kachel, Schriftgroesse in Punkt
Tessera CI/CD / Lint & Type Check (push) Successful in 49s
Tessera CI/CD / Tests (push) Successful in 57s
Tessera CI/CD / Build & Publish Images (push) Successful in 3m34s
- Bearbeitungs-Hinweis: Position und Groesse rasten in feinen Schritten ein
- Uhr-Zeile: Uhrzeit waechst mit der Kachel, feste Schriftgroesse in Punkt unter Einstellungen > Dashboard
- Satz zu den Widget-Einstellungen nennt die Uhr (Zeitzone und Schriftgroesse)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:15:03 +02:00
schalli a175c00c18 feat(quick-260916-bwo): Abstaende halbiert — Seitenrahmen p-3 (alle Seiten), Dashboard p-2, Grid 8 px, Widget-Innenabstaende
- app-shell.tsx: main p-3 (12 px statt 24) — gilt fuer alle Seiten, Nachtrag des Users
- page.tsx: Container relative p-2, Umschalter right-2 top-2; mt-8 bleibt (Umschalter 36 px hoch, sonst Ueberlappung)
- link/favorites p-1, calendar p-1.5 (Zustandsansichten p-2), search px-1.5, note-Kopfzeile px-1.5
- Grid-Abstand 8 px bereits in Task 1, Uhr/Stoppuhr/Rechner-Innenabstaende bereits in 2a

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:13:23 +02:00
schalli 2d8efe1a97 feat(quick-260916-bwo): Widget-Inhalt skaliert per Container-Queries (Uhr, Stoppuhr, Rechner), Punktgroesse der Uhrzeit einstellbar
- widget-wrapper.tsx: Rumpf ist Groessen-Container (@container-size) fuer cqw/cqh
- clock-font-size.ts (neu): Grenzen 8..200, resolveClockTimeFontSizePt nur fuer endliche Zahlen (T-BWO-01)
- clock-widget.tsx: Container-Query-Klassen mit clamp(), data-font-mode auto/fixed, Inline-pt nur bei Zahl, keine vw-Formel mehr, p-1
- stopwatch-widget.tsx: Anzeige per Container-Query, p-1.5; calculator-widget.tsx: Anzeige und Tasten skalieren, Tasten h-full min-h-7, p-1
- widget-settings-panel.tsx: Zahlenfeld Schriftgroesse der Uhrzeit (Blur/Enter, leer = automatisch, Fehlermeldung ausserhalb 8..200)
- de.json/en.json: widgets.clock.fontSizeLabel/fontSizeAuto/fontSizeHint/fontSizeInvalid (Sie-Form, Waechter gruen)
- Tests: Uhr +4, Stoppuhr +1, Rechner +1, widget-settings-panel.test.tsx neu (4)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:12:02 +02:00
schalli 3f5afb0f54 feat(quick-260916-bwo): Dashboard-Raster verdoppelt (24 Spalten, 20 px, 8 px Abstand), Konstanten x2, einmalige Umrechnung gespeicherter Anordnungen mit Marker __gridVersion
- dashboard-grid.tsx: COLS 24/20/12/8/2, rowHeight 20, margin 8 (containerPadding folgt), Rueckfallwerte 4
- widget-registry.tsx: alle 32 Werte in WIDGET_CONSTRAINTS verdoppelt
- grid-layout-migration.ts (neu): migrateGridLayouts/withGridVersion, Marker nur im JSON, Idempotenz (T-BWO-02)
- dashboard-store.ts: Umrechnung beim Laden, Sofort-Speichern mit Marker, withGridVersion bei jedem saveLayout
- Tests: Migration 7 (neu), Store 6 (neu), Registry +1 (Tabelle), Grid +2 (Props ueber Mock), API-Spec +2 (Durchreichung __gridVersion, timeFontSizePt)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:09:00 +02:00
schalli 50f201ecc1 docs(quick-260916-bwo): Plan — fails_when je Verify-Block ergaenzt (Pruefer-Warnung)
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:02:47 +02:00
schalli 7eb2516278 docs(quick-260916-bwo): Plan fuer Dashboard — feineres Raster, skalierende Widget-Inhalte, halbe Abstaende
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-16 09:00:26 +02:00
schalli 5f50c5faa0 docs: Todo — Desktop-Client auslieferungsreif machen (Versions-Check, Windows-Installer, Abnahme, CI-Bau)
Tessera CI/CD / Lint & Type Check (push) Successful in 44s
Tessera CI/CD / Tests (push) Successful in 52s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m48s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-15 21:40:15 +02:00
schalli 18170d690b docs: v1.0.0 live auf tessera.ctl.de seit 2026-09-15 — Stand festgehalten, nichts offen
Tessera CI/CD / Lint & Type Check (push) Successful in 47s
Tessera CI/CD / Tests (push) Successful in 57s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m44s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-15 16:25:42 +02:00
schalli 7d201a82ab docs: IMAGE_TAG, COMPOSE_FILE und TESSERA_BUGREPORT_TO in die Vorlage .env.prod.example aufgenommen; Handbuch-Hinweis angepasst
Tessera CI/CD / Lint & Type Check (push) Successful in 49s
Tessera CI/CD / Tests (push) Successful in 56s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m47s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-15 09:12:40 +02:00
schalli db2e2c83fe docs: Erstfreigabe v1.0.0 festgehalten — Zweig live, CI 332/333/334 gruen, Registry live/v1.0.0; Tagesabschluss 2026-09-14
Tessera CI/CD / Lint & Type Check (push) Successful in 47s
Tessera CI/CD / Tests (push) Successful in 56s
Tessera CI/CD / Build & Publish Images (push) Successful in 2m46s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
2026-09-14 17:39:48 +02:00
62 changed files with 4789 additions and 163 deletions
+3
View File
@@ -5,4 +5,7 @@ dist
.git
.env
*.md
# quick-260916-dcz: Wurzel-Markdown bleibt draussen, nur diese eine Datei braucht der Web-Bau
# (apps/web/next.config.ts liest sie zur Bauzeit, COPY im Web-Dockerfile).
!CHANGELOG.md
coverage
+15
View File
@@ -7,8 +7,18 @@ DATABASE_URL=postgresql://tessera:change-me-strong-password@db:5432/tessera
# App
APP_URL=https://tessera.deine-domain.de
# Generate with: openssl rand -hex 32
JWT_SECRET=change-me-64-char-random-string
# Auslieferungskanal (siehe Betriebshandbuch, Kapitel 9):
# beta = alle Neuerungen sofort (Teststellung)
# live = nur freigegebene Versionen mit Nummer (Produktivbetrieb)
# Fehlt die Zeile, nimmt die Compose-Datei "beta".
IMAGE_TAG=live
# Damit auf dem Server ein schlichtes "docker compose ..." genuegt,
# ohne jedes Mal "-f docker-compose.prod.yml" anzugeben.
COMPOSE_FILE=docker-compose.prod.yml
# Admin account (created on first start)
TESSERA_ADMIN_USER=admin
TESSERA_ADMIN_EMAIL=admin@deine-domain.de
@@ -29,3 +39,8 @@ TESSERA_ENCRYPTION_KEY=
# TESSERA_SMTP_USER=
# TESSERA_SMTP_PASSWORD=
# TESSERA_SMTP_FROM=Tessera <noreply@deine-domain.de>
# Fehlermeldungen (optional): Rueckfall-Postfach fuer den Knopf "Fehler melden",
# falls unter Administrator > SMTP kein Feld "Fehlermeldungen an" gesetzt ist.
# Leer = nur die Einstellung in der Oberflaeche gilt.
# TESSERA_BUGREPORT_TO=
+155
View File
@@ -0,0 +1,155 @@
#!/bin/sh
# publish-release.sh -- Gitea-Release je Freigabe-Tag aus CHANGELOG.md anlegen
# (quick-260916-dcz).
#
# Entscheidung wie publish-images.sh allein anhand GITHUB_REF:
# refs/tags/vX.Y.Z -> Abschnitt "## X.Y.Z" aus CHANGELOG.md schneiden und als
# Release "Tessera X.Y.Z" anlegen (bzw. aktualisieren, wenn
# der Release zum Tag schon existiert -- idempotent)
# alles andere -> nichts zu tun (Exit 0)
#
# Aufrufformen:
# sh .gitea/scripts/publish-release.sh # im CI, Tag aus GITHUB_REF
# sh .gitea/scripts/publish-release.sh --tag v1.0.0 # lokal, expliziter Tag
# sh .gitea/scripts/publish-release.sh --dry-run --tag v1.0.0 # nur JSON und Ziel zeigen
#
# Umgebung:
# GITEA_TOKEN Zugriffstoken (Pflicht im echten Lauf; im CI aus secrets.REGISTRY_TOKEN
# ueber `env`). Wird nie ausgegeben und nie als Argument uebergeben --
# der Authorization-Header kommt aus einer temporaeren Datei.
# GITEA_API API-Basis; sonst GITHUB_API_URL, sonst GITHUB_SERVER_URL/api/v1,
# sonst http://localhost:3002/api/v1 (nur lokal erreichbar).
# GITEA_REPO owner/repo; sonst GITHUB_REPOSITORY, sonst schalli/tessera-ctl.
# CHANGELOG_FILE Pfad zur Aenderungsliste; Vorgabe CHANGELOG.md.
#
# Fehlt der Abschnitt fuer die Version, endet das Skript mit Exit 1 -- es entsteht
# nie ein leerer Release. JSON wird ausschliesslich mit jq gebaut.
set -eu
usage() {
echo "Aufruf: publish-release.sh [--dry-run] [--tag vX.Y.Z]" >&2
}
DRY_RUN=0
TAG=""
while [ $# -gt 0 ]; do
case "$1" in
--dry-run) DRY_RUN=1 ;;
--tag)
[ $# -ge 2 ] || { usage; exit 2; }
TAG="$2"
shift
;;
*) usage; exit 2 ;;
esac
shift
done
if [ -z "$TAG" ]; then
REF="${GITHUB_REF:-}"
case "$REF" in
refs/tags/v*) TAG="${REF#refs/tags/}" ;;
*)
echo "Kein Freigabe-Tag (nur refs/tags/v*): nichts zu tun."
exit 0
;;
esac
fi
if ! echo "$TAG" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
echo "Ungueltiger Tag '$TAG' (erwartet vX.Y.Z)." >&2
exit 1
fi
VERSION="${TAG#v}"
API="${GITEA_API:-${GITHUB_API_URL:-${GITHUB_SERVER_URL:+${GITHUB_SERVER_URL}/api/v1}}}"
API="${API:-http://localhost:3002/api/v1}"
API="${API%/}"
REPO="${GITEA_REPO:-${GITHUB_REPOSITORY:-schalli/tessera-ctl}}"
echo "Gitea-API: $API Repo: $REPO Tag: $TAG"
CHANGELOG="${CHANGELOG_FILE:-CHANGELOG.md}"
if [ ! -f "$CHANGELOG" ]; then
echo "$CHANGELOG nicht gefunden." >&2
exit 1
fi
command -v jq >/dev/null 2>&1 || { echo "jq fehlt." >&2; exit 1; }
# Abschnitt "## X.Y.Z" bis zur naechsten "## "-Ueberschrift, ohne die eigene
# Ueberschrift; danach fuehrende und abschliessende Leerzeilen entfernen.
BODY=$(awk -v ver="$VERSION" '
BEGIN { esc = ver; gsub(/\./, "\\.", esc); pat = "^## " esc "( |$)" }
$0 ~ pat { f = 1; next }
/^## / { if (f) exit }
f { print }
' "$CHANGELOG" | awk '
{ line[NR] = $0; if ($0 !~ /^[[:space:]]*$/) last = NR }
END { for (i = 1; i <= last; i++) print line[i] }
' | sed '1{/^$/d}')
if [ -z "$BODY" ]; then
echo "$CHANGELOG hat keinen Abschnitt fuer Version $VERSION (erwartet eine Zeile '## $VERSION – <Datum>'). Kein Release ohne Text." >&2
exit 1
fi
NAME="Tessera $VERSION"
CREATE_JSON=$(jq -n --arg tag "$TAG" --arg name "$NAME" --arg body "$BODY" \
'{tag_name: $tag, name: $name, body: $body, draft: false, prerelease: false}')
UPDATE_JSON=$(jq -n --arg name "$NAME" --arg body "$BODY" '{name: $name, body: $body}')
RELEASES_URL="$API/repos/$REPO/releases"
TAG_URL="$API/repos/$REPO/releases/tags/$TAG"
if [ "$DRY_RUN" -eq 1 ]; then
echo "Probelauf (kein Netzaufruf):"
echo " POST $RELEASES_URL"
echo " PATCH $RELEASES_URL/<id> (falls GET $TAG_URL bereits 200 liefert)"
printf '%s\n' "$CREATE_JSON"
exit 0
fi
if [ -z "${GITEA_TOKEN:-}" ]; then
echo "Kein Zugriffstoken in der Umgebung gesetzt (siehe Kopfkommentar)." >&2
exit 1
fi
umask 077
TMPDIR_REL=$(mktemp -d)
trap 'rm -rf "$TMPDIR_REL"' EXIT INT TERM
HDR="$TMPDIR_REL/headers"
RESP="$TMPDIR_REL/response.json"
JSONFILE="$TMPDIR_REL/payload.json"
printf 'Authorization: token %s\nContent-Type: application/json\n' "$GITEA_TOKEN" > "$HDR"
CODE=$(curl -sS --header @"$HDR" -o "$RESP" -w '%{http_code}' "$TAG_URL")
case "$CODE" in
200)
ID=$(jq -r .id "$RESP")
printf '%s' "$UPDATE_JSON" > "$JSONFILE"
CODE=$(curl -sS --header @"$HDR" -X PATCH --data @"$JSONFILE" -o "$RESP" -w '%{http_code}' "$RELEASES_URL/$ID")
if [ "$CODE" = "200" ]; then
echo "Release $TAG aktualisiert (id $ID)"
else
echo "PATCH $RELEASES_URL/$ID antwortete mit $CODE:" >&2
cat "$RESP" >&2
exit 1
fi
;;
404)
printf '%s' "$CREATE_JSON" > "$JSONFILE"
CODE=$(curl -sS --header @"$HDR" -X POST --data @"$JSONFILE" -o "$RESP" -w '%{http_code}' "$RELEASES_URL")
if [ "$CODE" = "201" ]; then
echo "Release $TAG angelegt (id $(jq -r .id "$RESP"))"
else
echo "POST $RELEASES_URL antwortete mit $CODE:" >&2
cat "$RESP" >&2
exit 1
fi
;;
*)
echo "GET $TAG_URL antwortete mit $CODE:" >&2
cat "$RESP" >&2
exit 1
;;
esac
+6
View File
@@ -1,6 +1,7 @@
# Kanalmodell (quick-260914-ku1): main -> Kanal beta (Etiketten beta + latest);
# Tag v* -> Kanal live (Etiketten live + vX.Y.Z); Zweig live ohne Tag wird nur geprueft.
# Die Entscheidung trifft .gitea/scripts/publish-images.sh anhand GITHUB_REF.
# Tag v* (quick-260916-dcz): zusaetzlich Gitea-Release aus dem CHANGELOG.md-Abschnitt (publish-release.sh).
name: Tessera CI/CD
on:
@@ -66,3 +67,8 @@ jobs:
- name: Versionsstempel berechnen, Abbilder bauen und veroeffentlichen
run: sh .gitea/scripts/publish-images.sh
- name: Gitea-Release zum Freigabe-Tag anlegen (nur bei Tags v*)
env:
GITEA_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
run: sh .gitea/scripts/publish-release.sh
+15 -9
View File
@@ -4,11 +4,11 @@ milestone: v1.2
current_phase: 17
current_phase_name: eigene-ausschreibungs-quellen-je-nutzer
status: verified
stopped_at: "2026-09-14: Quick 260914-m97 Fehler-melden-Knopf ausgefuehrt (4 Commits 54121c1/60b0ee8/b41be21/77117de gepusht, CI-Lauf 299 nach Rerun success, :beta-Abbilder mit 77117de beta); offen: Browser-Check mit mailhog durch den Verifizierer, danach Erstfreigabe v1.0.0"
last_updated: "2026-09-14T15:08:28.980Z"
last_activity: 2026-09-14
stopped_at: Quick 260916-dcz ausgefuehrt (3/3 Tasks, CI 356 success, Release Tessera 1.0.0 id 1) — Browser-Nachweis durch Orchestrator offen
last_updated: "2026-09-16T09:32:51.778Z"
last_activity: 2026-09-16
last_activity_desc: Quick 260910-jab — drei zu kurz greifende RLS-Regeln geschlossen (GroupMembership beide Seiten, ModuleGrant beide Ziele, TenderRssFeedSource Lese-/Schreibsplit), listForUser gebunden, Aktenstand kohaerent
state_head: 77117de3d0f1bb82df7b659f46fe26244ca6f164
state_head: c5f4adeeed4bc858171323a5b4c3866ee991f560
progress:
total_phases: 17
completed_phases: 15
@@ -31,7 +31,7 @@ See: .planning/PROJECT.md (updated 2026-07-17)
Phase: 17 (eigene-ausschreibungs-quellen-je-nutzer) — VERIFIED / passed
Plan: 3 of 3
Status: Phase abgeschlossen und im Browser gegengeprueft — bereit fuer /gsd-ship
Last activity: 2026-09-14 - Fehler-melden-Knopf (260914-m97, verifiziert 9/9 + Browser), Zwei Kanaele + Versionsstempel (260914-ku1, 8/8), Etappe 3c (260914-eym, 9/9), WINDOWS #29 (260914-ebg, 6/6). Naechster Schritt: Zweig live + Tag v1.0.0
Last activity: 2026-09-16 - Aenderungsliste (260916-dcz: CHANGELOG.md, Seite "Was ist neu", Gitea-Release je Tag, Release v1.0.0 angelegt) + Uebersetzungs-Nachtrag c3d8e16; Beta-Abbild c3d8e16 bereit. Freigabe der naechsten Version (1.1.0) auf Zuruf des Users: CHANGELOG Unveroeffentlicht -> 1.1.0, live ff-merge, Tag, Push
Progress: [██████████] 100%
@@ -344,7 +344,10 @@ Gerettet aus `.continue-here.md`. Relevant fuer die noch offenen Live-Tests.
### Pending Todos
None yet.
- [2026-08-11] [module-registry] Jeder Mandanten-Admin kann sich jedes Modul selbst freischalten — Aktivierung ohne Lizenzpruefung — [todo file](.planning/todos/pending/2026-08-11-modulaktivierung-ohne-lizenzpruefung.md)
- [2026-09-07] [web/branding] Administrator kann das Aussehen branden — eigenes Logo und eigene Farben je Mandant — [todo file](.planning/todos/pending/2026-09-07-mandanten-branding-logo-und-farben.md)
- [2026-09-14] [module-registry] Lizenzmodell — Betreiber gibt Modul je Server mit Lizenzanzahl frei, Firmenadmin lizenziert an bis zu N … — [todo file](.planning/todos/pending/2026-09-14-lizenzmodell-freigabe-je-server-mit-lizenzanzahl.md)
- [2026-09-15] [desktop] Desktop-Client auslieferungsreif machen — Versions-Check, Windows-Installer, Abnahme, CI-Bau — [todo file](.planning/todos/pending/2026-09-15-desktop-client-auslieferungsreif-machen.md)
### Blockers/Concerns
@@ -404,6 +407,9 @@ None yet.
| 260914-eym | **Etappe 3c — Systemkontext fuer die Hintergrunddienste.** Migration `20260914120000_rls_system_context_read`: `is_system_context()`, fuenf permissive `system_read_policy ... FOR SELECT` (DkvModuleConfig, LdapConfig, LdapFieldMapping, TenderMatch, TenderSavedSearch); `forSystem(prisma)` in Array-Form mit ausdruecklichem Zuruecksetzen von Mandant/Benutzer, `forTenant()` setzt `app.system_context` zurueck (kein Erben, gemessen). Sechs Faelle: DKV-Planer einmal-abfragen-viele-bedienen (Auftrag je Mandant, WINDOWS #21 fixed); Mail-Transport je Versand aus der SmtpConfig des Empfaenger-Mandanten mit unveraenderter Umgebungs-Rueckfallkette, Startpfad und Mailer-Fabrik entfallen (WINDOWS #30 fixed, SmtpConfig ohne Systemregel); ldap `getAllActiveConfigs()` und Boot-Nachverschluesselung lesen ueber Systemkontext, schreiben je Mandant gebunden; tender-digest Kandidaten und tender-matching Suchprofile ueber Systemkontext, Schleifen gebunden; admin-seed nur dokumentiert (Tenant ohne Regel). Detektor mit fuenfter Erkennungsform `forSystem(` und exakter Erlaubnisliste (falsifiziert: Fremddatei 1 rot, Zweitaufruf 2 rot). Werkzeug 203 -> 253 (`runSystemContextChecks`: ungebunden 0 / System beide Mandanten / Schreiben abgewiesen 42501 bzw. count 0 / kein Erben / pg_policies 34, 5x SELECT). Rueckbau (a) 5 rot mit gelungenem Insert, (b) 1 rot, (c1) 253 gruen + (c2) 5 rot, (d) 2/3 rot. Tests 1028 -> 1054 / 62 -> 64 Dateien, tsc 0, 29 Dateien gegen 5e0e408, Schalter AUS (Compose/.env/Schema/Lockfile unveraendert). Klassifikation 61/179/5, 72 Paare, sechs Zeilen `system-gebunden`; Kritikschrift (y1)-(y5); Auftrag 3c Erledigt. Ledger 15 offen / 1 zurueckgestellt / 21 geschlossen / 37 gesamt; NEU #37 (prozessweiter Single-Flight-Riegel `processInbox`). Verifiziert 9/9, gepusht. | 2026-09-14 | 3d64567,6e2a641,939c812 | [260914-eym-mandantentrennung-etappe-3c-systemkontex](./quick/260914-eym-mandantentrennung-etappe-3c-systemkontex/) |
| 260914-ku1 | **Zwei Auslieferungskanaele und Versionsstempel.** `main` = Beta (Etiketten `beta` + `latest`), Tag `vX.Y.Z` = Live (Etiketten `live` + `vX.Y.Z`), Zweig `live` ohne Tag nur geprueft — Entscheidung in `.gitea/scripts/publish-images.sh` (`--print-plan`), CI-Trigger `branches: [main, live]` + `tags: [v*]`, `fetch-depth: 0`. Versionsstempel `APP_VERSION/APP_CHANNEL/APP_COMMIT/APP_BUILD_TIME` als Build-Args in beide Dockerfiles (web zur Bauzeit als `NEXT_PUBLIC_APP_*`, api als Laufzeit-ENV; Vorgabe `dev`). `GET /health/version` liefert name/version/channel/commit/buildTime, Startlog `Tessera API vX (channel) commit`. Web: `app-version.ts`, `AppVersionBadge` in `sidebar.tsx` (sidebar-footer.tsx ist seit ba02b25 toter Code). `docker-compose.prod.yml`: `image: ...:${IMAGE_TAG:-beta}`. Betriebshandbuch Kapitel 9 (Zwei Kanaele, Freigabe, Hotfix ohne Datenbankaenderung, neuer Live-Server), ci-cd-setup.md auf gemessenen Stand. Falsifiziert: Build mit `v9.9.9-test live` -> Stempel in dist und Web-Bundle, ohne Args `dev`. Echter CI-Lauf 297 gruen (5:18 min), Abbilder `beta`/`latest` tragen `ea6aa99 beta`. Tests API 1054 -> 1060 / 64 -> 65 Dateien, Web 233 -> 243 / 38 -> 40, tsc 0, 20 Dateien gegen 6c19451. Offen: Zweig `live` + Tag `v1.0.0` nach dem Fehler-melden-Knopf anlegen; Handgriffe fuer den User (IMAGE_TAG je Server) im SUMMARY. Verifiziert 8/8, gepusht. | 2026-09-14 | cdb571c,9731501,ea6aa99 | [260914-ku1-zwei-auslieferungskanaele-beta-auf-main-](./quick/260914-ku1-zwei-auslieferungskanaele-beta-auf-main-/) |
| 260914-m97 | **Fehler-melden-Knopf.** Kaefer-Knopf in der Kopfzeile: Bildschirmfoto VOR dem Dialog (`html-to-image` 1.11.13, laengste Kante 1600 px, `computeCaptureSize`), Dialog mit Vorschau, Haekchen und "Was ist passiert?"; Fehlerpuffer (Ringpuffer 20: window.onerror, unhandledrejection, console.error, fehlgeschlagene fetch-Antworten — keine Ruempfe/Cookies/Tokens); `POST /bug-reports` als Multipart (FileInterceptor 4 MiB -> 413, PNG-Signatur -> 400, kein Empfaenger -> 409, Drossel 5/10 min -> 429, Versandfehler -> 502; Mandant/Benutzer nur aus der Sitzung); E-Mail mit PNG-Anhang und Kontext (URL, Web-/API-Version+Kanal+Commit, Browser, Fenster, Zeitpunkt, Benutzer, letzte Fehler) ueber `MailService.sendBugReport` (Anhaenge; Kennwort-Reset bleibt verschluckend). Empfaenger: neue nullable Spalte `SmtpConfig.bugReportRecipient` (Migration `20260914170000`), Feld "Fehlermeldungen an" unter Administrator -> SMTP, Rueckfall `TESSERA_BUGREPORT_TO` (docker-compose.prod.yml). Handbuecher Anwender/Administration/Betrieb. Tests API 1060 -> 1076 / 67 Dateien, Web 243 -> 260 / 43 Dateien, tsc 0, `--frozen-lockfile` 0, 35 Dateien gegen 5c42c55, vier Commits. CI-Lauf 299 gruen (zweiter Versuch, erster scheiterte an Gitea-DB). Browser-Beweis durch den Orchestrator: E-Mail mit 85-KB-PNG (ohne Dialog, OKLCH korrekt) in mailhog, 409-Pfad im Dialog. Ledger #38 (Rule-1-Fix `@Expose()`) als fixed. Verifiziert 9/9 + Browser, gepusht. | 2026-09-14 | 54121c1,60b0ee8,b41be21,77117de | [260914-m97-fehler-melden-knopf-bildschirmfoto-der-a](./quick/260914-m97-fehler-melden-knopf-bildschirmfoto-der-a/) |
| 260916-bwo | **Dashboard — feineres Raster, skalierende Widget-Inhalte, halbe Abstaende.** Raster verdoppelt (COLS 24/20/12/8/2, rowHeight 20, margin 8; WIDGET_CONSTRAINTS x2), gespeicherte Anordnungen einmalig x2 mit Marker `__gridVersion: 2` (nur im JSON, `migrateGridLayouts`/`withGridVersion`, idempotent). Widget-Rumpf `container-type: size`; Uhr/Stoppuhr/Rechner skalieren per Container-Queries; Uhr mit `timeFontSizePt` (leer = automatisch, 8..200 = fest in pt) und Feld in Einstellungen -> Dashboard -> Widgets. Abstaende halbiert: `app-shell` p-6 -> p-3 (alle Seiten, User-Nachtrag), Dashboard p-2, Grid 8 px, Widget-Innenabstaende; `mt-8` bleibt (Umschalter-Hoehe). Anwenderhandbuch. Tests Web 260 -> 286 / 46 Dateien, API 1076 -> 1078, tsc 0, 29 Dateien gegen 5f50c5f, vier Commits, CI-Lauf 351 gruen, Beta-Abbild `v1.0.0-10-g1aefaa3`. Browser-Beweis durch den Orchestrator: SQL-Probe in alten Einheiten -> DB verdoppelt + Marker; Rand 28 px (vorher 56), Abstand 8 px (vorher 16), main 12 px; Uhr 51 px -> 107 px beim Vergroessern; 36 pt = 48 px fest. Verifiziert 8/8 + Browser, gepusht. | 2026-09-16 | 3f5afb0,2d8efe1,a175c00,1aefaa3 | [260916-bwo-dashboard-feineres-raster-spalten-und-ze](./quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/) |
| 260916-dyv | **Dashboard-Nachbesserung nach User-Test.** Mindestgroessen inhaltsgetrieben (clock 2/2, search 6/2, calendar 3/3, note 4/4, calculator 3/10 — vom Orchestrator im Browser von 9 auf 10 korrigiert, sechs Tastenreihen —, favorites 3/3, link 3/2, stopwatch 4/3 mit kompakter Bedienleiste), gespeicherte Layout-Eintraege bekommen minW/minH aus den Konstanten und zu kleine w/h werden angehoben (`applyConstraintMinima`, Test 9/9b). Bearbeiten-Schalter in feste Leiste unten rechts, `mt-8` weg: Rand oben 28 px statt 60. Drag & Drop: ganze Kachel als Griff mit Overlay-Kopfleiste, `dragConfig.cancel` (Eingaben, Knoepfe, .widgetNoDrag, Resize-Griff), `preventCollision: true` mit `noCompactor` (Ablegen auf belegtem Raum stoppt am Nachbarn, kein Ueberlappen). Anwenderhandbuch. Tests Web 286 -> 294 / 47 Dateien, API 67/1078, tsc 0, 12 Dateien gegen df16f46 + Fix 8792819; CI-Laeufe 353 und der Fix-Lauf gruen. Browser-Beweis: 28 px, Uhr 126x48, Ziehen an Kachelmitte, Suchfeld ohne Drag, Kollision stoppt, Rechner 272 px ohne Ueberlauf. Ledger #39 fixed. Verifiziert 6/6 + Browser, gepusht. | 2026-09-16 | dc992c9,dbbd54f,cf97b5b,8792819 | [260916-dyv-dashboard-nachbesserung-mindestgroessen-](./quick/260916-dyv-dashboard-nachbesserung-mindestgroessen-/) |
| 260916-dcz | **Aenderungsliste.** `CHANGELOG.md` (Keep-a-Changelog, Alltagssprache, echte Umlaute: `## Unveröffentlicht` mit Neu/Geändert/Behoben, `## 1.0.0 – 2026-09-15` mit 11 Punkten); Seite "Was ist neu" unter `/changelog` (Server-Komponente, Text zur Bauzeit ueber `env.TESSERA_CHANGELOG_MD` in next.config.ts, nur im Server-Bundle; Kanalfilter `filterChangelogForChannel`: live ohne Unveroeffentlicht, beta/dev markiert; `MDEditor.Markdown` + `rehypeSanitize`), Versionsabzeichen als Link; Dockerfile `COPY CHANGELOG.md` + `.dockerignore !CHANGELOG.md`; `.gitea/scripts/publish-release.sh` (awk-Abschnitt, jq, API-Basis aus GITHUB_*, POST/PATCH, --dry-run, Exit 1 ohne Abschnitt) + ci.yml-Schritt nur bei Tag-Refs; Gitea-Release `v1.0.0` rueckwirkend angelegt (id 1); Handbuecher (Betrieb Kap. 9, Anwender "Was ist neu", Entwicklung, CI). Tests Web 294 -> 309 / 49 Dateien, API 67/1078, tsc 0, 19 Dateien gegen 963fa36; CI 356/357 gruen. Nachtrag c3d8e16: 21 fehlende Uebersetzungen (Kalenderquellen-Formular, Kalender-Einstellungen, Marktplatz) in de/en, Changelog "Behoben". Browser-Beweis: /changelog mit 20 Punkten, Kalender-Formular ohne Schluesselnamen. Verifiziert 8/8 + Browser, gepusht. | 2026-09-16 | ba06db9,6940bd0,c5f4ade,c3d8e16 | [260916-dcz-aenderungsliste-changelog-md-in-alltagss](./quick/260916-dcz-aenderungsliste-changelog-md-in-alltagss/) |
## Deferred Items
@@ -445,8 +451,8 @@ sind. Kein Anlass, sie vorher erneut vorzulegen.
## Session Continuity
Last session: 2026-09-14T15:08:28.744Z
Last session: 2026-09-16T09:32:51.449Z
Resumed: 2026-09-14 — Sitzung ueber /gsd-resume-work fortgesetzt; #29 und 3c als /gsd-quick --validate mit voller Kette durchgefuehrt.
Stopped at: 2026-09-14: Quick 260914-m97 Fehler-melden-Knopf ausgefuehrt (4 Commits 54121c1/60b0ee8/b41be21/77117de gepusht, CI-Lauf 299 nach Rerun success, :beta-Abbilder mit 77117de beta); offen: Browser-Check mit mailhog durch den Verifizierer, danach Erstfreigabe v1.0.0
Stopped at: **2026-09-16, drei Quick-Tasks + Nachtrag: Dashboard-Umbau (260916-bwo), Dashboard-Nachbesserung (260916-dyv), Aenderungsliste (260916-dcz), fehlende Uebersetzungen (c3d8e16).** Alles verifiziert, im Browser bewiesen, gepusht; Beta-Abbild `c3d8e16` in der Registry, alpha holt es per pull. Live bleibt v1.0.0. NAECHSTER SCHRITT auf Zuruf des Users ("Version freigeben"): CHANGELOG.md `## Unveröffentlicht` -> `## 1.1.0 – <Datum>` + neues leeres Unveroeffentlicht, `git checkout live && git merge --ff-only main && git tag -a v1.1.0 -m "Tessera 1.1.0" && git push origin live v1.1.0` (Rezept docs/anleitung-betrieb.md Kap. 9; die Pipeline legt den Gitea-Release an — erster echter CI-Beweis des Release-Wegs). Offen ohne Dringlichkeit: Desktop-Client-Todo, Ship Phase 17, Ledger #35/#36/#37. Mandantenfaehigkeit RUHT. Schalter AUS. Einstieg: `/gsd-resume-work`.
Resume file: None
Last activity: 2026-09-14 - Completed quick task 260914-m97: Fehler-melden-Knopf mit Bildschirmfoto per E-Mail, Empfaenger unter Administrator -> SMTP
Last activity: 2026-09-16 - Completed quick task 260916-dcz: Aenderungsliste — CHANGELOG.md, Seite Was ist neu, Gitea-Release
+17 -3
View File
@@ -2,9 +2,9 @@
schema_version: 1
open_count: 15
waived_count: 1
fixed_count: 22
total_count: 38
last_updated: 2026-09-14T15:17:38.808Z
fixed_count: 23
total_count: 39
last_updated: 2026-09-16T09:00:26.845Z
---
# Broken Windows Ledger
@@ -53,6 +53,7 @@ last_updated: 2026-09-14T15:17:38.808Z
| 36 | quick-260914-ebg | deviation | apps/web/src/app/(portal)/admin/users/page.tsx | | handleSubmit und handleDelete pruefen nur res.ok ohne else-Zweig und fangen mit leerem catch - ein 403 der API fuehrt zu keiner sichtbaren Reaktion (Formular bleibt offen, Loeschdialog bleibt stehen, keine Meldung). Bestehendes Verhalten fuer alle 403-Wege (fremder Mandant, Selbstloeschung); seit 260914-ebg (WINDOWS #29) ist der Fall fuer einen ADMIN im Alltag erreichbar, weil die SUPER_ADMIN-Zeile in der eigenen Benutzerliste steht und Aendern/Loeschen darauf jetzt 403 liefert. Familie der still verschluckten Antworten (#28, #32). Frontend von 260914-ebg NICHT geaendert (ausserhalb der Erlaubnisliste). Zu schliessen: Fehlermeldung aus dem Antwortrumpf anzeigen und die Aktionsknoepfe fuer SUPER_ADMIN-Zeilen einem ADMIN gar nicht erst anbieten. | open | | 2026-09-14T08:38:12.619Z | |
| 37 | quick-260914-eym | deviation | apps/api/src/dkv/dkv.service.ts | | Der Single-Flight-Riegel processing in DkvService.processInbox ist EIN prozessweites Boolean, nicht je Mandant. Seit 260914-eym laeuft je aktivem Mandanten ein eigener Cron-Auftrag (dkv-inbox-poll:<tenantId>); ueberschneiden sich zwei Ticks verschiedener Mandanten, bricht der zweite still ab (Warnzeile 'already processing') und der Mandant wartet bis zum naechsten Intervall - kein Datenverlust, Verzoegerung; mit EINEM Mandanten unveraendert. Der Tick blieb in 3c laut Auftrag unangetastet (T-EYM-09, accept mit Aufzeichnung). Zu schliessen: Riegel je Mandant (Set<tenantId>) mit Test 'zwei Mandanten gleichzeitig, beide werden bedient'. | open | | 2026-09-14T09:51:24.295Z | |
| 38 | quick-260914-m97 | deviation | apps/api/src/bug-reports/dto/bug-report.dto.ts | 71 | Rule 1: @Expose() auf errors ergaenzt, damit die @Transform-Normalisierung auch bei ganz fehlendem Multipart-Feld greift (class-transformer transformiert nur vorhandene Schluessel) | fixed | | 2026-09-14T15:04:31.846Z | 2026-09-14T15:17:38.808Z |
| 39 | quick-260916-dyv | deviation | apps/web/src/components/dashboard/dashboard-grid.test.tsx | | Test 7 pinnt Identitaets-Kopie per toMatchObject statt toEqual (cloneLayoutItem normalisiert moved/static) | fixed | | 2026-09-16T08:48:45.783Z | 2026-09-16T09:00:26.845Z |
````json
[
@@ -515,6 +516,19 @@ last_updated: 2026-09-14T15:17:38.808Z
"recorded_at": "2026-09-14T15:04:31.846Z",
"resolved_at": "2026-09-14T15:17:38.808Z",
"milestone": "v1.2"
},
{
"id": 39,
"kind": "deviation",
"phase": "quick-260916-dyv",
"file": "apps/web/src/components/dashboard/dashboard-grid.test.tsx",
"line": null,
"description": "Test 7 pinnt Identitaets-Kopie per toMatchObject statt toEqual (cloneLayoutItem normalisiert moved/static)",
"status": "fixed",
"reason": "",
"recorded_at": "2026-09-16T08:48:45.783Z",
"resolved_at": "2026-09-16T09:00:26.845Z",
"milestone": "v1.2"
}
]
````
@@ -0,0 +1,339 @@
---
phase: quick-260916-bwo
plan: 01
type: execute
wave: 1
depends_on: []
autonomous: true
requirements: [QUICK-260916-BWO]
files_modified:
- apps/web/src/components/dashboard/dashboard-grid.tsx
- apps/web/src/components/dashboard/dashboard-grid.test.tsx
- apps/web/src/components/dashboard/widget-registry.tsx
- apps/web/src/components/dashboard/widget-registry.test.tsx
- apps/web/src/lib/grid-layout-migration.ts
- apps/web/src/lib/grid-layout-migration.test.ts
- apps/web/src/lib/stores/dashboard-store.ts
- apps/web/src/lib/stores/dashboard-store.test.ts
- apps/api/src/dashboard/dashboard.service.spec.ts
- apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
- apps/web/src/components/dashboard/widgets/clock-font-size.ts
- apps/web/src/components/dashboard/widgets/clock-widget.tsx
- apps/web/src/components/dashboard/widgets/clock-widget.test.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx
- apps/web/src/components/dashboard/widgets/calculator-widget.tsx
- apps/web/src/components/dashboard/widgets/calculator-widget.test.tsx
- apps/web/src/components/settings/widget-settings-panel.tsx
- apps/web/src/components/settings/widget-settings-panel.test.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- apps/web/src/components/dashboard/widgets/link-widget.tsx
- apps/web/src/components/dashboard/widgets/favorites-widget.tsx
- apps/web/src/components/dashboard/widgets/calendar-widget.tsx
- apps/web/src/components/dashboard/widgets/search-widget.tsx
- apps/web/src/components/dashboard/widgets/note-widget.tsx
- apps/web/src/app/(portal)/page.tsx
- apps/web/src/components/layout/app-shell.tsx
- docs/anleitung-anwender.md
estimate:
tokens: 120000
raw_tokens: 120000
tasks: 3
confidence: low
must_haves:
truths:
- "Das Dashboard-Raster ist doppelt so fein wie heute: `Responsive` bekommt `cols={{ lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 }}`, `rowHeight={20}`, `margin={[8, 8]}` (containerPadding folgt dem margin — gemessen in react-grid-layout 2.2.3 `chunk-WGL5FSZH.mjs:676` `effectiveContainerPadding = containerPadding ?? margin`); `BREAKPOINTS` unveraendert. Jedes der 32 Felder in `WIDGET_CONSTRAINTS` ist exakt das Doppelte des heutigen Werts (Tabelle im Test festgenagelt: clock 4/4/4/4, search 6/4/12/4, calendar 6/6/8/12, note 4/6/6/8, calculator 4/8/6/10, favorites 4/6/6/10, link 4/4/4/4, stopwatch 4/4/6/6 in der Reihenfolge minW/minH/defaultW/defaultH). Die Grid-Props sind im Test ueber den `react-grid-layout`-Mock lesbar (Mock faengt die Props von `Responsive` ein), und ein Widget ohne gespeicherten Eintrag bekommt `data-grid` `{ x: 0, y: 0, w: 4, h: 4, minW: 4, minH: 4 }` (clock)."
- "Gespeicherte Anordnungen in ALTEN Einheiten (12 Spalten / 40 px) verrutschen nicht: die reine Funktion `migrateGridLayouts(raw)` in `apps/web/src/lib/grid-layout-migration.ts` liefert `{ layouts, migrated }`; ohne Marker werden `x, y, w, h` und — falls numerisch vorhanden — `minW, minH, maxW, maxH` jedes Elements in JEDEM Breakpoint mit 2 multipliziert (`migrated: true`), mit Marker `__gridVersion >= 2` bleibt alles unveraendert (`migrated: false`), leere Anordnungen bleiben leer (`migrated: false`, kein Speichern noetig), und der Marker steht NIE im zurueckgegebenen `layouts`-Objekt (der Store iteriert mit `Object.keys` ueber die Breakpoints und ruft `.filter` auf jedem Wert — ein Fremdschluessel wuerde dort abstuerzen). Idempotenz: `migrateGridLayouts(withGridVersion(migrateGridLayouts(alt).layouts))` ist gleich `migrateGridLayouts(alt)` und `migrated: false`. `withGridVersion(layouts)` haengt `__gridVersion: 2` an, ohne die Eingabe zu veraendern."
- "Der Store (`dashboard-store.ts`) wendet `migrateGridLayouts` in `loadDashboard` an, setzt den Zustand OHNE Marker, und speichert bei `migrated === true` SOFORT ueber `api.saveLayout(withGridVersion(layouts))` (Fehler beim Speichern werden protokolliert, der Zustand bleibt umgerechnet, kein Fehlerzustand); JEDER Speichervorgang (`saveLayout`) sendet `withGridVersion(get().layouts)`, damit der Marker nach dem ersten Speichern persistiert und die Verdopplung genau einmal geschieht. `addWidget` legt neue Eintraege mit den verdoppelten `defaultW/defaultH` an. Die API bleibt unveraendert: `SaveLayoutDto` (`@IsObject()`) und `getLayout` (`return record.layouts`) reichen den Fremdschluessel `__gridVersion` durch, `updateWidgetConfig` (`{ ...widget.config, ...dto.config }`) reicht `timeFontSizePt` (Zahl oder `null`) durch — beides in `dashboard.service.spec.ts` gepinnt."
- "Der Inhalt von Uhr, Stoppuhr und Rechner skaliert mit der Widgetgroesse: der Widget-Rumpf in `widget-wrapper.tsx` ist ein Groessen-Container (`@container-size`, Tailwind 4.3.1 -> `container-type: size`, kompiliert nachgemessen), und die grossen Zahlen tragen Container-Query-Schriftgroessen als Tailwind-Klassen mit `clamp()`-Grenzen: Uhr-Zeit `text-[clamp(12px,min(20cqw,50cqh),400px)]` mit `leading-none`, Uhr-Datum `text-[clamp(10px,min(8cqw,20cqh),160px)]`, Stoppuhr-Anzeige `text-[clamp(14px,min(16cqw,35cqh),400px)]` mit `leading-none`, Rechner-Anzeige `text-[clamp(14px,min(8cqw,10cqh),96px)]`, Rechner-Tasten `text-[clamp(11px,min(4cqw,4.5cqh),40px)]` (Ziffern/Operatoren/Gleich) bzw. `text-[clamp(10px,min(3.2cqw,3.6cqh),32px)]` (Funktionstasten), Tasten `h-full min-h-7` statt fester Hoehe, damit das Tastenraster mitwaechst. Die Fensterbreiten-Formeln (`vw`) sind aus Uhr und Stoppuhr verschwunden. NICHT skaliert (bewusst, im SUMMARY als Annahme benannt): note, calendar, favorites, link, search — Listen und Formulare zeigen bei mehr Platz mehr Inhalt, nicht groessere Schrift."
- "Uhr: Punktgroesse einstellbar. Neues Config-Feld `timeFontSizePt`; `resolveClockTimeFontSizePt(config)` in `clock-font-size.ts` liefert die Zahl nur, wenn `typeof === 'number'`, endlich und `8 <= n <= 200` (`CLOCK_FONT_SIZE_MIN_PT = 8`, `CLOCK_FONT_SIZE_MAX_PT = 200`), sonst `null` = automatisch; Zeichenketten, NaN, Infinity, 7, 201, null, undefined -> `null`. Gesetzt -> `<time>` traegt `style.fontSize === '36pt'` (Test liest `style`) und `data-font-mode=\"fixed\"`, das Datum `style.fontSize === '14.4pt'` (Faktor 0.4); nicht gesetzt -> kein Inline-Style (`style.fontSize === ''`), `data-font-mode=\"auto\"`, `className` enthaelt `cqw` und `cqh`. Nur eine Zahl wird je zu `${n}pt` — kein Zeichenketten-Wert erreicht jemals den Style (T-BWO-01)."
- "Einstellungen -> Dashboard -> Widgets, Uhr: Zahlenfeld `#clock-font-size` (`type=\"number\"`, `min=8`, `max=200`, `step=1`, Platzhalter „automatisch“) mit Label `widgets.clock.fontSizeLabel` und Hilfetext `widgets.clock.fontSizeHint` (Sie-Form, Alltagssprache); Uebernahme bei Blur oder Enter: leer -> `updateWidgetConfig(id, { timeFontSizePt: null })`, ganze/dezimale Zahl 8..200 -> `{ timeFontSizePt: n }`, sonst Meldung `widgets.clock.fontSizeInvalid` (`role=\"alert\"`) und KEIN Aufruf. Vier Schluessel unter `widgets.clock` in de.json und en.json an derselben Stelle; der Umlaut-Waechter bleibt gruen ohne Aenderung an `umlaut-dictionary.ts` (Wortlaut zur Planungszeit gegen den Waechter geprueft: kein Treffer)."
- "Abstaende halbiert: `app-shell.tsx` `main` `p-3` (12 px, vorher 24 — gilt fuer ALLE Seiten, Nachtrag des Users); Dashboard `page.tsx` Container `relative p-2`, Umschalter `right-2 top-2`; Grid margin/containerPadding 8 statt 16; Innenabstaende der Widget-Ruempfe halbiert (clock p-1, stopwatch p-1.5, calculator p-1, link p-1, favorites p-1, calendar p-1.5 und Zustandsansichten p-2, search px-1.5, note Kopfzeile px-1.5). `mt-8` vor dem Grid BLEIBT (gemessen: der Umschalter ist 36 px hoch — `p-2` plus 20-px-Symbol — und liegt mit `top-2` bei 8..44 px; mit `mt-4` begaenne das erste Widget bei 8+16+8 = 32 px, also 12 px UNTER dem Umschalter; mit `mt-8` bei 48 px, 4 px Abstand). Ergebnis im Browser (lg, Bounding-Boxen): Abstand vom linken Rand des `main` zum ersten Widget 12+8+8 = 28 px (vorher 24+16+16 = 56), Abstand zwischen zwei benachbarten Widgets 8 px (vorher 16), oben 12+8+32+8 = 60 px (vorher 88)."
- "Baseline am Ende: Web `Test Files 46 passed (46)` / `Tests 286 passed (286)` (Planungszeit 43/260 plus 7 Migration + 6 Store + 4 Uhr + 1 Konstanten + 2 Grid + 1 Stoppuhr + 1 Rechner + 4 Einstellungen = 26 neue in 3 neuen und 5 bestehenden Dateien), API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)` (1076 plus 2), `tsc --noEmit` in shared, api und web je Exit 0; `git diff --stat 5f50c5f -- . ':!.planning'` nennt genau `29 files changed`; kein Schema, keine Migration, `.env*`, `docker-compose*.yml`, `pnpm-lock.yaml`, `apps/web/package.json`, `apps/api/src/dashboard/dashboard.service.ts` und `apps/api/src/dashboard/dto/` unangetastet; vier Commits (Task 2 in zwei Teilen 2a/2b) mit Scope `quick-260916-bwo`, gepusht, CI-Lauf beobachtet."
artifacts:
- "apps/web/src/components/dashboard/dashboard-grid.tsx — `COLS = { lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 }`, `rowHeight={20}`, `margin={[8, 8] as [number, number]}`; Kopfkommentar (deutsch, ASCII) erklaert die Verdopplung und den Verweis auf `grid-layout-migration.ts`"
- "apps/web/src/components/dashboard/dashboard-grid.test.tsx — `Responsive`-Mock faengt die Props ueber `vi.hoisted` ein; +2 Tests (Grid-Props; `data-grid`-Vorgaben eines Widgets ohne gespeicherten Eintrag)"
- "apps/web/src/components/dashboard/widget-registry.tsx — alle 32 Werte verdoppelt, Kommentar `// quick-260916-bwo: Raster verdoppelt (24 Spalten / 20 px), Werte = altes Doppel`"
- "apps/web/src/components/dashboard/widget-registry.test.tsx — +1 Test mit der exakten Tabelle (`toEqual` je Typ) und der Zusatzpruefung, dass jeder Wert gerade ist"
- "apps/web/src/lib/grid-layout-migration.ts — NEU: `GRID_VERSION = 2`, `GRID_VERSION_KEY = '__gridVersion'`, `GRID_SCALE_FACTOR = 2`, Typen `GridLayoutItem`/`GridLayouts`, `migrateGridLayouts(raw: unknown): { layouts: GridLayouts; migrated: boolean }`, `withGridVersion(layouts: GridLayouts): Record<string, unknown>`; Kopfkommentar (deutsch, ASCII) mit dem Warum (einmalige Umrechnung, Marker, Idempotenz, kein Schema)"
- "apps/web/src/lib/grid-layout-migration.test.ts — NEU, 7 Tests"
- "apps/web/src/lib/stores/dashboard-store.ts — `loadDashboard` mit Umrechnung und Sofort-Speichern, `saveLayout` mit `withGridVersion`"
- "apps/web/src/lib/stores/dashboard-store.test.ts — NEU, 6 Tests (`@/lib/dashboard-api` gemockt, Zustand je Test zurueckgesetzt)"
- "apps/api/src/dashboard/dashboard.service.spec.ts — +2 Tests: `__gridVersion` ueberlebt `saveLayout` -> `getLayout`; `updateWidgetConfig` reicht `timeFontSizePt: 36` und danach `null` durch"
- "apps/web/src/components/dashboard/widgets/widget-wrapper.tsx — Rumpf-`div` mit `@container-size h-full`"
- "apps/web/src/components/dashboard/widgets/clock-font-size.ts — NEU: Konstanten und `resolveClockTimeFontSizePt` (reine Funktion, von Widget UND Einstellungsformular benutzt — eine Quelle fuer die Grenzen)"
- "apps/web/src/components/dashboard/widgets/clock-widget.tsx — Container-Query-Klassen, `data-font-mode`, Inline-`pt` nur bei Zahl, Rumpf `p-1`"
- "apps/web/src/components/dashboard/widgets/clock-widget.test.tsx — +4 Tests"
- "apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx — Anzeige mit Container-Query-Klasse, Rumpf `p-1.5`; stopwatch-widget.test.tsx +1"
- "apps/web/src/components/dashboard/widgets/calculator-widget.tsx — Anzeige und Tasten mit Container-Query-Klassen, Tasten `h-full min-h-7`, Rumpf `p-1`; calculator-widget.test.tsx +1"
- "apps/web/src/components/settings/widget-settings-panel.tsx — `ClockConfig` mit Zahlenfeld, Hilfetext, Fehlermeldung"
- "apps/web/src/components/settings/widget-settings-panel.test.tsx — NEU, 4 Tests"
- "apps/web/src/messages/de.json + en.json — `widgets.clock.fontSizeLabel`, `fontSizeAuto`, `fontSizeHint`, `fontSizeInvalid`"
- "apps/web/src/components/dashboard/widgets/link-widget.tsx, favorites-widget.tsx, calendar-widget.tsx, search-widget.tsx, note-widget.tsx — nur halbierte Aussen-Innenabstaende (Tabelle in Task 2, Teil 2b)"
- "apps/web/src/app/(portal)/page.tsx — `relative p-2`, `right-2 top-2`, `mt-8` bleibt"
- "apps/web/src/components/layout/app-shell.tsx — `main` mit `p-3`"
- "docs/anleitung-anwender.md — Uhr-Zeile (Uhrzeit skaliert, Schriftgroesse in Punkt einstellbar), Satz zu den Widget-Einstellungen nennt die Uhr, Bearbeitungs-Hinweis auf das feine Raster"
key_links:
- "Marker AUSSERHALB des Zustands, INNERHALB des gespeicherten JSON: `migrateGridLayouts` entfernt `__gridVersion` aus `layouts`, `withGridVersion` haengt ihn beim Speichern wieder an. Fehlt der Marker beim Speichern, wird beim naechsten Laden ERNEUT verdoppelt — deshalb pinnt der Store-Test, dass JEDER `api.saveLayout`-Aufruf `__gridVersion: 2` traegt (T-BWO-02)."
- "`onLayoutChange(allLayouts)` von react-grid-layout liefert `{ ...layoutsRef.current, [breakpoint]: newLayout }` (gemessen `chunk-WGL5FSZH.mjs:1380`) — also genau die Schluessel des `layouts`-Props plus den aktuellen Breakpoint; da der Zustand markerfrei ist, kommt auch ueber diesen Weg kein Marker in den Zustand."
- "`container-type: size` braucht eine von aussen bestimmte Hoehe: der Rumpf ist `h-full` in der Karte (`h-full w-full`), die Karte fuellt das RGL-Element mit expliziter Pixelhoehe — die Kette ist definit, `cqh` loest auf. Ohne diese Kette waere `cqh` 0 und die Uhr unsichtbar klein; deshalb steht die Klasse am RUMPF (Kind der Karte), nicht an der Karte selbst (die im Bearbeitungsmodus zusaetzlich den 6-px-Griff enthaelt)."
- "jsdom (cssstyle in jsdom 29.1.1) VERWIRFT `clamp()`/`min()` in `style.fontSize` (gemessen: `''`), behaelt aber `36pt`, `22cqmin` und `var(...)` — deshalb liegen die automatischen Groessen in Tailwind-KLASSEN (jsdom behaelt `className` woertlich, der Browser bekommt echtes CSS) und nur die feste Punktgroesse im Inline-Style. Der Test liest fuer 'auto' die Klasse und `data-font-mode`, fuer 'fixed' `style.fontSize`."
- "Tailwind 4 findet Klassen nur als Literale im Quelltext: die Container-Query-Klassen stehen woertlich im JSX (oder als String-Konstante in derselben Datei), nie zusammengesetzt."
- "Grenzen 8..200 leben in `clock-font-size.ts` und werden vom Formular UND vom Widget benutzt — ein per API eingeschleuster Wert ausserhalb (die API prueft Config-Felder nicht, `@IsObject()`) faellt im Widget auf 'automatisch' zurueck, nie in den Style (T-BWO-01)."
- "`umlaut-guard.spec.ts` prueft `de.json` case-sensitiv gegen `UMLAUT_ALLOWLIST` (`lassen` steht darauf, `Lassen` nicht; `passt` nicht) — der Wortlaut unten ist so gewaehlt, dass kein neues Wort anfaellt; weicht der Executor ab, muss er das Woerterbuch ergaenzen (dann 30 Dateien, im SUMMARY begruenden)."
---
<objective>
Das Dashboard-Raster wird doppelt so fein (24 statt 12 Spalten, 20 statt 40 px Zeilenhoehe, 8 statt 16 px Abstand), gespeicherte Anordnungen werden GENAU EINMAL in die neuen Einheiten umgerechnet und markiert, der Inhalt von Uhr, Stoppuhr und Rechner skaliert per CSS-Container-Queries mit der Widgetgroesse, die Uhrzeit bekommt eine optionale feste Punktgroesse (Einstellungen -> Dashboard -> Widgets), und die Abstaende zu den Raendern werden halbiert — im Dashboard UND im aeusseren Seitenrahmen (`app-shell.tsx`, alle Seiten, Nachtrag des Users).
Purpose: Der User empfindet das Raster als zu grob, die Uhrzeit als starr (heute skaliert sie mit der FENSTERbreite, nicht mit dem Widget) und die Raender als zu breit. Alles drei ist reine Frontend-Arbeit ohne Schema; der einzige riskante Punkt ist die Umrechnung bestehender Anordnungen, die nicht verrutschen duerfen.
Output: 29 Dateien (1 API-Spec, 27 Web, 1 Handbuch), vier Commits (Task 2 in zwei Teilen 2a/2b) mit Scope `quick-260916-bwo`, gepusht, CI-Lauf beobachtet. Browser-Nachweis durch den Verifizierer/Orchestrator (Playwright MCP, lokale Container) inklusive SQL-Probe der Umrechnung.
</objective>
<execution_context>
@~/.claude/gsd-core/workflows/execute-plan.md
@~/.claude/gsd-core/templates/summary.md
</execution_context>
<context>
@.planning/STATE.md
@apps/web/src/components/dashboard/dashboard-grid.tsx
@apps/web/src/components/dashboard/dashboard-grid.test.tsx
@apps/web/src/components/dashboard/widget-registry.tsx
@apps/web/src/components/dashboard/widget-registry.test.tsx
@apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
@apps/web/src/components/dashboard/widgets/clock-widget.tsx
@apps/web/src/components/dashboard/widgets/clock-widget.test.tsx
@apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
@apps/web/src/components/dashboard/widgets/calculator-widget.tsx
@apps/web/src/components/settings/widget-settings-panel.tsx
@apps/web/src/lib/stores/dashboard-store.ts
@apps/web/src/lib/dashboard-api.ts
@apps/web/src/lib/error-buffer.test.ts
@apps/web/src/app/(portal)/page.tsx
@apps/web/src/components/layout/app-shell.tsx
@apps/web/src/messages/umlaut-guard.spec.ts
@apps/api/src/dashboard/dashboard.service.ts
@apps/api/src/dashboard/dashboard.service.spec.ts
@docs/anleitung-anwender.md
<planning_measurements>
Zur Planungszeit (2026-09-16, HEAD `5f50c5f`, Arbeitsbaum sauber, main == origin/main) gemessen — die Ausfuehrung misst erneut; diese Zahlen sind der Bezugspunkt der Gates:
- Baseline frisch nachgemessen: Web `Test Files 43 passed (43)` / `Tests 260 passed (260)`; API `Test Files 67 passed (67)` / `Tests 1076 passed (1076)`; `tsc --noEmit` in `packages/shared`, `apps/api`, `apps/web` je Exit 0. Testzahlen der beruehrten Dateien: dashboard-grid 3, widget-registry 3, clock 2, stopwatch 7, calculator 6; `widget-settings-panel.tsx` und `dashboard-store.ts` haben KEINEN Test. Lokal laufen `tessera-ctl-web-1` (3000), `tessera-ctl-api-1` (3001, healthy), `tessera-ctl-db-1` (IP `172.19.0.2`, kein Host-Port), `tessera-ctl-mailhog-1`, `gitea` (3002) und `gitea-runner`; die Web-/API-Abbilder sind 39 Stunden alt — fuer den Browser-Nachweis ist `docker compose up -d --build web` Pflicht (Erinnerung: `up` allein baut nicht neu).
- **Heutige Konstanten (Ist):** `dashboard-grid.tsx` Zeile 13-14 `BREAKPOINTS = { lg: 1200, md: 996, sm: 768, xs: 480, xxs: 0 }`, `COLS = { lg: 12, md: 10, sm: 6, xs: 4, xxs: 1 }`; Zeile 77-78 `rowHeight={40}`, `margin={[16, 16]}`; `containerPadding` wird nicht gesetzt. `widget-registry.tsx` Zeile 36-44: clock 2/2/2/2, search 3/2/6/2, calendar 3/3/4/6, note 2/3/3/4, calculator 2/4/3/5, favorites 2/3/3/5, link 2/2/2/2, stopwatch 2/2/3/3 (minW/minH/defaultW/defaultH). Keine weiteren Verbraucher von `defaultW/defaultH/minW/minH` ausserhalb `widget-registry`, `dashboard-grid`, `dashboard-store` (grep).
- **react-grid-layout 2.2.3 (gemessen im dist):** `ResponsiveLayouts = Partial<Record<string, Layout>>` (`types-jd8MiKM1.d.ts:436`) — ein Fremdschluessel mit Zahlwert ist typwidrig; zur Laufzeit greift `Responsive` nur per `layouts[breakpoint]` zu und spreadet `...layouts` (`chunk-KDANGDDL.mjs:524-540`, `chunk-WGL5FSZH.mjs:1380/1411`), iteriert also NICHT ueber Fremdschluessel. Aber der eigene Store iteriert (`Object.keys(newLayouts)` + `.filter`/Spread in `addWidget`/`removeWidget`, dashboard-store.ts 64-76, 94-96) — ein Zahlwert unter `__gridVersion` wuerde dort mit `filter is not a function` abstuerzen. **Entscheidung:** Marker im persistierten JSON (`layouts`-Spalte, Json, kein Schema), im Zustand NIE (Store entfernt ihn beim Laden, haengt ihn beim Speichern an). `effectiveContainerPadding = containerPadding ?? margin` (`chunk-WGL5FSZH.mjs:676`); Spaltenbreite `(containerWidth - margin[0]*(cols-1) - containerPadding[0]*2)/cols` (`chunk-76RTO6EO.mjs:2-5`). Gespeicherte Elemente aus `onLayoutChange` tragen `i, x, y, w, h, minW, maxW, minH, maxH, moved, static, isDraggable, isResizable, resizeHandles, constraints, isBounded` (`cloneLayoutItem`, `chunk-76RTO6EO.mjs:204-223`; `undefined` faellt im JSON weg) — die Umrechnung verdoppelt deshalb auch `minW/minH/maxW/maxH`, falls numerisch; `dashboard-grid.tsx` ueberschreibt `minW/minH` ohnehin aus den Konstanten.
- **Ort der Umrechnung — Frontend, begruendet:** (1) Die Einheiten (Spalten, Zeilenhoehe) sind Frontend-Konstanten, die API kennt sie nicht; die Umrechnung liegt damit neben `COLS`. (2) Kein Schreiben auf einem GET, keine Aenderung an `dashboard.service.ts` (dessen Bindungs-Invarianten der Inventar-Spec und `dashboard.service.spec.ts` festnageln). (3) Die reine Funktion ist im Web-Vitest ohne Prisma-Attrappe testbar. Preis: der Marker persistiert erst mit einem gelungenen PUT; bis dahin rechnet jedes Laden erneut aus den unveraendert ALTEN DB-Werten um — korrekt, weil die DB ohne Marker auch ohne verdoppelte Werte ist (der Zustand wird nie halb geschrieben: `saveLayout` sendet immer Marker UND Werte gemeinsam).
- **Bestand an Anordnungen:** lokal `DashboardLayout` 0 Zeilen, `WidgetInstance` 0 Zeilen; auf alpha (`192.168.13.12`, nur lesend per psql) ebenfalls 0/0 (Datenbank seit dem Neuaufbau leer). Live (`tessera.ctl.de`) nicht erreichbar/nicht gemessen — die Umrechnung bleibt Pflicht, weil dort Anordnungen existieren koennen. Fuer den Browser-Nachweis wird die alte Form per SQL hergestellt (siehe `<verification>`).
- **API reicht durch (gemessen):** `SaveLayoutDto`/`UpdateWidgetConfigDto` sind `@IsObject()`; `main.ts` `ValidationPipe({ whitelist: true, transform: true })` entfernt nur undekorierte DTO-Eigenschaften, nicht Schluessel INNERHALB von `layouts`/`config`. `getLayout` gibt `record.layouts` unveraendert zurueck (dashboard.service.ts 94-105; Spec Zeile 380 pinnt `{ lg: [{ i: 'w1' }] }` als Durchreichung); `updateWidgetConfig` mischt `{ ...widget.config, ...dto.config }` (Zeile 252-256; Spec Zeile 501 nutzt bereits ein Fremdfeld `foo`). `null` in `config` ist JSON-null innerhalb des Objekts (kein Prisma-`DbNull`-Fall). Keine API-Codeaenderung noetig.
- **jsdom 29.1.1 / cssstyle (Wegwerf-Skript im Scratchpad `jsdomprobe/probe.mjs`):** `el.style.fontSize = 'clamp(12px, min(18cqw, 50cqh), 200px)'` -> `''` (verworfen, auch die heutige Formel `clamp(28px, 4vw, 40px)` wird verworfen — deshalb testet sie heute niemand); `'36pt'` -> `'36pt'`; `'22cqmin'` -> `'22cqmin'`; `'var(--x)'` -> behalten; `setProperty('--x', 'clamp(...)')` -> behalten; `containerType = 'size'` -> behalten. **Folge:** automatische Groessen als Tailwind-Klassen, feste Punktgroesse als Inline-Style; Tests lesen `className`, `data-font-mode` und `style.fontSize`.
- **Tailwind 4.3.1 (Wegwerf-Kompilat gegen `tailwindcss/index.css`, `tw5.mjs`):** `@container-size` -> `container-type: size`; `@container-size/widget` -> zusaetzlich `container-name`; `[container-type:size]` ebenso; `text-[clamp(12px,min(20cqw,50cqh),400px)]` -> `font-size: clamp(12px, min(20cqw, 50cqh), 400px)` (verschachtelte Funktionen und Kommas ohne Leerzeichen funktionieren); `p-1.5` -> 6 px, `py-0.75` -> 3 px, `min-h-6`, `right-2`, `top-2` kompilieren. Container-Queries werden bisher NIRGENDS im Projekt genutzt (grep `@container|cqmin|cqw|cqh|container-type` leer); `globals.css` ist Standard-Tailwind-4 (`@import "tailwindcss"`, `@custom-variant dark`, `@theme inline`). Browser-Unterstuetzung: Chrome 105+, Firefox 110+, Safari 16+; der Tauri-Wrapper nutzt WebView2/Chromium.
- **Umschalter-Geometrie:** `edit-mode-toggle.tsx` Knopf `p-2` + Symbol 20 px = 36 px Hoehe/Breite; `page.tsx` heute `relative p-4`, Umschalter `absolute right-4 top-4`, Grid in `mt-8`, „Widget hinzufuegen“ `fixed bottom-6 right-6` (kein Rand-Abstand, bleibt). `app-shell.tsx` Zeile 34 `main` mit `p-6`; `globals.css` Zeile 123 `.app-shell-main { margin-left: var(--current-sidebar-width, ...) }` ab 768 px. KEIN Test nagelt `p-6`, `app-shell-main`, `page.tsx` des Dashboards oder `AppShell` fest (grep ueber alle `*.test.tsx`/`*.spec.ts`: leer; die drei Treffer fuer `./page` sind grants/cert-manager/groups).
- **Innenabstaende je Widget (Ist, Zeile):** clock 42 `p-2`; stopwatch 192 `p-3`; calculator 319 `p-2`; link 238 `p-2` (Kachel-Innenraum 317 `p-1` bleibt — kein Aussenabstand); favorites 174 `p-2`; calendar 112 `p-3` sowie 80/91/102 `p-4` (Laden/Fehler/leer); search 89 `px-3`; note 89 Kopfzeile `px-3 py-1.5` (der MDEditor darunter hat Bibliotheks-CSS, bleibt); widget-wrapper ohne Padding. Kein Test prueft Padding-Klassen (grep `toHaveClass|p-2|p-3|px-3` in den Widget-Tests: leer).
- **Rechner-Layout:** Tasten `h-9` fest in `grid flex-1 grid-cols-4 grid-rows-5 gap-1` (Zeilen `minmax(0,1fr)`) — heute wachsen beim Vergroessern nur die Luecken, nicht die Tasten; bei Mindestgroesse (alt 4 Zeilen = 208 px) ueberlaeuft der Rechner bereits heute (Anzeige 40 + Speicherzeile 28 + Tastenraster 196 + Luecken > 208). `h-full min-h-7` macht die Tasten zellenfuellend; die Speicherzeile (`h-7 text-xs`) bleibt bewusst klein. `utilBtn` traegt heute `text-xs` ZUSAETZLICH zur Basis `text-sm` — zwei Schriftgroessen-Utilities, deren Reihenfolge Tailwind bestimmt; die Basis verliert ihre Schriftgroesse, jede Tastenart bekommt genau eine Klasse.
- **Stoppuhr-Anzeige:** `formatMs` liefert `mm:ss` (5 Zeichen) oder `hh:mm:ss` (8 Zeichen), `font-mono` — 8 x 0.6 em = 4.8 em Breite; `16cqw` haelt das in 0.77 der Containerbreite. Uhr: `Intl` `de-DE` `HH:MM:SS` 8 Zeichen, `tabular-nums` — `20cqw` ergibt ca. 0.82 der Breite; mit `leading-none` belegt `50cqh` die halbe Hoehe, das Datum (`0.4` davon) darunter passt mit `gap-1`.
- **i18n:** `widgets.clock` in de.json/en.json (Zeile 186-190) traegt `name`, `description`, `dateHint`; beide Dateien 987 Zeilen. `umlaut-guard.spec.ts`: Tokenizer `/[A-Za-zÄÖÜäöüß]+/g`, `SUSPECT_RE = /(ae|oe|ue|ss)/i`, Allowlist case-sensitiv (`lassen` ja, `Lassen` nein, `passt` nein, `Passt` ja), Werte mit `@` uebersprungen; Key-Paritaet de/en rekursiv. Der Wortlaut in Task 2 wurde mit demselben Tokenizer/Muster gegen `UMLAUT_ALLOWLIST` und `UMLAUT_REPLACEMENTS` geprueft: **0 Treffer** -> `umlaut-dictionary.ts` bleibt unangetastet. `tenderRadar-parity.spec.ts` prueft nur `tenderRadar`. Das `ClockConfig`-Formular hat heute ein hart englisches Label „Timezone“ und eine hart englische „Saving...“-Zeile — bleibt (ausserhalb des Auftrags, im SUMMARY als Beobachtung).
- **Detektoren/Konfiguration:** `api-coverage` -> `{"detected":false}` (kein externer Dienst); `assumption-delta scan quick-260916-bwo` -> `{"skipped":true,"reason":"phase_unresolved"}` (Quick-Task ohne ROADMAP-Abschnitt; inhaltlich: `timeFontSizePt` ist ein optionales Feld neben dem automatischen Verhalten — kein Wechsel eines Primaerschluessels, `no-change`); `schema-gate` feuert NICHT (kein `schema.prisma`, keine Migration). `tdd_mode=false` (Task 1 und 2a tragen trotzdem `tdd="true"`), `security_enforcement=true`, ASVS 1, Blocking-Schwelle `high`, `human_verify_mode=end-of-phase`, `branching_strategy: none` (Commits auf `main`). Keine neuen Pakete -> keine Paketlegitimitaetspruefung; `T-BWO-SC` im Register als „kein Install“.
- Gitea: `curl http://localhost:3002/api/v1/version` -> `{"version":"1.26.2"}`; Push-URL zeigt auf `localhost:3002` (Token im Remote, nie ausgeben).
</planning_measurements>
</context>
<tasks>
<task type="auto" tdd="true">
<name>Task 1: Raster verdoppeln (Spalten, Zeilenhoehe, Abstand, Konstanten) und einmalige Umrechnung gespeicherter Anordnungen mit Marker — reine Funktion, Store-Anbindung, API-Durchreich-Specs</name>
<files>apps/web/src/components/dashboard/dashboard-grid.tsx, apps/web/src/components/dashboard/dashboard-grid.test.tsx, apps/web/src/components/dashboard/widget-registry.tsx, apps/web/src/components/dashboard/widget-registry.test.tsx, apps/web/src/lib/grid-layout-migration.ts, apps/web/src/lib/grid-layout-migration.test.ts, apps/web/src/lib/stores/dashboard-store.ts, apps/web/src/lib/stores/dashboard-store.test.ts, apps/api/src/dashboard/dashboard.service.spec.ts</files>
<behavior>
`apps/web/src/lib/grid-layout-migration.test.ts` (NEU, 7 Tests, Vorlage fuer Kopfkommentar und Stil: `error-buffer.test.ts`):
- Test 1 (alt -> x2 + migrated): Eingabe `{ lg: [{ i: 'a', x: 1, y: 2, w: 2, h: 3, minW: 2, minH: 2, moved: false, static: false }, { i: 'b', x: 2, y: 0, w: 6, h: 2, maxW: 12, maxH: 8 }], md: [{ i: 'a', x: 0, y: 0, w: 2, h: 2 }], sm: [], xs: [], xxs: [] }` -> `layouts.lg[0]` gleich `{ i: 'a', x: 2, y: 4, w: 4, h: 6, minW: 4, minH: 4, moved: false, static: false }`, `layouts.lg[1]` gleich `{ i: 'b', x: 4, y: 0, w: 12, h: 4, maxW: 24, maxH: 16 }`, `layouts.md[0]` gleich `{ i: 'a', x: 0, y: 0, w: 4, h: 4 }`, `sm/xs/xxs` leer, `migrated === true`, `Object.keys(layouts)` enthaelt NICHT `__gridVersion`.
- Test 2 (markiert -> unveraendert): dieselben Arrays plus `__gridVersion: 2` -> `layouts` tief gleich den Eingabe-Arrays (ohne Marker), `migrated === false`.
- Test 3 (leer -> leer): `{ lg: [], md: [], sm: [], xs: [], xxs: [] }` ohne Marker -> tief gleich, `migrated === false`; ebenso `{}` -> `{}` und `migrated === false`.
- Test 4 (Idempotenz — Falsifizierung a): `const once = migrateGridLayouts(alt); const twice = migrateGridLayouts(withGridVersion(once.layouts));` -> `twice.layouts` tief gleich `once.layouts`, `twice.migrated === false`. Wird die Marker-Pruefung entfernt, verdoppelt `twice` erneut -> rot.
- Test 5 (`withGridVersion`): Rueckgabe traegt `__gridVersion: 2` und dieselben Arrays (gleiche Referenzen zulaessig), die Eingabe ist danach unveraendert (kein `__gridVersion` darauf).
- Test 6 (Zukunft/Robustheit): `__gridVersion: 3` -> unveraendert, `migrated === false`; `__gridVersion: '2'` (Zeichenkette) zaehlt als unbekannt/alt -> verdoppelt, `migrated === true` (nur Zahlen sind ein Marker); Elemente mit nicht-numerischem `x` bleiben unveraendert (kein NaN), Fremdfelder wie `moved`/`static`/`resizeHandles` werden nicht angefasst.
- Test 7 (Fremdwerte): Breakpoint-Wert, der kein Array ist (`lg: 'kaputt'`, `md: null`) wird weggelassen; Eingabe `null`/`undefined`/Zahl -> `{ layouts: {}, migrated: false }`.
`apps/web/src/lib/stores/dashboard-store.test.ts` (NEU, 6 Tests; `vi.mock('@/lib/dashboard-api', ...)` mit `vi.fn()` fuer `fetchLayout`, `fetchWidgets`, `saveLayout`, `addWidget`, `removeWidget`, `updateWidgetConfig`; Import des Stores NACH dem Mock per `await import('./dashboard-store')`; `beforeEach` setzt `useDashboardStore.setState({ layouts: { lg: [], md: [], sm: [], xs: [], xxs: [] }, widgets: [], isEditMode: false, isDirty: false, isLoading: false, error: null })` und `vi.clearAllMocks()`; Zugriff ueber `useDashboardStore.getState()`):
- Test 1 (alt wird umgerechnet und sofort gespeichert): `fetchLayout` liefert `{ lg: [{ i: 'a', x: 1, y: 1, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [] }`, `fetchWidgets` `[]`, `saveLayout` resolved -> nach `await loadDashboard()` ist `layouts.lg[0]` gleich `{ i: 'a', x: 2, y: 2, w: 4, h: 4 }`, `Object.keys(layouts)` ohne `__gridVersion`, `api.saveLayout` GENAU EINMAL mit `expect.objectContaining({ __gridVersion: 2, lg: [{ i: 'a', x: 2, y: 2, w: 4, h: 4 }] })`, `isDirty === false`, `isLoading === false`, `error === null`.
- Test 2 (markiert bleibt): `fetchLayout` liefert dieselben Arrays plus `__gridVersion: 2` -> `layouts.lg[0]` unveraendert `{ i: 'a', x: 1, y: 1, w: 2, h: 2 }`, `api.saveLayout` NICHT gerufen, kein Marker im Zustand.
- Test 3 (leer): Vorgabe-Anordnung ohne Marker -> `api.saveLayout` NICHT gerufen.
- Test 4 (jedes Speichern traegt den Marker — T-BWO-02): `updateLayouts({ lg: [{ i: 'a', x: 2, y: 2, w: 4, h: 4 }], md: [], sm: [], xs: [], xxs: [] })` dann `await saveLayout()` -> `api.saveLayout` mit `expect.objectContaining({ __gridVersion: 2 })` und den Arrays, danach `isDirty === false`; der Zustand traegt weiterhin keinen Marker.
- Test 5 (Sofort-Speichern scheitert leise): wie Test 1, aber `saveLayout` lehnt ab; `console.error` per `vi.spyOn(console, 'error').mockImplementation(() => {})` -> `loadDashboard` wirft nicht, Zustand bleibt umgerechnet (`x: 2`), `error === null`, `console.error` einmal gerufen.
- Test 6 (neues Widget in neuen Einheiten): `api.addWidget` liefert `{ id: 'n1', widgetType: 'clock', config: {} }` -> nach `await addWidget('clock')` hat `layouts.lg` einen Eintrag `{ i: 'n1', x: 0, y: 0, w: 4, h: 4 }` (verdoppelte `defaultW/defaultH`), `isDirty === true`.
`apps/web/src/components/dashboard/widget-registry.test.tsx` (+1): `it('quick-260916-bwo: jede Groesse ist exakt das Doppelte der alten 12-Spalten-Werte', ...)` mit `expect(WIDGET_CONSTRAINTS).toEqual({ clock: { minW: 4, minH: 4, defaultW: 4, defaultH: 4 }, search: { minW: 6, minH: 4, defaultW: 12, defaultH: 4 }, calendar: { minW: 6, minH: 6, defaultW: 8, defaultH: 12 }, note: { minW: 4, minH: 6, defaultW: 6, defaultH: 8 }, calculator: { minW: 4, minH: 8, defaultW: 6, defaultH: 10 }, favorites: { minW: 4, minH: 6, defaultW: 6, defaultH: 10 }, link: { minW: 4, minH: 4, defaultW: 4, defaultH: 4 }, stopwatch: { minW: 4, minH: 4, defaultW: 6, defaultH: 6 } })` und einer Schleife, die jeden der 32 Werte auf `% 2 === 0` prueft.
`apps/web/src/components/dashboard/dashboard-grid.test.tsx` (+2; der `react-grid-layout`-Mock faengt die Props ein: `const captured = vi.hoisted(() => ({ props: null as Record<string, unknown> | null }))`, `Responsive: (props) => { captured.props = props; return <div data-testid="responsive-grid">{props.children}</div>; }`):
- Test 4 (Grid-Props — Falsifizierung c): nach dem Rendern mit einem Widget `captured.props.cols` tief gleich `{ lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 }`, `rowHeight === 20`, `margin` tief gleich `[8, 8]`, `breakpoints` tief gleich `{ lg: 1200, md: 996, sm: 768, xs: 480, xxs: 0 }` (unveraendert), `containerPadding === undefined` (folgt dem margin).
- Test 5 (Vorgaben ohne gespeicherten Eintrag): Widget `{ id: 'inst-3', widgetType: 'clock', config: {} }` mit leeren `layouts` -> das erste Kind aus `React.Children.toArray(captured.props.children)` traegt `props['data-grid']` tief gleich `{ x: 0, y: 0, w: 4, h: 4, minW: 4, minH: 4 }`.
`apps/api/src/dashboard/dashboard.service.spec.ts` (+2 im describe „Anordnung und Widgets gebunden an forTenant()“, Stil der Datei):
- Test A (`__gridVersion` ueberlebt speichern und laden): `makeFakePrisma({})`, `await service.saveLayout('user-1', 'tenant-1', { layouts: { lg: [{ i: 'w1', x: 0, y: 0, w: 4, h: 4 }], __gridVersion: 2 } } as any)`, dann `await service.getLayout('user-1', 'tenant-1')` -> tief gleich dem gespeicherten Objekt inklusive `__gridVersion: 2`.
- Test B (`timeFontSizePt` wird durchgereicht, `null` ueberschreibt): Widget `config: { timezone: 'Europe/Berlin' }`; `updateWidgetConfig('w1', 'user-1', 'tenant-1', { config: { timeFontSizePt: 36 } })` -> `widget.config` gleich `{ timezone: 'Europe/Berlin', timeFontSizePt: 36 }`; danach `{ config: { timeFontSizePt: null } }` -> `timeFontSizePt === null` und `timezone` unveraendert. Kommentar im Test: die API prueft Config-Felder nicht (`@IsObject()`), die Grenzen liegen im Frontend (`clock-font-size.ts`), ein Fremdwert faellt dort auf „automatisch“ zurueck.
</behavior>
<action>
Schritt A — RED: Die drei neuen Testdateien und die Ergaenzungen in `widget-registry.test.tsx`, `dashboard-grid.test.tsx` und `dashboard.service.spec.ts` gemaess `<behavior>` anlegen; `pnpm -C apps/web exec vitest run src/lib/grid-layout-migration.test.ts src/lib/stores/dashboard-store.test.ts src/components/dashboard` muss rot sein (Modul fehlt / alte Zahlen), Ausgabe fuer das SUMMARY notieren. Die API-Ergaenzungen sind nach heutigem Code bereits gruen — das ist der Beleg der Durchreichung (im SUMMARY so benennen, nicht als RED verkaufen).
Schritt B — `apps/web/src/lib/grid-layout-migration.ts` (NEU, Kopfkommentar deutsch ASCII: Warum einmalige Umrechnung, warum Marker im JSON aber nie im Zustand, Idempotenz, kein Schema, Bezug T-BWO-02): `export const GRID_VERSION = 2`, `export const GRID_VERSION_KEY = '__gridVersion'`, `export const GRID_SCALE_FACTOR = 2`; `export interface GridLayoutItem { i: string; x: number; y: number; w: number; h: number; [key: string]: unknown }`, `export type GridLayouts = Record<string, GridLayoutItem[]>`. `export function migrateGridLayouts(raw: unknown): { layouts: GridLayouts; migrated: boolean }`: ist `raw` kein Objekt (oder Array/null) -> `{ layouts: {}, migrated: false }`; `version` = Wert unter `GRID_VERSION_KEY`, falls `typeof === 'number'`, sonst `1`; `layouts` = fuer jeden Schluessel ausser `GRID_VERSION_KEY`, dessen Wert ein Array ist, eine neue Liste; ist `version >= GRID_VERSION`, werden die Elemente flach kopiert (`{ ...item }`), sonst je Element eine Kopie, in der jedes der Felder `x, y, w, h, minW, minH, maxW, maxH` mit `typeof === 'number'` mit `GRID_SCALE_FACTOR` multipliziert wird (andere Felder unveraendert), und `migrated` wird `true`, sobald mindestens ein Element verdoppelt wurde (leere Arrays -> `false`). `export function withGridVersion(layouts: GridLayouts): Record<string, unknown>` liefert `{ ...layouts, [GRID_VERSION_KEY]: GRID_VERSION }` ohne Mutation. Keine Abhaengigkeit auf React oder den Store.
Schritt C — `dashboard-grid.tsx`: `COLS` auf `{ lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 }`, `rowHeight={20}`, `margin={[8, 8] as [number, number]}`; `BREAKPOINTS` unveraendert; `containerPadding` weiterhin nicht setzen (folgt dem margin — Kommentar mit dem gemessenen Fallback). Kopfkommentar (deutsch, ASCII, kurz) ergaenzen: Raster seit quick-260916-bwo doppelt so fein, gespeicherte Anordnungen werden in `grid-layout-migration.ts` einmalig umgerechnet; die Rueckfallwerte `?? 2` im `data-grid` auf `?? 4` anheben (gleiche Bedeutung in neuen Einheiten). `widget-registry.tsx`: alle 32 Werte verdoppeln (Tabelle aus `<behavior>`), Kommentar ueber dem Objekt: `// quick-260916-bwo: Raster verdoppelt (24 Spalten / 20 px) — jeder Wert ist das Doppelte des alten 12-Spalten-Werts, Widgets bleiben optisch gleich gross.`
Schritt D — `dashboard-store.ts`: Import `{ migrateGridLayouts, withGridVersion }` aus `@/lib/grid-layout-migration`. In `loadDashboard` nach dem `Promise.all`: `const { layouts: migratedLayouts, migrated } = migrateGridLayouts(rawLayouts)`; `set({ layouts: migratedLayouts, widgets, isLoading: false })`; danach `if (migrated) { try { await api.saveLayout(withGridVersion(migratedLayouts)); } catch (err) { console.error('Failed to persist migrated layout:', err); } }` — NACH dem `set`, damit die Oberflaeche unabhaengig vom Speichern rendert, und innerhalb des aeusseren `try` so, dass ein Speicherfehler NICHT in den `catch` mit `error: 'Failed to load dashboard'` faellt (eigener innerer try/catch). In `saveLayout`: `await api.saveLayout(withGridVersion(get().layouts))`. Kommentar am Store (deutsch, ASCII): der Marker lebt nur im gespeicherten JSON; fehlt er beim Speichern, wird beim naechsten Laden erneut verdoppelt — deshalb `withGridVersion` an BEIDEN Speicherstellen. Typ von `layouts` im Zustand bleibt `Record<string, Array<{ i; x; y; w; h }>>` (GridLayouts ist zuweisbar).
Schritt E — GREEN: `pnpm -C apps/web exec vitest run src/lib/grid-layout-migration.test.ts src/lib/stores/dashboard-store.test.ts src/components/dashboard` gruen (Grid 5, Registry 4, Migration 7, Store 6, uebrige Widget-Tests unveraendert); `pnpm -C apps/api exec vitest run src/dashboard` gruen; `pnpm -C apps/web exec tsc --noEmit` und `pnpm -C apps/api exec tsc --noEmit` je Exit 0.
Commit: `feat(quick-260916-bwo): Dashboard-Raster verdoppelt (24 Spalten, 20 px, 8 px Abstand), Konstanten x2, einmalige Umrechnung gespeicherter Anordnungen mit Marker __gridVersion` mit genau den 9 Dateien dieser Aufgabe (`git show --stat HEAD` zeigt 9).
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && pnpm -C apps/web exec vitest run src/lib/grid-layout-migration.test.ts src/lib/stores/dashboard-store.test.ts src/components/dashboard/dashboard-grid.test.tsx src/components/dashboard/widget-registry.test.tsx 2>&1 | grep -E "^\s+(Test Files|Tests)" ; pnpm -C apps/api exec vitest run src/dashboard/dashboard.service.spec.ts 2>&1 | grep -E "^\s+(Test Files|Tests)" ; grep -c "lg: 24, md: 20, sm: 12, xs: 8, xxs: 2" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "rowHeight={20}" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "margin={\[8, 8\]" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "clock: { minW: 4, minH: 4, defaultW: 4, defaultH: 4 }" apps/web/src/components/dashboard/widget-registry.tsx ; grep -c "search: { minW: 6, minH: 4, defaultW: 12, defaultH: 4 }" apps/web/src/components/dashboard/widget-registry.tsx ; grep -c "calculator: { minW: 4, minH: 8, defaultW: 6, defaultH: 10 }" apps/web/src/components/dashboard/widget-registry.tsx ; grep -c "withGridVersion(" apps/web/src/lib/stores/dashboard-store.ts ; grep -c "migrateGridLayouts(" apps/web/src/lib/stores/dashboard-store.ts ; grep -cE "export const GRID_VERSION\s*=\s*2\b" apps/web/src/lib/grid-layout-migration.ts ; U=$(git diff --stat 5f50c5f -- apps/api/src/dashboard/dashboard.service.ts apps/api/src/dashboard/dto apps/api/prisma); echo U_EXIT=$? ; test -z "$U"; echo U_EMPTY=$? ; pnpm -C apps/web exec tsc --noEmit >/dev/null 2>&1; echo TSC_web=$? ; pnpm -C apps/api exec tsc --noEmit >/dev/null 2>&1; echo TSC_api=$?</automated>
<fails_when>Eine der beiden Vitest-Zeilen weicht von den in <done> genannten Zahlen ab (Web 4/22, API-Datei +2) oder fehlt; irgendein grep liefert 0 statt 1; U_EMPTY ist 1 (API-Dienst, DTOs oder Prisma wurden angefasst); TSC_web oder TSC_api ist nicht 0.</fails_when>
</verify>
<done>
Web-Vitest-Zeilen `Test Files 4 passed (4)` / `Tests 22 passed (22)` (5 + 4 + 7 + 6); API-Zeilen `Test Files 1 passed (1)` und `Tests` mit der bisherigen Zahl der Datei plus 2; Greps liefern `1` (COLS), `1` (rowHeight), `1` (margin), `1`, `1`, `1` (drei Stichproben der Konstanten), mindestens `2` (withGridVersion an beiden Speicherstellen), mindestens `1` (migrateGridLayouts im Laden), `1` (GRID_VERSION); `U_EXIT=0` und `U_EMPTY=0` (API-Produktivcode, DTOs und Prisma unangetastet); `TSC_web=0`, `TSC_api=0`. Der RED-Lauf aus Schritt A steht im SUMMARY. Commit existiert mit genau 9 Dateien.
</done>
</task>
<task type="auto" tdd="true">
<name>Task 2: Inhalt skaliert mit der Widgetgroesse (Container-Queries fuer Uhr, Stoppuhr, Rechner), Punktgroesse der Uhrzeit einstellbar (Feld + i18n), Abstaende halbiert (Dashboard, Widget-Ruempfe, Seitenrahmen)</name>
<files>apps/web/src/components/dashboard/widgets/widget-wrapper.tsx, apps/web/src/components/dashboard/widgets/clock-font-size.ts, apps/web/src/components/dashboard/widgets/clock-widget.tsx, apps/web/src/components/dashboard/widgets/clock-widget.test.tsx, apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx, apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx, apps/web/src/components/dashboard/widgets/calculator-widget.tsx, apps/web/src/components/dashboard/widgets/calculator-widget.test.tsx, apps/web/src/components/settings/widget-settings-panel.tsx, apps/web/src/components/settings/widget-settings-panel.test.tsx, apps/web/src/messages/de.json, apps/web/src/messages/en.json, apps/web/src/components/dashboard/widgets/link-widget.tsx, apps/web/src/components/dashboard/widgets/favorites-widget.tsx, apps/web/src/components/dashboard/widgets/calendar-widget.tsx, apps/web/src/components/dashboard/widgets/search-widget.tsx, apps/web/src/components/dashboard/widgets/note-widget.tsx, apps/web/src/app/(portal)/page.tsx, apps/web/src/components/layout/app-shell.tsx</files>
<behavior>
`apps/web/src/components/dashboard/widgets/clock-widget.test.tsx` (+4; Import `{ resolveClockTimeFontSizePt, CLOCK_FONT_SIZE_MIN_PT, CLOCK_FONT_SIZE_MAX_PT }` aus `./clock-font-size`):
- Test 3 (reine Funktion): `resolveClockTimeFontSizePt({ timeFontSizePt: 36 })` -> `36`; `8` -> `8`; `200` -> `200`; `36.5` -> `36.5`; `7` -> `null`; `201` -> `null`; `'36'` -> `null`; `NaN` -> `null`; `Infinity` -> `null`; `null` -> `null`; `{}` -> `null`; `CLOCK_FONT_SIZE_MIN_PT === 8`, `CLOCK_FONT_SIZE_MAX_PT === 200`.
- Test 4 (fest — Falsifizierung b, Test liest `style`): `config={{ timezone: 'Europe/Berlin', showDate: true, timeFontSizePt: 36 }}` -> `screen.getByRole('time').style.fontSize === '36pt'`, `getAttribute('data-font-mode') === 'fixed'`, `screen.getByTestId('clock-date').style.fontSize === '14.4pt'`.
- Test 5 (automatisch): ohne `timeFontSizePt` -> `time.style.fontSize === ''`, `data-font-mode === 'auto'`, `time.className` passt auf `/cqw/` UND `/cqh/`, `clock-date` (showDate true) `className` passt auf `/cq[wh]/` und `style.fontSize === ''`.
- Test 6 (Fremdwert wird ignoriert): `timeFontSizePt: '36'` -> wie Test 5 (`auto`, kein Inline-Style).
`apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx` (+1): `screen.getByTestId('stopwatch-display').className` passt auf `/cqw/` und `/cqh/`, und `style.fontSize === ''` (keine Fensterbreiten-Formel mehr).
`apps/web/src/components/dashboard/widgets/calculator-widget.test.tsx` (+1): `screen.getByLabelText('Anzeige').className` passt auf `/cqw/`; `screen.getByRole('button', { name: '7' }).className` passt auf `/cqw/` und enthaelt `h-full`; `screen.getByRole('button', { name: 'CE' }).className` passt auf `/cqw/`.
`apps/web/src/components/settings/widget-settings-panel.test.tsx` (NEU, 4 Tests; `vi.mock('next-intl')` mit Texten aus `de.json` (Muster `tessera-logo.test.tsx`, Import `de from '@/messages/de.json'`, Namensraum `widgets` flach: `'clock.fontSizeLabel'` usw.), `vi.mock('@/lib/dashboard-api', () => ({ updateWidgetConfig: vi.fn().mockResolvedValue(undefined) }))`, `vi.mock('next/link', ...)` als einfacher Anker, `vi.mock('@/components/settings/search-provider-form', () => ({ SearchProviderForm: () => null }))`; Widget `{ id: 'c1', widgetType: 'clock', config: { timezone: 'Europe/Berlin', timeFontSizePt: 24 } }`, Aufklappen per Klick auf den Kopf-Knopf (`screen.getByRole('button', { name: /Uhr #1/ })`)):
- Test 1 (Feld vorbelegt): Eingabe `screen.getByLabelText(de.widgets.clock.fontSizeLabel)` hat `value === '24'`, `type === 'number'`, `min === '8'`, `max === '200'`, `placeholder === de.widgets.clock.fontSizeAuto`; der Hilfetext `de.widgets.clock.fontSizeHint` steht im Dokument.
- Test 2 (Zahl uebernehmen bei Blur): `fireEvent.change(input, { target: { value: '36' } })`, `fireEvent.blur(input)` -> `updateWidgetConfig` genau einmal mit `('c1', { timeFontSizePt: 36 })`, `onWidgetUpdate` mit `('c1', { timeFontSizePt: 36 })`.
- Test 3 (leer = automatisch): `change` auf `''`, Enter (`fireEvent.keyDown(input, { key: 'Enter' })`) -> `updateWidgetConfig` mit `('c1', { timeFontSizePt: null })`; keine Fehlermeldung.
- Test 4 (ausserhalb der Grenzen): `change` auf `'300'`, `blur` -> `updateWidgetConfig` NICHT gerufen, `screen.getByRole('alert')` zeigt `de.widgets.clock.fontSizeInvalid`, `input` traegt `aria-invalid="true"`; danach `change` auf `'7'`, `blur` -> weiterhin nicht gerufen.
</behavior>
<action>
Teil 2a — Skalierung, Punktgroesse, i18n (11 Dateien, eigener Commit):
Schritt A — RED: Testergaenzungen und die neue Spec gemaess `<behavior>`; `pnpm -C apps/web exec vitest run src/components/dashboard/widgets src/components/settings/widget-settings-panel.test.tsx` rot, Ausgabe notieren.
Schritt B — `clock-font-size.ts` (NEU, Kopfkommentar deutsch ASCII, Bezug T-BWO-01): `export const CLOCK_FONT_SIZE_MIN_PT = 8`, `export const CLOCK_FONT_SIZE_MAX_PT = 200`, `export const CLOCK_DATE_FACTOR = 0.4`, `export function resolveClockTimeFontSizePt(config: Record<string, unknown>): number | null` — liest `config.timeFontSizePt`, gibt die Zahl nur zurueck, wenn `typeof value === 'number'`, `Number.isFinite(value)` und `MIN <= value <= MAX`, sonst `null`. Kein anderer Typ wird umgewandelt (eine Zeichenkette bleibt „automatisch“ — der Style bekommt nie Text aus der Konfiguration).
Schritt C — `widget-wrapper.tsx`: Rumpf-`div` (Zeile 69) bekommt `@container-size` zusaetzlich zu `h-full` (Klasse woertlich im JSX). Kommentar (deutsch, ASCII, 3-4 Zeilen): Groessen-Container fuer `cqw`/`cqh`; braucht definite Hoehe — die kommt ueber `h-full` aus der Karte, die das RGL-Element mit Pixelhoehe fuellt; steht am Rumpf statt an der Karte, weil die Karte im Bearbeitungsmodus den Griff traegt.
Schritt D — `clock-widget.tsx`: Import `{ resolveClockTimeFontSizePt, CLOCK_DATE_FACTOR }`; `const fixedPt = resolveClockTimeFontSizePt(config)`; Rumpf `flex h-full flex-col items-center justify-center gap-1 p-1` (Innenabstand halbiert); `<time role="time" data-font-mode={fixedPt === null ? 'auto' : 'fixed'} className="font-semibold tabular-nums leading-none text-foreground text-[clamp(12px,min(20cqw,50cqh),400px)]" style={fixedPt === null ? undefined : { fontSize: `${fixedPt}pt` }} ...>`; das Datum `className="text-muted-foreground text-[clamp(10px,min(8cqw,20cqh),160px)]"` mit `style={fixedPt === null ? undefined : { fontSize: `${fixedPt * CLOCK_DATE_FACTOR}pt` }}` (36 -> `14.4pt`). Die bisherige Fensterbreiten-Formel im Inline-Style entfaellt vollstaendig. Kopfkommentar der Datei um `timeFontSizePt` (number | null, leer = automatisch ueber Container-Queries, Grenzen in `clock-font-size.ts`) ergaenzen. Kommentar am `<time>`: Inline-Style nur fuer die feste Punktgroesse, weil jsdom `clamp()` verwirft und der Browser die Klasse ohnehin bekommt — kein Testtrick, sondern die einfachere Trennung „automatisch = CSS, fest = Zahl“.
Schritt E — `stopwatch-widget.tsx`: Rumpf `flex h-full flex-col overflow-hidden p-1.5`; Anzeige-`span` `className="font-mono font-semibold tabular-nums leading-none text-foreground text-[clamp(14px,min(16cqw,35cqh),400px)]"` OHNE `style`. `calculator-widget.tsx`: Rumpf `flex h-full flex-col gap-1 p-1 select-none`; `output` Anzeige `text-xl` ersetzen durch `text-[clamp(14px,min(8cqw,10cqh),96px)]`; `CalcButton`-Basisklasse verliert `text-sm`; `baseBtn` = `h-full min-h-7 cursor-pointer select-none active:scale-95`; `numBtn`, `opBtn`, `eqBtn` erhalten zusaetzlich `text-[clamp(11px,min(4cqw,4.5cqh),40px)]`, `utilBtn` statt `text-xs` die Klasse `text-[clamp(10px,min(3.2cqw,3.6cqh),32px)]`; `memBtn` (`h-7 text-xs`) bleibt (Speicherzeile bewusst klein; Kommentar). Alle Klassen woertlich als String-Literale in der Datei (Tailwind-Scanner). Bestehende Tests (Tastatur, Division durch null, Komma) bleiben unberuehrt.
Schritt F — `widget-settings-panel.tsx`, `ClockConfig`: Import `{ resolveClockTimeFontSizePt, CLOCK_FONT_SIZE_MIN_PT, CLOCK_FONT_SIZE_MAX_PT }`; lokaler Zustand `const [fontSizeDraft, setFontSizeDraft] = useState(() => { const pt = resolveClockTimeFontSizePt(config); return pt === null ? '' : String(pt); })` und `const [fontSizeError, setFontSizeError] = useState(false)`; `commitFontSize()`: `raw = fontSizeDraft.trim()`; leer -> `setFontSizeError(false)` und, falls `resolveClockTimeFontSizePt(config) !== null`, `onChange({ timeFontSizePt: null })` (im Test ist 24 gesetzt -> Aufruf erfolgt); sonst `n = Number(raw)`; `!Number.isFinite(n) || n < MIN || n > MAX` -> `setFontSizeError(true)`, KEIN `onChange`; sonst `setFontSizeError(false)` und `onChange({ timeFontSizePt: n })`, falls `n !== resolveClockTimeFontSizePt(config)`. Markup nach dem Datums-Haekchen: `<div>` mit `<label htmlFor="clock-font-size" className="mb-1 block text-sm text-foreground">{t('clock.fontSizeLabel')}</label>`, `<input id="clock-font-size" type="number" inputMode="decimal" min={CLOCK_FONT_SIZE_MIN_PT} max={CLOCK_FONT_SIZE_MAX_PT} step={1} placeholder={t('clock.fontSizeAuto')} value={fontSizeDraft} onChange={(e) => setFontSizeDraft(e.target.value)} onBlur={commitFontSize} onKeyDown={(e) => { if (e.key === 'Enter') { e.preventDefault(); commitFontSize(); } }} aria-invalid={fontSizeError || undefined} aria-describedby="clock-font-size-hint" className="h-9 w-full max-w-xs rounded border border-border bg-background px-3 text-sm text-foreground" />`, `<p id="clock-font-size-hint" className="mt-1 text-xs text-muted-foreground">{t('clock.fontSizeHint')}</p>`, bei Fehler `<p role="alert" className="mt-1 text-xs text-destructive">{t('clock.fontSizeInvalid')}</p>`. Das hart englische „Timezone“-Label und „Saving...“ bleiben unangetastet (Beobachtung fuers SUMMARY).
Schritt G — Uebersetzungen: in `de.json` und `en.json` unter `widgets.clock` hinter `dateHint` in dieser Reihenfolge und in BEIDEN Dateien an derselben Stelle: `fontSizeLabel`, `fontSizeAuto`, `fontSizeHint`, `fontSizeInvalid`. Deutsch (Sie-Form, echte Umlaute, Wortlaut GENAU so — gegen den Waechter geprueft): `fontSizeLabel` „Schriftgröße der Uhrzeit (Punkt)“; `fontSizeAuto` „automatisch“; `fontSizeHint` „Leer lassen, dann richtet sich die Uhrzeit nach der Größe der Kachel. Ein Wert zwischen 8 und 200 legt die Schrift fest, unabhängig von der Kachelgröße.“; `fontSizeInvalid` „Bitte geben Sie eine Zahl zwischen 8 und 200 ein oder lassen Sie das Feld leer.“. Englisch: `fontSizeLabel` „Font size of the time (pt)“; `fontSizeAuto` „automatic“; `fontSizeHint` „Leave empty and the time follows the size of the tile. A value between 8 and 200 fixes the font size regardless of the tile size.“; `fontSizeInvalid` „Please enter a number between 8 and 200 or leave the field empty.“. Danach `pnpm -C apps/web exec vitest run src/messages` gruen OHNE Aenderung an `umlaut-dictionary.ts`; flaggt der Waechter dennoch ein Wort (nur bei abweichendem Wortlaut moeglich), das Wort GENAU SO in `UMLAUT_ALLOWLIST` eintragen (Kommentar `// 260916-bwo`) und die Dateizahl im SUMMARY auf 30 korrigieren.
Schritt H — GREEN 2a: `pnpm -C apps/web exec vitest run src/components/dashboard/widgets src/components/settings/widget-settings-panel.test.tsx src/messages` gruen (clock 6, stopwatch 8, calculator 7, settings 4); `pnpm -C apps/web exec tsc --noEmit` Exit 0. Commit 2a: `feat(quick-260916-bwo): Widget-Inhalt skaliert per Container-Queries (Uhr, Stoppuhr, Rechner), Punktgroesse der Uhrzeit einstellbar` mit genau den 11 Dateien (widget-wrapper, clock-font-size, clock (+test), stopwatch (+test), calculator (+test), widget-settings-panel (+test), de.json, en.json). Wiederaufsetzpunkt nach diesem Commit ist Schritt I.
Teil 2b — Abstaende halbieren (7 Dateien, eigener Commit):
Schritt I — Tabelle vorher/nachher, jeweils nur die genannte Klasse an der genannten Stelle, sonst nichts:
| Datei | Stelle | vorher | nachher |
| link-widget.tsx | Rumpf Zeile 238 | Padding-Stufe 2 | `p-1` (Kachel-Innenraum Zeile 317 bleibt) |
| favorites-widget.tsx | Rumpf Zeile 174 | Stufe 2 | `p-1` |
| calendar-widget.tsx | Rumpf Zeile 112 | Stufe 3 | `p-1.5`; Zustandsansichten Zeile 80/91/102 Stufe 4 -> `p-2` |
| search-widget.tsx | Rumpf Zeile 89 | horizontale Stufe 3 | `px-1.5` |
| note-widget.tsx | Kopfzeile Zeile 89 | horizontale Stufe 3 | `px-1.5` (`py-1.5` bleibt — Hoehe der Kopfzeile, kein Randabstand) |
| page.tsx | Container Zeile 69 | Stufe 4 | `relative p-2`; Umschalter Zeile 71 -> `absolute right-2 top-2 z-10`; `mt-8` Zeile 79 BLEIBT mit Kommentar (deutsch, ASCII): der Umschalter ist 36 px hoch und liegt bei 8..44 px, das erste Widget beginnt mit `mt-8` bei 48 px — eine Halbierung wuerde ihn ins Widget legen |
| app-shell.tsx | `main` Zeile 34 | Stufe 6 (24 px) | `p-3` (12 px) — gilt fuer ALLE Seiten, ausdruecklicher Wunsch des Users; Kommentar im JSX (deutsch, ASCII): Seitenrahmen seit quick-260916-bwo halbiert |
(Uhr `p-1`, Stoppuhr `p-1.5`, Rechner `p-1` sind bereits in Teil 2a gesetzt; widget-wrapper hat kein Padding.)
Schritt J — GREEN 2b: volle Web-Suite `Test Files 46 passed (46)` / `Tests 286 passed (286)`; `pnpm -C apps/web exec tsc --noEmit` Exit 0. Commit 2b: `feat(quick-260916-bwo): Abstaende halbiert — Seitenrahmen p-3 (alle Seiten), Dashboard p-2, Grid 8 px, Widget-Innenabstaende` mit genau den 7 Dateien. Weicht eine Testzahl ab, ist das ein Befund fuer das SUMMARY — erst die Ursache benennen, dann korrigieren.
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; grep -c "@container-size" apps/web/src/components/dashboard/widgets/widget-wrapper.tsx ; grep -c "text-\[clamp(12px,min(20cqw,50cqh),400px)\]" apps/web/src/components/dashboard/widgets/clock-widget.tsx ; grep -c "data-font-mode" apps/web/src/components/dashboard/widgets/clock-widget.tsx ; grep -c "vw" apps/web/src/components/dashboard/widgets/clock-widget.tsx ; grep -c "vw" apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx ; grep -c "cqw" apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx ; grep -c "cqw" apps/web/src/components/dashboard/widgets/calculator-widget.tsx ; grep -c "h-full min-h-7" apps/web/src/components/dashboard/widgets/calculator-widget.tsx ; grep -cE "export const CLOCK_FONT_SIZE_MIN_PT\s*=\s*8\b" apps/web/src/components/dashboard/widgets/clock-font-size.ts ; grep -cE "export const CLOCK_FONT_SIZE_MAX_PT\s*=\s*200\b" apps/web/src/components/dashboard/widgets/clock-font-size.ts ; grep -c 'id="clock-font-size"' apps/web/src/components/settings/widget-settings-panel.tsx ; grep -c '"fontSizeLabel"' apps/web/src/messages/de.json ; grep -c '"fontSizeInvalid"' apps/web/src/messages/en.json ; D2=$(git diff --stat 5f50c5f -- apps/web/src/messages/umlaut-dictionary.ts); echo D2_EXIT=$? ; test -z "$D2"; echo DICT_UNCHANGED=$? ; grep -c '"relative p-2"' "apps/web/src/app/(portal)/page.tsx" ; grep -c "right-2 top-2" "apps/web/src/app/(portal)/page.tsx" ; grep -c '"mt-8"' "apps/web/src/app/(portal)/page.tsx" ; grep -c "p-3" apps/web/src/components/layout/app-shell.tsx ; grep -c " p-6" apps/web/src/components/layout/app-shell.tsx ; grep -c "overflow-auto p-1 gap-2" apps/web/src/components/dashboard/widgets/link-widget.tsx ; grep -c "overflow-auto p-1 gap-2" apps/web/src/components/dashboard/widgets/favorites-widget.tsx ; grep -c "overflow-y-auto p-1.5" apps/web/src/components/dashboard/widgets/calendar-widget.tsx ; grep -c "justify-center p-2" apps/web/src/components/dashboard/widgets/calendar-widget.tsx ; grep -c "gap-2 px-1.5" apps/web/src/components/dashboard/widgets/search-widget.tsx ; grep -c "px-1.5 py-1.5" apps/web/src/components/dashboard/widgets/note-widget.tsx ; grep -c "justify-center gap-1 p-1\"" apps/web/src/components/dashboard/widgets/clock-widget.tsx ; grep -c "overflow-hidden p-1.5" apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx ; grep -c "gap-1 p-1 select-none" apps/web/src/components/dashboard/widgets/calculator-widget.tsx ; pnpm -C apps/web exec tsc --noEmit >/dev/null 2>&1; echo TSC_web=$?</automated>
<fails_when>Vitest-Zeilen weichen von `46 passed (46)` / `286 passed (286)` ab; ein grep, der laut <done> >= 1 sein muss, liefert 0; ein grep, der 0 sein muss (vw in clock/stopwatch, " p-6" in app-shell), liefert >= 1; DICT_UNCHANGED ist 1; TSC_web ist nicht 0.</fails_when>
</verify>
<done>
Vitest `Test Files 46 passed (46)` / `Tests 286 passed (286)`; Greps in dieser Reihenfolge: mindestens `1` (Container), `1` (Uhr-Klasse), `2` (data-font-mode: Attribut plus Kommentar zulaessig, mindestens 1), `0` (keine Fensterbreiten-Einheit in der Uhr), `0` (ebenso Stoppuhr), `1` (Stoppuhr cqw), mindestens `3` (Rechner cqw: Anzeige, Tasten, Funktionstasten), `1` (Tasten zellenfuellend), `1`, `1` (Grenzen), `1` (Feld), `1`, `1` (i18n beide Sprachen), `D2_EXIT=0` und `DICT_UNCHANGED=0` (Woerterbuch unangetastet), `1` (Dashboard-Container), `1` (Umschalter), `1` (mt-8 bleibt), `1` (Seitenrahmen p-3), `0` (alte Stufe 6 weg), dann `1` fuer jede der Innenabstands-Stichproben link, favorites, calendar Rumpf, search, note, clock, stopwatch, calculator und `3` fuer die drei calendar-Zustandsansichten; `TSC_web=0`. Zwei Commits (2a mit 11, 2b mit 7 Dateien). RED-Lauf aus Schritt A im SUMMARY.
</done>
</task>
<task type="auto">
<name>Task 3: Anwenderhandbuch, Abschluss-Gates, Push und Beobachtung des CI-Laufs</name>
<files>docs/anleitung-anwender.md</files>
<precondition>Gitea antwortet lokal: `curl -s --max-time 5 http://localhost:3002/api/v1/version` liefert `{"version":"1.26.2"}`, und `docker ps --format '{{.Names}}' | grep -c '^gitea-runner$'` liefert `1` (sonst Push trotzdem, Beobachtung als offenen Punkt ins SUMMARY).</precondition>
<action>
Schritt A — `docs/anleitung-anwender.md` (echte Umlaute, Sie-Form, Ton der Datei, drei Stellen im Abschnitt „Das Dashboard“):
1. Aufzaehlungspunkt „Können Sie Widgets an der Ecke in der Größe ziehen …“ (Zeile 64): Satz anhaengen: „Position und Größe rasten dabei in feinen Schritten ein, sodass sich auch kleine Anpassungen vornehmen lassen.“
2. Tabellenzeile „| Uhr | Zeigt die aktuelle Uhrzeit an (optional mit Datum) |“ (Zeile 73) ersetzen durch: „| Uhr | Zeigt die aktuelle Uhrzeit an (optional mit Datum). Die Uhrzeit wächst und schrumpft mit der Kachel; wer eine feste Größe möchte, stellt sie unter Einstellungen > Dashboard als Schriftgröße in Punkt ein |“.
3. Satz „Für Suchleiste, Kalender, Favoriten und Link gibt es zusätzliche Einstellungen (z. B. eigene Suchanbieter, Kalenderquellen, hinterlegte Links)“ (Zeile 82) ersetzen durch „Für Uhr, Suchleiste, Kalender, Favoriten und Link gibt es zusätzliche Einstellungen (z. B. Zeitzone und Schriftgröße der Uhr, eigene Suchanbieter, Kalenderquellen, hinterlegte Links)“; Rest des Satzes unveraendert.
Schritt B — Gates, Commit, Push, Beobachtung:
1. `grep -c "Schriftgröße" docs/anleitung-anwender.md` -> mindestens 2; `grep -c "feinen Schritten" docs/anleitung-anwender.md` -> 1.
2. Volle Suiten und tsc erneut: Web `46 passed (46)` / `286 passed (286)`, API `67 passed (67)` / `1078 passed (1078)`, `for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit; done` dreimal Exit 0; `pnpm install --frozen-lockfile` Exit 0 (Lockfile unveraendert).
3. `D=$(git diff --stat 5f50c5f -- . ':!.planning'); echo GIT_EXIT=$?; tail -n1 <<< "$D"` -> `29 files changed`; Unangetastet-Stichprobe `git diff --stat 5f50c5f -- '.env*' docker-compose.yml docker-compose.prod.yml docker-compose.dev.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard/dashboard.service.ts apps/api/src/dashboard/dto apps/web/src/app/globals.css` -> leer.
4. Commit: `docs(quick-260916-bwo): Anwenderhandbuch — feines Raster, Uhrzeit skaliert mit der Kachel, Schriftgroesse in Punkt` (nur diese Datei). Danach `git push` (schlichter Aufruf; die Push-URL zeigt auf localhost:3002); `git status -sb | head -n1` ohne `[ahead`.
5. Beobachtung des echten CI-Laufs (Token NIE ausgeben — nur in einer Shell-Variablen; Verfahren wie 260914-m97 Task 3): `PUSHED=$(git rev-parse HEAD); TOK=$(git config --get remote.origin.pushurl | sed -E 's#.*schalli:([^@]+)@.*#\1#')`; bis zu 12 Minuten alle 20 s `curl -s -H "Authorization: token $TOK" "http://localhost:3002/api/v1/repos/schalli/tessera-ctl/actions/runs?limit=5"` abfragen (Hintergrundbefehl, falls `sleep` im Vordergrund blockiert ist), Eintrag mit `head_sha == PUSHED`, auf `status == completed` warten; Erwartung `conclusion == success`, Dauer eher 4-6 Minuten (kein Lockfile-Wechsel, deps-Stufen aus dem Cache). Danach Abbild-Probe: `docker run --rm --entrypoint node localhost:3002/schalli/tessera-ctl/api:beta -e 'console.log(process.env.APP_VERSION)'` -> kurzer SHA von `PUSHED`. Lauf-ID, Dauer, Ergebnis ins SUMMARY. Ist `conclusion` nicht `success`: Job-Log ueber `.../actions/runs/<id>/jobs` lesen, Ursache beheben, erneut pushen, erneut beobachten.
6. Wird das SUMMARY erst nach dem Push committet, den Push danach wiederholen (weiterer CI-Lauf erwartet, in Ordnung). SUMMARY-Pflichtinhalte: beide RED-Laeufe, die gemessenen jsdom-/Tailwind-Befunde in Kurzform, die Entscheidung „Umrechnung im Frontend“ mit Begruendung, die Entscheidung „`mt-8` bleibt“ mit der Umschalter-Messung, die Annahme „Listen-Widgets skalieren nicht“, die Beobachtung „Timezone-Label hart englisch“, die Bestandszahlen (lokal/alpha 0 Anordnungen, live nicht gemessen) und die Anleitung fuer den Browser-Nachweis aus `<verification>`.
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && grep -c "Schriftgröße" docs/anleitung-anwender.md ; grep -c "feinen Schritten" docs/anleitung-anwender.md ; pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; pnpm -C apps/api exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit >/dev/null 2>&1; echo "TSC_$p=$?"; done ; pnpm install --frozen-lockfile >/dev/null 2>&1; echo FROZEN=$? ; D=$(git diff --stat 5f50c5f -- . ':!.planning'); echo GIT_EXIT=$? ; tail -n1 <<< "$D" ; U=$(git diff --stat 5f50c5f -- '.env*' docker-compose.yml docker-compose.prod.yml docker-compose.dev.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard/dashboard.service.ts apps/api/src/dashboard/dto apps/web/src/app/globals.css); echo U_EXIT=$? ; test -z "$U"; echo U_EMPTY=$? ; S=$(git status -sb); head -n1 <<< "$S"</automated>
<fails_when>Eine Suite weicht von Web 46/286 bzw. API 67/1078 ab; ein TSC_* oder FROZEN oder GIT_EXIT ist nicht 0; die Summenzeile nennt nicht genau `29 files changed`; U_EMPTY ist 1 (eine unantastbare Datei wurde geaendert); die Statuszeile zeigt `[ahead` oder `[behind`.</fails_when>
</verify>
<done>
Greps liefern `>= 2` und `1`; Web `Test Files 46 passed (46)` / `Tests 286 passed (286)`; API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`; dreimal `TSC_...=0`; `FROZEN=0`; `GIT_EXIT=0` und die Summenzeile nennt `29 files changed`; `U_EXIT=0`, `U_EMPTY=0`; die Status-Zeile enthaelt kein `[ahead`. Das SUMMARY traegt unter „CI-Lauf nach dem Push“ Lauf-ID, `conclusion`, Dauer und die Abbild-Probe — oder, falls Gitea/Runner nicht erreichbar waren, den Grund und den offenen Punkt.
</done>
</task>
</tasks>
<threat_model>
## Trust Boundaries
| Boundary | Description |
|----------|-------------|
| Browser (angemeldeter Benutzer) -> `PUT /dashboard/layout` (`layouts` Json) | Vom Benutzer kontrolliertes JSON inklusive des Markers `__gridVersion`; wird ungeprueft (`@IsObject()`) in die eigene `DashboardLayout`-Zeile geschrieben und beim naechsten Laden vom Frontend interpretiert |
| Browser -> `PATCH /dashboard/widgets/:id/config` (`timeFontSizePt`) | Vom Benutzer kontrollierter Wert landet ungeprueft in `WidgetInstance.config` und wird spaeter in einen Inline-Style des Uhr-Widgets uebersetzt |
| Gespeichertes JSON -> `migrateGridLayouts` -> Zustand -> Speichern | Die Umrechnung veraendert Benutzerdaten; ein Fehler (fehlender Marker) wiederholt sich bei jedem Laden |
| Widget-Konfiguration -> CSS (`font-size`) | Konfigurationsdaten werden zu Style |
## STRIDE Threat Register (ASVS Level 1, Blocking-Schwelle `high`)
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|-----------|----------|-----------|----------|-------------|-----------------|
| T-BWO-01 | Tampering | `timeFontSizePt` -> Inline-Style in `clock-widget.tsx` | low | mitigate | `resolveClockTimeFontSizePt` laesst NUR `typeof number`, endlich, 8..200 durch; alles andere ist „automatisch“ ohne Inline-Style; der Style entsteht als React-Objekt `{ fontSize: `${n}pt` }` aus einer Zahl, nie aus Text; Tests pinnen `'36'` (Zeichenkette), NaN, Infinity, 7, 201 -> auto; dieselben Grenzen im Formular (eine Quelle: `clock-font-size.ts`) |
| T-BWO-02 | Tampering / Integritaet | Umrechnung gespeicherter Anordnungen (`migrateGridLayouts`, Store) | medium | mitigate | Marker `__gridVersion: 2` im gespeicherten JSON; Verdopplung NUR ohne numerischen Marker `>= 2`; Idempotenz-Test (Falsifizierung a); Store-Tests pinnen Marker bei JEDEM `api.saveLayout` (Laden mit Umrechnung UND normales Speichern); Marker nie im Zustand (Store-Iteration); Sofort-Speichern nach der Umrechnung, Fehler protokolliert statt verschluckt |
| T-BWO-03 | Elevation of Privilege | Fremde Anordnungen/Widgets ueber die Umrechnung | low | accept | Keine neue API, keine neue Abfrage: `getLayout`/`saveLayout`/`updateWidgetConfig` bleiben `forTenant(prisma, tenantId, userId)`-gebunden mit Besitzpruefung (Spec 260910-krx unveraendert gruen); die Umrechnung laeuft im Browser des Benutzers auf seiner eigenen, ueber die gebundenen Wege geladenen Anordnung |
| T-BWO-04 | Denial of Service | Manipulierter Marker oder absurde Werte in der EIGENEN Anordnung (`__gridVersion: 99`, `x: 1e9`) | low | accept | Wirkt nur auf das eigene Dashboard (Zeile je Benutzer); react-grid-layout begrenzt Positionen ueber `correctBounds`; ein Marker `>= 2` verhindert lediglich die Verdopplung; kein Absturz: nicht-numerische Felder bleiben unveraendert, Nicht-Arrays werden weggelassen (Test 6/7) |
| T-BWO-05 | Information Disclosure | Neue Fehlerpfade (Speichern nach Umrechnung scheitert) | low | accept | `console.error` nur mit dem Fehlerobjekt des eigenen Aufrufs, keine fremden Daten; kein neuer Fehlerzustand in der Oberflaeche |
| T-BWO-06 | Tampering | CSS-Container-Queries / Tailwind-Klassen als Angriffsflaeche | low | accept | Klassen sind statische Literale im Quelltext, keine Benutzerdaten in `className` |
| T-BWO-SC | Tampering | npm/pip/cargo-Installationen | low | accept | Keine neuen Pakete, `pnpm-lock.yaml` unveraendert (`pnpm install --frozen-lockfile` als Gate in Task 3) |
</threat_model>
<verification>
Nach Task 3, alles aus `/home/vicolab/projects/tessera-ctl`:
- `pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)"` -> `Test Files 46 passed (46)` / `Tests 286 passed (286)`
- `pnpm -C apps/api exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)"` -> `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`
- `for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit; echo "TSC_$p=$?"; done` -> dreimal `=0`
- `pnpm install --frozen-lockfile; echo $?` -> `0`
- `D=$(git diff --stat 5f50c5f -- . ':!.planning'); tail -n1 <<< "$D"` -> `29 files changed`
- `git diff --stat 5f50c5f -- '.env*' docker-compose.yml docker-compose.prod.yml docker-compose.dev.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard/dashboard.service.ts apps/api/src/dashboard/dto apps/web/src/app/globals.css` -> leer
- Falsifizierungen im SUMMARY benannt: (a) Marker-Pruefung in `migrateGridLayouts` entfernt -> Idempotenz-Test rot (und Store-Test 2 rot); (b) `resolveClockTimeFontSizePt` ohne Typpruefung -> Test 6 der Uhr rot (`'36'` wuerde `36pt`); (c) eine Konstante in `widget-registry.tsx` auf den alten Wert -> Tabellen-Test rot, `rowHeight` auf 40 -> Grid-Props-Test rot. Jede Falsifizierung einmal durchfuehren, Testnamen rot notieren, zuruecksetzen.
- Human-Check (end-of-phase, nicht blockierend, durch den Verifizierer/Orchestrator mit Playwright MCP gegen die lokalen Container; VORHER `docker compose up -d --build web` — das Web-Abbild ist 39 Stunden alt; die API braucht keinen Neubau):
1. Anmelden (Benutzername `admin`, Kennwort `admin123` — Benutzername, nicht E-Mail). Dashboard: „Dashboard bearbeiten“, Uhr-Widget und Suchleiste hinzufuegen, Uhr rechts neben die Suchleiste ziehen, speichern.
2. Bounding-Boxen messen (Playwright `boundingBox()` der Elemente, nie per `fetch` aus der Seite): `main.app-shell-main` links vs. erstes Widget (`[data-widget-id]`) links -> Differenz 28 px (+/-1); zwei horizontal benachbarte Widgets -> Luecke 8 px (+/-1); oben `main` vs. erstes Widget -> 60 px (+/-1). Zweite Seite `/admin/users`: Abstand vom `main`-Rand zum ersten Inhaltselement 12 px (vorher 24) — Beleg, dass der Rahmen ueberall enger ist.
3. Raster: im Bearbeitungsmodus die Uhr um EINE Rasterstufe nach rechts ziehen — der Versatz betraegt eine Spaltenbreite von `(Containerbreite - 8*23 - 8*2)/24` px (bei 1200 px Containerbreite ca. 41 px statt ca. 83 px); notieren.
4. Skalierung: Uhr im Bearbeitungsmodus auf 12x8 vergroessern -> `getComputedStyle(time).fontSize` deutlich groesser als bei 4x4 (Zahlen notieren, z. B. 4x4 ca. 38-42 px, 12x8 ca. 80+ px); wieder verkleinern -> schrumpft; `data-font-mode="auto"`.
5. Punktgroesse: Einstellungen -> Dashboard, Uhr #1 aufklappen, „Schriftgröße der Uhrzeit (Punkt)“ auf 36, Feld verlassen; zurueck zum Dashboard -> `time.style.fontSize === '36pt'`, `getComputedStyle(time).fontSize === '48px'` (36 pt = 48 px) unabhaengig von der Widgetgroesse (einmal 4x4, einmal 12x8 pruefen); `data-font-mode="fixed"`. Danach 300 eintragen -> Fehlermeldung, kein Speichern; Feld leeren -> wieder automatisch.
6. Umrechnungs-Probe (SQL gegen die lokale Datenbank, Rolle `tessera` hat BYPASSRLS, Schalter AUS): `docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT "userId", layouts::text FROM "DashboardLayout";'` — die gespeicherte Anordnung (neue Einheiten, `__gridVersion: 2`) lesen und die Widget-Kennungen notieren. Dann die Zeile in ALTE Einheiten ohne Marker zurueckschreiben, z. B. `UPDATE "DashboardLayout" SET layouts = jsonb_build_object('lg', jsonb_build_array(jsonb_build_object('i','<uhr-id>','x',6,'y',0,'w',2,'h',2), jsonb_build_object('i','<such-id>','x',0,'y',0,'w',6,'h',2)), 'md','[]'::jsonb,'sm','[]'::jsonb,'xs','[]'::jsonb,'xxs','[]'::jsonb) WHERE "userId" = '<id>';`. Seite neu laden -> Uhr steht rechts neben der Suchleiste an derselben optischen Stelle (Bounding-Boxen vergleichen: Uhr links = Suchleiste rechts + 8 px); danach `SELECT layouts->'__gridVersion', layouts->'lg' FROM "DashboardLayout"` -> `2` und `x: 12, w: 4, h: 4` bzw. `x: 0, w: 12, h: 4`. Seite ein zweites Mal laden -> Werte unveraendert (keine erneute Verdopplung).
7. Rechner und Stoppuhr hinzufuegen, jeweils vergroessern -> Anzeige und Tasten wachsen mit, das Tastenraster bleibt 4x5 und ueberlaeuft nicht; bei Mindestgroesse bleibt der Rechner bedienbar (sonst: nur die Anzeige skalieren und das im SUMMARY begruenden — vorher gemessen, nicht angenommen).
</verification>
<success_criteria>
- Raster: 24/20/12/8/2 Spalten, 20 px Zeilen, 8 px Abstand und Randabstand des Grids; alle 32 Konstanten exakt verdoppelt und im Test festgenagelt; Grid-Props im Test ueber den Mock gelesen.
- Umrechnung: reine Funktion mit 7 Tests (alt x2, markiert unveraendert, leer leer, Idempotenz, Marker-Helfer, Zukunft/Robustheit, Fremdwerte), Store rechnet beim Laden um, speichert sofort mit Marker und traegt den Marker bei jedem Speichern; API unveraendert, Durchreichung von `__gridVersion` und `timeFontSizePt` per Spec gepinnt.
- Skalierung: Widget-Rumpf ist Groessen-Container; Uhr, Stoppuhr, Rechner tragen Container-Query-Klassen mit `clamp()`-Grenzen, keine Fensterbreiten-Formel mehr; Listen-Widgets bewusst unveraendert.
- Punktgroesse: `timeFontSizePt` 8..200 als Zahl, Feld unter Einstellungen -> Dashboard mit Hilfetext und Fehlermeldung (de/en, Sie-Form, Waechter gruen ohne Woerterbuch-Aenderung), Widget mit `36pt` im Style bzw. `auto`-Modus; Falsifizierungen a/b/c rot-gruen.
- Abstaende: Seitenrahmen 12 px (alle Seiten), Dashboard-Container 8 px, Umschalter bei 8 px, Widget-Innenabstaende halbiert (Tabelle), `mt-8` mit Messbegruendung; Browser: 28 px Rand, 8 px Luecke.
- Web 46/286, API 67/1078, tsc dreimal 0, Lockfile unveraendert, genau 29 Dateien ausserhalb `.planning`, vier Commits mit Scope `quick-260916-bwo`, gepusht, CI-Lauf `success` beobachtet, Abbild-Probe notiert; Handbuch nennt Raster, Skalierung und Schriftgroesse.
</success_criteria>
<output>
Create `.planning/quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/260916-bwo-SUMMARY.md` when done
</output>
@@ -0,0 +1,357 @@
---
phase: quick-260916-bwo
plan: 01
subsystem: ui, dashboard
tags: [dashboard, react-grid-layout, container-queries, tailwind, zustand, vitest, i18n]
requires:
- phase: 08-dashboard-widgets
provides: WIDGET_CONSTRAINTS, Uhr/Stoppuhr/Rechner-Widgets, Dashboard-Store, Widget-Einstellungen
provides:
- "Dashboard-Raster 24/20/12/8/2 Spalten, 20 px Zeilen, 8 px Abstand; alle 32 Widget-Konstanten verdoppelt"
- "Einmalige Umrechnung gespeicherter Anordnungen (grid-layout-migration.ts) mit Marker __gridVersion: 2 im gespeicherten JSON, nie im Zustand"
- "Uhr, Stoppuhr, Rechner skalieren per CSS-Container-Queries mit der Kachel (Widget-Rumpf ist @container-size)"
- "Uhr: optionale feste Schriftgroesse in Punkt (timeFontSizePt, 8..200, leer = automatisch) mit Zahlenfeld unter Einstellungen -> Dashboard"
- "Abstaende halbiert: Seitenrahmen p-3 (alle Seiten), Dashboard p-2, Grid 8 px, Widget-Innenabstaende"
affects: [dashboard, alle-seiten-rahmen, anwenderhandbuch]
actuals:
tokens: 72941
tasks: 3
commits: 4
plan_head_before: 50f201ecc1292232ff96e13226b62386cfc36e76
tech-stack:
added: []
patterns:
- "Marker im persistierten JSON, nie im Zustand: Store entfernt beim Laden, haengt bei JEDEM Speichern an (Idempotenz-Test + Store-Test pinnen es)"
- "Container-Query-Schriftgroessen als Tailwind-Klassen mit clamp()-Grenzen (jsdom verwirft clamp() im Inline-Style), feste Groesse als Inline-Style nur aus einer geprueften Zahl"
- "Grenzen fuer ein Config-Feld in EINER Quelldatei (clock-font-size.ts), von Formular und Widget benutzt"
- "react-grid-layout-Mock faengt Props per vi.hoisted ein, damit Raster-Konstanten testbar sind"
key-files:
created:
- apps/web/src/lib/grid-layout-migration.ts
- apps/web/src/lib/grid-layout-migration.test.ts
- apps/web/src/lib/stores/dashboard-store.test.ts
- apps/web/src/components/dashboard/widgets/clock-font-size.ts
- apps/web/src/components/settings/widget-settings-panel.test.tsx
modified:
- apps/web/src/components/dashboard/dashboard-grid.tsx
- apps/web/src/components/dashboard/dashboard-grid.test.tsx
- apps/web/src/components/dashboard/widget-registry.tsx
- apps/web/src/components/dashboard/widget-registry.test.tsx
- apps/web/src/lib/stores/dashboard-store.ts
- apps/api/src/dashboard/dashboard.service.spec.ts
- apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
- apps/web/src/components/dashboard/widgets/clock-widget.tsx
- apps/web/src/components/dashboard/widgets/clock-widget.test.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx
- apps/web/src/components/dashboard/widgets/calculator-widget.tsx
- apps/web/src/components/dashboard/widgets/calculator-widget.test.tsx
- apps/web/src/components/settings/widget-settings-panel.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- apps/web/src/components/dashboard/widgets/link-widget.tsx
- apps/web/src/components/dashboard/widgets/favorites-widget.tsx
- apps/web/src/components/dashboard/widgets/calendar-widget.tsx
- apps/web/src/components/dashboard/widgets/search-widget.tsx
- apps/web/src/components/dashboard/widgets/note-widget.tsx
- apps/web/src/app/(portal)/page.tsx
- apps/web/src/components/layout/app-shell.tsx
- docs/anleitung-anwender.md
key-decisions:
- "Umrechnung im Frontend (neben COLS), nicht in der API: Einheiten sind Frontend-Konstanten, kein Schreiben auf GET, API-Dienst/DTOs unangetastet, reine Funktion ohne Prisma testbar; Preis: Marker persistiert erst mit gelungenem PUT, bis dahin rechnet jedes Laden erneut aus den unveraendert alten DB-Werten (korrekt, nie halb geschrieben)"
- "Marker __gridVersion nur im gespeicherten JSON, nie im Zustand (Store iteriert mit Object.keys + .filter); withGridVersion an BEIDEN Speicherstellen"
- "mt-8 vor dem Grid bleibt: Umschalter 36 px hoch (p-2 + 20-px-Symbol) bei 8..44 px; mit mt-4 begaenne das erste Widget bei 32 px im Umschalter, mit mt-8 bei 48 px"
- "Automatische Schriftgroesse als Tailwind-Klasse (clamp/min/cqw/cqh), feste Punktgroesse als Inline-Style aus einer geprueften Zahl — Trennung wegen jsdom UND als einfachere Form"
- "Listen-/Formular-Widgets (note, calendar, favorites, link, search) skalieren bewusst NICHT — mehr Platz zeigt mehr Inhalt, nicht groessere Schrift"
patterns-established:
- "Einmalige Datenumrechnung im Client: reine Funktion + Marker + Idempotenz-Test + Store-Test 'jedes Speichern traegt den Marker'"
requirements-completed: [QUICK-260916-BWO]
coverage:
- id: D1
description: "Raster 24/20/12/8/2, rowHeight 20, margin 8, 32 Konstanten verdoppelt, data-grid-Vorgaben"
requirement: QUICK-260916-BWO
verification:
- kind: unit
ref: "apps/web/src/components/dashboard/dashboard-grid.test.tsx#Test 4-5, widget-registry.test.tsx#Tabelle (Falsifizierung c)"
status: pass
human_judgment: false
- id: D2
description: "Einmalige Umrechnung mit Marker, Store rechnet um und speichert sofort, Marker bei jedem Speichern, API reicht durch"
requirement: QUICK-260916-BWO
verification:
- kind: unit
ref: "apps/web/src/lib/grid-layout-migration.test.ts#Test 1-7 (Falsifizierung a), dashboard-store.test.ts#Test 1-6, dashboard.service.spec.ts#Test A-B"
status: pass
human_judgment: true
rationale: "Dass eine ALTE Anordnung im Browser an derselben optischen Stelle bleibt und nach zwei Ladevorgaengen nicht erneut verdoppelt wird, zeigt nur die SQL-Probe im Browser (unten)"
- id: D3
description: "Container-Query-Skalierung Uhr/Stoppuhr/Rechner, feste Punktgroesse, Einstellungsfeld, i18n"
requirement: QUICK-260916-BWO
verification:
- kind: unit
ref: "clock-widget.test.tsx#Test 3-6 (Falsifizierung b), stopwatch-widget.test.tsx#+1, calculator-widget.test.tsx#+1, widget-settings-panel.test.tsx#Test 1-4, umlaut-guard.spec.ts"
status: pass
human_judgment: true
rationale: "jsdom rechnet keine Container-Queries; ob cqh im Browser aufloest (definite Hoehe) und die Uhr sichtbar mitwaechst, muss der Browser zeigen"
- id: D4
description: "Abstaende halbiert (Seitenrahmen, Dashboard, Widget-Ruempfe), Handbuch"
requirement: QUICK-260916-BWO
verification:
- kind: other
ref: "grep-Gates Task 2/3 (Klassen, Handbuch 2/1)"
status: pass
human_judgment: true
rationale: "Bounding-Boxen (28 px Rand, 8 px Luecke, 60 px oben, 12 px auf /admin/users) nur im Browser messbar"
duration: "18 min (07:04Z bis 07:22Z, davon ca. 4 min Suiten-Laeufe und 5,5 min CI-Beobachtung)"
completed: "2026-09-16"
status: complete
---
# Quick 260916-bwo Plan 01: Dashboard — feineres Raster, skalierende Widget-Inhalte, halbe Abstaende — Summary
Das Dashboard-Raster ist doppelt so fein (24 statt 12 Spalten, 20 statt 40 px Zeilenhoehe, 8 statt 16 px Abstand) bei optisch gleich grossen Widgets (alle 32 Konstanten in `WIDGET_CONSTRAINTS` verdoppelt und im Test festgenagelt); gespeicherte Anordnungen in alten Einheiten werden beim Laden GENAU EINMAL mit 2 multipliziert und mit `__gridVersion: 2` im gespeicherten JSON markiert (reine Funktion `migrateGridLayouts`, Marker nie im Zustand, Idempotenz-Test); der Widget-Rumpf ist ein CSS-Groessen-Container, sodass Uhrzeit, Stoppuhr-Anzeige und Rechner (Anzeige und Tasten) per `cqw`/`cqh` mit der Kachel wachsen; die Uhrzeit laesst sich unter Einstellungen -> Dashboard -> Uhr in Punkt fest einstellen (8..200, leer = automatisch, Fremdwerte fallen auf automatisch zurueck, T-BWO-01); Seitenrahmen (`app-shell.tsx`, alle Seiten), Dashboard-Container, Grid-Abstand und Widget-Innenabstaende sind halbiert. Vier Commits auf `main` (`3f5afb0`, `2d8efe1`, `a175c00`, `1aefaa3`), gepusht, CI-Lauf 351 `success` in 5 min 26 s, `api:beta` traegt `1aefaa3 beta`.
## Ausgangslage und Bezugspunkt
Alle Gates gegen `5f50c5f` (Code unangetastet seit Planung; HEAD bei Start `50f201e` = Plan-Commit, Arbeitsbaum sauber). `git status -sb` bei Start: `## main...origin/main [voraus 2]` — die beiden Plan-Commits des Orchestrators (`7eb2516`, `50f201e`) waren noch nicht gepusht; sie gingen mit dem Push in Task 3 mit (`5f50c5f..1aefaa3`). Vorbedingung Task 3: `curl localhost:3002/api/v1/version` -> `{"version":"1.26.2"}`, `docker ps | grep -c '^gitea-runner$'` -> `1`.
Baseline vor jeder Aenderung (frisch gemessen, identisch mit der Planung):
| Suite | Vorher | Nachher (Ziel des Plans) |
|---|---|---|
| Web `pnpm -C apps/web exec vitest run` | `Test Files 43 passed (43)` / `Tests 260 passed (260)` | `Test Files 46 passed (46)` / `Tests 286 passed (286)` |
| API `pnpm -C apps/api exec vitest run` | `Test Files 67 passed (67)` / `Tests 1076 passed (1076)` | `Test Files 67 passed (67)` / `Tests 1078 passed (1078)` |
| `tsc --noEmit` shared / api / web | 0 / 0 / 0 | 0 / 0 / 0 |
Bestand an Anordnungen (nur lesend, `docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At`): lokal `DashboardLayout` 0, `WidgetInstance` 0 (erneut gemessen 07:19Z); alpha 0/0 laut Planung (nicht erneut gemessen); live nicht gemessen — die Umrechnung bleibt Pflicht.
## Task 1 — Raster verdoppelt, Umrechnung, Store, API-Durchreich-Specs (`3f5afb0`, 9 Dateien)
**RED (Schritt A)** `pnpm -C apps/web exec vitest run src/lib/grid-layout-migration.test.ts src/lib/stores/dashboard-store.test.ts src/components/dashboard`:
```
FAIL src/lib/grid-layout-migration.test.ts — Failed to resolve import "./grid-layout-migration"
× dashboard-store Test 1: expected { i: 'a', x: 1, y: 1, w: 2, h: 2 } to deeply equal { i: 'a', x: 2, y: 2, w: 4, h: 4 }
× dashboard-store Test 2: expected [ 'lg', 'md', 'sm', 'xs', 'xxs', …(1) ] to not include '__gridVersion'
× dashboard-store Test 4: expected "vi.fn()" to be called with arguments: [ ObjectContaining{…} ]
× dashboard-store Test 5: expected 1 to be 2
× dashboard-store Test 6: expected [ { i: 'n1', x: +0, y: +0, …(2) } ] to deep equally contain { i: 'n1', x: +0, y: +0, w: 4, h: 4 }
× dashboard-grid Test 4: expected { Object (lg, md, ...) } to deeply equal { lg: 24, md: 20, sm: 12, xs: 8, …(1) }
× dashboard-grid Test 5: expected { x: +0, y: +0, w: 2, h: 2, …(2) } to deeply equal { x: +0, y: +0, w: 4, h: 4, …(2) }
× widget-registry Tabelle: expected { …(8) } to deeply equal { …(8) }
Test Files 4 failed | 8 passed (12)
Tests 8 failed | 55 passed (63)
```
(Store-Test 3 „leer -> kein Speichern“ war nach altem Code bereits gruen — erwartbar, alter Code speicherte beim Laden nie.)
**API-Spec (+2)** `pnpm -C apps/api exec vitest run src/dashboard/dashboard.service.spec.ts` -> `Test Files 1 passed (1)` / `Tests 31 passed (31)` (vorher 29 `it(`-Bloecke). Beide neuen Tests waren nach heutigem Code sofort gruen — das ist der Beleg der Durchreichung (`@IsObject()`, `return record.layouts`, `{ ...widget.config, ...dto.config }`), kein RED.
**GREEN (Schritt E)** und Verify-Block:
```
Web (4 Dateien): Test Files 4 passed (4) / Tests 29 passed (29)
API: Test Files 1 passed (1) / Tests 31 passed (31)
greps: COLS 1, rowHeight 1, margin 1, clock 1, search 1, calculator 1, withGridVersion( 2, migrateGridLayouts( 1, GRID_VERSION 1
U_EXIT=0 U_EMPTY=0 (dashboard.service.ts, dto/, prisma/ unangetastet)
TSC_web=0 TSC_api=0
```
**Messung widerspricht dem Plan (beide festgehalten):** Der Plan nennt fuer die vier Web-Dateien `Tests 22 passed (22)` („5 + 4 + 7 + 6“); gemessen `29`. Ursache: `widget-registry.test.tsx` hatte vorher 10 Testfaelle (1 + `it.each` ueber 8 Typen + 1), der Plan zaehlte 3 `it(`-Bloecke. Mit +1 sind es 11 (`pnpm -C apps/web exec vitest run src/components/dashboard/widget-registry.test.tsx` -> `Tests 11 passed (11)`): 5 + 11 + 7 + 6 = 29. Die Zielzahl der Gesamtsuite (260 + 26 = 286) ist davon nicht betroffen und wurde exakt erreicht.
## Task 2 — Teil 2a: Skalierung, Punktgroesse, i18n (`2d8efe1`, 12 Dateien)
**RED (Schritt A)** `pnpm -C apps/web exec vitest run src/components/dashboard/widgets src/components/settings/widget-settings-panel.test.tsx`:
```
FAIL src/components/dashboard/widgets/clock-widget.test.tsx — Failed to resolve import "./clock-font-size"
× stopwatch quick-260916-bwo: expected 'font-mono font-semibold tabular-nums …' to match /cqw/
× calculator quick-260916-bwo: expected 'flex min-h-[2.5rem] items-end justify…' to match /cqw/
× widget-settings-panel Test 1-4: It looks like undefined was passed instead of a matcher (de.widgets.clock.fontSizeLabel fehlte noch)
Test Files 4 failed | 5 passed (9)
Tests 6 failed | 39 passed (45)
```
**GREEN (Schritt H)** `... src/components/dashboard/widgets src/components/settings/widget-settings-panel.test.tsx src/messages` -> `Test Files 11 passed (11)` / `Tests 57 passed (57)`; je Datei: clock 6, stopwatch 8, calculator 7, widget-settings-panel 4, `src/messages` 6 (Umlaut-Waechter und tenderRadar-Paritaet gruen OHNE Aenderung an `umlaut-dictionary.ts`); `TSC_web=0`.
**Messung widerspricht dem Plan (beide festgehalten):** Der Plan nennt fuer Commit 2a „genau 11 Dateien“, zaehlt in Klammern aber 12 auf (widget-wrapper, clock-font-size, clock + Test, stopwatch + Test, calculator + Test, widget-settings-panel + Test, de.json, en.json). `git show --stat 2d8efe1` -> `12 files changed`. 9 + 12 + 7 + 1 = 29 stimmt mit der Gesamtzahl des Plans ueberein; die „11“ ist ein Zaehlfehler des Plans, nicht des Commits.
## Task 2 — Teil 2b: Abstaende halbiert (`a175c00`, 7 Dateien)
Tabelle aus dem Plan eins zu eins umgesetzt (link 238 `p-1`, favorites 174 `p-1`, calendar 112 `p-1.5` und 80/91/102 `p-2`, search 89 `px-1.5`, note 89 `px-1.5 py-1.5`, page.tsx `relative p-2` / `right-2 top-2` / `mt-8` bleibt mit Kommentar, app-shell `main` `p-3` mit Kommentar).
**Verify-Block Task 2** (volle Web-Suite und 29 greps):
```
Test Files 46 passed (46) / Tests 286 passed (286)
@container-size 2 | Uhr-Klasse 1 | data-font-mode 1 | vw clock 0 | vw stopwatch 0 | cqw stopwatch 1 | cqw calculator 5 | h-full min-h-7 1
MIN 1 | MAX 1 | id=clock-font-size 1 | fontSizeLabel de 1 | fontSizeInvalid en 1 | D2_EXIT=0 DICT_UNCHANGED=0
relative p-2 1 | right-2 top-2 1 | "mt-8" 1 | app-shell p-3 2 | app-shell " p-6" 0 (nach Korrektur, s. Abweichung 2)
link 1 | favorites 1 | calendar Rumpf 1 | calendar Zustandsansichten 3 | search 1 | note 1 | clock 1 | stopwatch 1 | calculator 1 | TSC_web=0
```
## Task 3 — Handbuch, Abschluss-Gates, Push, CI (`1aefaa3`, 1 Datei)
`grep -c "Schriftgröße" docs/anleitung-anwender.md` -> `2`; `grep -c "feinen Schritten"` -> `1`.
Abschluss-Gates (nach dem Handbuch, vor dem Commit):
```
Web: Test Files 46 passed (46) / Tests 286 passed (286)
API: Test Files 67 passed (67) / Tests 1078 passed (1078)
TSC_packages/shared=0 TSC_apps/api=0 TSC_apps/web=0
FROZEN=0 (pnpm install --frozen-lockfile)
GIT_EXIT=0 29 files changed, 895 insertions(+), 60 deletions(-) (git diff --stat 5f50c5f -- . ':!.planning')
U_EXIT=0 U_EMPTY=0 (.env*, Compose, Lockfile, package.json, prisma, dashboard.service.ts, dto/, globals.css unangetastet)
```
Push 07:15:03Z: `5f50c5f..1aefaa3 main -> main`; `git fetch -q && git status -sb | head -1` -> `## main...origin/main` (kein `[ahead`, kein `[behind`).
### CI-Lauf nach dem Push
| Feld | Versuch 1 (einziger) |
|---|---|
| Lauf-ID | 351 (event `push`, ref `main`, `head_sha` `1aefaa36c1e3ae7c3055e714b059223a1e5aff77`) |
| status / conclusion | `completed` / **`success`** |
| started_at / completed_at | 09:15:08 / 09:20:34 (+02:00) — **5 min 26 s** (17 Polls a 20 s, kein Warten in der Warteschlange: der Lauf war beim ersten Poll 11 s nach dem Push bereits `in_progress`) |
| Jobs | Lint & Type Check `success` (07:15:08-07:15:57Z), Tests `success` (07:16:00-07:16:57Z), Build & Publish Images `success` (07:16:59-07:20:33Z) |
| `api:beta` node `APP_VERSION APP_CHANNEL APP_COMMIT` | `v1.0.0-10-g1aefaa3 beta 1aefaa3` — Messinstrument-Befund: der Plan erwartet fuer `APP_VERSION` den „kurzen SHA“; seit dem Tag `v1.0.0` (260915) liefert `git describe` `v1.0.0-10-g1aefaa3`, der kurze SHA steht in `APP_COMMIT` = `1aefaa3` = `git rev-parse --short HEAD`. Beide Werte sind das erwartete Abbild des gepushten Stands |
| `docker image inspect Created` web:beta / api:beta | `2026-09-16T09:18:31+02:00` / `2026-09-16T09:19:29+02:00` (nach dem Lauf-Start; fuer die Probe wurde `api:beta` per `docker pull` geholt, kein Container gebaut oder gestartet) |
## Falsifizierungen (a)-(c) — rot/gruen
Jede einmal durchgefuehrt, Rueckstellung per `git checkout -- <Datei>`, danach `git status --porcelain` leer.
| Falsifizierung | Eingriff | Rot (Testnamen woertlich) | Zurueckgesetzt |
|---|---|---|---|
| (a) Marker-Pruefung entfernt | `grid-layout-migration.ts`: `const needsScaling = true;` | `Tests 4 failed | 9 passed (13)`: Migration „Test 2: markierte Anordnung (__gridVersion 2) bleibt unveraendert, migrated false“, „Test 4: Idempotenz — einmal umgerechnet und markiert wird nicht erneut verdoppelt (T-BWO-02)“, „Test 6: Zukunft und Robustheit …“; Store „Test 2: markierte Anordnung bleibt unveraendert, kein Speichern, kein Marker im Zustand“ | ja, gruen |
| (b) `resolveClockTimeFontSizePt` ohne Typpruefung | `clock-font-size.ts`: `const value = Number(config.timeFontSizePt)` | `Tests 2 failed | 4 passed (6)`: „Test 3 (quick-260916-bwo): resolveClockTimeFontSizePt laesst nur endliche Zahlen 8..200 durch (T-BWO-01)“ (`expected 36 to be null`), „Test 6 (quick-260916-bwo): Zeichenketten-Wert wird ignoriert — auto, kein Inline-Style (T-BWO-01)“ (`expected '36pt' to be ''`) — genau der Angriff: `'36'` wuerde zum Style | ja, gruen |
| (c1) eine Konstante auf den alten Wert | `widget-registry.tsx`: `clock.minW: 2` | `Tests 2 failed | 14 passed (16)`: „quick-260916-bwo: jede Groesse ist exakt das Doppelte der alten 12-Spalten-Werte“, dashboard-grid „quick-260916-bwo Test 5: Widget ohne gespeicherten Eintrag bekommt die verdoppelten Vorgaben als data-grid“ | ja, gruen |
| (c2) `rowHeight` auf 40 | `dashboard-grid.tsx` | `Tests 1 failed | 4 passed (5)`: „quick-260916-bwo Test 4: Grid-Props — 24/20/12/8/2 Spalten, rowHeight 20, margin 8, Breakpoints unveraendert, containerPadding folgt dem margin“ | ja, gruen |
## Gemessene Befunde und Entscheidungen (Kurzform)
- **jsdom 29.1.1 / cssstyle** (Planungsmessung, in der Ausfuehrung durch die Tests bestaetigt): `style.fontSize = 'clamp(...)'` wird verworfen (`''`), `'36pt'` bleibt. Folge: automatische Groessen als Tailwind-Klassen (`text-[clamp(12px,min(20cqw,50cqh),400px)]` usw.), feste Punktgroesse als Inline-Style; Tests lesen `className`, `data-font-mode` und `style.fontSize` — Test 5/6 der Uhr laufen exakt so gruen.
- **Tailwind 4.3.1** (Planungsmessung): `@container-size` -> `container-type: size`; `text-[clamp(12px,min(20cqw,50cqh),400px)]` kompiliert mit verschachtelten Funktionen. Alle Klassen stehen woertlich im JSX bzw. als String-Literale in derselben Datei (Scanner). Nicht erneut kompiliert — der Browser-Nachweis prueft das Ergebnis.
- **Umrechnung im Frontend** (siehe key-decisions): Einheiten sind Frontend-Konstanten; die API reicht durch (Spec Test A/B pinnen es); kein Schreiben auf GET; reine Funktion ohne Prisma testbar. Preis: bis zum ersten gelungenen PUT rechnet jedes Laden erneut aus den unveraenderten alten DB-Werten — korrekt, weil `saveLayout` Marker und Werte immer gemeinsam schreibt.
- **`mt-8` bleibt**: Umschalter `p-2` + 20-px-Symbol = 36 px, mit `top-2` bei 8..44 px; erstes Widget mit `mt-8` bei 8+32+8 = 48 px (4 px Abstand), mit `mt-4` bei 32 px (12 px IM Umschalter). Kommentar in `page.tsx`.
- **Annahme „Listen-Widgets skalieren nicht“**: note, calendar, favorites, link, search behalten ihre Schriftgroessen — bei mehr Platz zeigen sie mehr Inhalt. Nur ihre Aussen-Innenabstaende sind halbiert.
- **Beobachtung**: Das `ClockConfig`-Formular traegt weiterhin ein hart englisches Label „Timezone“ und die Zeile „Saving...“ (ausserhalb des Auftrags, unveraendert). Ebenso „Title“ im Notiz-Formular und der englische Kalender-Hinweis.
- **Rechner-Speicherzeile** (`h-7 text-xs`) bleibt bewusst klein; die Tasten fuellen ihre Rasterzelle (`h-full min-h-7`), damit das 4x5-Raster mitwaechst.
## Task Commits
1. **Task 1: Raster, Umrechnung, Store, API-Specs** — `3f5afb0` (feat) — 9 Dateien
2. **Task 2a: Skalierung, Punktgroesse, i18n** — `2d8efe1` (feat) — 12 Dateien
3. **Task 2b: Abstaende halbiert** — `a175c00` (feat) — 7 Dateien
4. **Task 3: Anwenderhandbuch** — `1aefaa3` (docs) — 1 Datei
`commits: 4` gemessen aus `git rev-list --count 50f201e..HEAD` (Ledger `plan_head_before` = `50f201ecc1292232ff96e13226b62386cfc36e76`). `actuals.tokens` = 291.763 Zeichen ueber die 29 geaenderten Dateien / 4 = 72.941 (Methode wie 260914-m97; der reine Diff waere 65.872 Zeichen = 16.468). Der Plan schaetzte 120.000 bei `confidence: low`.
`git log --oneline 50f201e..HEAD` (vor dem SUMMARY, 07:21Z):
```
1aefaa3 docs(quick-260916-bwo): Anwenderhandbuch — feines Raster, Uhrzeit skaliert mit der Kachel, Schriftgroesse in Punkt
a175c00 feat(quick-260916-bwo): Abstaende halbiert — Seitenrahmen p-3 (alle Seiten), Dashboard p-2, Grid 8 px, Widget-Innenabstaende
2d8efe1 feat(quick-260916-bwo): Widget-Inhalt skaliert per Container-Queries (Uhr, Stoppuhr, Rechner), Punktgroesse der Uhrzeit einstellbar
3f5afb0 feat(quick-260916-bwo): Dashboard-Raster verdoppelt (24 Spalten, 20 px, 8 px Abstand), Konstanten x2, einmalige Umrechnung gespeicherter Anordnungen mit Marker __gridVersion
```
`git status --porcelain` (vor dem SUMMARY): leer. `git status -sb | head -1`: `## main...origin/main`.
## Deviations from Plan
### Auto-fixed Issues
**1. [Rule 3 - Blocking] Versehentliches `git stash` waehrend Task 1, sofort zurueckgeholt**
- **Found during:** Task 1, zwischen GREEN-Lauf und Commit
- **Issue:** In einem Messbefehl (Zaehlen der Registry-Testfaelle) lief ein `git stash -q` mit, das die sechs geaenderten, noch nicht committeten Dateien in `stash@{0}` verschob (die drei neuen Dateien blieben als unversioniert liegen). Die Stash-Liste war vor Beginn leer (geprueft), der einzige Eintrag war mein eigener auf HEAD `50f201e`; kein Worktree, keine Nebenlaeufer.
- **Fix:** `git stash pop` (Ausgabe: alle sechs Dateien wieder geaendert, `refs/stash@{0} … geloescht`), Stash-Liste danach leer; Inhalt per grep und erneutem Testlauf (`Test Files 4 passed (4)` / `Tests 29 passed (29)`) bestaetigt, dann erst committet.
- **Files modified:** keine (Wiederherstellung des Arbeitsbaums)
- **Commit:** — (`3f5afb0` enthaelt den unveraenderten Stand)
**2. [Rule 1 - Bug] Gate `grep -c " p-6"` in `app-shell.tsx` musste 0 sein, lieferte 1**
- **Found during:** Task 2b, Verify-Block
- **Issue:** Die Klasse `p-6` war korrekt durch `p-3` ersetzt, aber mein neuer JSX-Kommentar enthielt wörtlich „statt p-6 (24 px)“ und traf das Muster.
- **Fix:** Kommentar umformuliert („statt vorher 24 px (Stufe 6)“); Gate danach `0`, `p-3` weiterhin `2` (Kommentar + Klasse), tsc 0. Innerhalb der Allowlist, vor dem Commit 2b.
- **Files modified:** `apps/web/src/components/layout/app-shell.tsx`
- **Commit:** `a175c00`
### Messungen, die dem Plan widersprechen (beide Zahlen oben festgehalten)
1. Task 1 Web-Vitest-Zeile: Plan `22`, gemessen `29` — `it.each` ueber 8 Typen in `widget-registry.test.tsx` (Plan zaehlte `it(`-Bloecke). Gesamtsuite 286 wie geplant.
2. Commit 2a: Plan „11 Dateien“, gemessen `12` — der Plan listet selbst 12 auf; 9 + 12 + 7 + 1 = 29 stimmt.
3. Abbild-Probe: Plan „`APP_VERSION` -> kurzer SHA“, gemessen `v1.0.0-10-g1aefaa3` (`git describe` seit dem Tag v1.0.0); der kurze SHA `1aefaa3` steht in `APP_COMMIT`.
## Was bewusst offen bleibt
- **Browser-Nachweis** (Bounding-Boxen, Rasterstufe, Skalierung, Punktgroesse, SQL-Probe der Umrechnung, Rechner bei Mindestgroesse): nicht im Executor moeglich (jsdom rechnet keine Container-Queries, keine Container gebaut) — Human-Check `end-of-phase`, Anleitung unten.
- **Rechner bei Mindestgroesse (4x8 = 8 Zeilen x 20 px + 7 x 8 px = 216 px)**: Der Plan nennt den heutigen Ueberlauf bei alter Mindestgroesse; ob der Rechner mit `h-full min-h-7`-Tasten (5 x 28 px = 140 px + Anzeige 40 + Speicherzeile 28 + Luecken ca. 24 = ca. 232 px) bei 216 px bedienbar bleibt, ist im Browser zu messen (Punkt 7 unten). Faellt er durch, ist die Rueckfalloption des Plans „nur die Anzeige skalieren“ — vorher messen.
- **Hart englische Texte im Einstellungsformular** („Timezone“, „Saving...“, „Title“, Kalender-Hinweis): ausserhalb des Auftrags, unveraendert.
- **Marker-Persistenz bei dauerhaft scheiterndem PUT**: bis zum ersten gelungenen Speichern rechnet jedes Laden erneut aus den alten DB-Werten (korrekt, aber jedes Laden loest einen PUT-Versuch aus, `console.error` je Versuch).
- **Live (`tessera.ctl.de`)**: Bestand nicht gemessen; nach dem naechsten Deploy rechnet jeder Benutzer seine Anordnung beim ersten Laden selbst um.
## Fuer den Verifizierer/Orchestrator (Browser-Nachweis)
Vorher `docker compose up -d --build web` (Web-Abbild vom 14.09.; `up` allein baut nicht neu). Die API braucht keinen Neubau. Anmelden mit Benutzername `admin`, Kennwort `admin123`. Alle Bounding-Boxen per Playwright `boundingBox()`, nie per `fetch` aus der Seite.
1. **Anordnung anlegen:** Dashboard -> „Dashboard bearbeiten“ -> Uhr und Suchleiste hinzufuegen, Uhr rechts neben die Suchleiste ziehen, Bearbeitungsmodus beenden (speichert).
2. **Abstaende:** `main.app-shell-main` links vs. erstes `[data-widget-id]` links -> 28 px (+/-1; vorher 56); zwei horizontal benachbarte Widgets -> Luecke 8 px (+/-1; vorher 16); `main` oben vs. erstes Widget -> 60 px (+/-1; vorher 88). Zweite Seite `/admin/users`: `main`-Rand zum ersten Inhaltselement 12 px (vorher 24).
3. **Raster:** Uhr im Bearbeitungsmodus um EINE Stufe nach rechts ziehen -> Versatz eine Spaltenbreite `(Containerbreite - 8*23 - 8*2) / 24` px (bei 1200 px ca. 41 px, vorher ca. 83 px).
4. **Skalierung:** Uhr auf 12x8 vergroessern -> `getComputedStyle(time).fontSize` deutlich groesser als bei 4x4 (Zahlen notieren; Erwartung 4x4 ca. 38-42 px, 12x8 ca. 80+ px); verkleinern -> schrumpft; `time.dataset.fontMode === 'auto'`. Ist `cqh` 0 (Uhr unsichtbar klein), fehlt die definite Hoehe — dann `widget-wrapper.tsx` pruefen (Rumpf `h-full` in der Karte `h-full`).
5. **Punktgroesse:** Einstellungen -> Dashboard -> Widgets, „Uhr #1“ aufklappen, „Schriftgröße der Uhrzeit (Punkt)“ auf `36`, Feld verlassen -> zurueck zum Dashboard: `time.style.fontSize === '36pt'`, `getComputedStyle(time).fontSize === '48px'` bei 4x4 UND 12x8, `data-font-mode="fixed"`, Datum `14.4pt`. Dann `300` -> Fehlermeldung „Bitte geben Sie eine Zahl zwischen 8 und 200 ein oder lassen Sie das Feld leer.“, kein Speichern (Netzwerk: kein PATCH). Feld leeren, Enter -> wieder automatisch.
6. **Umrechnungs-Probe (SQL, lokale DB, Rolle `tessera` hat BYPASSRLS, Schalter AUS).** Zuerst den gespeicherten Stand lesen und die Kennungen notieren:
```
docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT "userId", layouts::text FROM "DashboardLayout";'
docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT id, "widgetType" FROM "WidgetInstance" ORDER BY "createdAt";'
```
Erwartung nach Schritt 1: `__gridVersion: 2`, Suchleiste `x: 0, w: 12, h: 4`, Uhr `x: 12, w: 4, h: 4` (o. ae.). Dann die Zeile in ALTE Einheiten ohne Marker zurueckschreiben (`<uhr-id>`/`<such-id>` aus der zweiten Abfrage; `userId` des lokalen Admins ist `1166431d-a556-47d0-9e19-6bd3616f148f`):
```sql
UPDATE "DashboardLayout"
SET layouts = jsonb_build_object(
'lg', jsonb_build_array(
jsonb_build_object('i','<uhr-id>','x',6,'y',0,'w',2,'h',2),
jsonb_build_object('i','<such-id>','x',0,'y',0,'w',6,'h',2)),
'md','[]'::jsonb,'sm','[]'::jsonb,'xs','[]'::jsonb,'xxs','[]'::jsonb),
"updatedAt" = now()
WHERE "userId" = '1166431d-a556-47d0-9e19-6bd3616f148f';
```
**Falls noch keine Widgets/Anordnung existieren** (lokal waren es zum Zeitpunkt der Ausfuehrung 0/0), stattdessen alles in einem Rutsch anlegen — Uhr und Suchleiste als `WidgetInstance` plus die Anordnung in ALTEN Einheiten (Admin-User `1166431d-a556-47d0-9e19-6bd3616f148f`, Mandant `e2592907-0118-4cce-a407-7e27d375b68d`; beide Kennungen am 16.09. aus `"User"` gelesen, bei einer neu aufgesetzten DB erneut per `SELECT id, "tenantId" FROM "User" WHERE username = 'admin';` holen):
```sql
INSERT INTO "WidgetInstance" (id, "userId", "tenantId", "widgetType", config, "createdAt", "updatedAt") VALUES
('probe-suche-1', '1166431d-a556-47d0-9e19-6bd3616f148f', 'e2592907-0118-4cce-a407-7e27d375b68d', 'search', '{}'::jsonb, now(), now()),
('probe-uhr-1', '1166431d-a556-47d0-9e19-6bd3616f148f', 'e2592907-0118-4cce-a407-7e27d375b68d', 'clock', '{"timezone":"Europe/Berlin","showDate":true}'::jsonb, now() + interval '1 second', now());
INSERT INTO "DashboardLayout" (id, "userId", "tenantId", layouts, "createdAt", "updatedAt") VALUES
('probe-layout-1', '1166431d-a556-47d0-9e19-6bd3616f148f', 'e2592907-0118-4cce-a407-7e27d375b68d',
'{"lg":[{"i":"probe-suche-1","x":0,"y":0,"w":6,"h":2},{"i":"probe-uhr-1","x":6,"y":0,"w":2,"h":2}],"md":[],"sm":[],"xs":[],"xxs":[]}'::jsonb,
now(), now());
```
(Alte Einheiten: Suchleiste 6x2 ab Spalte 0, Uhr 2x2 ab Spalte 6 — die frueheren Vorgabegroessen, Uhr direkt rechts neben der Suchleiste.) Seite laden -> Uhr steht rechts neben der Suchleiste (Uhr links = Suchleiste rechts + 8 px, Bounding-Boxen), nicht halb so gross und nicht verrutscht; danach:
```
docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT layouts->''__gridVersion'', layouts->''lg'' FROM "DashboardLayout";'
```
-> `2` und Suchleiste `x: 0, w: 12, h: 4`, Uhr `x: 12, w: 4, h: 4`. Seite ein ZWEITES Mal laden -> Werte unveraendert (keine erneute Verdopplung). Aufraeumen der Probe: `DELETE FROM "DashboardLayout" WHERE id = 'probe-layout-1'; DELETE FROM "WidgetInstance" WHERE id IN ('probe-suche-1','probe-uhr-1');` (nur falls per INSERT angelegt).
7. **Rechner und Stoppuhr:** beide hinzufuegen, vergroessern -> Anzeige und Tasten wachsen mit, das Tastenraster bleibt 4x5 und ueberlaeuft nicht; auf Mindestgroesse (Rechner 4x8, Stoppuhr 4x4) verkleinern -> Rechner bedienbar, Stoppuhr-Anzeige lesbar. Ueberlaeuft der Rechner bei 4x8: Hoehe der Tasten und der Anzeige notieren (siehe „Was bewusst offen bleibt“).
## Fuer den Changelog
- Das Dashboard-Raster ist doppelt so fein: Widgets lassen sich in kleineren Schritten verschieben und in der Groesse ziehen, bleiben dabei aber genauso gross wie bisher. Bereits gespeicherte Anordnungen werden beim ersten Aufruf automatisch uebernommen und verrutschen nicht.
- Uhrzeit, Stoppuhr und Rechner wachsen und schrumpfen jetzt mit ihrer Kachel — eine grosse Uhr-Kachel zeigt eine grosse Uhrzeit.
- Die Uhr hat eine neue Einstellung: unter Einstellungen > Dashboard laesst sich die Schriftgroesse der Uhrzeit fest in Punkt (8 bis 200) vorgeben; leer gelassen passt sie sich weiter automatisch an.
- Die Raender sind ueberall enger: der aeussere Seitenrahmen auf allen Seiten, der Abstand zwischen den Widgets und die Innenabstaende in den Widgets sind halbiert.
- Das Anwenderhandbuch beschreibt das feine Raster, die mitwachsende Uhrzeit und die neue Schriftgroessen-Einstellung.
## Self-Check: PASSED
- Dateien: alle 5 neu angelegten Dateien vorhanden (`grid-layout-migration.ts/.test.ts`, `dashboard-store.test.ts`, `clock-font-size.ts`, `widget-settings-panel.test.tsx`).
- Commits: `3f5afb0`, `2d8efe1`, `a175c00`, `1aefaa3` in `git log --oneline --all` gefunden; `git ls-remote origin main` = `1aefaa3`; `main == origin/main`.
- `commits: 4` = `git rev-list --count 50f201e..HEAD`; `git status --porcelain` leer vor dem SUMMARY.
@@ -0,0 +1,210 @@
---
phase: quick-260916-bwo
verified: 2026-09-16T09:32:00Z
status: passed
score: 8/8 must-haves (Code-Ebene) verifiziert; Bounding-Box-/Browser-Nachweis steht beim Orchestrator aus (siehe eigener Abschnitt, zaehlt laut Auftrag NICHT als human_needed)
covered_files:
- .planning/quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/260916-bwo-PLAN.md
- .planning/quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/260916-bwo-SUMMARY.md
- apps/api/src/dashboard/dashboard.service.spec.ts
- apps/web/src/app/(portal)/page.tsx
- apps/web/src/components/dashboard/dashboard-grid.test.tsx
- apps/web/src/components/dashboard/dashboard-grid.tsx
- apps/web/src/components/dashboard/widget-registry.test.tsx
- apps/web/src/components/dashboard/widget-registry.tsx
- apps/web/src/components/dashboard/widgets/calculator-widget.test.tsx
- apps/web/src/components/dashboard/widgets/calculator-widget.tsx
- apps/web/src/components/dashboard/widgets/calendar-widget.tsx
- apps/web/src/components/dashboard/widgets/clock-font-size.ts
- apps/web/src/components/dashboard/widgets/clock-widget.test.tsx
- apps/web/src/components/dashboard/widgets/clock-widget.tsx
- apps/web/src/components/dashboard/widgets/favorites-widget.tsx
- apps/web/src/components/dashboard/widgets/link-widget.tsx
- apps/web/src/components/dashboard/widgets/note-widget.tsx
- apps/web/src/components/dashboard/widgets/search-widget.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
- apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
- apps/web/src/components/layout/app-shell.tsx
- apps/web/src/components/settings/widget-settings-panel.test.tsx
- apps/web/src/components/settings/widget-settings-panel.tsx
- apps/web/src/lib/grid-layout-migration.test.ts
- apps/web/src/lib/grid-layout-migration.ts
- apps/web/src/lib/stores/dashboard-store.test.ts
- apps/web/src/lib/stores/dashboard-store.ts
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- docs/anleitung-anwender.md
covered_digest: "v1:sha256:dacef1a2fbd450d5f16d8d363537e171cdc2e0a539edff4c8287fe508922f96f"
behavior_unverified: 0
overrides_applied: 0
---
# Quick-Task 260916-bwo: Dashboard — feineres Raster, skalierende Widget-Inhalte, halbe Abstaende — Verifikation
**Auftrag:** Raster doppelt so fein (24/20/12/8/2 Spalten, rowHeight 20, margin [8,8], WIDGET_CONSTRAINTS x2), einmalige Umrechnung gespeicherter Anordnungen mit Marker `__gridVersion: 2`, Container-Query-Skalierung fuer Uhr/Stoppuhr/Rechner, Uhr mit einstellbarer Punktgroesse, Abstaende halbiert, Anwenderhandbuch, gepusht, CI gruen.
**Verifiziert:** 2026-09-16, gegen HEAD `1aefaa3` (main == origin/main)
**Status:** passed (Code-Ebene vollstaendig verifiziert; Browser-/Bounding-Box-Nachweis ist explizit Aufgabe des Orchestrators, siehe unten — laut Auftrag NICHT als human_needed zu werten)
Ich habe der SUMMARY.md an keiner Stelle vertraut, sondern jede Zahl, jede Datei und jeden Testlauf selbst erneut gemessen.
## 1. Git-Historie
| Pruefung | Befehl | Ergebnis | Status |
|---|---|---|---|
| Commit-Reihenfolge | `git log --oneline 50f201e..HEAD` | `1aefaa3`, `a175c00`, `2d8efe1`, `3f5afb0` (genau die vier erwarteten, in der erwarteten Reihenfolge) | OK |
| Gesamtumfang | `git diff --stat 5f50c5f -- . ':!.planning'` | `29 files changed, 895 insertions(+), 60 deletions(-)` | OK |
| Unantastbare Dateien | `git diff --name-only 5f50c5f -- '.env*' docker-compose*.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard/dashboard.service.ts apps/api/src/dashboard/dto apps/web/src/app/globals.css apps/web/src/messages/umlaut-dictionary.ts` | leer | OK |
| Dateien je Commit | `git show --stat <commit> \| grep -c '|'` | `3f5afb0`=9, `2d8efe1`=12, `a175c00`=7, `1aefaa3`=1 | OK — die im Plan genannte „11“ fuer 2a ist, wie im SUMMARY behauptet, ein Zaehlfehler des PLANS selbst: der Plan listet in Klammern selbst 12 Dateien auf (widget-wrapper, clock-font-size, clock+test, stopwatch+test, calculator+test, widget-settings-panel+test, de.json, en.json) und 9+12+7+1=29 stimmt mit der Gesamtsumme. Kein Abweichungsfund am Commit, sondern am Plantext. |
| Dateiliste je Commit vs. Plan-Aufgabenliste | `git show --stat --name-only <commit>` gegen die `<files>`-Listen der Tasks 1-3 | identisch (alle Dateien der Aufgabenliste, keine fehlt, keine zusaetzliche) | OK |
## 2. Testsuiten, Typprüfung, Lockfile (selbst erneut ausgefuehrt)
| Suite | Befehl | Erwartet | Gemessen | Status |
|---|---|---|---|---|
| Web-Vitest | `pnpm -C apps/web exec vitest run` | 46/286 | `Test Files 46 passed (46)` / `Tests 286 passed (286)` | OK |
| API-Vitest | `pnpm -C apps/api exec vitest run` | 67/1078 | `Test Files 67 passed (67)` / `Tests 1078 passed (1078)` | OK |
| tsc shared | `pnpm -C packages/shared exec tsc --noEmit` | 0 | Exit 0 | OK |
| tsc api | `pnpm -C apps/api exec tsc --noEmit` | 0 | Exit 0 | OK |
| tsc web | `pnpm -C apps/web exec tsc --noEmit` | 0 | Exit 0 | OK |
| Lockfile | `pnpm install --frozen-lockfile` | Exit 0, Lockfile unveraendert | Exit 0; `git status --porcelain -- pnpm-lock.yaml` leer | OK |
## 3. Code-Lesung — Raster, Konstanten, Umrechnung, Store
| Datei | Pruefung | Befund | Status |
|---|---|---|---|
| `dashboard-grid.tsx` | `COLS`, `rowHeight`, `margin`, `BREAKPOINTS`, Fallback `?? 4` | `COLS = { lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 }`, `rowHeight={20}`, `margin={[8, 8]}`, `BREAKPOINTS` unveraendert (`{ lg: 1200, md: 996, sm: 768, xs: 480, xxs: 0 }`), `data-grid`-Fallback jetzt `?? 4` | ✓ VERIFIED |
| `widget-registry.tsx` | Diff gegen `git show 5f50c5f:...widget-registry.tsx` | Alle 8 Widget-Typen x 4 Felder (32 Werte) exakt verdoppelt: clock 2/2/2/2→4/4/4/4, search 3/2/6/2→6/4/12/4, calendar 3/3/4/6→6/6/8/12, note 2/3/3/4→4/6/6/8, calculator 2/4/3/5→4/8/6/10, favorites 2/3/3/5→4/6/6/10, link 2/2/2/2→4/4/4/4, stopwatch 2/2/3/3→4/4/6/6 | ✓ VERIFIED |
| `grid-layout-migration.ts` | Volltext gelesen | `GRID_VERSION=2`, `GRID_VERSION_KEY='__gridVersion'`, `GRID_SCALE_FACTOR=2`; `migrateGridLayouts` markiert nur bei `typeof === 'number'` als Marker (Zeichenkette zaehlt als alt), skaliert `x,y,w,h,minW,minH,maxW,maxH` sofern `typeof === 'number'`, ueberspringt Nicht-Array-Breakpoints, entfernt den Marker aus der Rueckgabe, `isPlainObject` faengt `null/undefined/Zahl/Array` ab; `withGridVersion` haengt den Marker unmutierend an | ✓ VERIFIED |
| `grid-layout-migration.test.ts` | Volltext gelesen, 7 Tests inhaltlich mit `<behavior>` abgeglichen | Testfaelle 1-7 decken alt→x2, markiert→unveraendert, leer→leer, Idempotenz, `withGridVersion`, Zukunft/Zeichenketten-Marker/nicht-numerische Felder, Fremdwerte — Wortlaut und Erwartungswerte stimmen mit dem Plan ueberein | ✓ VERIFIED |
| `dashboard-store.ts` | Volltext gelesen, Aufrufstellen gezaehlt | `grep -c "withGridVersion("` = 2 (Sofort-Speichern nach Migration in `loadDashboard`, sowie `saveLayout`); `grep -c "migrateGridLayouts("` = 1 (nur in `loadDashboard`); Migrationsfehler landet in einem eigenen inneren try/catch, NICHT im aeusseren Lade-Fehlerzustand; Zustand traegt nie den Marker (Store iteriert `Object.keys` + Spread in `addWidget`/`removeWidget`) | ✓ VERIFIED |
| `dashboard-store.test.ts` | `it(...)`-Titel gelesen | Genau 6 Tests, inhaltlich passend zu den 6 im Plan beschriebenen Faellen (Umrechnung+Sofortspeichern, markiert bleibt, leer kein Speichern, jedes Speichern traegt Marker, Sofort-Speichern scheitert leise, neues Widget in verdoppelten Vorgaben) | ✓ VERIFIED |
| `dashboard.service.spec.ts` | `grep` auf `__gridVersion`/`timeFontSizePt` | Test A (`__gridVersion` uebersteht saveLayout→getLayout) und Test B (`timeFontSizePt` gemischt, `null` ueberschreibt, `timezone` bleibt) vorhanden, exakter Wortlaut wie im Plan | ✓ VERIFIED |
| `dashboard.service.ts`, `dto/`, `prisma/` | `git diff --stat 5f50c5f` | leer (keine Aenderung) | ✓ VERIFIED — Durchreichung ohne Codeaenderung, wie im Plan begruendet |
## 4. Unabhaengige Falsifizierung (Schritt 4 des Auftrags)
Eingriff: `needsScaling = version < GRID_VERSION;` in `migrateGridLayouts` zu `const needsScaling = true;` geaendert (Marker-Pruefung ausgehebelt).
```
pnpm -C apps/web exec vitest run src/lib/grid-layout-migration.test.ts
→ Test Files 1 failed (1)
Tests 3 failed | 4 passed (7)
```
Rot wurden genau die Tests, die die Marker-Pruefung absichern: Test 2 (markierte Anordnung bleibt unveraendert), Test 4 (Idempotenz, T-BWO-02) indirekt ueber Test 2/6, und Test 6 (Zukunft: Marker `3` bleibt unveraendert). Damit ist bewiesen, dass die Idempotenz/Marker-Logik tatsaechlich von der Pruefung abhaengt und nicht zufaellig gruen ist.
Ruecksetzung: `git checkout -- apps/web/src/lib/grid-layout-migration.ts`; danach `git status --porcelain -- apps/` leer (geprueft). Kein Rest des Eingriffs im Arbeitsbaum.
## 5. Widget-Skalierung, Punktgroesse, Einstellungen, i18n
| Pruefung | Befund | Status |
|---|---|---|
| `widget-wrapper.tsx` Rumpf | `` `@container-size h-full ${isEditMode ? 'pt-0' : ''}` `` mit Kommentar zur definiten Hoehe (aus der Karte, `h-full`) | ✓ VERIFIED |
| `clock-font-size.ts` | `CLOCK_FONT_SIZE_MIN_PT=8`, `MAX_PT=200`, `CLOCK_DATE_FACTOR=0.4`; `resolveClockTimeFontSizePt` prueft `typeof === 'number'`, `Number.isFinite`, Bereich 8..200 — Zeichenketten, `NaN`, `Infinity`, negative Zahlen, 7, 201 liefern alle `null` (Code selbst gelesen, nicht nur Test) | ✓ VERIFIED |
| `clock-widget.tsx` | `data-font-mode` auto/fixed, `style` nur bei Zahl gesetzt (`${fixedPt}pt` bzw. `${fixedPt*0.4}pt`), Klassen `text-[clamp(12px,min(20cqw,50cqh),400px)]` / `text-[clamp(10px,min(8cqw,20cqh),160px)]`, `p-1`, keine `vw`-Formel mehr | ✓ VERIFIED |
| `stopwatch-widget.tsx` | `text-[clamp(14px,min(16cqw,35cqh),400px)]`, `p-1.5`, kein `vw` | ✓ VERIFIED |
| `calculator-widget.tsx` | `baseBtn = 'h-full min-h-7 ...'`, Zahlen/Operator/Gleich `clamp(11px,min(4cqw,4.5cqh),40px)`, Funktionstasten `clamp(10px,min(3.2cqw,3.6cqh),32px)`, Anzeige `clamp(14px,min(8cqw,10cqh),96px)`, Speicherzeile bewusst `h-7 text-xs` | ✓ VERIFIED |
| `widget-settings-panel.tsx` | Feld `id="clock-font-size"`, `fontSizeDraft`/`fontSizeError`/`commitFontSize` nutzen `resolveClockTimeFontSizePt` aus derselben Quelldatei wie das Widget (eine Grenze) | ✓ VERIFIED |
| `de.json`/`en.json` | `widgets.clock.fontSizeLabel/fontSizeAuto/fontSizeHint/fontSizeInvalid` in beiden Sprachen, Sie-Form mit echten Umlauten geprueft, Wortlaut exakt wie im Plan | ✓ VERIFIED |
| Umlaut-Waechter / tenderRadar-Paritaet | `pnpm -C apps/web exec vitest run src/messages` → `Test Files 2 passed (2)` / `Tests 6 passed (6)`; `git diff --stat 5f50c5f -- apps/web/src/messages/umlaut-dictionary.ts` leer | ✓ VERIFIED |
## 6. Tailwind-Kompilat (Schritt 7 des Auftrags — unabhaengig nachgemessen)
Da `npx next build` zu schwer waere, habe ich `@tailwindcss/postcss` (dieselbe Version wie im Projekt) direkt ueber ein Wegwerf-Skript gegen den echten Quellbaum (`apps/web`) laufen lassen (`@import "tailwindcss";` als Eingabe, `base: apps/web`), das Ergebnis geprueft und danach die temporaeren Dateien geloescht (`git status --porcelain -- apps/web` anschliessend leer):
```
.\@container-size { container-type: size; }
.text-\[clamp\(...\)\] { font-size: clamp(12px, min(20cqw, 50cqh), 400px); }
```
Beide Kernklassen kompilieren tatsaechlich zu den erwarteten CSS-Eigenschaften. Damit ist die Kompilierbarkeit unabhaengig bestaetigt, nicht nur behauptet.
## 7. Abstaende
| Datei | Erwartung | Befund | Status |
|---|---|---|---|
| `app-shell.tsx` | `main` `p-3`, kein ` p-6` | `className="app-shell-main ... p-3"`, kein `p-6`-Treffer | ✓ VERIFIED |
| `page.tsx` | `relative p-2`, `right-2 top-2`, `mt-8` bleibt mit Begruendung | alle drei vorhanden, Kommentar mit Umschalter-Geometrie (36 px hoch, `top-2` 8..44 px, `mt-8` → 48 px) | ✓ VERIFIED |
| `link-widget.tsx` | `p-1` | `flex flex-col h-full overflow-auto p-1 gap-2` | ✓ VERIFIED |
| `favorites-widget.tsx` | `p-1` | dieselbe Klasse | ✓ VERIFIED |
| `calendar-widget.tsx` | Rumpf `p-1.5`, Zustandsansichten `p-2` | Zeilen 80/91/102 `p-2`, Rumpf `p-1.5` | ✓ VERIFIED |
| `search-widget.tsx` | `px-1.5` | `px-1.5` | ✓ VERIFIED |
| `note-widget.tsx` | `px-1.5 py-1.5` | vorhanden | ✓ VERIFIED |
## 8. Dokumentation
`docs/anleitung-anwender.md`: „feinen Schritten“ (1x), „Schriftgröße“ (2x, korrekt an den drei im Plan genannten Stellen), Text nennt feines Raster, mitwachsende Uhrzeit und die neue Punktgroessen-Einstellung, Alltagssprache mit echten Umlauten. ✓ VERIFIED
## 9. CI und Push (unabhaengig ueber die Gitea-API geprueft, Token nicht ausgegeben)
```
curl -H "Authorization: token $TOK" ".../actions/runs?limit=5"
→ Lauf 351, head_sha 1aefaa36c1e3ae7c3055e714b059223a1e5aff77, status completed, conclusion success
```
`docker run --rm --entrypoint node localhost:3002/schalli/tessera-ctl/api:beta -e '...'` → `v1.0.0-10-g1aefaa3 beta 1aefaa3` — exakt wie im SUMMARY behauptet. Die dritte im Auftrag genannte Messdiskrepanz („APP_VERSION“ = kurzer SHA erwartet, tatsaechlich `git describe`-Format) ist eine Fehlerwartung des PLANS: `APP_COMMIT` traegt korrekt den kurzen SHA `1aefaa3`, beide Werte spiegeln den gepushten Stand. Kein Fund gegen den Executor.
`git fetch -q && git status -sb | head -1` → `## main...origin/main` (kein `[ahead`, kein `[behind`). ✓ VERIFIED
## 10. Zwei dokumentierte Abweichungen — Bewertung
1. **Versehentlicher `git stash` waehrend Task 1** (sofort per `stash pop` zurueckgeholt): Der Dateivergleich `git show --stat --name-only 3f5afb0` gegen die Task-1-Dateiliste zeigt exakt die neun erwarteten Dateien mit dem inhaltlich erwarteten Code (siehe Abschnitt 3) — nichts wurde durch den Stash-Zwischenfall verloren. Bewertung: harmlos, korrekt dokumentiert.
2. **Grep-Gate `" p-6"` traf einen eigenen Kommentar** (umformuliert): `app-shell.tsx` enthaelt tatsaechlich `p-3` an der `main`-Klasse und keinen `p-6`-Treffer mehr; der Kommentar spricht jetzt von „24 px (Stufe 6)“ statt „p-6“. Bewertung: kosmetische Korrektur am eigenen Kommentartext, keine Funktionsaenderung, korrekt dokumentiert.
Keine der beiden Abweichungen hat Code oder Testabdeckung beeintraechtigt.
## 11. Anti-Pattern-Scan
`grep` auf `TBD|FIXME|XXX|TODO|HACK|PLACEHOLDER` (case-insensitiv, plus `placeholder|coming soon|not yet implemented`) ueber alle in dieser Phase veraenderten Dateien: ausschliesslich legitime HTML-`placeholder`-Attribute (Eingabefelder) und ein VORBESTEHENDER Kommentar „Placeholder widget for types not yet implemented“ in `widget-registry.tsx`, der schon in `5f50c5f` (vor dieser Phase) unveraendert vorhanden war (per `git show 5f50c5f:...` bestaetigt) und nicht zu den 32 verdoppelten Werten gehoert. Kein neuer Debt-Marker durch diese Phase. Keine Stub-Returns (`return null`/`{}`/`[]` an Render-Pfaden) gefunden.
## 12. Requirements-Abdeckung
Quick-Task mit `requirements: [QUICK-260916-BWO]` — kein separates `.planning/REQUIREMENTS.md`-Register fuer Quick-Tasks in diesem Projekt (projekttypisch); die Anforderung ist vollstaendig im PLAN/SUMMARY beschrieben und oben Punkt fuer Punkt gegen den Code verifiziert.
---
## Vom Orchestrator im Browser zu pruefen
Dies ist laut Auftrag AUSDRUECKLICH nicht Teil dieser Verifikation und zaehlt nicht als `human_needed`, sondern als eigener Nachweisschritt des Orchestrators (Playwright MCP gegen die lokalen Container). Vorher `docker compose up -d --build web` (Web-Abbild war 39h alt; `up` allein baut nicht neu). Anmeldung: Benutzername `admin`, Kennwort `admin123`.
1. **Anordnung anlegen:** Dashboard → „Dashboard bearbeiten“ → Uhr-Widget und Suchleiste hinzufuegen, Uhr rechts neben die Suchleiste ziehen, Bearbeitungsmodus beenden (speichert).
2. **Abstaende (Bounding-Boxen, `boundingBox()`, NIE per `fetch`):** `main.app-shell-main` links vs. erstes `[data-widget-id]` links → 28 px (±1; vorher 56); zwei horizontal benachbarte Widgets → Luecke 8 px (±1; vorher 16); `main` oben vs. erstes Widget → 60 px (±1; vorher 88). Zweite Seite `/admin/users`: Abstand `main`-Rand zum ersten Inhaltselement 12 px (vorher 24).
3. **Raster:** Uhr im Bearbeitungsmodus um eine Rasterstufe nach rechts ziehen → Versatz eine Spaltenbreite `(Containerbreite - 8*23 - 8*2)/24` px (bei 1200 px ca. 41 px statt ca. 83 px vorher).
4. **Skalierung:** Uhr auf 12x8 vergroessern → `getComputedStyle(time).fontSize` deutlich groesser als bei 4x4 (Erwartung 4x4 ca. 38-42 px, 12x8 ca. 80+ px); verkleinern → schrumpft; `data-font-mode="auto"`. Ist `cqh` 0 (Uhr unsichtbar klein), fehlt die definite Hoehe in `widget-wrapper.tsx`/Karte.
5. **Punktgroesse:** Einstellungen → Dashboard → Widgets → „Uhr #1“ → „Schriftgröße der Uhrzeit (Punkt)“ auf `36`, Feld verlassen → `time.style.fontSize === '36pt'`, `getComputedStyle(time).fontSize === '48px'` bei 4x4 UND 12x8, `data-font-mode="fixed"`, Datum `14.4pt`. Danach `300` → Fehlermeldung, kein Speichern (kein PATCH im Netzwerktab). Feld leeren, Enter → wieder automatisch.
6. **SQL-Umrechnungs-Probe** (lokale DB, Rolle `tessera`, BYPASSRLS, RLS-Schalter AUS):
```
docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT "userId", layouts::text FROM "DashboardLayout";'
docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT id, "widgetType" FROM "WidgetInstance" ORDER BY "createdAt";'
```
Gespeicherten Stand (neue Einheiten, `__gridVersion: 2`) lesen, dann per `UPDATE`/`INSERT` (siehe SUMMARY Abschnitt „Fuer den Verifizierer/Orchestrator“, wortgleiche SQL-Bloecke dort) in ALTE Einheiten ohne Marker zuruecksetzen bzw. neu anlegen. Seite laden → Uhr optisch an derselben Stelle rechts neben der Suchleiste (nicht halb so gross, nicht verrutscht); danach:
```
docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT layouts->''__gridVersion'', layouts->''lg'' FROM "DashboardLayout";'
```
→ `2`, Suchleiste `x:0,w:12,h:4`, Uhr `x:12,w:4,h:4`. Seite ein zweites Mal laden → Werte unveraendert (keine erneute Verdopplung). Probe-Datensaetze danach aufraeumen, falls per INSERT angelegt.
7. **Rechner/Stoppuhr:** hinzufuegen, vergroessern → Anzeige/Tasten wachsen mit, 4x5-Tastenraster ueberlaeuft nicht; auf Mindestgroesse (Rechner 4x8, Stoppuhr 4x4) verkleinern → Rechner bleibt bedienbar (im SUMMARY als offene Messfrage benannt — Rueckfalloption „nur Anzeige skalieren“, falls er ueberlaeuft), Stoppuhr-Anzeige lesbar.
## Angenommene Risiken
- **Container-Query-Aufloesung im echten Browser** (`cqh`/`cqw`, definite Hoehe der Kette Karte→Rumpf) ist mit jsdom prinzipiell nicht pruefbar; ich habe den Tailwind-Kompilat-Pfad unabhaengig verifiziert (Abschnitt 6), aber die tatsaechliche visuelle Skalierung im Chromium-basierten WebView bleibt Sache des Browser-Nachweises oben.
- **Rechner bei Mindestgroesse (4x8):** rechnerisch knapp (vom Executor selbst als offene Frage benannt, ca. 216 px Kachelhoehe vs. ca. 232 px benoetigter Inhalt) — nicht durch Code-Lesung entscheidbar, siehe Browser-Punkt 7.
- **Marker-Persistenz bei dauerhaft scheiterndem PUT:** akzeptiertes Verhalten laut Threat-Model (T-BWO-05, accept) — jedes Laden loest bis zum ersten erfolgreichen Speichern einen erneuten PUT-Versuch aus; kein Datenverlust, nur wiederholte Log-Eintraege.
- **Bestand an Anordnungen auf `alpha`/live** wurde vom Executor nicht zum Verifikationszeitpunkt erneut gemessen (nur zur Planungszeit 0/0 auf alpha, live gar nicht erreichbar) — die Umrechnung selbst ist unabhaengig vom Bestand korrekt (Code- und Falsifizierungsnachweis oben), aber ich kann den tatsaechlichen Produktivbestand nicht bestaetigen.
- **`git show`-Autorenzeile der Commits** nennt „Claude Opus 5 (1M context)“ statt der in dieser Sitzung vorgegebenen Attribution — das ist die Attribution der AUSFUEHRENDEN Sitzung (nicht dieser Verifikationssitzung) und kein inhaltlicher Mangel; nur der Vollstaendigkeit halber vermerkt.
## Nachtrag des Orchestrators — Browser-Check durchgefuehrt (2026-09-16, 07:33-07:36Z)
Umgebung: lokale Container aus `main` (`1aefaa3`) frisch gebaut, Playwright MCP (Chromium), Anmeldung als lokaler Admin.
| Schritt | Beobachtung |
|---|---|
| SQL-Probe Umrechnung | Anordnung in ALTEN Einheiten eingespielt (`search` 6x2 bei 0/0, `clock` 2x2 bei 6/0, kein Marker). Nach dem ersten Laden des Dashboards in der DB: `search` 12x4 bei 0/0, `clock` 4x4 bei 12/0, `"__gridVersion": 2` — genau verdoppelt, optisch an derselben Stelle |
| Abstaende (Bounding-Boxen) | `main` padding 12 px (vorher 24); Rand bis erstes Widget 28 px (vorher 56); Abstand zwischen zwei Widgets 8 px (vorher 16); erstes Widget bei top 120 |
| Uhr automatisch | Kachel 264x104 px -> Uhrzeit 51 px, `data-font-mode="auto"`, Rumpf `container-type: size`. Im Bearbeitungsmodus per Griff auf 536x300 px vergroessert -> Uhrzeit 106,8 px: skaliert mit der Kachel |
| Uhr feste Punktgroesse | Einstellungen -> Dashboard -> Widgets -> Uhr #1, Feld "Schriftgroesse der Uhrzeit (Punkt)" = 36 -> DB `timeFontSizePt: 36` (Zahl); Dashboard: Inline-Style `36pt`, berechnet 48 px, `data-font-mode="fixed"`, unabhaengig von der Kachelgroesse (264x104) |
| Rahmen auf anderer Seite | `/admin/users`: `main` padding 12 px, Klasse `p-3` |
| Rasterstufe | Kachel 4x4 = 264x104 px -> eine Spalte ca. 41 px, eine Zeile 20 px + 8 px Abstand (vorher 12 Spalten / 40 px) |
Nach der Probe: Probe-Zeilen aus der lokalen DB entfernt (0/0), Playwright-Artefakte entfernt, Arbeitsbaum unveraendert bis auf die Akten dieses Quick-Tasks.
@@ -0,0 +1,319 @@
---
phase: quick-260916-dcz
plan: 01
type: execute
wave: 1
depends_on: []
autonomous: true
requirements: [QUICK-260916-DCZ]
files_modified:
- CHANGELOG.md
- .dockerignore
- apps/web/Dockerfile
- apps/web/next.config.ts
- apps/web/src/lib/changelog.ts
- apps/web/src/lib/changelog.test.ts
- apps/web/src/app/(portal)/changelog/page.tsx
- apps/web/src/app/(portal)/changelog/changelog-page.test.tsx
- apps/web/src/components/changelog/changelog-view.tsx
- apps/web/src/components/layout/app-version-badge.tsx
- apps/web/src/components/layout/app-version-badge.test.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- .gitea/scripts/publish-release.sh
- .gitea/workflows/ci.yml
- docs/anleitung-betrieb.md
- docs/anleitung-anwender.md
- docs/anleitung-entwicklung.md
- docs/ci-cd-setup.md
estimate:
tokens: 140000
raw_tokens: 140000
tasks: 3
confidence: low
must_haves:
truths:
- "`CHANGELOG.md` liegt im Wurzelverzeichnis, deutsch mit echten Umlauten, Alltagssprache in Sie-Form, Form nach Keep a Changelog: H1, kurzer Vorspann, dann `## Unveröffentlicht` (Untergruppen `### Neu` / `### Geändert` mit den Punkten des Dashboard-Umbaus 260916-bwo, der Nachbesserung 260916-dyv und der Seite „Was ist neu“ dieses Auftrags — zu EINER stimmigen Liste zusammengefuehrt, 8 Punkte), darunter `## 1.0.0 – 2026-09-15` mit 6-12 Punkten des Live-Standes aus den Handbuechern (Portal, Dashboard-Widgets, Marktplatz/Freigaben, Ausschreibungs-Radar, DKV-Rechnung, Zertifikat-Manager + Domaincheck, Benutzer/Gruppen/AD, SMTP + Passwort zuruecksetzen, persoenliche Einstellungen, Fehler melden, Versionsanzeige). Keine Dateinamen, keine Commit-Kuerzel, keine unerklaerten Fachbegriffe."
- "Ein angemeldeter Anwender klickt unten in der Seitenleiste auf die Versionszeile (jetzt ein Link mit `aria-label` „Was ist neu“, `href=\"/changelog\"`, Tooltip unveraendert) und sieht unter `/changelog` im Portal-Layout die Seite „Was ist neu“ mit dem Inhalt von `CHANGELOG.md` als gerendertem Markdown (`MDEditor.Markdown` aus dem bereits installierten `@uiw/react-md-editor` 4.1.1 mit `rehype-sanitize`, kein neues Paket). Ohne Anmeldung leitet die bestehende Middleware auf `/login` um (`/changelog` ist keine oeffentliche Route)."
- "Kanalregel als reine Funktion `filterChangelogForChannel(markdown, channel, options?)` in `apps/web/src/lib/changelog.ts`: auf `live` fehlt der Abschnitt „Unveröffentlicht“ vollstaendig; auf `beta` und `dev` bleibt er und traegt die Ueberschrift „Noch nicht freigegeben (Beta)“ (uebersetzt), die Seite zeigt dazu einen Hinweis; ein leerer Abschnitt (ohne Listenpunkt) wird auf allen Kanaelen ausgeblendet; H1 und Vorspann vor der ersten `## `-Ueberschrift entfallen (die Seite hat ihren eigenen Titel). Falsifizierung (a): der live-Test wird rot, sobald die Funktion den Abschnitt nicht mehr entfernt."
- "Der Changelog-Text kommt zur BAUZEIT ins Bundle: `apps/web/next.config.ts` liest `../../CHANGELOG.md` per `fs.readFileSync` und legt den Text als `env.TESSERA_CHANGELOG_MD` ab (Next.js ersetzt `process.env.TESSERA_CHANGELOG_MD` in webpack UND Turbopack ueber denselben Define-Mechanismus — gemessen in `next/dist/lib/static-env.js` `getNextConfigEnv` + `serializeDefineEnv`). Fehlt die Datei, bricht der Build mit klarer deutscher Meldung ab. Im Docker-Bau liegt die Datei im Kontext (`.dockerignore` schliesst `*.md` an der Wurzel aus — gemessen: `COPY README.md` scheitert mit `not found` — daher die Ausnahme `!CHANGELOG.md`) und wird mit EINER COPY-Zeile in die builder-Stufe kopiert. Falsifizierung (c): im lokal gebauten Web-Abbild enthaelt `/app/apps/web/.next/server` den Datums-Marker der 1.0.0-Ueberschrift, `/app/apps/web/.next/static` NICHT (der Text liegt nur im Server-Bundle, nicht in oeffentlich abrufbaren Chunks)."
- "`.gitea/scripts/publish-release.sh` (POSIX sh, `set -eu`, `jq` + `curl` — beides im Runner-Abbild `gitea/runner-images:ubuntu-latest` vorhanden: jq 1.6, und auf dem Host: jq 1.7) entscheidet wie `publish-images.sh` anhand `GITHUB_REF` (`refs/tags/v*`, sonst „nichts zu tun“, Exit 0), akzeptiert `--tag vX.Y.Z` und `--dry-run`, schneidet den Abschnitt `## X.Y.Z` (bis zur naechsten `## `-Ueberschrift, ohne die eigene Ueberschrift, ohne Leerzeilen am Rand) per awk aus `CHANGELOG.md`, baut das JSON ausschliesslich mit `jq --arg`, legt den Release per `POST .../releases` an (`tag_name`, `name` = `Tessera X.Y.Z`, `body` = Abschnitt) und aktualisiert per `PATCH .../releases/{id}`, wenn `GET .../releases/tags/{tag}` bereits 200 liefert (idempotent, Text folgt CHANGELOG.md). Falsifizierung (b): `--dry-run --tag v9.9.9` (kein Abschnitt) endet mit Exit 1 und der Meldung, dass CHANGELOG.md keinen Abschnitt fuer 9.9.9 hat — es entsteht nie ein leerer Release. Das Token kommt nur aus `GITEA_TOKEN` (Umgebung), wird nie ausgegeben und nicht als Kommandozeilenargument uebergeben (Header aus Datei). API-Basis: `GITEA_API`, sonst `GITHUB_API_URL`, sonst `GITHUB_SERVER_URL/api/v1`, sonst `http://localhost:3002/api/v1` — im CI-Job-Container ist `localhost:3002` NICHT erreichbar (gemessen: 000), `https://git.vicolab.de` schon (200)."
- "`.gitea/workflows/ci.yml`: der Job `publish` hat nach dem Abbild-Schritt einen Schritt, der `sh .gitea/scripts/publish-release.sh` mit `GITEA_TOKEN: ${{ secrets.REGISTRY_TOKEN }}` in `env` aufruft (kein Echo, kein Argument). Das Token traegt gemessen `write:repository` (Scopes der Nutzer-Tokens `cc-full`/`Claude-Code`, per Basic-Auth gelesen) — das deckt Releases ab. Rueckwirkend existiert nach dem echten lokalen Lauf `--tag v1.0.0` (Token aus der Push-URL, nie ausgeben) der Release `Tessera 1.0.0` zum bestehenden Tag `v1.0.0` (Commit e509860; vorher gemessen: null Releases im Repo); ein zweiter Lauf geht den PATCH-Weg (Exit 0, weiterhin genau ein Release)."
- "Handbuecher: `docs/anleitung-betrieb.md` Kapitel 9 „Eine Version freigeben“ nennt VOR dem Tag den Schritt „CHANGELOG.md: Unveröffentlicht in X.Y.Z – Datum umbenennen, neues leeres Unveröffentlicht anlegen, auf main pushen“, den automatischen Gitea-Release durch die Pipeline (und was passiert, wenn der Abschnitt fehlt) und die Seite „Was ist neu“ als vierten Weg unter „Woran Sie erkennen, welche Version läuft“; der Absatz „Erstfreigabe v1.0.0“ steht in der Vergangenheit (erfolgt: Tag 2026-09-14, live seit 2026-09-15). `docs/anleitung-anwender.md` hat einen Abschnitt „Was ist neu“ (Klick auf die Version unten links; auf Live nur Freigegebenes) samt Inhaltsverzeichnis-Eintrag. `docs/anleitung-entwicklung.md` traegt unter „Konventionen und Fallstricke“ die Regel „jede Änderung sofort in CHANGELOG.md unter Unveröffentlicht“. `docs/ci-cd-setup.md` (ASCII-Umschrift wie im Bestand) nennt den vierten Schritt des Jobs `publish`, die Token-Berechtigung `repository: write` und den Release je Tag."
- "Baseline am Ende: Web `Test Files 49 passed (49)` / `Tests 309 passed (309)` (Planungszeit nach Revision 47/294 plus 10 in `changelog.test.ts`, 3 in `changelog-page.test.tsx`, 2 in `app-version-badge.test.tsx`), API unveraendert `67 passed (67)` / `1078 passed (1078)`, `tsc --noEmit` in web, api und shared Exit 0, `pnpm install --frozen-lockfile` Exit 0 (keine neuen Pakete), `git diff --stat 963fa36 -- . ':!.planning'` nennt genau `19 files changed`; `.env*`, Compose-Dateien, Prisma-Schema, `pnpm-lock.yaml`, `package.json` beider Apps, `umlaut-dictionary.ts` unangetastet. Nach `git push` endet der CI-Lauf zum gepushten Commit mit `conclusion == success` (der Release-Schritt meldet auf `main` „nichts zu tun“)."
artifacts:
- "CHANGELOG.md — H1 `# Änderungen an Tessera`, Vorspann (2-3 Saetze), `## Unveröffentlicht` mit `### Neu` (2 Punkte) und `### Geändert` (6 Punkte, bwo + dyv zusammengefuehrt), `## 1.0.0 – 2026-09-15` mit `### Neu` (11 Punkte)"
- ".dockerignore — Zeile `!CHANGELOG.md` direkt nach `*.md`"
- "apps/web/Dockerfile — in der builder-Stufe genau eine neue Zeile `COPY CHANGELOG.md ./` (zwischen `COPY tsconfig.base.json ./` und `ENV NEXT_PUBLIC_API_URL`), Kommentar mit Verweis auf next.config.ts"
- "apps/web/next.config.ts — `readChangelog()` (node:fs/node:path, `path.resolve(__dirname, '../../CHANGELOG.md')`, klare Fehlermeldung) und `env: { TESSERA_CHANGELOG_MD: readChangelog() }`"
- "apps/web/src/lib/changelog.ts — `export type ChangelogChannel = AppChannel`; `export interface FilteredChangelog { markdown: string; hasUnreleased: boolean }`; `export function filterChangelogForChannel(markdown: string, channel: AppChannel, options?: { unreleasedHeading?: string }): FilteredChangelog`; `export const UNRELEASED_HEADING = 'Unveröffentlicht'`; `export const changelogMarkdown: string = process.env.TESSERA_CHANGELOG_MD ?? ''` (voller Literalname)"
- "apps/web/src/lib/changelog.test.ts — NEU, 10 Tests laut <behavior>"
- "apps/web/src/app/(portal)/changelog/page.tsx — async Server-Komponente (kein 'use client'), `getTranslations('changelog')`, Kanal aus `appVersion.channel`, rendert `<h1>`, Intro, optionalen Hinweis (`data-testid=\"changelog-unreleased-hint\"`), `<ChangelogView markdown=…/>` oder Leer-Text (`data-testid=\"changelog-empty\"`)"
- "apps/web/src/app/(portal)/changelog/changelog-page.test.tsx — NEU, 3 Tests laut <behavior>"
- "apps/web/src/components/changelog/changelog-view.tsx — 'use client', `ChangelogView({ markdown })` mit `MDEditor.Markdown` (`source`, `rehypePlugins={[[rehypeSanitize]]}`, `wrapperElement={{ 'data-color-mode': mode }}` aus `useTheme().resolvedTheme` nach Mount, `data-testid=\"changelog-markdown\"` am Wrapper)"
- "apps/web/src/components/layout/app-version-badge.tsx — `span` wird `Link` (next/link) auf `/changelog` mit `aria-label={t('whatsNew')}`, `title` wie bisher, `data-testid=\"app-version\"`, Klassen wie bisher plus `hover:text-foreground hover:underline`"
- "apps/web/src/components/layout/app-version-badge.test.tsx — `next/link`-Mock (Props durchreichen) und 2 neue Tests (href, aria-label)"
- "apps/web/src/messages/de.json + en.json — `sidebar.whatsNew` und neuer Namensraum `changelog` mit `title`, `intro`, `unreleasedHeading`, `unreleasedHint`, `empty`"
- ".gitea/scripts/publish-release.sh — NEU, ausfuehrbar (chmod +x), Kopfkommentar wie publish-images.sh"
- ".gitea/workflows/ci.yml — vierter Schritt im Job `publish`"
- "docs/anleitung-betrieb.md, docs/anleitung-anwender.md, docs/anleitung-entwicklung.md, docs/ci-cd-setup.md — Abschnitte wie in den truths"
key_links:
- "Bauzeit-Einbettung: `env` in next.config.ts wird von `getNextConfigEnv` zu `process.env.TESSERA_CHANGELOG_MD` fuer client/edge/nodejs-Varianten definiert und per `serializeDefineEnv` JSON-stringifiziert (mehrzeilige Werte sicher). Deshalb (1) muss `changelog.ts` den vollen Literalnamen verwenden (kein Destructuring, kein `process.env[name]` — dieselbe Regel wie in app-version.ts), (2) darf `changelog.ts` NUR von der Server-Seite (`page.tsx`) importiert werden, damit der Text nicht in `.next/static` landet, (3) haengt die Docker-Falsifizierung an der COPY-Zeile PLUS der `.dockerignore`-Ausnahme — eine ohne die andere laesst den Build mit `not found` bzw. mit der eigenen Fehlermeldung scheitern."
- "Option (b) `?raw`/`asset/source` scheidet aus: `apps/web` startet mit `next dev --turbopack`, der `webpack`-Block in next.config.ts greift dort nicht, und eine Turbopack-`rules`-Regel braeuchte einen Loader (`raw-loader`) — verbotenes neues Paket. Option (a) Laufzeit-`fs.readFileSync` in einer Server-Komponente scheidet aus, weil jede Seite dynamisch ist (`i18n/request.ts` liest Cookies) und die Datei dann per `outputFileTracingIncludes` ausserhalb des Projektordners in die runner-Stufe muesste — zwei Mechanismen statt einem. Option (c) generierte Datei braeuchte Skript-Ketten vor build/dev/tsc/vitest."
- "Seite -> Abzeichen: `sidebar.test.tsx` mockt `@/components/layout/app-version-badge` komplett — der Link-Umbau erfordert dort keine Aenderung; `app-version-badge.test.tsx` rendert die echte Komponente und braucht deshalb einen `next/link`-Mock wie in sidebar.test.tsx (Props inkl. `aria-label`, `title`, `data-testid` durchreichen)."
- "Auth: `apps/web/src/middleware.ts` schuetzt jede Route ausser `/login`, `/reset-password`, `/_next/*`, `/api*` — `/changelog` ist damit ohne weiteres Zutun nur angemeldet erreichbar. Statische Chunks unter `/_next/static` sind NICHT geschuetzt — deshalb Server-Bundle-only (siehe oben)."
- "Release-Skript -> Gitea: Aus dem Job-Container ist Gitea nur ueber `https://git.vicolab.de` erreichbar (per-Job-Netz `GITEA-ACTIONS-TASK-…-network`, Runner-Instanz-URL = git.vicolab.de); `docker login localhost:3002` funktioniert heute nur, weil der Docker-DAEMON (Host) die Registry anspricht, nicht der Job-Container. Das Skript darf also im CI nie auf localhost:3002 zurueckfallen — es loest `GITHUB_API_URL`/`GITHUB_SERVER_URL` auf und gibt die gewaehlte API-Basis (ohne Token) als erste Zeile aus; der CI-Lauf auf `main` beweist die Aufloesung im Log, der Release-Weg selbst wird lokal gegen localhost:3002 mit `--tag v1.0.0` bewiesen."
- "Abschnitt-Schnitt: awk-Muster `^## X\\.Y\\.Z( |$)` bis zur naechsten `^## `; zur Planungszeit auf einem Muster-Changelog bewiesen (1.0.0 und 0.9.0 korrekt, `1.0` und `2.0.0` leer -> Exit 1). `## Unveröffentlicht` kann nie getroffen werden, weil der Tag `^v[0-9]+\\.[0-9]+\\.[0-9]+$` erfuellen muss."
- "Umlaut-Waechter: `umlaut-guard.spec.ts` prueft jede neue de.json-Zeichenkette gegen `SUSPECT_RE=/(ae|oe|ue|ss)/i` und die Allowlist. Die vorgegebenen Texte enthalten kein solches Token ausser bereits gelisteten Woertern (`aktuelle`) — daher bleibt `umlaut-dictionary.ts` unangetastet (Gate). Woerter wie „Neuerungen“ (ue), „Fassung“ (ss), „dass“ (ss) sind zu vermeiden."
---
<objective>
Revidiert (Runde 1): Bezugspunkt `963fa36`, Baseline Web 47/294, Nachbesserung 260916-dyv im Abschnitt „Unveröffentlicht“ aufgenommen.
Aenderungsliste fuer Anwender und Betrieb: (1) `CHANGELOG.md` im Wurzelverzeichnis in Alltagssprache (rueckwirkend 1.0.0, dazu „Unveröffentlicht“ mit dem Dashboard-Umbau und dieser Seite); (2) Seite „Was ist neu“ unter `/changelog`, erreichbar per Klick auf die Versionszeile in der Seitenleiste, mit Kanalfilter (Live sieht nur Freigegebenes) — Text zur Bauzeit ins Bundle, kein neues Paket; (3) Gitea-Release je Freigabe-Tag durch die Pipeline (Skript mit `--dry-run`, idempotent, rueckwirkend `v1.0.0`); (4) Handbuecher (Betrieb Kapitel 9, Anwender, Entwicklung, CI-Setup).
Purpose: Auf dem Live-Server soll jederzeit einsehbar sein, was sich geaendert hat — fuer Anwender in der Oberflaeche, fuer den Betrieb im Gitea-Release, fuer die Entwicklung als Pflichtschritt je Aenderung.
Output: 19 Dateien (13 Code/Tests/Bau, 2 CI, 4 Handbuecher), drei Commits mit Scope `quick-260916-dcz` (feat / ci / docs), gepusht, CI-Lauf beobachtet, Release `v1.0.0` in Gitea vorhanden.
</objective>
<execution_context>
@~/.claude/gsd-core/workflows/execute-plan.md
@~/.claude/gsd-core/templates/summary.md
</execution_context>
<context>
@.planning/STATE.md
@CLAUDE.md
@.planning/quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/260916-bwo-SUMMARY.md
@.planning/quick/260916-dyv-dashboard-nachbesserung-mindestgroessen-/260916-dyv-SUMMARY.md
@.planning/quick/260914-ku1-zwei-auslieferungskanaele-beta-auf-main-/260914-ku1-PLAN.md
@apps/web/src/components/layout/app-version-badge.tsx
@apps/web/src/components/layout/app-version-badge.test.tsx
@apps/web/src/lib/app-version.ts
@apps/web/src/components/layout/sidebar.test.tsx
@apps/web/src/components/modules/module-access-gate.tsx
@apps/web/src/components/modules/module-access-gate.test.tsx
@apps/web/src/components/dashboard/widgets/note-widget.tsx
@apps/web/src/components/dashboard/widgets/note-widget.test.tsx
@apps/web/src/middleware.ts
@apps/web/next.config.ts
@apps/web/Dockerfile
@.dockerignore
@.gitea/workflows/ci.yml
@.gitea/scripts/publish-images.sh
@apps/web/src/messages/umlaut-guard.spec.ts
@docs/anleitung-betrieb.md
@docs/anleitung-anwender.md
@docs/anleitung-entwicklung.md
@docs/ci-cd-setup.md
</context>
<planning_measurements>
**Revidiert (Runde 1, 2026-09-16):** Bezugspunkt ist jetzt HEAD `963fa36` (nach der Dashboard-Nachbesserung 260916-dyv: dc992c9, dbbd54f, cf97b5b, 8792819 + Akten 963fa36; Arbeitsbaum sauber, main == origin/main). Urspruenglich am 2026-09-16 an `7a6f42e` gemessen; alles unten gilt unveraendert, sofern nicht als Revision markiert. Abweichungen vom Auftragstext sind mit „DELTA“ markiert.
- Revision: dyv hat von den 19 Plan-Dateien nur `de.json`/`en.json` (je eine Zeile `dragHint` im Dashboard-Namensraum) und `docs/anleitung-anwender.md` (Abschnitt „Dashboard“, Zeilen 57-84: Stift-Schalter unten rechts, ganze Kachel ziehbar, Mindestgroessen) beruehrt — die Einfuegepunkte dieses Plans (`sidebar`/`changelog`-Namensraum; „Aufbau der Oberfläche“ Zeile 38-55, neuer Abschnitt vor „Häufige Stolpersteine“ Zeile 172, Inhaltsverzeichnis Zeilen 6-22) liegen ausserhalb und bleiben gueltig. `app-version-badge.tsx`, `sidebar.tsx`, `next.config.ts`, Dockerfile, `.dockerignore`, `.gitea/*`, die drei anderen Handbuecher: unveraendert (git diff 7a6f42e..963fa36 leer).
- Baseline (Revision Runde 1, gemessen an 963fa36): Web `47 files / 294 tests` (260916-dyv brachte `page.test.tsx` mit 8 Tests), API `67 / 1078`, `tsc --noEmit` web Exit 0 (api/shared an 7a6f42e gemessen, von dyv nicht beruehrt).
- Tag `v1.0.0` ist ein annotierter Tag (Objekt 4d36942) auf Commit `e509860`, Tagger-Datum 2026-09-14; live seit 2026-09-15 laut STATE.md. Changelog-Datum bleibt wie beauftragt `2026-09-15` (Tag der Inbetriebnahme).
- Gitea 1.26.2; `GET /repos/schalli/tessera-ctl/releases` -> leere Liste (kein Release vorhanden). Token aus der Push-URL (Form `user:token@localhost:3002`) antwortet auf `/api/v1/user` mit 200; die Nutzer-Tokens `cc-full` und `Claude-Code` tragen u. a. `write:repository` und `write:package` — `secrets.REGISTRY_TOKEN` ist eines davon (docker login mit `-u schalli`), reicht also fuer Releases. Repo-Rechte: admin/push/pull true, `has_releases: true`.
- DELTA (wichtig): `.dockerignore` enthaelt `*.md` — gemessen mit `COPY README.md` in einem Test-Dockerfile: `"/README.md": not found`. Eine COPY-Zeile allein reicht NICHT; `.dockerignore` braucht die Ausnahme `!CHANGELOG.md` (zweite Bau-Datei, im N enthalten).
- DELTA: `localhost:3002` ist aus einem Container mit dem Runner-Abbild NICHT erreichbar (curl -> 000), `https://git.vicolab.de/api/v1/version` schon (200). Job-Container laufen in einem per-Job-Netz (`GITEA-ACTIONS-TASK-…-network`), Runner-Instanz-URL `https://git.vicolab.de`. Das Release-Skript darf im CI nicht auf localhost:3002 zeigen.
- Werkzeuge: Runner-Abbild `gitea/runner-images:ubuntu-latest` hat `jq` 1.6, `curl`, `python3`, `git`; Host hat `jq` 1.7, `curl`, `python3`. Entscheidung: `jq`.
- `@uiw/react-md-editor` 4.1.1 exportiert `MDEditor.Markdown` (statisch am Default-Export, Typ `MarkdownPreviewProps`: `source`, `rehypePlugins`, `wrapperElement` mit `data-color-mode: 'light'|'dark'`, `className`, `style`). `@uiw/react-markdown-preview` ist NUR transitiv vorhanden (pnpm-Isolation) — nicht direkt importieren. Das Notiz-Widget nutzt `MDEditor` mit `preview='preview'` und `previewOptions.rehypePlugins=[[rehypeSanitize]]`; sein Test mockt `@uiw/react-md-editor` als Modul mit `default` + `commands`.
- Next 15.5.19: `next.config.ts` wird per SWC nach CommonJS transpiliert und mit Dateiname `<cwd>/next.config.compiled.js` geladen -> `__dirname` = `apps/web`. `env`-Werte laufen ueber `getNextConfigEnv` (Schluessel `process.env.<KEY>`, verboten nur `NODE_*`, `__*`, `NEXT_RUNTIME`) und `serializeDefineEnv` (JSON.stringify) fuer webpack und Turbopack gleichermassen. `node:fs`, `node:path`, `__dirname` typechecken in `apps/web` (Scratch-Datei, tsc Exit 0).
- Jede Seite ist dynamisch (`i18n/request.ts` -> `cookies()`), deshalb keine Prerender-Abkuerzung; `middleware.ts` schuetzt alle Routen ausser `/login`, `/reset-password`, `/_next/*`, `/api*`.
- Bestehende Server-Komponente mit `getTranslations` + Test-Muster (Funktion awaiten, Ergebnis rendern, `next-intl/server` gemockt): `module-access-gate.tsx` / `.test.tsx`. Bestehende Server-Seiten ohne 'use client': `(portal)/settings/page.tsx`, `(portal)/modules/[category]/[moduleSlug]/page.tsx`.
- `sidebar.test.tsx` mockt das Abzeichen als Modul — der Link-Umbau beruehrt sidebar.tsx/-test nicht. `app-version-badge.test.tsx` mockt heute `next-intl` und `@/lib/app-version`, aber nicht `next/link`.
- `umlaut-guard.spec.ts`: Allowlist enthaelt u. a. `aktuelle`, `neue`, `muss`, `Adresse`, `Passwort` — NICHT `Neuerungen`, `Fassung`, `dass`. Texte unten sind so gewaehlt, dass `umlaut-dictionary.ts` unangetastet bleibt.
- DELTA: Die Handbuecher nennen VIER Module (Ausschreibungs-Radar, DKV-Rechnung, Zertifikat-Manager, Domaincheck), nicht zwei; „DKV Fleet“ heisst fuer Anwender „DKV-Rechnung“. Das Anwenderhandbuch beschreibt in „Aufbau der Oberfläche“ heute keine Versionszeile.
- Commits seit `v1.0.0`: nur Doku-Commits und 260916-bwo (5 Commits) — „Unveröffentlicht“ = bwo-Punkte + diese Seite.
- Lokaler `docker build` des Web-Abbilds: Kontext enthaelt `apps/desktop/src-tauri/target` (3,8 GB, nicht in .dockerignore) — BuildKit ueberfuehrt inkrementell; ku1 hat lokal 99-129 s je Bau gemessen. Einplanen: 2-4 Minuten.
- Planer-Beitraege: `schema-gate` — keine Prisma-/Schema-Datei im Umfang, kein Push-Task. `api-coverage` — Gitea-Release-API ist eine externe API: Matrix in `COVERAGE.md` neben diesem Plan (POST/GET-by-tag/PATCH INTEGRATE; list/latest/delete/assets/draft OPT-OUT mit Grund). `assumption-delta scan` -> `{"skipped":true,"reason":"phase_unresolved"}` (Quick-Task ohne ROADMAP-Abschnitt); inhaltlich keine Singular->Plural-Verschiebung (Kanaele existieren seit ku1) -> `no-change`. `estimate-calibration`: factor 1, sample_count 0, confidence low.
</planning_measurements>
<tasks>
<task type="tracer" tdd="true">
<name>Task 1: CHANGELOG.md, Bauzeit-Einbettung, Kanalfilter mit Tests, Seite „Was ist neu“, Abzeichen-Link, i18n</name>
<files>CHANGELOG.md, .dockerignore, apps/web/Dockerfile, apps/web/next.config.ts, apps/web/src/lib/changelog.ts, apps/web/src/lib/changelog.test.ts, apps/web/src/app/(portal)/changelog/page.tsx, apps/web/src/app/(portal)/changelog/changelog-page.test.tsx, apps/web/src/components/changelog/changelog-view.tsx, apps/web/src/components/layout/app-version-badge.tsx, apps/web/src/components/layout/app-version-badge.test.tsx, apps/web/src/messages/de.json, apps/web/src/messages/en.json</files>
<read_first>
- apps/web/src/lib/app-version.ts (Literalname-Regel fuer process.env, `AppChannel`)
- apps/web/src/lib/app-version.test.ts (Muster vi.stubEnv + vi.resetModules + dynamischer Import)
- apps/web/src/components/layout/app-version-badge.tsx + .test.tsx
- apps/web/src/components/layout/sidebar.test.tsx (Zeilen 1-20: `next/link`-Mock)
- apps/web/src/components/modules/module-access-gate.tsx + .test.tsx (Server-Komponente mit getTranslations, Testmuster)
- apps/web/src/components/dashboard/widgets/note-widget.tsx (MDEditor + rehypeSanitize) und note-widget.test.tsx (Modul-Mock von @uiw/react-md-editor)
- apps/web/src/components/layout/app-shell.tsx (mounted-Guard) und apps/web/src/app/(portal)/change-password/page.tsx (Seitenrahmen `mx-auto max-w-… py-8 px-4`, `<h1 className="text-2xl font-bold …">`)
- apps/web/next.config.ts, apps/web/Dockerfile, .dockerignore
- apps/web/src/messages/umlaut-guard.spec.ts (Regeln), de.json/en.json Namensraum `sidebar`
- docs/anleitung-anwender.md (Abschnitte Aufbau der Oberflaeche, Dashboard, Marktplatz, Module, Persoenliche Einstellungen, Fehler melden) und docs/anleitung-administration.md (Kapitel 1-6) — Quelle der 1.0.0-Punkte, nichts raten
- .planning/quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/260916-bwo-SUMMARY.md Abschnitt „Fuer den Changelog“ (5 Punkte) und .planning/quick/260916-dyv-dashboard-nachbesserung-mindestgroessen-/260916-dyv-SUMMARY.md Abschnitt „Fuer den Changelog“ (5 Punkte) — Vorlage der zusammengefuehrten Liste steht in Schritt B
</read_first>
<behavior>
changelog.test.ts (10 Tests, Vorlage: Muster-Changelog als Konstante mit H1, Vorspann, `## Unveröffentlicht` (`### Geändert` mit zwei Punkten), `## 1.0.0 – 2026-09-15` (`### Neu` mit zwei Punkten), `## 0.9.0 – 2026-09-01`):
- Test 1 (live): Ergebnis enthaelt weder `## Unveröffentlicht` noch die Punkte darunter, aber `## 1.0.0 – 2026-09-15`, `## 0.9.0 – 2026-09-01` und deren Punkte in dieser Reihenfolge; `hasUnreleased === false`. (Falsifizierung a: wird rot, sobald die Funktion den Abschnitt nicht entfernt.)
- Test 2 (beta): Ergebnis enthaelt `## Noch nicht freigegeben (Beta)` statt `## Unveröffentlicht`, die Punkte darunter bleiben, `hasUnreleased === true`.
- Test 3 (dev): wie Test 2.
- Test 4 (eigenes Label): `options.unreleasedHeading = 'Not yet released (beta)'` -> Ueberschrift `## Not yet released (beta)`.
- Test 5 (leerer Abschnitt, beta): Unveröffentlicht nur mit `### Neu` ohne Listenpunkt -> Abschnitt fehlt im Ergebnis, `hasUnreleased === false`, 1.0.0 bleibt.
- Test 6 (kein Abschnitt): Markdown ohne Unveröffentlicht -> `hasUnreleased === false`, Versionsabschnitte unveraendert.
- Test 7 (Hierarchie): H1-Zeile und Vorspann fehlen; das Ergebnis beginnt (nach trim) mit `## `; `### `-Ueberschriften bleiben.
- Test 8 (CRLF): Eingabe mit `\r\n` -> live entfernt den Abschnitt ebenfalls, Ergebnis enthaelt kein `\r`.
- Test 9 (Einbettung): `vi.stubEnv('TESSERA_CHANGELOG_MD', '# T\n\n## 1.0.0 – 2026-01-01\n\n- x')` + `vi.resetModules()` + dynamischer Import -> `changelogMarkdown` ist exakt dieser Wert.
- Test 10 (ohne Variable): `vi.stubEnv('TESSERA_CHANGELOG_MD', '')` bzw. unset -> `changelogMarkdown === ''`.
changelog-page.test.tsx (3 Tests; Mocks: `next-intl/server` getTranslations mit Handtabelle fuer `title`, `intro`, `unreleasedHeading`, `unreleasedHint`, `empty`; `@/lib/app-version` mit veraenderbarem `appVersion.channel`; `@/lib/changelog` per `vi.doMock` mit `importOriginal` und eigenem `changelogMarkdown`; `@uiw/react-md-editor` als Modul mit `default: { Markdown: ({ source }) => <pre data-testid="md">{source}</pre> }`; `next-themes` `useTheme: () => ({ resolvedTheme: 'light' })`; Seite wie module-access-gate.test awaiten und rendern):
- Test 1 (live): H1 „Was ist neu“ sichtbar, `data-testid="changelog-unreleased-hint"` fehlt, `md`-Text enthaelt `1.0.0`, aber weder `Unveröffentlicht` noch `Noch nicht freigegeben`.
- Test 2 (beta): Hinweis vorhanden (Text aus Tabelle), `md`-Text enthaelt `Noch nicht freigegeben (Beta)`.
- Test 3 (leer): `changelogMarkdown = ''` -> `data-testid="changelog-empty"` mit Leer-Text sichtbar, kein `md`-Element.
app-version-badge.test.tsx (+2, plus `next/link`-Mock, der `href`, `className`, `title`, `aria-label`, `data-testid` durchreicht; `whatsNew: 'Was ist neu'` in der next-intl-Tabelle):
- Test 5: `screen.getByTestId('app-version')` hat `href="/changelog"` (Tag `a`).
- Test 6: `aria-label` ist `Was ist neu`; Tests 1-4 bleiben gruen (Text, title mit/ohne API, dev ohne title).
</behavior>
<action>
Schritt A — RED: die drei Testdateien gemaess `<behavior>` anlegen bzw. ergaenzen; `pnpm -C apps/web exec vitest run src/lib/changelog.test.ts "src/app/(portal)/changelog" src/components/layout/app-version-badge.test.tsx` muss rot sein (Modul fehlt / kein Link), Ausgabe fuer das SUMMARY notieren.
Schritt B — `CHANGELOG.md` (Wurzel, UTF-8, echte Umlaute, Sie-Form, Alltagssprache; keine Dateinamen, keine Commit-Kuerzel, keine unerklaerten Fachbegriffe). Aufbau: `# Änderungen an Tessera`; Vorspann (2-3 Saetze: was die Liste ist, neueste Version oben, „Unveröffentlicht“ = nur in der Beta enthalten); `## Unveröffentlicht` (Revision Runde 1: bwo- und dyv-Punkte zu EINER Liste zusammengefuehrt, 8 Punkte, sprachlich geglaettet, echte Umlaute) mit `### Neu` — (N1) Seite „Was ist neu“: ein Klick auf die Versionsnummer unten in der Seitenleiste zeigt diese Liste; auf Live nur Freigegebenes, auf der Beta zusaetzlich „Noch nicht freigegeben“; (N2) Uhr: unter Einstellungen > Dashboard laesst sich die Schriftgroesse der Uhrzeit fest in Punkt (8 bis 200) vorgeben, leer gelassen passt sie sich weiter automatisch an — und `### Geändert` — (G1) Raster + Mindestgroessen: das Dashboard-Raster ist doppelt so fein, Widgets lassen sich in kleineren Schritten verschieben und in der Groesse ziehen; jedes Widget hat jetzt genau die Mindestgroesse, bei der es gerade noch bedienbar ist (kleiner geht es nicht, groesser jederzeit), auch bereits platzierte; gespeicherte Anordnungen werden beim ersten Aufruf automatisch uebernommen und verrutschen nicht; (G2) Verschieben: im Bearbeitungsmodus laesst sich jede Kachel an einer beliebigen Stelle anfassen (ausser an Eingabefeldern, Knoepfen und Links), ein grauer Griff am oberen Rand zeigt das an; Kacheln ueberlappen sich beim Ablegen nicht mehr — ueber einer belegten Stelle springt die Kachel an ihren Ausgangspunkt zurueck; (G3) der Bearbeiten-Schalter des Dashboards sitzt jetzt unten rechts, die Widgets beginnen direkt unter der Kopfzeile; (G4) Uhrzeit, Stoppuhr und Rechner wachsen und schrumpfen mit ihrer Kachel — eine grosse Uhr-Kachel zeigt eine grosse Uhrzeit; die Stoppuhr hat kompaktere Knoepfe und passt so auch in kleine Kacheln; (G5) die Raender sind ueberall enger: aeusserer Seitenrahmen auf allen Seiten, Abstand zwischen den Widgets und Innenabstaende der Widgets halbiert; (G6) das Anwenderhandbuch beschreibt das feine Raster, die mitwachsende Uhrzeit, die Schriftgroessen-Einstellung, den neuen Schalter, das Ziehen und die Mindestgroessen; dann `## 1.0.0 – 2026-09-15` (Gedankenstrich U+2013, keine eckigen Klammern) mit `### Neu` und 11 Punkten, JEDER aus den Handbuechern belegt: (1) Portal mit Kopfleiste und Seitenleiste — Dashboard, Marktplatz, freigegebene Module nach Kategorien mit Suchfeld, Seitenleiste ein-/ausklappbar, hell/dunkel/System, Deutsch/Englisch; (2) persoenliches Dashboard mit frei anordenbaren Kacheln: Uhr, Suchleiste, Kalender, Notizen, Taschenrechner, Favoriten, Link, Stoppuhr; Bearbeitungsmodus (hinzufuegen, verschieben, Groesse ziehen), Einstellungen je Kachel unter Einstellungen > Dashboard (Kalenderquellen, Suchanbieter, Links); (3) Marktplatz mit Status Aktiviert/Verfuegbar, Suche, Filter, Detailseite; Aktivierung durch Administratoren, Freigabe je Gruppe oder Benutzer (Freigaben-Matrix); (4) Ausschreibungs-Radar: Trefferliste oeffentlicher Ausschreibungen, Filter (Frist, Postleitzahl, Bundesland, Branche, Wert), Suchprofile mit Sofort-Alarm per E-Mail, Sammel-Mail taeglich/woechentlich, Merken/Gelesen, eigene Postfaecher und RSS-Feeds als Quellen; (5) DKV-Rechnung: automatische Verarbeitung von DKV-Tankkarten-Rechnungen aus einem Postfach, Fahrzeug-Stammdaten mit CSV-Import, Verarbeitungshistorie, Exportdateien; (6) Zertifikat-Manager (analysieren, aufteilen, zusammenfuehren, konvertieren) und Domaincheck (Verfuegbarkeit von Internet-Domains); (7) Benutzer-, Gruppen- und Rechteverwaltung: Rollen Benutzer/Admin/Super-Admin, lokale und verzeichnisgefuehrte Konten, Gruppen mit Standardgruppe, Active-Directory-Anbindung mit Import von Gruppen und Einzelbenutzern, Ausschlussliste, automatische Synchronisation; (8) E-Mail-Versand (SMTP) mit Testnachricht, Passwort vergessen/zuruecksetzen per E-Mail, erzwungene Passwortaenderung bei neuen Konten; (9) persoenliche Einstellungen: Profilbild, Akzentfarbe, Passwort aendern fuer lokale Konten; (10) Knopf „Fehler melden“ mit Bildschirmfoto, Beschreibung und technischen Angaben per E-Mail an den Administrator; (11) Versionsanzeige unten in der Seitenleiste (Version und Kanal Live/Beta). Umlaute in dieser Aufzaehlung sind ASCII-Umschrift des Plans — in der Datei echte Umlaute.
Schritt C — Bauweg. `.dockerignore`: direkt unter `*.md` die Zeile `!CHANGELOG.md` mit Kommentarzeile (Grund: Wurzel-Markdown ist ausgeschlossen, diese eine Datei braucht der Web-Bau). `apps/web/Dockerfile`: in der builder-Stufe nach `COPY tsconfig.base.json ./` genau eine Zeile `COPY CHANGELOG.md ./` plus Kommentar (quick-260916-dcz: next.config.ts liest die Datei zur Bauzeit; Ausnahme in .dockerignore). `apps/web/next.config.ts`: `import { readFileSync } from 'node:fs'`, `import path from 'node:path'`; Funktion `readChangelog(): string`, die `path.resolve(__dirname, '../../CHANGELOG.md')` liest und bei Fehler eine Error mit deutscher Meldung wirft (Dateipfad nennen, Hinweis auf .dockerignore-Ausnahme und COPY-Zeile); in `nextConfig` den Schluessel `env: { TESSERA_CHANGELOG_MD: readChangelog() }` ergaenzen; Kopfkommentar (deutsch, ASCII, 3-5 Zeilen): Bauzeit-Einbettung, gilt fuer webpack und Turbopack, Server-Bundle-only durch Importdisziplin (nur page.tsx importiert lib/changelog).
Schritt D — `apps/web/src/lib/changelog.ts` (Kopfkommentar deutsch ASCII): `UNRELEASED_HEADING = 'Unveröffentlicht'`; `changelogMarkdown = process.env.TESSERA_CHANGELOG_MD ?? ''` mit vollem Literalnamen und Kommentar zur Literalname-Regel; `filterChangelogForChannel(markdown, channel, options?)`: Zeilenenden auf `\n` normalisieren; Zeilen ab der ersten `## `-Ueberschrift behalten (H1 und Vorspann verwerfen); Abschnitte an `^## `-Grenzen bilden; den Abschnitt mit Ueberschrift `^## Unveröffentlicht\s*$` suchen; „leer“ = kein Listenpunkt `^\s*[-*] ` im Abschnitt; leer ODER channel === 'live' -> Abschnitt verwerfen, `hasUnreleased=false`; sonst Ueberschriftszeile durch `## ${options?.unreleasedHeading ?? 'Noch nicht freigegeben (Beta)'}` ersetzen, `hasUnreleased=true`; Rueckgabe `{ markdown: abschnitte.join('\n').trim() + '\n', hasUnreleased }`. Keine Abhaengigkeit von React/Next im Modul (rein testbar).
Schritt E — Seite. `apps/web/src/components/changelog/changelog-view.tsx`: 'use client'; `import MDEditor from '@uiw/react-md-editor'`, `import rehypeSanitize from 'rehype-sanitize'`, `useTheme` aus `next-themes`; `mounted`-Guard wie AppShell; `mode: 'light'|'dark'` = `resolvedTheme === 'dark' ? 'dark' : 'light'` (vor Mount 'light'); Wrapper `<div data-testid="changelog-markdown" className="rounded-md border border-border bg-card p-4">` mit `<MDEditor.Markdown source={markdown} rehypePlugins={[[rehypeSanitize]]} wrapperElement={{ 'data-color-mode': mode }} style={{ background: 'transparent' }} />`. `apps/web/src/app/(portal)/changelog/page.tsx`: async Server-Komponente ohne 'use client' (Vorbild module-access-gate.tsx); `const t = await getTranslations('changelog')`; `const { markdown, hasUnreleased } = filterChangelogForChannel(changelogMarkdown, appVersion.channel, { unreleasedHeading: t('unreleasedHeading') })`; Rahmen `<div className="mx-auto max-w-3xl py-8 px-4">`, `<h1 className="text-2xl font-bold text-foreground mb-2">{t('title')}</h1>`, `<p className="text-sm text-muted-foreground mb-6">{t('intro')}</p>`; wenn `hasUnreleased`: Hinweisbox (gelbes Muster aus change-password/page.tsx) mit `data-testid="changelog-unreleased-hint"` und `t('unreleasedHint')`; wenn `markdown.trim()` leer: `<p data-testid="changelog-empty" className="text-sm text-muted-foreground">{t('empty')}</p>`, sonst `<ChangelogView markdown={markdown} />`. Kopfkommentar: Kanalregel (Live ohne Unveröffentlicht), Quelle Bauzeit-Variable, Auth durch Middleware.
Schritt F — Abzeichen. `app-version-badge.tsx`: `import Link from 'next/link'`; das `span` wird `<Link href="/changelog" data-testid="app-version" aria-label={t('whatsNew')} title={title} className="block truncate text-xs text-muted-foreground transition-colors hover:text-foreground hover:underline">`; Inhalt und Tooltip-Logik unveraendert; Kopfkommentar um den Satz ergaenzen, dass die Zeile seit quick-260916-dcz zur Seite „Was ist neu“ fuehrt.
Schritt G — i18n (beide Dateien, Schluesselparitaet). de.json: `sidebar.whatsNew` = „Was ist neu“; neuer Top-Level-Namensraum `changelog` (nach `bugReport` einordnen): `title` „Was ist neu“, `intro` „Alle Änderungen an Tessera, sortiert nach Version – die aktuelle Version steht oben.“, `unreleasedHeading` „Noch nicht freigegeben (Beta)“, `unreleasedHint` „Die Punkte unter „Noch nicht freigegeben“ sind in dieser Beta bereits enthalten, aber noch nicht als Version freigegeben.“, `empty` „Noch keine Einträge vorhanden.“ en.json: `sidebar.whatsNew` „What's new“; `changelog`: `title` „What's new“, `intro` „All changes to Tessera, sorted by version – the current version is at the top.“, `unreleasedHeading` „Not yet released (beta)“, `unreleasedHint` „The items under “Not yet released” are already part of this beta but have not been released as a version yet.“, `empty` „No entries yet.“ (Sollte der ICU-Parser am Apostroph in „What's“ anstossen, „What is new“ verwenden.) Diese Texte brauchen keinen neuen Eintrag in `umlaut-dictionary.ts` — die Datei bleibt unangetastet.
Schritt H — GREEN: Zielsuite gruen, dann die gesamte Web-Suite (47+2 Dateien) und `tsc`. Danach lokal `pnpm -C apps/web exec next build` einmal laufen lassen (webpack-Build, ca. 1-2 Minuten) und pruefen, dass `apps/web/.next/server` den Datums-Marker enthaelt und `apps/web/.next/static` nicht (Vorstufe zur Docker-Falsifizierung in Task 2). Commit `feat(quick-260916-dcz): CHANGELOG.md, Seite "Was ist neu" mit Kanalfilter, Versionszeile als Link, Bauzeit-Einbettung`.
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; test -f CHANGELOG.md; echo CL_EXISTS=$? ; grep -c "^## Unveröffentlicht$" CHANGELOG.md ; grep -c "^## 1.0.0 – 2026-09-15$" CHANGELOG.md ; grep -c "^### " CHANGELOG.md ; awk '/^## 1\.0\.0/{f=1;next} /^## /{if(f)exit} f' CHANGELOG.md | grep -c "^- " ; awk '/^## Unveröffentlicht$/{f=1;next} /^## /{if(f)exit} f' CHANGELOG.md | grep -c "^- " ; grep -c "^!CHANGELOG.md$" .dockerignore ; grep -c "^COPY CHANGELOG.md ./$" apps/web/Dockerfile ; grep -c "TESSERA_CHANGELOG_MD" apps/web/next.config.ts ; grep -c "process.env.TESSERA_CHANGELOG_MD" apps/web/src/lib/changelog.ts ; grep -c "export function filterChangelogForChannel" apps/web/src/lib/changelog.ts ; grep -rl "@/lib/changelog'" apps/web/src --include=*.tsx --include=*.ts | grep -v test | grep -vc "changelog/page.tsx" ; grep -c "MDEditor.Markdown" apps/web/src/components/changelog/changelog-view.tsx ; grep -c "rehypeSanitize" apps/web/src/components/changelog/changelog-view.tsx ; head -1 "apps/web/src/app/(portal)/changelog/page.tsx" | grep -c "use client" ; grep -c 'href="/changelog"' apps/web/src/components/layout/app-version-badge.tsx ; grep -c "aria-label={t('whatsNew')}" apps/web/src/components/layout/app-version-badge.tsx ; grep -c '"whatsNew"' apps/web/src/messages/de.json ; grep -c '"unreleasedHint"' apps/web/src/messages/en.json ; D2=$(git diff --stat 963fa36 -- apps/web/src/messages/umlaut-dictionary.ts apps/web/package.json pnpm-lock.yaml); echo D2_EXIT=$? ; test -z "$D2"; echo UNTOUCHED=$? ; pnpm -C apps/web exec tsc --noEmit >/dev/null 2>&1; echo TSC_web=$?</automated>
<fails_when>Die Vitest-Zeilen weichen von `49 passed (49)` / `309 passed (309)` ab; CL_EXISTS ist nicht 0; einer der greps auf CHANGELOG.md liefert nicht genau 1 (Unveröffentlicht, 1.0.0-Ueberschrift) bzw. weniger als 3 (`### `) bzw. weniger als 6 oder mehr als 12 (Punkte unter 1.0.0) bzw. weniger als 7 oder mehr als 9 (Punkte unter Unveröffentlicht — Soll 8); `.dockerignore`- oder `Dockerfile`-grep ist nicht 1; ein Code-grep, der >= 1 sein muss, liefert 0; der Import-Zaehler von `@/lib/changelog` ausserhalb von page.tsx ist nicht 0 (Text wuerde ins Client-Bundle wandern); page.tsx beginnt mit `use client` (Zaehler 1 statt 0); UNTOUCHED ist 1; TSC_web ist nicht 0.</fails_when>
</verify>
<done>Web-Suite 49/309 gruen, tsc 0; CHANGELOG.md mit Unveröffentlicht (bwo + dyv + diese Seite, 8 Punkte) und 1.0.0 (6-12 Punkte, aus den Handbuechern) vorhanden; Bauweg (dockerignore-Ausnahme, COPY, env in next.config.ts) steht; `/changelog` rendert als Server-Seite den kanalgefilterten Changelog ueber `MDEditor.Markdown` + rehype-sanitize; Versionszeile ist ein Link mit aria-label; de/en-Schluessel vollstaendig, Umlaut-Woerterbuch unangetastet; ein Commit `feat(quick-260916-dcz)`.</done>
</task>
<task type="auto">
<name>Task 2: Release-Skript mit --dry-run, CI-Schritt, Docker-Falsifizierung, rueckwirkender Release v1.0.0</name>
<files>.gitea/scripts/publish-release.sh, .gitea/workflows/ci.yml</files>
<read_first>
- .gitea/scripts/publish-images.sh (Kopfkommentar-Stil, Entscheidung anhand GITHUB_REF, `--print-plan`, `set -eu`, kein Secret)
- .gitea/workflows/ci.yml (Job `publish`, `${{ secrets.REGISTRY_TOKEN }}` nur im Login-Schritt)
- apps/web/Dockerfile (runner-Stufe: `/app/apps/web/.next/server` aus standalone, `/app/apps/web/.next/static` separat kopiert)
- .planning/quick/260914-ku1-zwei-auslieferungskanaele-beta-auf-main-/260914-ku1-PLAN.md (Task 2: lokaler Docker-Beweis, Task 3: Token aus pushurl, nie ausgeben)
- COVERAGE.md neben diesem Plan (welche Release-Endpunkte genutzt werden)
</read_first>
<precondition>Gitea antwortet lokal: `curl -s --max-time 5 http://localhost:3002/api/v1/version` liefert `{"version":"1.26.2"}`; `command -v jq` und `command -v docker` liefern Pfade; `git remote get-url --push origin` enthaelt `localhost:3002` (Token-Quelle fuer den echten Lauf — nie ausgeben).</precondition>
<action>
Schritt A — `.gitea/scripts/publish-release.sh` (POSIX sh, `chmod +x`, `set -eu`, Kopfkommentar deutsch ASCII im Stil von publish-images.sh: Zweck, Entscheidung anhand GITHUB_REF, Aufrufformen, Umgebungsvariablen, dass das Token nie ausgegeben wird). Verhalten:
1. Argumente in einer `while`-Schleife: `--dry-run` (Schalter), `--tag <vX.Y.Z>` (Wert), sonst Fehler mit Hilfetext Exit 2.
2. Tag: aus `--tag`, sonst aus `GITHUB_REF` (`refs/tags/v*` -> Rest), sonst Meldung „Kein Freigabe-Tag (nur refs/tags/v*): nichts zu tun.“ und Exit 0. Tag muss `^v[0-9]+\.[0-9]+\.[0-9]+$` erfuellen (grep -E), sonst Exit 1 mit Meldung. `VERSION=${TAG#v}`.
3. API-Basis: `GITEA_API`, sonst `GITHUB_API_URL`, sonst `${GITHUB_SERVER_URL}/api/v1`, sonst `http://localhost:3002/api/v1`; Repo: `GITEA_REPO`, sonst `GITHUB_REPOSITORY`, sonst `schalli/tessera-ctl`. Erste Ausgabezeile: `Gitea-API: <basis> Repo: <repo> Tag: <tag>` (ohne Token).
4. `CHANGELOG="${CHANGELOG_FILE:-CHANGELOG.md}"`; fehlt die Datei: Exit 1 mit Meldung. Abschnitt schneiden (zur Planungszeit bewiesenes Muster): `awk -v ver="$VERSION" 'BEGIN{esc=ver; gsub(/\./,"\\.",esc); pat="^## " esc "( |$)"} $0 ~ pat {f=1; next} /^## / {if(f) exit} f {print}'`, danach fuehrende/abschliessende Leerzeilen entfernen (zweiter awk, der die letzte nicht-leere Zeile merkt, plus `sed '1{/^$/d}'`). Ist das Ergebnis leer: nach stderr „CHANGELOG.md hat keinen Abschnitt fuer Version <VERSION> (erwartet eine Zeile '## <VERSION> – <Datum>'). Kein Release ohne Text.“ und Exit 1 (Falsifizierung b).
5. JSON ausschliesslich per `jq -n --arg tag "$TAG" --arg name "Tessera $VERSION" --arg body "$BODY" '{tag_name:$tag, name:$name, body:$body, draft:false, prerelease:false}'` (kein manuelles Quoting). Fehlt `jq`: Exit 1 mit Meldung.
6. `--dry-run`: JSON und die Zielpfade (`POST <basis>/repos/<repo>/releases` bzw. `PATCH …/releases/<id>`) ausgeben, Exit 0, kein Netzaufruf, kein Token noetig.
7. Echter Lauf: `GITEA_TOKEN` muss gesetzt sein (sonst Exit 1 mit Meldung, Wert nie ausgeben). Header in eine temporaere Datei (`umask 077`, `mktemp`, `trap` zum Loeschen) schreiben und mit `curl -sS --header @"$HDR"` verwenden — das Token erscheint so weder in Argumenten noch in der Prozessliste. `GET <basis>/repos/<repo>/releases/tags/<tag>` mit `-o "$RESP" -w '%{http_code}'`: 200 -> `ID=$(jq -r .id "$RESP")`, `PATCH …/releases/$ID` mit `{name, body}` (jq wie oben ohne tag_name), Erwartung 200 -> Ausgabe „Release <tag> aktualisiert (id <ID>)“; 404 -> `POST …/releases`, Erwartung 201 -> „Release <tag> angelegt (id …)“; jeder andere Code -> Code und Antwort-Body (der Body enthaelt nie das Token) nach stderr, Exit 1. `Content-Type: application/json`, `--data @"$JSONFILE"` (JSON in Datei, nicht als Argument).
8. Das Skript kennt kein `set -x` und kein Echo einer Variablen mit dem Token.
<!-- planner-discipline-allow: set -x -->
Schritt B — `.gitea/workflows/ci.yml`: im Job `publish` nach dem Schritt „Versionsstempel berechnen, Abbilder bauen und veroeffentlichen“ einen Schritt `- name: Gitea-Release zum Freigabe-Tag anlegen (nur bei Tags v*)` mit `env: GITEA_TOKEN: ${{ secrets.REGISTRY_TOKEN }}` und `run: sh .gitea/scripts/publish-release.sh`. Kopfkommentar der Datei um eine Zeile ergaenzen (Tag v* -> zusaetzlich Gitea-Release aus CHANGELOG.md). Keine weitere Aenderung. `node -e "require('js-yaml')"` steht nicht sicher zur Verfuegung — YAML-Pruefung ueber `python3 -c 'import yaml'` nur, wenn PyYAML vorhanden ist, sonst genuegt die strukturelle grep-Pruefung unten.
Schritt C — Lokale Beweise (Ausgaben ins SUMMARY):
1. `sh .gitea/scripts/publish-release.sh --dry-run --tag v1.0.0` -> Exit 0, JSON mit `"name": "Tessera 1.0.0"` und Body, der mit `### Neu` beginnt.
2. `sh .gitea/scripts/publish-release.sh --dry-run --tag v9.9.9` -> Exit 1, Meldung nennt 9.9.9 (Falsifizierung b).
3. `GITHUB_REF=refs/heads/main sh .gitea/scripts/publish-release.sh --dry-run` -> Exit 0, „nichts zu tun“.
4. `GITHUB_REF=refs/tags/v1.0.0 GITHUB_SERVER_URL=https://git.vicolab.de sh .gitea/scripts/publish-release.sh --dry-run` -> erste Zeile nennt `https://git.vicolab.de/api/v1`.
5. Docker-Falsifizierung (c): `docker build -t tessera-web-dcz-test --build-arg APP_VERSION=v9.9.9-test --build-arg APP_CHANNEL=live -f apps/web/Dockerfile .` (2-4 Minuten; als Hintergrundbefehl starten, falls die Vordergrundzeit knapp ist). Danach `docker run --rm --entrypoint sh tessera-web-dcz-test -c 'grep -rl "2026-09-15" /app/apps/web/.next/server | wc -l; grep -rl "2026-09-15" /app/apps/web/.next/static | wc -l'` -> erste Zahl >= 1, zweite genau 0.
<!-- planner-discipline-allow: 2026-09-15 -->
Zusaetzlich Gegenprobe der COPY/dockerignore-Kopplung: `git stash`-frei pruefen, indem ein zweiter Bau mit `--build-arg` NICHT noetig ist — stattdessen im SUMMARY die gemessene Kontext-Meldung aus `docker build` (Zeile mit `COPY CHANGELOG.md`) zitieren. Test-Abbild danach `docker rmi tessera-web-dcz-test`.
6. Echter Lauf fuer v1.0.0 (Token NIE ausgeben, nur in Variablen): `PUSHURL=$(git remote get-url --push origin); TOK=${PUSHURL#*://}; TOK=${TOK#*:}; TOK=${TOK%%@*}`; dann `GITEA_API=http://localhost:3002/api/v1 GITEA_TOKEN="$TOK" sh .gitea/scripts/publish-release.sh --tag v1.0.0` -> Exit 0, Zeile „Release v1.0.0 angelegt (id N)“. Pruefung: `curl -s -H "Authorization: token $TOK" -o rel.json http://localhost:3002/api/v1/repos/schalli/tessera-ctl/releases/tags/v1.0.0; jq -c '{id, tag_name, name, draft, prerelease}' rel.json; jq -r .body rel.json` (Datei im Scratchpad) -> `tag_name v1.0.0`, `name "Tessera 1.0.0"`, `draft false`, Body beginnt mit `### Neu` und ist laenger als 100 Zeichen. Zweiter Lauf desselben Skriptaufrufs -> Exit 0, Zeile „aktualisiert (id N)“ mit derselben id; `…/releases` in eine Datei holen und `jq length` darauf -> 1 (idempotent, kein Duplikat).
Commit `ci(quick-260916-dcz): Gitea-Release je Freigabe-Tag aus CHANGELOG.md (publish-release.sh, idempotent, --dry-run), Schritt in ci.yml`.
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && test -x .gitea/scripts/publish-release.sh; echo EXEC=$? ; head -1 .gitea/scripts/publish-release.sh | grep -c '^#!/bin/sh$' ; grep -c "^set -eu$" .gitea/scripts/publish-release.sh ; grep -c "set -x" .gitea/scripts/publish-release.sh ; grep -cE 'echo[^\n]*GITEA_TOKEN' .gitea/scripts/publish-release.sh ; grep -c 'jq -n --arg' .gitea/scripts/publish-release.sh ; grep -c 'header @' .gitea/scripts/publish-release.sh ; grep -c 'releases/tags/' .gitea/scripts/publish-release.sh ; grep -c 'PATCH' .gitea/scripts/publish-release.sh ; sh .gitea/scripts/publish-release.sh --dry-run --tag v1.0.0 >/dev/null 2>&1; echo DRY_OK=$? ; sh .gitea/scripts/publish-release.sh --dry-run --tag v9.9.9 >/dev/null 2>/tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-dry-err.txt; echo DRY_MISSING=$? ; grep -c "9.9.9" /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-dry-err.txt ; GITHUB_REF=refs/heads/main sh .gitea/scripts/publish-release.sh --dry-run | grep -c "nichts zu tun" ; sh .gitea/scripts/publish-release.sh --dry-run --tag v1.0.0 | grep -c '"name": "Tessera 1.0.0"' ; grep -c "publish-release.sh" .gitea/workflows/ci.yml ; grep -c "GITEA_TOKEN: \${{ secrets.REGISTRY_TOKEN }}" .gitea/workflows/ci.yml ; grep -c "secrets.REGISTRY_TOKEN" .gitea/workflows/ci.yml ; PUSHURL=$(git remote get-url --push origin); echo PU_EXIT=$? ; TOK=${PUSHURL#*://}; TOK=${TOK#*:}; TOK=${TOK%%@*}; curl -s -H "Authorization: token $TOK" -o /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rel.json http://localhost:3002/api/v1/repos/schalli/tessera-ctl/releases/tags/v1.0.0; echo REL_EXIT=$? ; jq -r '.tag_name, .name, .draft' /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rel.json ; jq -r '.body' /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rel.json > /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rel-body.txt; wc -c < /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rel-body.txt ; curl -s -H "Authorization: token $TOK" -o /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rels.json http://localhost:3002/api/v1/repos/schalli/tessera-ctl/releases; jq length /tmp/claude-1000/-home-vicolab-projects-tessera-ctl/d06a4a73-407a-4ea6-b686-d1f72c209902/scratchpad/dcz-rels.json</automated>
<fails_when>EXEC ist nicht 0; PU_EXIT oder REL_EXIT ist nicht 0; Shebang- oder `set -eu`-Zaehler ist nicht 1; der `set -x`-Zaehler oder der Echo-Token-Zaehler ist nicht 0; jq-/header-/tags-/PATCH-greps liefern 0; DRY_OK ist nicht 0; DRY_MISSING ist 0 (ein Tag ohne Abschnitt darf nicht durchgehen) oder die stderr-Datei nennt 9.9.9 nicht; „nichts zu tun“ fehlt fuer refs/heads/main; der Name-grep im dry-run-JSON ist 0; ci.yml nennt das Skript nicht genau einmal, den env-Eintrag nicht genau einmal oder REGISTRY_TOKEN nicht genau zweimal (Login + Release); die drei Release-Zeilen lauten nicht `v1.0.0`, `Tessera 1.0.0`, `false`; die Body-Laenge (wc -c) ist nicht groesser als 100; die Release-Anzahl ist nicht 1.</fails_when>
</verify>
<done>Skript vorhanden und POSIX-sauber; dry-run fuer v1.0.0 liefert JSON, fuer v9.9.9 Exit 1 mit klarer Meldung; main-Ref ist ein No-Op; ci.yml ruft das Skript nach dem Abbild-Schritt mit dem Token aus `env` auf; das Web-Abbild traegt den Changelog nur im Server-Bundle (Docker-Beweis im SUMMARY mit beiden Zahlen); Release `Tessera 1.0.0` existiert in Gitea zum Tag v1.0.0, ein Wiederholungslauf aktualisiert statt dupliziert; ein Commit `ci(quick-260916-dcz)`.</done>
</task>
<task type="auto">
<name>Task 3: Handbuecher (Betrieb Kapitel 9, Anwender, Entwicklung, CI-Setup), Push und Beobachtung des CI-Laufs</name>
<files>docs/anleitung-betrieb.md, docs/anleitung-anwender.md, docs/anleitung-entwicklung.md, docs/ci-cd-setup.md</files>
<read_first>
- docs/anleitung-betrieb.md Kapitel 9 (Zeilen 357-530: „Eine Version freigeben“, „Woran Sie erkennen, welche Version läuft“, Absatz „Erstfreigabe v1.0.0“) — Ton: Alltagssprache, echte Umlaute, Sie-Form
- docs/anleitung-anwender.md (Inhaltsverzeichnis Zeilen 6-22, „Aufbau der Oberfläche“ Zeilen 38-55, Abschnittsfolge vor „Häufige Stolpersteine“ Zeile 172; Abschnitt „Dashboard“ Zeilen 57-84 ist Stand dyv und bleibt unangetastet)
- docs/anleitung-entwicklung.md „Konventionen und Fallstricke“ (ab Zeile 425) — Ton: technisch, echte Umlaute
- docs/ci-cd-setup.md Abschnitte 3 (Secrets-Tabelle) und 4 (Pipeline-Ueberblick, Etiketten-Tabelle) — ASCII-Umschrift wie im Bestand
- .planning/quick/260914-ku1-zwei-auslieferungskanaele-beta-auf-main-/260914-ku1-PLAN.md Task 3 Schritt 4 (CI-Beobachtung ueber die Gitea-API)
</read_first>
<precondition>Gitea antwortet lokal (`curl -s --max-time 5 http://localhost:3002/api/v1/version` -> `{"version":"1.26.2"}`) und `docker ps --format '{{.Names}}' | grep -c '^gitea-runner$'` liefert `1` (sonst Push trotzdem, Beobachtung als offenen Punkt ins SUMMARY).</precondition>
<action>
1. `docs/anleitung-betrieb.md`, Kapitel 9: (a) Unterabschnitt „Eine Version freigeben“ — vor dem Befehlsblock einen nummerierten Vorschritt einfuegen: in `CHANGELOG.md` den Abschnitt „Unveröffentlicht“ in „X.Y.Z – JJJJ-MM-TT“ umbenennen, darueber ein neues leeres „Unveröffentlicht“ anlegen, auf `main` committen und pushen — erst dann `live` zusammenfuehren und taggen; (b) nach dem Absatz zur Pipeline-Dauer einen Absatz: die Pipeline legt beim Tag zusaetzlich einen Release in Gitea an (Name „Tessera X.Y.Z“, Text = der Abschnitt dieser Version aus CHANGELOG.md, zu finden unter Releases im Repository); fehlt der Abschnitt, schlaegt genau dieser letzte Schritt fehl — die Abbilder sind dann trotzdem gebaut, der Release wird nach dem Nachtragen des Abschnitts durch erneutes Ausloesen des Tags-Laufs oder lokal per Skript (`.gitea/scripts/publish-release.sh --tag vX.Y.Z`) nachgeholt; (c) Absatz „Erstfreigabe v1.0.0“ in die Vergangenheit setzen: erfolgt am 2026-09-14 (Tag), live seit 2026-09-15; der Release „Tessera 1.0.0“ wurde nachtraeglich angelegt; (d) unter „Woran Sie erkennen, welche Version läuft“ einen vierten Punkt: Klick auf die Versionszeile unten in der Seitenleiste oeffnet „Was ist neu“ — auf Live nur freigegebene Versionen, auf Beta zusaetzlich „Noch nicht freigegeben (Beta)“. Echte Umlaute, Sie-Form.
2. `docs/anleitung-anwender.md`: (a) in „Aufbau der Oberfläche“, Absatz Seitenleiste, einen Satz ergaenzen: ganz unten steht die Versionsnummer von Tessera; ein Klick darauf oeffnet „Was ist neu“; (b) den von 260916-dyv geaenderten Abschnitt „Dashboard“ (Stift-Schalter unten rechts, ganze Kachel ziehbar, Mindestgroessen) NICHT anfassen; neuen Abschnitt `## Was ist neu` VOR „Häufige Stolpersteine“ (4-6 Saetze: was die Seite zeigt, Gruppen Neu/Geändert/Behoben, neueste Version oben, Hinweis „Noch nicht freigegeben (Beta)“ nur auf der Beta, auf Live nur Freigegebenes); (c) Inhaltsverzeichnis-Eintrag an passender Stelle. Echte Umlaute, Sie-Form.
3. `docs/anleitung-entwicklung.md`, „Konventionen und Fallstricke“: neuen Fettabsatz „**Änderungsliste (`CHANGELOG.md`):**“ — jede Aenderung sofort unter „Unveröffentlicht“ eintragen (Alltagssprache fuer Anwender, Sie-Form, echte Umlaute, Gruppen Neu/Geändert/Behoben, keine Dateinamen/Commit-Kuerzel); Freigabe = Abschnitt umbenennen + neues leeres Unveröffentlicht; die Seite „Was ist neu“ (`apps/web/src/app/(portal)/changelog/page.tsx`) liest den Text zur Bauzeit aus `env.TESSERA_CHANGELOG_MD` in `next.config.ts` (deshalb `COPY CHANGELOG.md` im Web-Dockerfile und die Ausnahme `!CHANGELOG.md` in `.dockerignore`; nur `page.tsx` darf `@/lib/changelog` importieren, damit der Text nicht in oeffentliche Client-Chunks gelangt); Kanalregel in `filterChangelogForChannel` mit Tests; `.gitea/scripts/publish-release.sh` schneidet beim Tag den Abschnitt fuer den Gitea-Release — ohne Abschnitt bricht der CI-Schritt ab. Echte Umlaute.
4. `docs/ci-cd-setup.md` (ASCII-Umschrift wie im Bestand): Secrets-Tabelle — `REGISTRY_TOKEN` braucht zusaetzlich Schreibrecht auf das Repository (`repository: write`) fuer Releases, wird im Release-Schritt ueber `env` an das Skript gereicht, nie als Argument; Pipeline-Ueberblick — Job `publish` besteht aus vier Schritten (Checkout, Login, publish-images.sh, publish-release.sh); Etiketten-Tabelle — Zeile Tag `vX.Y.Z` ergaenzen um „+ Gitea-Release `Tessera X.Y.Z` mit dem CHANGELOG-Abschnitt“; kurzer Hinweis, dass das Skript die API ueber `GITHUB_API_URL`/`GITHUB_SERVER_URL` (im Job-Container `https://git.vicolab.de`) anspricht und `localhost:3002` dort nicht erreichbar ist.
5. Commit `docs(quick-260916-dcz): Betriebshandbuch Kapitel 9 (Changelog-Schritt, Gitea-Release, Seite Was ist neu), Anwender-, Entwicklungs- und CI-Handbuch`. Dann `git push` (Push-URL zeigt auf localhost:3002; schlichtes `git push` genuegt).
6. Beobachtung des CI-Laufs (Token NIE ausgeben): `PUSHED=$(git rev-parse HEAD); PUSHURL=$(git remote get-url --push origin); TOK=${PUSHURL#*://}; TOK=${TOK#*:}; TOK=${TOK%%@*}`; bis zu 12 Minuten alle 20 s `curl -s -H "Authorization: token $TOK" "http://localhost:3002/api/v1/repos/schalli/tessera-ctl/actions/runs?limit=5"` abfragen (als Hintergrundbefehl, falls `sleep` im Vordergrund blockiert ist), Eintrag mit `head_sha == PUSHED`, auf `status == completed` warten; Erwartung `conclusion == success`. Zusaetzlich versuchen, das Job-Log des Jobs `publish` zu lesen (`…/actions/runs/<id>/jobs`, dann `…/actions/jobs/<job_id>/logs`, falls die Gitea-Version antwortet) und die Zeilen `Gitea-API: https://git.vicolab.de/api/v1 …` und „nichts zu tun“ des Release-Schritts zitieren; antwortet der Log-Endpunkt nicht, im SUMMARY vermerken (der Erfolg des Laufs beweist den Exit 0 des Schritts). Lauf-ID, Dauer (`started_at`/`completed_at`), conclusion ins SUMMARY. Ist `conclusion` nicht `success`: Ursache aus dem Job-Log benennen, Korrektur als eigener `fix(quick-260916-dcz)`-Commit, erneut pushen und beobachten.
7. Wird das SUMMARY erst nach dem Push committet, den Push danach wiederholen (ein weiterer CI-Lauf ist erwartet).
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && grep -c "CHANGELOG.md" docs/anleitung-betrieb.md ; grep -c "Was ist neu" docs/anleitung-betrieb.md ; grep -c "Release" docs/anleitung-betrieb.md ; grep -c "^## Was ist neu" docs/anleitung-anwender.md ; grep -c "Was ist neu" docs/anleitung-anwender.md ; grep -c "Änderungsliste" docs/anleitung-entwicklung.md ; grep -c "TESSERA_CHANGELOG_MD" docs/anleitung-entwicklung.md ; grep -c "publish-release.sh" docs/ci-cd-setup.md ; grep -c "repository: write" docs/ci-cd-setup.md ; grep -c '[äöüÄÖÜß]' docs/ci-cd-setup.md ; pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; pnpm -C apps/api exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit >/dev/null 2>&1; echo "TSC_$p=$?"; done ; pnpm install --frozen-lockfile >/dev/null 2>&1; echo FROZEN=$? ; D=$(git diff --stat 963fa36 -- . ':!.planning'); echo GIT_EXIT=$? ; tail -n1 <<< "$D" ; U=$(git diff --stat 963fa36 -- '.env*' docker-compose.yml docker-compose.prod.yml docker-compose.dev.yml docker-compose.ci.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/Dockerfile apps/web/src/messages/umlaut-dictionary.ts); echo U_EXIT=$? ; test -z "$U"; echo U_EMPTY=$? ; S=$(git status -sb); head -n1 <<< "$S"</automated>
<fails_when>Ein grep auf die Handbuecher liefert 0 (betrieb: CHANGELOG.md >= 2, Was ist neu >= 1, Release >= 2; anwender: `## Was ist neu` genau 1, Was ist neu >= 2; entwicklung: Änderungsliste >= 1, TESSERA_CHANGELOG_MD >= 1; ci-cd-setup: publish-release.sh >= 2, repository: write >= 1) oder ci-cd-setup.md enthaelt echte Umlaute (Zaehler nicht 0); Web weicht von 49/309 oder API von 67/1078 ab; ein TSC_*, FROZEN oder GIT_EXIT ist nicht 0; die Summenzeile nennt nicht genau `19 files changed`; U_EMPTY ist 1 (eine unantastbare Datei wurde geaendert); die Statuszeile zeigt `[ahead` oder `[behind`.</fails_when>
</verify>
<done>Vier Handbuecher auf dem gemessenen Stand (Kapitel 9 mit Changelog-Vorschritt, Release-Hinweis, Erstfreigabe in der Vergangenheit, vierter Erkennungsweg; Anwender-Abschnitt „Was ist neu“ mit TOC; Entwicklungsregel; CI-Setup ASCII); Suiten Web 49/309, API 67/1078; tsc 0 dreimal; frozen-lockfile 0; genau 19 Dateien ausserhalb `.planning`; Push erfolgt, CI-Lauf zum HEAD `success` (Lauf-ID, Dauer und Release-Schritt-Zeilen im SUMMARY); Commit `docs(quick-260916-dcz)`.</done>
</task>
</tasks>
<threat_model>
## Trust Boundaries
| Boundary | Description |
|----------|-------------|
| Repository-Datei -> Web-Bundle -> Browser des Anwenders | `CHANGELOG.md` (vertrauenswuerdige, versionierte Quelle) wird zu HTML gerendert; jeder Commit-Autor kann Markdown einbringen |
| Internet -> `/changelog` und `/_next/static/*` | Seite nur mit gueltigem Session-Cookie (Middleware); statische Chunks sind ohne Anmeldung abrufbar |
| Gitea-Repository -> CI-Job-Container -> Gitea-API | Beim Tag-Push haelt der Job das Repo-Token als Secret und ruft die Release-API ueber `https://git.vicolab.de` auf |
| CHANGELOG-Text -> JSON-Body -> Gitea-Release | Freitext (Anfuehrungszeichen, Backslashes, Zeilenumbrueche) wird in JSON und dann in Gitea-Markdown ueberfuehrt |
| Docker-Bau-Kontext -> Abbild | Eine zusaetzliche Wurzeldatei gelangt in den Kontext und in die builder-Stufe |
## STRIDE Threat Register (ASVS Level 1, Blocking-Schwelle `high`)
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|-----------|----------|-----------|----------|-------------|-----------------|
| T-DCZ-01 | Tampering (XSS ueber Markdown) | `changelog-view.tsx` (`MDEditor.Markdown`) | medium | mitigate | `rehypePlugins={[[rehypeSanitize]]}` wie im Notiz-Widget (Gate: grep `rehypeSanitize` in changelog-view.tsx >= 1); Quelle ist eine versionierte Repo-Datei, keine Nutzereingabe; kein `dangerouslySetInnerHTML` |
| T-DCZ-02 | Information Disclosure | Changelog-Text in `/_next/static` (ohne Auth abrufbar) | low | mitigate | Text nur im Server-Bundle: `@/lib/changelog` wird ausschliesslich von `page.tsx` (Server-Komponente) importiert (Gate Task 1: Import-Zaehler ausserhalb page.tsx = 0; Docker-Gate Task 2: `.next/static` enthaelt den Marker nicht) |
| T-DCZ-03 | Elevation / Zugriff | `/changelog` ohne Anmeldung | medium | mitigate | Bestehende `middleware.ts` (alle Routen ausser `/login`, `/reset-password`) — keine neue oeffentliche Route; Seitentest rendert unabhaengig davon, der Schutz liegt eine Schicht darueber und wird nicht geschwaecht (publicRoutes unveraendert, Gate: `git diff` auf middleware.ts leer, da nicht in files_modified) |
| T-DCZ-04 | Information Disclosure (Secret im Log) | `publish-release.sh`, `ci.yml` | high | mitigate | Token nur ueber `env: GITEA_TOKEN` (Gitea maskiert Secrets im Log), im Skript kein Shell-Tracing, kein Echo des Tokens, Header aus Datei (`--header @file`, nicht in argv/Prozessliste), JSON aus Datei; lokal: Token nur in Variablen, nie ausgegeben (Gates Task 2: `set -x`-Zaehler 0, Echo-Token-Zaehler 0, `header @` >= 1) |
| T-DCZ-05 | Tampering (JSON-/Body-Injection) | Release-Body aus CHANGELOG.md | medium | mitigate | JSON ausschliesslich per `jq -n --arg` (korrektes Escaping), keine String-Konkatenation; `--dry-run` zeigt das JSON vorab (Gate: `jq -n --arg` >= 1) |
| T-DCZ-06 | Denial of Service / Fehlbetrieb | Leerer oder falscher Release | low | mitigate | Tag-Regex `^v[0-9]+\.[0-9]+\.[0-9]+$`, Abschnittspflicht (Exit 1 ohne Text), idempotenter PATCH statt Duplikat (Gates Task 2: DRY_MISSING != 0, Release-Anzahl 1) |
| T-DCZ-07 | Spoofing (falsche API-Basis) | Skript im CI-Job-Container | medium | mitigate | API-Basis aus `GITHUB_API_URL`/`GITHUB_SERVER_URL` (https://git.vicolab.de, TLS), Fallback localhost nur lokal; erste Ausgabezeile nennt die Basis; Token geht nur an diese Basis |
| T-DCZ-08 | Repudiation | Welcher Text zu welcher Version gehoert | low | accept | Release-Text stammt aus der versionierten Datei am getaggten Commit; Aenderungen sind ueber Git nachvollziehbar |
| T-DCZ-09 | Information Disclosure (Bau-Kontext) | `.dockerignore`-Ausnahme | low | mitigate | Ausnahme gilt genau fuer `!CHANGELOG.md` (Gate: exakte Zeile), `*.md` bleibt ausgeschlossen, keine `.env`-Aenderung |
| T-DCZ-SC | Tampering (Supply Chain) | npm-Installs | high | mitigate | Keine neuen Pakete: `MDEditor.Markdown` aus dem installierten `@uiw/react-md-editor` 4.1.1, `rehype-sanitize` vorhanden; Gate `pnpm install --frozen-lockfile` Exit 0 und `pnpm-lock.yaml`/`package.json` unangetastet — daher kein Legitimitaets-Checkpoint noetig |
</threat_model>
<verification>
- `pnpm -C apps/web exec vitest run` -> `Test Files 49 passed (49)` / `Tests 309 passed (309)`; `pnpm -C apps/api exec vitest run` -> `67 passed (67)` / `1078 passed (1078)`.
- `tsc --noEmit` in packages/shared, apps/api, apps/web -> Exit 0; `pnpm install --frozen-lockfile` -> Exit 0.
- `git diff --stat 963fa36 -- . ':!.planning'` -> genau `19 files changed`; `.env*`, Compose, Prisma, Lockfile, package.json, umlaut-dictionary.ts unangetastet.
- Falsifizierung (a): Test 1 in `changelog.test.ts` (live) wird rot, wenn `filterChangelogForChannel` den Abschnitt nicht mehr entfernt (Probe im SUMMARY: Funktion kurzzeitig auf Durchreichen gesetzt -> genau dieser Test rot, danach zurueck).
- Falsifizierung (b): `sh .gitea/scripts/publish-release.sh --dry-run --tag v9.9.9` -> Exit 1, Meldung nennt 9.9.9.
- Falsifizierung (c): lokal gebautes Web-Abbild: `grep -rl "2026-09-15" /app/apps/web/.next/server | wc -l` >= 1 und dasselbe fuer `.next/static` = 0.
- Gitea: `GET /repos/schalli/tessera-ctl/releases/tags/v1.0.0` -> `Tessera 1.0.0`, `draft false`, Body > 100 Zeichen; Release-Anzahl 1.
- CI-Lauf zum gepushten HEAD: `conclusion == success`.
- Browser-Gegenprobe (Playwright MCP, nur wenn ein Dev-Stack laeuft; sonst als offenen Punkt vermerken): Klick auf die Versionszeile fuehrt zu `/changelog`, Seite zeigt „Was ist neu“ mit Hinweis „Noch nicht freigegeben (Beta)“ (lokal Kanal dev).
</verification>
<success_criteria>
- CHANGELOG.md mit `Unveröffentlicht` (Dashboard-Umbau + Seite „Was ist neu“) und `1.0.0 – 2026-09-15` (6-12 Punkte aus den Handbuechern), Alltagssprache, echte Umlaute, Sie-Form.
- Seite `/changelog` (nur angemeldet, Portal-Layout) rendert den Changelog ueber `MDEditor.Markdown` + rehype-sanitize; Live sieht kein `Unveröffentlicht`, Beta/dev sehen „Noch nicht freigegeben (Beta)“ mit Hinweis; Versionszeile ist ein Link mit aria-label „Was ist neu“; de/en vollstaendig.
- Bauweg: `env.TESSERA_CHANGELOG_MD` in next.config.ts, `COPY CHANGELOG.md ./` im Web-Dockerfile, `!CHANGELOG.md` in .dockerignore; Docker-Beweis Server-Bundle ja / statische Chunks nein.
- `publish-release.sh` (dry-run, idempotent, Exit 1 ohne Abschnitt) + ci.yml-Schritt; Release `Tessera 1.0.0` in Gitea.
- Handbuecher aktualisiert; alle Zahlen-Gates erfuellt; gepusht; CI gruen.
</success_criteria>
<output>
Nach Abschluss `.planning/quick/260916-dcz-aenderungsliste-changelog-md-in-alltagss/260916-dcz-SUMMARY.md` anlegen (Deutsch, ASCII): Messwerte aller Gates (Vitest-Zeilen, tsc, 19 files changed), RED-Ausgabe aus Task 1, Docker-Beweis (beide Zahlen, Baudauer), dry-run-Ausgaben, Release-Antwort (id, name, body_len) und PATCH-Wiederholung, CI-Lauf (ID, Dauer, conclusion, Release-Schritt-Zeilen oder Grund, warum das Log nicht lesbar war), Abschnitt „Fuer den Changelog“ entfaellt (die Punkte von bwo, dyv und diesem Auftrag stehen bereits in CHANGELOG.md unter Unveröffentlicht), offene Punkte (z. B. Browser-Gegenprobe, CI-Beweis des Release-Wegs erst beim naechsten Tag).
</output>
@@ -0,0 +1,187 @@
---
phase: quick-260916-dcz
plan: 01
subsystem: web-portal, ci-cd, docs
tags: [changelog, whats-new, gitea-release, build-time-embedding, i18n, handbuecher]
status: complete
requires: [quick-260914-ku1, quick-260916-bwo, quick-260916-dyv]
provides:
- CHANGELOG.md (Wurzel) in Alltagssprache mit Unveroeffentlicht + 1.0.0
- Seite /changelog "Was ist neu" mit Kanalfilter (Server-Komponente)
- Bauzeit-Einbettung env.TESSERA_CHANGELOG_MD (next.config.ts, Dockerfile, .dockerignore)
- .gitea/scripts/publish-release.sh + CI-Schritt (Gitea-Release je Tag v*)
- Release "Tessera 1.0.0" in Gitea (id 1)
affects: [apps/web, .gitea, docs]
tech-stack:
added: []
patterns:
- "Bauzeit-Einbettung einer Repo-Datei ueber next.config.ts env + Importdisziplin (nur Server-Seite importiert das Modul)"
- "Release-Skript: Token nur ueber Header-Datei, JSON nur per jq --arg, idempotent GET/tags -> PATCH oder POST"
key-files:
created:
- CHANGELOG.md
- apps/web/src/lib/changelog.ts
- apps/web/src/lib/changelog.test.ts
- apps/web/src/app/(portal)/changelog/page.tsx
- apps/web/src/app/(portal)/changelog/changelog-page.test.tsx
- apps/web/src/components/changelog/changelog-view.tsx
- .gitea/scripts/publish-release.sh
modified:
- .dockerignore
- apps/web/Dockerfile
- apps/web/next.config.ts
- apps/web/src/components/layout/app-version-badge.tsx
- apps/web/src/components/layout/app-version-badge.test.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- .gitea/workflows/ci.yml
- docs/anleitung-betrieb.md
- docs/anleitung-anwender.md
- docs/anleitung-entwicklung.md
- docs/ci-cd-setup.md
decisions:
- "Commits auf main: Projektstrategie branching_strategy none, Auftrag schreibt Push von main vor"
- "Ein feat-Commit fuer Task 1 statt getrennter test/feat-Commits: der Plan schreibt genau drei Commits (feat/ci/docs) vor; RED-Nachweis liegt als TAP-Record vor (RED_EVIDENCE_OK)"
- "filterChangelogForChannel liefert bei leerem Ergebnis '' statt '\\n' (Seite prueft ohnehin markdown.trim())"
- "publish-release.sh gibt die API-Basis erst NACH der Tag-Entscheidung aus (Reihenfolge der Plan-Schritte 2 und 3); auf main erscheint daher nur 'nichts zu tun'"
metrics:
duration: "ca. 2 h 20 min (Start 09:13 UTC, Ende ca. 09:35 UTC + CI-Beobachtung bis 09:30 UTC lokal 11:30)"
completed: 2026-09-16
plan_head_before: 0db21627f51290f26ca049968d11d53b2394cd0f
commits: 3
actuals:
tokens: 12659
tasks: 3
commits: 3
---
# Quick 260916-dcz: Aenderungsliste (CHANGELOG.md) in Alltagssprache, Seite "Was ist neu", Gitea-Release je Tag — Summary
CHANGELOG.md im Wurzelverzeichnis (Unveroeffentlicht mit 8 Punkten aus bwo + dyv + dieser Seite, 1.0.0 mit 11 Punkten aus den Handbuechern), zur Bauzeit ueber `env.TESSERA_CHANGELOG_MD` ins Server-Bundle eingebettet und unter `/changelog` als Server-Seite mit Kanalfilter (Live ohne Unveroeffentlicht) ueber `MDEditor.Markdown` + `rehype-sanitize` gerendert; die Versionszeile ist ein Link; `publish-release.sh` legt beim Tag den Gitea-Release aus dem CHANGELOG-Abschnitt an (idempotent, Exit 1 ohne Abschnitt), Release `Tessera 1.0.0` rueckwirkend angelegt; vier Handbuecher nachgezogen; gepusht, CI 356 success.
## Aktenstand (git ist die Wahrheit)
`git status --porcelain` nach Task 3 (vor dem SUMMARY): leer.
`git log --oneline 0db2162..HEAD`:
```
c5f4ade docs(quick-260916-dcz): Betriebshandbuch Kapitel 9 (Changelog-Schritt, Gitea-Release, Seite Was ist neu), Anwender-, Entwicklungs- und CI-Handbuch
6940bd0 ci(quick-260916-dcz): Gitea-Release je Freigabe-Tag aus CHANGELOG.md (publish-release.sh, idempotent, --dry-run), Schritt in ci.yml
ba06db9 feat(quick-260916-dcz): CHANGELOG.md, Seite "Was ist neu" mit Kanalfilter, Versionszeile als Link, Bauzeit-Einbettung
```
`git status -sb | head -1` nach `git fetch -q`: `## main...origin/main` (nicht voraus, nicht zurueck). Push: `963fa36..c5f4ade main -> main` — die beiden Plan-Docs-Commits (df16f46, 0db2162) gingen wie erwartet mit.
`commits: 3` ist gemessen: `git rev-list --count 0db2162..HEAD` = 3.
## Task 1 — CHANGELOG.md, Bauzeit-Einbettung, Kanalfilter, Seite, Abzeichen-Link, i18n (ba06db9)
**RED (Schritt A), Befehl** `pnpm -C apps/web exec vitest run src/lib/changelog.test.ts "src/app/(portal)/changelog" src/components/layout/app-version-badge.test.tsx`, Exit 1:
```
FAIL src/lib/changelog.test.ts [ src/lib/changelog.test.ts ]
Error: Failed to resolve import "./changelog" from "src/lib/changelog.test.ts". Does the file exist?
FAIL src/app/(portal)/changelog/changelog-page.test.tsx [ ... ]
Error: Failed to resolve import "./page" from "src/app/(portal)/changelog/changelog-page.test.tsx". Does the file exist?
FAIL ... app-version-badge.test.tsx > Test 5 (Link): die Versionszeile ist ein Link auf /changelog
AssertionError: expected 'SPAN' to be 'A' // Object.is equality
FAIL ... app-version-badge.test.tsx > Test 6 (aria-label): der Link traegt den Namen "Was ist neu"
Test Files 3 failed (3)
Tests 2 failed | 4 passed (6)
```
RED-Nachweis nach #3770: TAP-Lauf (`--reporter=tap-flat`) der Badge-Datei als Record persistiert, `gsd_run check tdd-red-evidence` -> `RED_EVIDENCE_OK` (target_test_failed, Zieltest = Test 5 Link). Hinweis: Vitest-TAP hat keine node:test-Summenzeilen; `# tests 6 / # pass 4 / # fail 2` wurden aus den ok/not-ok-Zeilen gezaehlt und angehaengt (Format, kein Inhalt).
**GREEN (Schritt H):** Zielsuite `3 passed (3)` / `19 passed (19)`; gesamte Web-Suite `Test Files 49 passed (49)` / `Tests 309 passed (309)` (Plan-Soll 49/309, erfuellt); `tsc --noEmit` web Exit 0.
**Falsifizierung (a):** `if (isEmpty || channel === 'live')` kurzzeitig auf `if (isEmpty)` gesetzt -> `Tests 2 failed | 8 passed (10)`: Test 1 (live) UND Test 8 (CRLF, ebenfalls live) rot; Datei danach byte-identisch zurueckgesetzt (diff leer).
**Lokaler `next build`:** Exit 0 in 89 s; `/changelog` als `ƒ (Dynamic)` 1.84 kB; Marker `2026-09-15`: `apps/web/.next/server` = 1 Datei, `apps/web/.next/static` = 0.
**Verify-Gates Task 1 (alle erfuellt):** CL_EXISTS=0; `## Unveröffentlicht` 1; `## 1.0.0 – 2026-09-15` 1; `### ` 3; Punkte unter 1.0.0 = 11 (Soll 6-12); Punkte unter Unveroeffentlicht = 8 (Soll 7-9); `!CHANGELOG.md` 1; `COPY CHANGELOG.md ./` 1; TESSERA_CHANGELOG_MD in next.config.ts 3; `process.env.TESSERA_CHANGELOG_MD` in changelog.ts 1; `export function filterChangelogForChannel` 1; Importe von `@/lib/changelog` ausserhalb page.tsx = 0; `MDEditor.Markdown` 2; `rehypeSanitize` 2; page.tsx `use client` 0; `href="/changelog"` 1; `aria-label={t('whatsNew')}` 1; `"whatsNew"` de 1; `"unreleasedHint"` en 1; umlaut-dictionary.ts / package.json / pnpm-lock.yaml: UNTOUCHED=0 (unangetastet); TSC_web=0.
Umlaut-Waechter: alle neuen de.json-Texte bestehen (`aktuelle`, `Tessera` sind gelistet; keine neuen ae/oe/ue/ss-Woerter), `umlaut-dictionary.ts` unangetastet.
## Task 2 — Release-Skript, CI-Schritt, Docker-Falsifizierung, Release v1.0.0 (6940bd0)
Precondition: Gitea `{"version":"1.26.2"}`, jq `/bin/jq`, docker `/bin/docker`, Push-URL enthaelt localhost:3002 — erfuellt.
**Dry-run-Ausgaben:**
1. `--dry-run --tag v1.0.0` -> Exit 0; erste Zeile `Gitea-API: http://localhost:3002/api/v1 Repo: schalli/tessera-ctl Tag: v1.0.0`, dann POST-/PATCH-Ziele und das JSON; `.name` = `Tessera 1.0.0`, Body 2227 Zeichen, erste Zeile `### Neu`, letzte Zeile `- Versionsanzeige unten in der Seitenleiste ...`.
2. `--dry-run --tag v9.9.9` -> Exit 1, stderr: `CHANGELOG.md hat keinen Abschnitt fuer Version 9.9.9 (erwartet eine Zeile '## 9.9.9 – <Datum>'). Kein Release ohne Text.` (Falsifizierung b).
3. `GITHUB_REF=refs/heads/main ... --dry-run` -> Exit 0, `Kein Freigabe-Tag (nur refs/tags/v*): nichts zu tun.`
4. `GITHUB_REF=refs/tags/v1.0.0 GITHUB_SERVER_URL=https://git.vicolab.de ... --dry-run` -> erste Zeile `Gitea-API: https://git.vicolab.de/api/v1 Repo: schalli/tessera-ctl Tag: v1.0.0`.
**Docker-Falsifizierung (c):** `docker build -t tessera-web-dcz-test --build-arg APP_VERSION=v9.9.9-test --build-arg APP_CHANNEL=live -f apps/web/Dockerfile .` -> Exit 0 in 103 s; Kontext `transferring context: 518.75MB 4.7s`; Schicht `#18 [builder 6/7] COPY CHANGELOG.md ./` (die Datei kam also trotz `*.md` durch die Ausnahme in den Kontext). Im Abbild: `grep -rl "2026-09-15" /app/apps/web/.next/server | wc -l` = **1**, `.../.next/static` = **0**. Abbild danach mit `docker rmi` entfernt.
**Echter Lauf v1.0.0 (Token nur in Variablen, nie ausgegeben):** vorher `GET .../releases` -> `0` Releases. Lauf 1: `Release v1.0.0 angelegt (id 1)`, Exit 0. Pruefung `GET .../releases/tags/v1.0.0`: `{"id":1,"tag_name":"v1.0.0","name":"Tessera 1.0.0","draft":false,"prerelease":false,"body_len":2227}`, Body beginnt mit `### Neu`. Lauf 2 (identischer Aufruf): `Release v1.0.0 aktualisiert (id 1)`, Exit 0; `jq length` auf `.../releases` = **1** (idempotent, kein Duplikat).
**Verify-Gates Task 2:** EXEC=0; Shebang 1; `set -eu` 1; `set -x` 0; Echo-Token-Zaehler 0; `jq -n --arg` 2; `header @` 3; `releases/tags/` 1; `PATCH` 3; DRY_OK=0; DRY_MISSING=1 mit `9.9.9` in stderr; „nichts zu tun“ 1; Name-grep 1; `publish-release.sh` in ci.yml 1; `secrets.REGISTRY_TOKEN` 2.
**Messwiderspruch (beide Werte, nicht angepasst):** Das Plan-Gate `grep -c "GITEA_TOKEN: \${{ secrets.REGISTRY_TOKEN }}" .gitea/workflows/ci.yml` liefert auf diesem Host **0**, weil `grep` hier `ugrep 7.8.4` ist und `$` mitten im Muster als Anker wirkt (Gegenprobe: dasselbe Muster auf eine Echo-Zeile mit exakt diesem Text liefert ebenfalls 0). `grep -cF 'GITEA_TOKEN: ${{ secrets.REGISTRY_TOKEN }}'` und `grep -c 'GITEA_TOKEN: [$]{{ secrets.REGISTRY_TOKEN }}'` liefern **1**; die Zeile steht woertlich in ci.yml (Zeilen 70-72).
Zwei Korrekturen VOR dem Commit (kein Plan-Deviation, Skript war noch ungetestet): (1) dash-`echo` interpretiert `\n` im jq-JSON -> `printf '%s\n'`; (2) die Fehlermeldung bei fehlendem Token nannte den Variablennamen in einer echo-Zeile und haette das Echo-Token-Gate ausgeloest -> umformuliert („Kein Zugriffstoken in der Umgebung gesetzt“).
YAML-Pruefung: PyYAML nicht vorhanden (`No module named 'yaml'`); strukturelle grep-Pruefung wie im Plan vorgesehen, und der CI-Lauf hat die Datei geparst und ausgefuehrt.
## Task 3 — Handbuecher, Push, CI-Beobachtung (c5f4ade)
Precondition: Gitea 1.26.2, `gitea-runner` laeuft (1).
**Handbuch-Gates:** betrieb `CHANGELOG.md` 2 (>=2), `Was ist neu` 1 (>=1), `Release` 4 (>=2); anwender `## Was ist neu` 1, `Was ist neu` 4 (>=2); entwicklung `Änderungsliste` 1, `TESSERA_CHANGELOG_MD` 1; ci-cd-setup `publish-release.sh` 2 (>=2), `repository: write` 1, echte Umlaute 0. Abschnitt „Dashboard“ im Anwenderhandbuch: kein Diff (0 geaenderte Zeilen mit „Dashboard“, Aenderung nur Inhaltsverzeichnis, Satz in „Aufbau der Oberflaeche“ und neuer Abschnitt vor den Stolpersteinen).
**Baseline:** Web `Test Files 49 passed (49)` / `Tests 309 passed (309)` (zweimal gemessen, nach Task 1 und nach Task 3); API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`; `tsc --noEmit`: packages/shared 0, apps/api 0, apps/web 0; `pnpm install --frozen-lockfile` Exit 0; `git diff --stat 963fa36 -- . ':!.planning'` -> `19 files changed, 843 insertions(+), 17 deletions(-)`; Unantastbare (`.env*`, Compose, pnpm-lock.yaml, package.json beider Apps, prisma, apps/api/Dockerfile, umlaut-dictionary.ts): U_EMPTY=0 (unveraendert).
**CI-Lauf:** id **356**, head_sha c5f4ade, `started_at 2026-09-16T11:25:15+02:00`, `completed_at 2026-09-16T11:29:57+02:00` (4 min 42 s), `conclusion: success`. Jobs: 1023 Lint & Type Check success, 1024 Tests success, 1025 Build & Publish Images success. Job-Log 1025 (`/actions/jobs/1025/logs`, HTTP 200) zeigt den Release-Schritt:
```
::group::Run sh .gitea/scripts/publish-release.sh
Kein Freigabe-Tag (nur refs/tags/v*): nichts zu tun.
```
Die Zeile `Gitea-API: https://git.vicolab.de/api/v1 ...` erscheint auf `main` NICHT — das Skript beendet sich laut Plan-Schritt 2 (Tag-Entscheidung) vor Plan-Schritt 3 (API-Basis ausgeben). Die Aufloesung ueber `GITHUB_SERVER_URL` ist lokal bewiesen (dry-run 4 oben); der CI-Beweis der Aufloesung kommt mit dem naechsten Tag (siehe offen).
## Deviations from Plan
**1. [Rule 1 - Bug] dash-`echo` haette das dry-run-JSON zerlegt** — Found during Task 2, Schritt C1 (jq konnte das dry-run-JSON nicht parsen: „control characters must be escaped“); Fix `printf '%s\n'` statt `echo`; Datei publish-release.sh; im Commit 6940bd0 enthalten.
**2. Reihenfolge Tag-Entscheidung vor API-Ausgabe** — der Plan-Text in key_links erwartet die `Gitea-API:`-Zeile im main-Lauf, die Action-Schritte 2/3 legen die Reihenfolge anders fest; ich habe die Action-Schritte umgesetzt. Ergebnis im CI-Log: nur „nichts zu tun“. Kein Gate verletzt.
**3. Leeres Ergebnis** — `filterChangelogForChannel` liefert `''` statt `'\n'`, wenn kein Abschnitt uebrig bleibt; die Seite prueft `markdown.trim()`, Test 3 der Seite deckt den Fall.
Sonst: Plan wie geschrieben ausgefuehrt. Keine neuen Pakete, keine Auth-Gates.
## Beobachtungen ausserhalb des Umfangs (nicht behoben)
- `pnpm exec biome check ...` bricht mit „Biome exited because the configuration resulted in errors“ ab (Konfiguration braucht `biome migrate`) — vorbestehend, nicht durch diesen Auftrag verursacht; Lint im CI ist ohnehin ein Leerlauf (WINDOWS #35).
## Threat Flags
Keine neue Oberflaeche ausserhalb des `<threat_model>`: T-DCZ-01 (rehypeSanitize 2 Treffer), T-DCZ-02 (Import-Zaehler 0, Docker static 0), T-DCZ-03 (middleware.ts nicht angefasst), T-DCZ-04 (set -x 0, Echo-Token 0, header @ 3, Token nie ausgegeben), T-DCZ-05 (jq --arg), T-DCZ-06 (v9.9.9 Exit 1, Release-Anzahl 1), T-DCZ-07 (API-Basis-Aufloesung lokal bewiesen), T-DCZ-09 (genau `!CHANGELOG.md`), T-DCZ-SC (frozen-lockfile 0) — alle Gates gruen.
## Known Stubs
Keine.
## Was bewusst offen bleibt
- **CI-Beweis des Release-Wegs:** Der POST/PATCH-Weg lief nur lokal gegen `localhost:3002` (v1.0.0). Der erste echte Tag-Lauf im CI (`refs/tags/v1.0.1` oder `v1.1.0`) beweist die API-Aufloesung `https://git.vicolab.de/api/v1` aus dem Job-Container und die Token-Berechtigung von `secrets.REGISTRY_TOKEN` fuer Releases (gemessen zur Planungszeit: `write:repository`).
- **Browser-Gegenprobe** (siehe naechster Abschnitt) — vom Orchestrator durchzufuehren; kein Container wurde gestartet oder neu gebaut.
- Der Abschnitt „Fuer den Changelog“ entfaellt: die Punkte von bwo, dyv und diesem Auftrag stehen bereits in CHANGELOG.md unter Unveroeffentlicht.
## Fuer den Verifizierer/Orchestrator (Browser-Nachweis)
1. Web-Container neu bauen (der Changelog kommt zur BAUZEIT ins Bundle; `up` allein reicht nicht): `docker compose up -d --build --force-recreate web`. Lokal ist der Kanal `dev` (kein `APP_CHANNEL`-Build-Arg).
2. Anmelden, unten in der Seitenleiste auf die Versionszeile (`dev · Entwicklung`, Link mit aria-label „Was ist neu“) klicken -> URL `/changelog`, Seitentitel „Was ist neu“, Vorspann.
3. Erwartung auf `dev`: gelber Hinweis („Die Punkte unter „Noch nicht freigegeben“ sind in dieser Beta bereits enthalten ...“, `data-testid="changelog-unreleased-hint"`), darunter die gerenderte Liste mit Ueberschrift „Noch nicht freigegeben (Beta)“ (8 Punkte) und „1.0.0 – 2026-09-15“ (11 Punkte); H1 „Änderungen an Tessera“ und Vorspann der Datei fehlen (die Seite hat ihren eigenen Titel).
4. Sanitized Rendering: das Markdown wird ueber `MDEditor.Markdown` mit `rehype-sanitize` gerendert (`data-testid="changelog-markdown"`); Dunkelmodus-Umschalter oben rechts wechselt `data-color-mode`.
5. Ohne Anmeldung `/changelog` aufrufen -> Umleitung auf `/login` (bestehende Middleware).
6. `live` lokal simulieren: `docker build --build-arg APP_CHANNEL=live -f apps/web/Dockerfile .` und den Container damit starten — dann fehlt der Abschnitt „Noch nicht freigegeben“ samt Hinweis komplett; alternativ genuegt der Unit-Beweis (Test 1 und 8 in changelog.test.ts, Test 1 in changelog-page.test.tsx decken den live-Pfad; Falsifizierung (a) oben).
7. Gitea: Repository -> Releases zeigt „Tessera 1.0.0“ zum Tag v1.0.0 mit dem 1.0.0-Abschnitt als Text.
## Self-Check: PASSED
- Dateien: CHANGELOG.md, apps/web/src/lib/changelog.ts, changelog.test.ts, (portal)/changelog/page.tsx, changelog-page.test.tsx, components/changelog/changelog-view.tsx, .gitea/scripts/publish-release.sh — FOUND (19 Dateien im Diff gegen 963fa36).
- Commits ba06db9, 6940bd0, c5f4ade — FOUND in `git log`, gepusht (origin/main == main).
@@ -0,0 +1,124 @@
---
phase: quick-260916-dcz
verified: 2026-09-16T11:40:00Z
status: passed
score: 8/8 must-haves verified
covered_files: [".dockerignore", ".gitea/scripts/publish-release.sh", ".gitea/workflows/ci.yml", ".planning/quick/260916-dcz-aenderungsliste-changelog-md-in-alltagss/260916-dcz-PLAN.md", ".planning/quick/260916-dcz-aenderungsliste-changelog-md-in-alltagss/260916-dcz-SUMMARY.md", ".planning/quick/260916-dcz-aenderungsliste-changelog-md-in-alltagss/deferred-items.md", "CHANGELOG.md", "apps/web/Dockerfile", "apps/web/next.config.ts", "apps/web/src/app/(portal)/changelog/changelog-page.test.tsx", "apps/web/src/app/(portal)/changelog/page.tsx", "apps/web/src/components/changelog/changelog-view.tsx", "apps/web/src/components/layout/app-version-badge.test.tsx", "apps/web/src/components/layout/app-version-badge.tsx", "apps/web/src/lib/changelog.test.ts", "apps/web/src/lib/changelog.ts", "apps/web/src/messages/de.json", "apps/web/src/messages/en.json", "docs/anleitung-anwender.md", "docs/anleitung-betrieb.md", "docs/anleitung-entwicklung.md", "docs/ci-cd-setup.md"]
covered_digest: "v1:sha256:45c924c03cc6ffda72be090cf17a9877899dbcde20eddf2a28b4c558b4cecb1f"
behavior_unverified: 0
overrides_applied: 0
---
# Quick-Task 260916-dcz: Aenderungsliste (CHANGELOG.md), Seite "Was ist neu", Gitea-Release je Tag — Verifikationsbericht
**Auftragsziel:** `CHANGELOG.md` in Alltagssprache (Unveroeffentlicht + 1.0.0), Seite "Was ist neu" unter `/changelog` (Server-Komponente, Bauzeit-Einbettung, Kanalfilter, MDEditor.Markdown + rehypeSanitize), Dockerfile/`.dockerignore`-Anpassung, Release-Skript `publish-release.sh` + ci.yml-Schritt, rueckwirkender Gitea-Release v1.0.0, vier Handbuecher.
**Verifiziert:** 2026-09-16, 11:15-11:45 UTC (lokal 13:15-13:45)
**Status:** passed
**Re-Verifikation:** Nein — Erstverifikation
Zusaetzlich im Umfang dieser Verifikation (per Auftrag): der vom Orchestrator angehaengte Commit `c3d8e16` (fehlende i18n-Schluessel Kalenderquellen-Formular + ein "Behoben"-Eintrag in `CHANGELOG.md`) — geprueft nur darauf, ob er ein Gate dieses Plans bricht. Tut er nicht (siehe unten).
## Zielerreichung
### Beobachtbare Wahrheiten
| # | Wahrheit | Status | Beleg |
|---|----------|--------|-------|
| 1 | `CHANGELOG.md` liegt im Wurzelverzeichnis, deutsch, echte Umlaute, Alltagssprache, Keep-a-Changelog-Form | VERIFIZIERT | `cat CHANGELOG.md`: H1 "# Änderungen an Tessera", Vorspann, `## Unveröffentlicht` mit `### Neu` (2), `### Geändert` (6), `### Behoben` (1, aus c3d8e16), `## 1.0.0 – 2026-09-15` mit `### Neu` (11 Punkte, Bereich 6-12 erfuellt). Keine Dateinamen (`grep -nE '\.tsx|\.ts[^a-z]'` leer), keine Commit-Kuerzel (`grep -nE '\b[0-9a-f]{7,40}\b'` leer). |
| 2 | Versionszeile ist Link zu `/changelog`, Seite rendert CHANGELOG als Markdown, Middleware schuetzt die Route | VERIFIZIERT | `app-version-badge.tsx`: `<Link href="/changelog" aria-label={t('whatsNew')} data-testid="app-version" title={title}>`; `page.tsx`: async Server-Komponente ohne `'use client'`; `middleware.ts` `publicRoutes = ['/login', '/reset-password']` — `/changelog` ist geschuetzt. |
| 3 | Kanalregel `filterChangelogForChannel` als reine Funktion, live entfernt Unveroeffentlicht, beta/dev zeigen "Noch nicht freigegeben (Beta)", leerer Abschnitt immer ausgeblendet | VERIFIZIERT | Quellcode geprueft (`apps/web/src/lib/changelog.ts`); Falsifizierung selbst durchgefuehrt: `if (isEmpty || channel === 'live')` -> `if (isEmpty)` gesetzt, `vitest run changelog.test.ts` -> `2 failed \| 8 passed (10)` (Test 1 live, Test 8 CRLF/live rot wie von SUMMARY behauptet); danach `git checkout --` und `git status --porcelain -- apps/` leer bestaetigt. |
| 4 | Bauzeit-Einbettung via `next.config.ts` `env.TESSERA_CHANGELOG_MD`, Server-Bundle-only, Docker COPY + `.dockerignore`-Ausnahme | VERIFIZIERT | `next.config.ts`: `readChangelog()` liest `path.resolve(__dirname, '../../CHANGELOG.md')`, `env: { TESSERA_CHANGELOG_MD: readChangelog() }`; `.dockerignore` Zeile 7 `*.md`, Zeile 10 `!CHANGELOG.md` (danach); `apps/web/Dockerfile` Zeile 27 `COPY CHANGELOG.md ./` in der builder-Stufe nach `COPY tsconfig.base.json ./`. Docker-Beweis selbst nicht neu gebaut (Environment verbietet Container-Build), SUMMARY-Beleg (Exit 0, `.next/server`=1 Treffer, `.next/static`=0) als plausibel bewertet, da Quellcode und Importdisziplin (`grep -rl "@/lib/changelog'" apps/web/src` nur in `page.tsx`/Tests) die Behauptung stuetzen. |
| 5 | `publish-release.sh`: awk-Schnitt, jq, API-Basis aus GITHUB_*, POST/PATCH, `--dry-run`, Exit != 0 ohne Abschnitt, Token nie ausgegeben | VERIFIZIERT | Selbst ausgefuehrt: `--dry-run --tag v1.0.0` -> Exit 0, JSON mit `.name="Tessera 1.0.0"`; `--dry-run --tag v9.9.9` -> Exit 1, Meldung "CHANGELOG.md hat keinen Abschnitt fuer Version 9.9.9". Token nur in `printf ... > "$HDR"`, kein `echo`/`set -x` von `$GITEA_TOKEN`. |
| 6 | `ci.yml`-Schritt ruft `publish-release.sh` mit `GITEA_TOKEN` aus `secrets.REGISTRY_TOKEN` in `env` auf, rueckwirkender Release v1.0.0 existiert | VERIFIZIERT | `.gitea/workflows/ci.yml` Zeilen 71-74: Schritt nach dem Abbild-Schritt, `env: GITEA_TOKEN: ${{ secrets.REGISTRY_TOKEN }}`, `run: sh .gitea/scripts/publish-release.sh` — kein Echo, kein Argument. Gitea-API (read-only, Token aus Push-URL, nicht ausgegeben): `GET /releases` -> genau 1 Release, `tag_name=v1.0.0`, `name="Tessera 1.0.0"`, `body` 2227 Zeichen, beginnt mit `### Neu`. |
| 7 | Handbuecher (Betrieb Kap. 9, Anwender, Entwicklung, CI-Setup) dokumentieren den neuen Ablauf | VERIFIZIERT | `anleitung-betrieb.md`: Schritt "Änderungsliste abschließen" vor dem Tag, automatischer Gitea-Release beschrieben, "Was ist neu" als vierter Weg. `anleitung-anwender.md`: `## Was ist neu` (Zeile 173) + Inhaltsverzeichnis-Eintrag. `anleitung-entwicklung.md`: Regel "jede Änderung sofort ... unter Unveröffentlicht". `docs/ci-cd-setup.md`: `publish-release.sh` (2 Treffer), `repository: write` genannt; ASCII-Umschrift konsistent mit Bestandsdatei. |
| 8 | Baseline am Ende: Web 49/309, API 67/1078, tsc 0, `pnpm install --frozen-lockfile` 0, 19 Dateien im Diff, verbotene Pfade unangetastet, CI-Lauf success, `git push` synchron | VERIFIZIERT | Selbst gemessen: Web `Test Files 49 passed (49)` / `Tests 309 passed (309)`; API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`; `tsc --noEmit` Exit 0 in web/api/shared; `pnpm install --frozen-lockfile` Exit 0; `git diff --stat 963fa36 c3d8e16~1 -- . ':!.planning'` -> 19 Dateien; vollstaendiger Dateibaum-Vergleich `963fa36..c3d8e16` zeigt keine der verbotenen Pfade (Compose, pnpm-lock.yaml, package.json, prisma, api-Dockerfile, umlaut-dictionary.ts, `.env*`) — nur die 19 erwarteten Dateien; CI-Lauf 356 (c5f4ade) `status=success` (alle 3 Jobs), CI-Lauf fuer c3d8e16 (Task-IDs 771/772/773, `run 357`) bei erster Messung "running" (Build & Publish Images), nach Poll bis ~2 Min: alle 3 Jobs `success`; `git fetch && git status -sb` -> `## main...origin/main`. |
**Score:** 8/8 Wahrheiten verifiziert (0 present-behavior-unverified)
### Erforderliche Artefakte
| Artefakt | Erwartet | Status | Details |
|----------|----------|--------|---------|
| `CHANGELOG.md` | H1, Vorspann, Unveroeffentlicht + 1.0.0, echte Umlaute | VERIFIZIERT | Inhalt gelesen und geprueft, siehe Wahrheit 1 |
| `.dockerignore` | `!CHANGELOG.md` nach `*.md` | VERIFIZIERT | Zeile 7 `*.md`, Zeile 10 `!CHANGELOG.md` |
| `apps/web/Dockerfile` | `COPY CHANGELOG.md ./` in builder-Stufe | VERIFIZIERT | Zeile 27, nach `COPY tsconfig.base.json ./` |
| `apps/web/next.config.ts` | `readChangelog()` + `env.TESSERA_CHANGELOG_MD` | VERIFIZIERT | Quellcode gelesen |
| `apps/web/src/lib/changelog.ts` | `filterChangelogForChannel`, `UNRELEASED_HEADING`, `changelogMarkdown` | VERIFIZIERT | Quellcode gelesen, Falsifizierung bestanden |
| `apps/web/src/lib/changelog.test.ts` | 10 Tests | VERIFIZIERT | `vitest run` 10/10 gruen |
| `apps/web/src/app/(portal)/changelog/page.tsx` | async Server-Komponente | VERIFIZIERT | Quellcode gelesen, kein `'use client'` |
| `apps/web/src/app/(portal)/changelog/changelog-page.test.tsx` | 3 Tests | VERIFIZIERT | in Gesamtsuite (309) enthalten |
| `apps/web/src/components/changelog/changelog-view.tsx` | `MDEditor.Markdown` + `rehypeSanitize` | VERIFIZIERT | Quellcode gelesen |
| `apps/web/src/components/layout/app-version-badge.tsx` | Link auf `/changelog` | VERIFIZIERT | Quellcode gelesen |
| `apps/web/src/messages/de.json` + `en.json` | `sidebar.whatsNew`, Namensraum `changelog` | VERIFIZIERT | JSON geparst, alle Schluessel vorhanden |
| `.gitea/scripts/publish-release.sh` | ausfuehrbar, POSIX sh | VERIFIZIERT | `sh .gitea/scripts/publish-release.sh` lief ohne chmod-Fehler |
| `.gitea/workflows/ci.yml` | vierter Schritt im Job `publish` | VERIFIZIERT | Zeilen 71-74 |
| Handbuecher (4 Dateien) | Abschnitte wie in Wahrheiten | VERIFIZIERT | siehe Wahrheit 7 |
### Key-Link-Verifikation
| Von | Nach | Via | Status | Details |
|-----|------|-----|--------|---------|
| `next.config.ts` | `changelog.ts` | `env.TESSERA_CHANGELOG_MD` -> `process.env.TESSERA_CHANGELOG_MD` (voller Literalname) | WIRED | Literalname in beiden Dateien identisch, Test 9/10 in changelog.test.ts bestehen |
| `changelog.ts` | `page.tsx` | einziger Import ausserhalb Tests | WIRED | `grep -rl "@/lib/changelog'" apps/web/src` liefert nur `page.tsx` und Testdateien |
| `page.tsx` | `changelog-view.tsx` | Prop `markdown` | WIRED | `<ChangelogView markdown={markdown} />` |
| `app-version-badge.tsx` | `/changelog` | `next/link` `Link href` | WIRED | Quellcode gelesen |
| `middleware.ts` | `/changelog` | implizit (nicht in `publicRoutes`) | WIRED | `publicRoutes` enthaelt `/changelog` nicht |
| `ci.yml` (`publish`-Job) | `publish-release.sh` | `env.GITEA_TOKEN` + `run: sh ...` | WIRED | Skript lief im CI-Lauf 356 und 357 mit "nichts zu tun" (main, kein Tag) |
| `publish-release.sh` | Gitea-API | `GITEA_API`/`GITHUB_API_URL`/`GITHUB_SERVER_URL`/Fallback | WIRED (lokal bewiesen) | Rueckwirkender Lauf `v1.0.0` gegen `localhost:3002` erzeugte den Release; Aufloesung im CI selbst noch ungeprueft, da noch kein neuer Tag seit diesem Auftrag gepusht wurde (siehe "Angenommene Risiken") |
### Verhaltens-Stichproben
| Verhalten | Befehl | Ergebnis | Status |
|-----------|--------|----------|--------|
| Kanalfilter live entfernt Unveroeffentlicht | `vitest run src/lib/changelog.test.ts` (Original) | 10/10 gruen | PASS |
| Falsifizierung: Funktion ohne live-Zweig | `sed -i` Aenderung + `vitest run` | 2 failed / 8 passed | PASS (rot wie erwartet) |
| Release-Skript ohne Abschnitt | `--dry-run --tag v9.9.9` | Exit 1, Meldung korrekt | PASS |
| Release-Skript mit Abschnitt | `--dry-run --tag v1.0.0` | Exit 0, JSON korrekt | PASS |
| Gitea-Release existiert | `GET /repos/schalli/tessera-ctl/releases` | 1 Release, v1.0.0, "Tessera 1.0.0" | PASS |
| Web-Testsuite | `npx vitest run` (apps/web) | 49 Dateien / 309 Tests gruen | PASS |
| API-Testsuite | `npx vitest run` (apps/api) | 67 Dateien / 1078 Tests gruen | PASS |
| TypeScript | `npx tsc --noEmit` (web/api/shared) | Exit 0 je | PASS |
| Lockfile | `pnpm install --frozen-lockfile` | Exit 0 | PASS |
### Requirements Coverage
Kein Eintrag `QUICK-260916-DCZ` in `.planning/REQUIREMENTS.md` gefunden — bei Quick-Tasks ueblich (keine formale Requirements-Zuordnung). Kein verwaistes Requirement identifiziert.
### Anti-Pattern-Scan
Alle 13 vom Plan genannten Code-/Skript-Dateien auf `TBD|FIXME|XXX|TODO|HACK|PLACEHOLDER|not yet implemented|coming soon` geprueft — keine Treffer.
### Probe-Ausfuehrung
Kein dediziertes `scripts/*/tests/probe-*.sh`-Muster im Umfang dieses Auftrags; die Falsifizierungen (a) und (b) wurden als Ad-hoc-Proben unter "Verhaltens-Stichproben" durchgefuehrt.
## Vom Orchestrator im Browser zu pruefen
Der Executor hat im SUMMARY (Abschnitt "Fuer den Verifizierer/Orchestrator") sieben Browser-Schritte dokumentiert; keiner davon wurde in dieser Verifikation ausgefuehrt (Umgebung untersagt Container-Neubau/-Start und Browser-Nutzung). Zur Erledigung durch den Orchestrator:
1. `docker compose up -d --build --force-recreate web` (Bauzeit-Einbettung erfordert Neubau).
2. Anmelden, Versionszeile unten links anklicken -> `/changelog`, Titel "Was ist neu".
3. Auf lokalem Kanal `dev`: gelber Hinweis + "Noch nicht freigegeben (Beta)" (9 Punkte inkl. Behoben-Eintrag) + "1.0.0 – 2026-09-15" (11 Punkte); H1/Vorspann der Datei fehlen.
4. Sanitized Rendering pruefen (`data-testid="changelog-markdown"`), Dunkelmodus-Umschalter wechselt `data-color-mode`.
5. Ohne Anmeldung `/changelog` -> Umleitung `/login`.
6. Optional: `live`-Kanal lokal simulieren (Build-Arg `APP_CHANNEL=live`) -> Abschnitt "Noch nicht freigegeben" fehlt komplett.
7. Gitea-Oberflaeche: Releases zeigt "Tessera 1.0.0".
Dies ist **keine** `human_needed`-Klassifizierung fuer den Gesamtbericht — der Auftrag weist diese Pruefung explizit dem Orchestrator zu, nicht dem Verifizierer, und alle automatisiert pruefbaren Wahrheiten sind bereits VERIFIZIERT.
## Angenommene Risiken
- **Docker-Falsifizierung (c) nicht selbst nachgebaut:** Die Umgebung dieser Verifikation untersagt Container-Builds. Ich habe die SUMMARY-Behauptung (`docker build` Exit 0, Marker nur in `.next/server`, nicht in `.next/static`) nicht durch einen eigenen Bau nachvollzogen, sondern anhand des Quellcodes (Importdisziplin, COPY-Zeile, `.dockerignore`-Ausnahme) als plausibel und konsistent mit dem Verhalten des `next build`-Laufs bewertet, den ich indirekt ueber die identischen Server-/Static-Pruefungen im Code nachvollziehen kann. Der Browser-/Docker-Nachweis bleibt formal beim Orchestrator (siehe oben).
- **CI-Beweis der Gitea-API-Aufloesung im Job-Container:** Der reale POST/PATCH-Weg lief nur lokal gegen `localhost:3002`. Seit diesem Auftrag wurde kein neuer Freigabe-Tag gepusht, daher zeigt keiner der beiden beobachteten CI-Laeufe (356, 357) den Tag-Pfad — beide liefen auf `main` und meldeten "nichts zu tun", wie vom Skript-Design (Tag-Entscheidung vor API-Ausgabe) auch erwartet. Dies ist ein vom Executor selbst benanntes offenes Risiko ("Was bewusst offen bleibt"), keine Luecke dieses Auftrags — die lokale Falsifizierung (b) und der rueckwirkende Release-Lauf decken die Skriptlogik ab.
- **Extra-Commit `c3d8e16`:** Ausserhalb des urspruenglichen Plans, aber nachweislich harmlos fuer alle Gates dieses Plans (19-Dateien-Zaehlung, verbotene Pfade, Testzahlen, CHANGELOG-Struktur) — CI-Lauf fuer diesen Commit ist inzwischen ebenfalls gruen (alle 3 Jobs `success`).
- **`ci.yml`-Schritt hat kein `if:` auf Tag-Refs:** Die Gate-Beschreibung "nur bei Tag-Refs" wird durch interne Skriptlogik (`GITHUB_REF`-Pruefung, Exit 0 mit "nichts zu tun") erreicht, nicht durch eine Job-/Step-Bedingung in YAML. Das entspricht der im Plan dokumentierten Design-Entscheidung (Skript entscheidet wie `publish-images.sh`) und wurde durch zwei reale CI-Laeufe auf `main` bestaetigt — kein Gap, nur zur Transparenz vermerkt.
---
_Verifiziert: 2026-09-16T11:45:00Z_
_Verifizierer: Claude (gsd-verifier)_
## Nachtrag des Orchestrators — Browser-Check durchgefuehrt (2026-09-16, 09:37Z)
Lokales Web-Abbild aus `c3d8e16` gebaut, Playwright MCP, Anmeldung als lokaler Admin. Versionsabzeichen ist ein Link (`<a href="/changelog" aria-label="Was ist neu">`). `/changelog`: H1 "Was ist neu", H2 "Noch nicht freigegeben (Beta)" mit H3 Neu/Geaendert/Behoben, H2 "1.0.0 – 2026-09-15" mit H3 Neu; 20 Listenpunkte; Hinweistext zur Beta sichtbar (Kanal `dev` verhaelt sich wie beta). Kalender-Einstellungen -> Kalenderquelle hinzufuegen: Beschriftungen "Name *", "Typ *", "Adresse (URL) *", "Benutzername", "Passwort", "Farbe", Knoepfe "Speichern / Verbindung testen / Abbrechen" — keine Schluesselnamen mehr (c3d8e16). CI-Lauf fuer c3d8e16 success.
@@ -0,0 +1,15 @@
# API Coverage — Gitea REST API v1, Bereich Releases (quick-260916-dcz)
> Full coverage by default. Opt-outs are explicit, reasoned decisions.
> Gemessen 2026-09-16: Gitea 1.26.2 auf localhost:3002 (intern) bzw. https://git.vicolab.de (aus dem CI-Job-Container erreichbar, localhost:3002 dort NICHT). Token aus der Push-URL und `secrets.REGISTRY_TOKEN` tragen `write:repository` (deckt Releases ab).
| capability | decision | reason |
|---|---|---|
| `GET /repos/{owner}/{repo}/releases/tags/{tag}` (Release zum Tag lesen) | INTEGRATE | Idempotenz-Pruefung vor dem Anlegen |
| `POST /repos/{owner}/{repo}/releases` (Release anlegen) | INTEGRATE | Kernfall beim Tag-Push |
| `PATCH /repos/{owner}/{repo}/releases/{id}` (Release aktualisieren) | INTEGRATE | Wiederholter Lauf zum selben Tag haelt Name/Text mit CHANGELOG.md synchron |
| `GET /repos/{owner}/{repo}/releases` (alle Releases listen) | OPT-OUT | nicht noetig — die Abfrage je Tag genuegt |
| `GET /repos/{owner}/{repo}/releases/latest` | OPT-OUT | nicht noetig — die Oberflaeche zeigt den Changelog aus dem Bundle, nicht aus Gitea |
| `DELETE /repos/{owner}/{repo}/releases/{id}` | OPT-OUT | ausdruecklich ausserhalb des Auftrags — Releases werden nie automatisch geloescht |
| Release-Anhaenge (`.../releases/{id}/assets`) | OPT-OUT | nicht noetig — Auslieferung laeuft ueber die Container-Registry, nicht ueber Anhaenge |
| Draft/Prerelease-Markierungen | OPT-OUT | nicht noetig — jeder Tag `v*` ist eine Freigabe; `draft:false`, `prerelease:false` fest |
@@ -0,0 +1,3 @@
# Deferred Items (quick-260916-dcz)
- Biome-Konfiguration vorbestehend fehlerhaft: `pnpm exec biome check` bricht mit Konfigurationsfehler ab (braucht `biome migrate`). Nicht durch diesen Auftrag verursacht; Lint im CI ist ein Leerlauf (WINDOWS #35).
@@ -0,0 +1,277 @@
---
phase: quick-260916-dyv
plan: 01
type: execute
wave: 1
depends_on: []
autonomous: true
requirements: [QUICK-260916-DYV]
files_modified:
- apps/web/src/components/dashboard/widget-registry.tsx
- apps/web/src/components/dashboard/widget-registry.test.tsx
- apps/web/src/components/dashboard/dashboard-grid.tsx
- apps/web/src/components/dashboard/dashboard-grid.test.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
- apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
- apps/web/src/components/dashboard/edit-mode-toggle.tsx
- apps/web/src/app/(portal)/page.tsx
- apps/web/src/app/(portal)/page.test.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- docs/anleitung-anwender.md
estimate:
tokens: 90000
raw_tokens: 90000
tasks: 3
confidence: low
must_haves:
truths:
- "Jeder Widget-Typ laesst sich auf seine kleinste noch bedienbare Kachel verkleinern — nicht kleiner, nicht groesser. `WIDGET_CONSTRAINTS` traegt genau diese Tabelle (minW/minH/defaultW/defaultH): clock 2/2/4/4, search 6/2/12/4, calendar 3/3/8/12, note 4/4/6/8, calculator 3/9/6/10, favorites 3/3/6/10, link 3/2/4/4, stopwatch 4/3/6/6; die Vorgaben (default) sind unveraendert, die Minima sind inhaltsgetrieben aus dem Innenaufbau gerechnet (Tabelle in `<planning_measurements>`), im Test `widget-registry.test.tsx` mit `toEqual` festgenagelt. Der bisherige Test „jede Groesse ist exakt das Doppelte“ ist ersetzt (3 und 9 sind ungerade)."
- "Die Minima wirken auch fuer BESTEHENDE Widgets: react-grid-layout 2.2.3 nimmt fuer ein Widget mit gespeichertem Eintrag den gespeicherten Eintrag WOERTLICH inklusive `minW/minH` und ignoriert `data-grid` (gemessen `chunk-WGL5FSZH.mjs:559-562` `synchronizeLayoutWithChildren`: `existingItem` -> `cloneLayoutItem(existingItem)`). Gespeicherte Anordnungen tragen `minW/minH` (RGL `cloneLayoutItem` beim `onLayoutChange`, von 260916-bwo verdoppelt persistiert). Deshalb ueberschreibt `dashboard-grid.tsx` vor der Uebergabe an `Responsive` in JEDEM Breakpoint `minW/minH` jedes Eintrags aus `WIDGET_CONSTRAINTS` (`useMemo` ueber `layouts` + `widgets`); Test: gespeicherter Uhr-Eintrag mit `minW: 8, minH: 8` kommt als `minW: 2, minH: 2` bei `Responsive` an."
- "Der obere Rand ist halbiert: der Bearbeiten-Umschalter sitzt nicht mehr oben rechts im Dashboard-Container, sondern in einer festen Aktionsleiste unten rechts (`fixed bottom-6 right-6 z-20 flex items-center gap-2`), im Ansichtsmodus nur der Stift (mit Karten-Hintergrund, Rahmen und Schatten, damit er ueber Widgets sichtbar bleibt), im Bearbeitungsmodus „Widget hinzufuegen“ links neben dem Haekchen. Das Grid steht direkt im Container `p-2`, ohne Abstands-Wrapper. Ergebnis: Kopfzeilen-Unterrand bis erstes Widget 12 (main p-3) + 8 (p-2) + 8 (containerPadding) = 28 px statt 60 px (Bounding-Box im Browser: erstes Widget top = Header-Unterrand + 28). Test `page.test.tsx` nagelt die Leiste, die Knopf-Reihenfolge und das Fehlen des alten Wrappers fest."
- "Ziehen ist zuverlaessig: im Bearbeitungsmodus ist die GANZE Kachel der Griff (`widget-drag-handle` an der Karte, `cursor-grab`), eine 20 px hohe Kopfleiste mit Griff-Symbol liegt als Overlay (`absolute inset-x-0 top-0 z-10 h-5`) ueber dem oberen Kachelrand als optischer Hinweis (Tooltip `widgets.dragHint`), der Loesch-Knopf sitzt in dieser Kopfleiste rechts und traegt `data-no-drag`. `dragConfig.cancel` = `input, textarea, select, button, a, [contenteditable], [data-no-drag], .widgetNoDrag` — react-draggable 4.7.0 prueft `cancel` NACH `handle` und vom Ziel aufwaerts bis zum RGL-Element (gemessen `Draggable.js:417` + `matchesSelectorAndParentsTo`), also verhindert ein Eingabefeld INNERHALB des Griffs den Drag-Start; RGL haengt `.react-resizable-handle` selbst voran (`chunk-WGL5FSZH.mjs:526`), der Groessen-Griff funktioniert weiter. `threshold: 3` (RGL-Standard, Klick vs. Ziehen). Die bislang tote Klasse `widgetNoDrag` (Favoriten/Link, 12 Stellen, nirgends verdrahtet) wird durch den Selektor wirksam."
- "Ablegen auf belegter Stelle ueberlappt nie und springt nicht wild: `compactor` = `{ ...noCompactor, preventCollision: true }` (freie Platzierung bleibt — `noCompactor` kam mit Commit c8f3361 ‚prevent auto-compaction on drag' bewusst; Kompaktierung `vertical` wuerde die freie Platzierung aufheben). Gemessen in `chunk-76RTO6EO.mjs:279-328`: OHNE `preventCollision` springt das gezogene Widget auf die Zeile des getroffenen Widgets und das getroffene wird um seine EIGENE Hoehe nach unten geschoben, ohne Kaskade und ohne Aufloesung — Ueberlappungen bleiben, weil `noCompactor.compact` die Identitaet ist; beim Vergroessern in einen Nachbarn (`se`-Griff, `shouldMoveItem=false`, `chunk-WGL5FSZH.mjs:872-885`) entsteht heute stumm eine Ueberlappung. MIT `preventCollision` bleibt das gezogene Widget an seinem Ausgangsort (`l.x = oldX; l.y = oldY`), der Platzhalter wandert nicht in belegten Raum, und Vergroessern stoppt am Nachbarn. Im Test ueber den echten `noCompactor` (`importOriginal`) festgenagelt: `type: null`, `allowOverlap: false`, `preventCollision: true`."
- "Die Stoppuhr kann ueberhaupt kleiner werden: ihre Bedienleiste (Start/Stop/Runde/Reset) ist kompakt (`px-2 py-1 text-xs`, Zeile `gap-1 py-1`, 32 px hoch statt 48). Gerechnet: heute bei Mindestbreite 4 Spalten (191 px, Rumpf 179 px) ueberlaeuft die laufende Stoppuhr (Stop + Runde + Reset mit `px-4 text-sm` ca. 222 px) — der Reset-Knopf ist abgeschnitten; kompakt ca. 151 px passt. Ohne diese Aenderung waere das inhaltsgetriebene Minimum der Stoppuhr 6x4 und damit BREITER als heute — das Gegenteil des Auftrags. Kein anderes Widget wird innen umgebaut (Rechner: hoeheres Minimum 3x9 statt Umbau, wie im Auftrag vorgesehen)."
- "Baseline gehalten und erweitert: Web von `46 / 286` auf `Test Files 47 passed (47)` / `Tests 293 passed (293)` (dashboard-grid +4, page.test.tsx NEU +3, widget-registry 11 -> 11 mit ersetztem Tabellen-Test), API unveraendert `67 / 1078`, `tsc --noEmit` dreimal 0, `pnpm install --frozen-lockfile` 0, `git diff --stat df16f46 -- . ':!.planning'` nennt genau `12 files changed`; Schema, `.env*`, Compose, Lockfile, `package.json`, `dashboard.service.ts`, `dto/`, `globals.css`, `umlaut-dictionary.ts` unangetastet; drei Commits mit Scope `quick-260916-dyv`, `git push` (schiebt auch den lokalen Vorsprung df16f46 mit), CI-Lauf beobachtet."
artifacts:
- "apps/web/src/components/dashboard/widget-registry.tsx — neue Mindestwerte (Tabelle), Vorgaben unveraendert, Kommentar (deutsch, ASCII) ‚inhaltsgetrieben, Rechnung im Plan 260916-dyv'"
- "apps/web/src/components/dashboard/widget-registry.test.tsx — Tabellen-Test ersetzt (exakte 32 Werte per `toEqual`, zusaetzlich min <= default je Typ)"
- "apps/web/src/components/dashboard/dashboard-grid.tsx — exportierte Konstanten `WIDGET_DRAG_HANDLE_SELECTOR`, `WIDGET_DRAG_CANCEL_SELECTOR`, `FREE_PLACEMENT_COMPACTOR`; `effectiveLayouts` (minW/minH aus den Konstanten); `dragConfig` mit `handle`, `cancel`, `threshold: 3`; Kopfkommentare mit den gemessenen RGL-Fundstellen"
- "apps/web/src/components/dashboard/dashboard-grid.test.tsx — Mock per `importOriginal` (echter `noCompactor`), Test 5 angepasst (clock minW/minH 2), +4 Tests (dragConfig-Pin, Compactor-Pin, cancel/handle-Semantik im DOM, minW/minH-Ueberschreibung)"
- "apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx — kompakte Bedienleiste"
- "apps/web/src/components/dashboard/widgets/widget-wrapper.tsx — Karte als Griff im Bearbeitungsmodus, Overlay-Kopfleiste mit Griff-Symbol und Tooltip, Loesch-Knopf in der Kopfleiste mit `data-no-drag`; Rumpf `@container-size h-full` UNVERAENDERT (Hoehenkette bleibt definit, keine Aenderung der Container-Query-Aufloesung)"
- "apps/web/src/components/dashboard/edit-mode-toggle.tsx — schwebender Stil: `shadow-lg`, inaktiv `border border-border bg-card`"
- "apps/web/src/app/(portal)/page.tsx — feste Aktionsleiste unten rechts (Stift/Haekchen + „Widget hinzufuegen“), Grid direkt im Container, alter Block oben rechts und Abstands-Wrapper entfernt"
- "apps/web/src/app/(portal)/page.test.tsx — NEU, 3 Tests (Ansichtsmodus, Bearbeitungsmodus, Umschalten)"
- "apps/web/src/messages/de.json + en.json — `widgets.dragHint` (de: „Ziehen Sie die Kachel, um sie zu verschieben“, en: „Drag the tile to move it“), direkt nach `deleteTooltip`; Umlaut-Waechter gruen ohne Woerterbuch-Aenderung (Wortlaut zur Planungszeit gegen Tokenizer/Muster geprueft: 0 Treffer)"
- "docs/anleitung-anwender.md — Abschnitt Dashboard: Schalter unten rechts, ganze Kachel ziehbar (Eingabefelder/Knoepfe ausgenommen), Kopfleiste als Griff-Hinweis, Ablegen nur auf freiem Platz, Mindestgroesse = gerade noch bedienbar"
key_links:
- "Gespeicherte `minW/minH` schlagen `data-grid`: ohne die Ueberschreibung in `dashboard-grid.tsx` bleiben alle vorhandenen Widgets auf den verdoppelten Minima aus der Datenbank, egal was in `WIDGET_CONSTRAINTS` steht — die Konstante allein aendert fuer den User NICHTS Sichtbares. Deshalb ist Test 9 (Ueberschreibung) der entscheidende Test dieser Aufgabe, nicht der Tabellen-Test."
- "`handle` an der Karte + `cancel` fuer Interaktives: `matchesSelectorAndParentsTo` laeuft vom Ereignisziel aufwaerts bis zum RGL-Element; die Karte ist Kind des RGL-Elements, also matcht jedes Ziel in der Karte den Griff, und `cancel` gewinnt fuer Ziele in Eingabefeldern/Knoepfen/Links. Die Karte selbst darf NICHT auf `cancel` passen (Test 8 prueft `card.closest(cancel) === null`), sonst zieht nichts mehr."
- "`preventCollision` lebt am Compactor-Objekt (`compactor.preventCollision ?? false`, `chunk-WGL5FSZH.mjs:666`), nicht als eigene Prop — deshalb ein eigenes Objekt `{ ...noCompactor, preventCollision: true }` statt `noCompactor`. Der Test importiert den echten `noCompactor` (`importOriginal`), damit `compact` die echte Identitaet ist und nicht ein Mock-Stub."
- "Die Overlay-Kopfleiste ist bewusst `absolute` und NICHT im Fluss: der Rumpf bleibt `h-full`, die Hoehenkette Karte -> Rumpf bleibt definit, `cqh` loest weiter auf (Grund fuer `h-full` in 260916-bwo). Eine Kopfleiste im Fluss haette den Rumpf im Bearbeitungsmodus um 20 px gekuerzt und den Rechner bei Mindestgroesse beschnitten."
- "Feste Aktionsleiste: `fixed` bezieht sich auf das Viewport (kein transformierter Vorfahr — der bisherige „Widget hinzufuegen“-Knopf benutzt `fixed bottom-6 right-6` bereits und funktioniert); `z-20` liegt ueber RGL-Elementen (gezogenes Element z-index 3)."
- "`umlaut-guard.spec.ts` prueft de/en-Schluesselparitaet rekursiv ueber ALLE Namespaces — `dragHint` muss in beiden Dateien stehen."
---
<objective>
Drei Nachbesserungen am Dashboard nach dem Beta-Test des Users: (1) jedes Widget laesst sich wieder auf seine kleinste bedienbare Groesse verkleinern — die in 260916-bwo verdoppelten Minima werden durch inhaltsgetriebene Minima ersetzt UND die in der Datenbank gespeicherten `minW/minH` werden beim Rendern aus den Konstanten ueberschrieben (sonst bleibt alles wie gehabt); (2) der obere Rand wird von 60 px auf 28 px halbiert, indem der Bearbeiten-Umschalter in eine feste Leiste unten rechts wandert; (3) Drag & Drop wird zuverlaessig: ganze Kachel als Griff, `cancel` fuer Eingabefelder/Knoepfe/Links, kein Ueberlappen beim Ablegen (`preventCollision`). Dazu die kompakte Stoppuhr-Bedienleiste (ohne sie kann die Stoppuhr nicht kleiner werden), Handbuch, Tests, Push, CI.
Purpose: Der User sieht auf alpha, dass die Kacheln „nicht mehr klein genug werden“ (verdoppelte Minima plus persistierte Minima), der Rand oben zu gross ist und Ziehen „nur semi“ funktioniert (6-px-Griff, Eingabefelder starten Drags, Kollisionen erzeugen Spruenge und Ueberlappungen). Alles ist reine Frontend-Arbeit ohne Schema.
Output: 12 Dateien (11 Web, 1 Handbuch), drei Commits mit Scope `quick-260916-dyv`, gepusht, CI-Lauf beobachtet. Browser-Nachweis durch den Orchestrator (Playwright MCP, lokale Container nach `docker compose up -d --build web`), siehe `<verification>`.
</objective>
<execution_context>
@~/.claude/gsd-core/workflows/execute-plan.md
@~/.claude/gsd-core/templates/summary.md
</execution_context>
<context>
@.planning/STATE.md
@.planning/quick/260916-bwo-dashboard-feineres-raster-spalten-und-ze/260916-bwo-SUMMARY.md
@apps/web/src/components/dashboard/dashboard-grid.tsx
@apps/web/src/components/dashboard/dashboard-grid.test.tsx
@apps/web/src/components/dashboard/widget-registry.tsx
@apps/web/src/components/dashboard/widget-registry.test.tsx
@apps/web/src/components/dashboard/edit-mode-toggle.tsx
@apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
@apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
@apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx
@apps/web/src/app/(portal)/page.tsx
@apps/web/src/app/(portal)/admin/groups/groups-page.test.tsx
@apps/web/src/messages/umlaut-guard.spec.ts
@apps/web/node_modules/react-grid-layout/dist/types-jd8MiKM1.d.ts
@docs/anleitung-anwender.md
<planning_measurements>
Zur Planungszeit (2026-09-16, HEAD `df16f46`, Arbeitsbaum sauber, `main` ist 1 Commit VOR `origin/main` — df16f46 ist ein reiner Akten-Commit, der mit dem Push dieser Aufgabe mitgeht) gemessen:
- **Baseline frisch:** Web `Test Files 46 passed (46)` / `Tests 286 passed (286)`; API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`; `tsc --noEmit` in `packages/shared`, `apps/api`, `apps/web` je Exit 0. Je Datei: `widget-registry.test.tsx` 11 Tests (1 + `it.each` 8 + 1 + 1), `dashboard-grid.test.tsx` 5, `stopwatch-widget.test.tsx` 8 (keine Klassen-Pins an Knoepfen, nur `cqw/cqh` an der Anzeige), `src/messages` 6. Kein Test fuer `page.tsx` des Dashboards und keiner fuer `edit-mode-toggle.tsx` (grep leer). Vitest findet Tests unter `src/app/(portal)/...` (zehn Beispiele vorhanden, z. B. `admin/groups/groups-page.test.tsx` — Muster fuer next-intl-Mock mit Namensraum). Container: `tessera-ctl-web-1` (3000), `tessera-ctl-api-1` (3001, healthy), `tessera-ctl-db-1` (kein Host-Port), Gitea `1.26.2` auf 3002, `gitea-runner` laeuft; Web-Abbild 47 Minuten alt aus dem Stand 1aefaa3 — vor dem Browser-Nachweis `docker compose up -d --build web` (Erinnerung: `up` allein baut nicht neu). Lokale DB: `DashboardLayout` 0 Zeilen, `WidgetInstance` 0 Zeilen.
- **Raster-Arithmetik (Ist, unveraendert):** rowHeight 20, margin 8, containerPadding = margin. Kachelhoehe(h) = 28h - 8 px. Spaltenbreite = (Containerbreite - 8*(cols-1) - 16)/cols: lg bei 1200 px = 41,67 px (Kachelbreite(w) = 49,67w - 8), beim Orchestrator-Viewport von 260916-bwo (4 Spalten = 264 px -> Spalte 60 px, Container ca. 1640 px) = 60 px; md (996 px, 20 Spalten) 41,4 px; sm (768, 12) 55 px; xs (480, 8) 51 px. Eine Spalte ist also in allen Breakpoints ausser xxs 41-60 px breit, eine Zeile 20 px + 8 px Abstand.
- **Der zweite, im Auftrag nicht genannte Grund fuer „nicht klein genug“:** `synchronizeLayoutWithChildren` (`chunk-WGL5FSZH.mjs:553-582`) nimmt fuer jedes Kind mit Eintrag im `layout` den Eintrag per `cloneLayoutItem` WOERTLICH — `data-grid` wird nur fuer Kinder OHNE Eintrag gelesen. `dashboard-grid.tsx` ueberschreibt `minW/minH` heute nur im `data-grid` (Zeile 100-109), das fuer bestehende Widgets wirkungslos ist. Die gespeicherten Eintraege tragen `minW/minH` (`cloneLayoutItem` in `chunk-76RTO6EO.mjs:204-223` -> `onLayoutChange` -> Store -> `PUT /dashboard/layout`; 260916-bwo hat sie beim Migrieren verdoppelt). Folge: eine Aenderung der Konstanten allein aendert fuer bestehende Widgets nichts. `Responsive` vergleicht `layouts` per `deepEqual` (`chunk-WGL5FSZH.mjs:1354`), ein inhaltsgleiches neues Objekt loest nichts aus; ein geaendertes wird abgeleitet, ohne `onLayoutChange` zu rufen; `GridLayout` meldet beim Mount ohnehin `onLayoutChange`, wenn sein synchronisiertes Layout vom Prop abweicht (Zeile 697-702) — das ist heute schon so (Store `isDirty`, gespeichert wird erst beim Verlassen des Bearbeitungsmodus, `dashboard-store.ts:53-54`), keine Schleife: nach der ersten Meldung tragen die Store-Eintraege dieselben `minW/minH` wie die Ueberschreibung.
- **Kollision mit `noCompactor` (gemessen `chunk-KDANGDDL.mjs:450-454`, `chunk-76RTO6EO.mjs:279-328`, `chunk-WGL5FSZH.mjs:664-666, 776-835, 855-885`):** `noCompactor = { type: null, allowOverlap: false, compact: cloneLayout }`, `preventCollision` fehlt -> `false`. `moveElement` bei Kollision waehrend des Ziehens: `moveElementAwayFromCollision(layout, l, collision, isUserAction=true, null)` -> `fakeItem` an der Position des getroffenen Widgets, `firstCollision` ist immer gesetzt (das gezogene oder das getroffene Widget selbst), `collisionNorth` ist wahr, Zweig `collisionNorth && compactType === null`: `collidesWith.y = itemToMove.y` (das GEZOGENE springt auf die Zeile des getroffenen) und `itemToMove.y += itemToMove.h` (das getroffene rutscht um seine EIGENE Hoehe nach unten), `return [...layout]` — keine Kaskade, keine Nachpruefung; ist das gezogene hoeher als das getroffene, ueberlappen beide weiter; das verschobene kann auf ein drittes fallen. `compact` ist Identitaet, also bleibt jede Ueberlappung. Beim Vergroessern mit dem `se`-Griff ist `shouldMoveItem` false, `moveElement` wird gar nicht gerufen — die Ueberlappung entsteht stumm. MIT `preventCollision: true`: Ziehen `if (hasCollisions && preventCollision) { l.x = oldX; l.y = oldY; l.moved = false; return layout; }` (Platzhalter bleibt am Ursprung, beim Loslassen ueber belegtem Raum bleibt das Widget, wo es war); Vergroessern: `getAllCollisions` am neuen Mass -> Mass bleibt. `Compactor.preventCollision` ist im Typ (`types-jd8MiKM1.d.ts:211`, `readonly preventCollision?: boolean`), `Compactor` wird aus `react-grid-layout` exportiert (`index.d.ts:3`). `noCompactor` kam mit Commit `c8f3361` (2026-07-02, „add noCompactor to prevent auto-compaction on drag“) bewusst — freie Platzierung ist gewollt und bleibt; `verticalCompactor` wuerde Luecken automatisch nach oben schliessen.
- **Griff/cancel (gemessen):** `DragConfig` (`types-jd8MiKM1.d.ts:357-372`): `enabled`, `bounded`, `handle?`, `cancel?`, `threshold` (Standard 3, `chunk-KDANGDDL.mjs:333-337`); `GridLayout` mischt `{ ...defaultDragConfig, ...dragConfigProp }` (`chunk-WGL5FSZH.mjs:633-636`), `dragConfig` ist `Partial<DragConfig>`. `GridItem` reicht `handle` und `cancel: '.react-resizable-handle' + (cancel ? ',' + cancel : '')` an `DraggableCore` aus `react-draggable` 4.7.0 (`chunk-WGL5FSZH.mjs:520-530`). Dort (`build/cjs/Draggable.js:417`): kein Drag, wenn `handle` gesetzt und das Ziel (aufwaerts bis zum Knoten) nicht passt, ODER wenn `cancel` gesetzt und das Ziel (aufwaerts bis zum Knoten) passt — `cancel` gewinnt also auch INNERHALB des Griffs. `threshold` wird in `GridItem` per `Math.hypot` ausgewertet (`chunk-WGL5FSZH.mjs:214-221`). Die Klasse `widgetNoDrag` steht 5x in `favorites-widget.tsx` und 7x in `link-widget.tsx` (Umschaltzeilen, Formulare, Links) und ist NIRGENDS verdrahtet (grep ueber `src`: kein `cancel`, kein `draggableCancel`) — toter Marker aus Phase 8, der durch den Selektor lebendig wird. Kein Test greift `widgetNoDrag`.
- **Innenaufbau bei Mindestgroesse (gerechnet aus den Klassen; der Browser-Nachweis prueft nach):**
| Typ | bwo-Minimum (heute) | neues Minimum | px bei Spalte 41,67 / 60 | Rechnung |
|---|---|---|---|---|
| clock | 4/4 | 2/2 | 91x48 / 128x48 | Zeit `min(20cqw, 50cqh)` = ca. 17-20 px, 8 Zeichen tabular ca. 80 px passen in 83 px; Datum (falls an) 10 px darunter |
| search | 6/4 | 6/2 | 290x48 / 400x48 | Breite: Auswahl 120 + Eingabe >= 80 + Knopf 40 + Abstaende 28 = 268 <= 278 Rumpf (6 Spalten; 3 Spalten = 141 px waeren unbrauchbar, die alte 12-Spalten-Zahl 3 entsprach 281 px); Hoehe: Eingabe `h-8` 32 px in 48 px |
| calendar | 6/6 | 3/3 | 141x76 / 196x76 | eine Terminzeile 48 px + `p-1.5` = 60 <= 76; Leertext (3 Zeilen text-sm) 60 px passt knapp |
| note | 4/6 | 4/4 | 191x104 / 264x104 | Kopfzeile ca. 36 px + Vorschau >= 2 Zeilen (40) = 76 <= 104; im Editiermodus Werkzeugleiste ca. 29 px + 2 Zeilen |
| calculator | 4/8 | 3/9 | 141x244 / 196x244 | Breite: 4 Tasten x >= 30 px + 3x4 + `p-1` 8 = 140 <= 141; Hoehe: Anzeige `min-h-[2.5rem]` 40 + 4 + Speicherzeile `h-7` 28 + 4 + Tastenfeld 5x`min-h-7` 28 + 4x4 = 156, plus `p-1` 8 = 240 <= 244. Bei h=8 (216 px) fehlen 24 px: die unterste Tastenreihe (+/-, 0, Komma, =) ist HEUTE bei Mindestgroesse abgeschnitten (Rumpf `flex-1` mit `min-height: auto` schrumpft nicht unter 156). Kein Umbau des Rechners (Auftrag: hoeheres Minimum begruendet waehlen) |
| favorites | 4/6 | 3/3 | 141x76 / 196x76 | Umschaltzeile Liste/Kacheln (nur Bearbeitungsmodus) ca. 110 px <= 133; drei Listenzeilen (20 px + 4) in 68 px; Kachelraster `grid-cols-3` ca. 40-px-Kacheln |
| link | 4/4 | 3/2 | 141x48 / 196x48 | Listenzeile Symbol 20 + Titel in 40 px Rumpf; Umschaltzeile Liste/Kachel <= 133; Kachelansicht (Symbol 32 + Text 16 + Abstand) braucht 3 Zeilen — der User zieht dafuer eine Zeile hoeher (im SUMMARY nennen) |
| stopwatch | 4/4 | 4/3 | 191x76 / 264x76 | NUR mit kompakter Bedienleiste: laufend Stop+Runde+Reset `px-2 text-xs` ca. 151 px <= 179 (heute `px-4 text-sm` ca. 222 px > 179: Reset abgeschnitten); Zeile 32 px statt 48; Anzeige `min(16cqw, 35cqh)` = 26,6 px bei 76 px Kachel im Rest von 32 px; Rundenliste (`max-h-32`) darunter braucht mehr Hoehe — Nebenfunktion |
Die Vorgaben (defaultW/defaultH) bleiben: clock 4/4, search 12/4, calendar 8/12, note 6/8, calculator 6/10, favorites 6/10, link 4/4, stopwatch 6/6 — neue Widgets erscheinen wie gewohnt. Alle Minima liegen <= Vorgabe (der bestehende `it.each`-Test prueft das).
- **Umschalter-Geometrie (Ist):** `edit-mode-toggle.tsx` Knopf `rounded-md p-2` + 20-px-Symbol = 36x36 px, inaktiv OHNE Hintergrund (`text-muted-foreground hover:bg-muted`), aktiv `bg-primary`. `page.tsx` Zeile 69-91: Container `relative p-2`, Umschalter in einem absolut positionierten Block oben rechts (`z-10`), Grid in einem Abstands-Wrapper (Kommentar erklaert die Kollision mit dem 36-px-Knopf), „Widget hinzufuegen“ `fixed bottom-6 right-6 z-20` nur im Bearbeitungsmodus, Knopf `px-4 py-2 text-sm` = 36 px hoch (gleiche Hoehe wie der Umschalter). Oben heute: 12 + 8 + 32 + 8 = 60 px (gemessen top=120 bei Header 60 in 260916-bwo). Neu: 12 + 8 + 8 = 28 px.
- **Widget-Karte (Ist):** `widget-wrapper.tsx` Karte `relative h-full w-full overflow-hidden rounded-lg border border-primary/20 bg-card shadow-sm`, im Bearbeitungsmodus ein 6 px hoher Griffstreifen IM FLUSS (der Rumpf `h-full` laeuft heute schon 6 px ueber, `overflow-hidden` schneidet) und der Loesch-Knopf `absolute right-1 top-1 z-10 h-6 w-6` ueber dem Streifen; Rumpf `@container-size h-full` plus einer wirkungslosen `pt-0`-Bedingung. RGL-CSS: `.react-grid-item > .react-resizable-handle` liegt als GESCHWISTER der Karte unten rechts (20x20 px), nicht in der Karte — bleibt sichtbar. `bg-muted/50`, `hover:bg-muted/50`, `cursor-grab`, `active:cursor-grabbing`, `shadow-lg` sind im Projekt bereits kompilierte Klassen; `inset-x-0`, `h-5`, `w-5`, `bg-muted/70`, `border-primary/40` sind Standard-Utilities (kein `calc`, kein Arbitrary Value noetig).
- **Store:** `addWidget` legt neue Widgets bei `x: 0, y: maxY` (unter allen vorhandenen) an — keine Ueberlappung beim Hinzufuegen, `preventCollision` stoert nicht. `saveLayout` sendet `withGridVersion(layouts)`; die ueberschriebenen `minW/minH` landen beim naechsten Speichern in der DB (gewollt: RGL liefert sie in `onLayoutChange`).
- **i18n:** `widgets` in de.json/en.json Zeile 176-185, `deleteTooltip` Zeile 181; `umlaut-guard.spec.ts` Tokenizer `/[A-Za-zÄÖÜäöüß]+/g`, `SUSPECT_RE = /(ae|oe|ue|ss)/i`, Allowlist case-sensitiv, de/en-Paritaet rekursiv. Wortlaut „Ziehen Sie die Kachel, um sie zu verschieben“ mit demselben Tokenizer/Muster geprueft: 0 verdaechtige Token -> `umlaut-dictionary.ts` bleibt unangetastet. `dashboard-grid.test.tsx` mockt `useTranslations` mit einer Map (fehlende Schluessel -> Schluesselname).
- **Detektoren/Konfiguration:** `api-coverage` -> `{"detected":false}`; `assumption-delta scan quick-260916-dyv` -> `{"skipped":true,"reason":"phase_unresolved"}` (Quick-Task ohne ROADMAP-Abschnitt; inhaltlich `no-change`); `schema-gate` feuert NICHT (kein `schema.prisma`, keine Migration). `tdd_mode=false` (Tasks 1 und 2 tragen trotzdem `tdd="true"`), `security_enforcement=true`, ASVS 1, Blocking-Schwelle `high`, `human_verify_mode=end-of-phase`, `branching_strategy: none`. Keine neuen Pakete (`estimate-calibration`: Faktor 1, 0 Stichproben, `confidence: low`).
</planning_measurements>
</context>
<!-- planner-discipline-allow: mt-8 -->
<!-- planner-discipline-allow: top-2 -->
<!-- planner-discipline-allow: h-[6px] -->
<!-- planner-discipline-allow: px-4 py-1.5 text-sm -->
<tasks>
<task type="auto" tdd="true">
<name>Task 1: Mindestgroessen inhaltsgetrieben (Tabelle), gespeicherte Minima beim Rendern ueberschreiben, Stoppuhr-Bedienleiste kompakt</name>
<files>apps/web/src/components/dashboard/widget-registry.tsx, apps/web/src/components/dashboard/widget-registry.test.tsx, apps/web/src/components/dashboard/dashboard-grid.tsx, apps/web/src/components/dashboard/dashboard-grid.test.tsx, apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx</files>
<behavior>
- widget-registry.test.tsx, ersetzt den bwo-Test „jede Groesse ist exakt das Doppelte“ durch „Test A (quick-260916-dyv): Minima = kleinste bedienbare Kachel je Typ, Vorgaben unveraendert“: `expect(WIDGET_CONSTRAINTS).toEqual({ clock: { minW: 2, minH: 2, defaultW: 4, defaultH: 4 }, search: { minW: 6, minH: 2, defaultW: 12, defaultH: 4 }, calendar: { minW: 3, minH: 3, defaultW: 8, defaultH: 12 }, note: { minW: 4, minH: 4, defaultW: 6, defaultH: 8 }, calculator: { minW: 3, minH: 9, defaultW: 6, defaultH: 10 }, favorites: { minW: 3, minH: 3, defaultW: 6, defaultH: 10 }, link: { minW: 3, minH: 2, defaultW: 4, defaultH: 4 }, stopwatch: { minW: 4, minH: 3, defaultW: 6, defaultH: 6 } })`; dazu die Zaehlung „32 Felder“ wie bisher. Die Pruefung „jeder Wert ist gerade“ entfaellt (3 und 9 sind ungerade); `minW <= defaultW` und `minH <= defaultH` je Typ prueft weiterhin der bestehende `it.each`.
- dashboard-grid.test.tsx Test 5 angepasst: Uhr ohne gespeicherten Eintrag -> `data-grid` `{ x: 0, y: 0, w: 4, h: 4, minW: 2, minH: 2 }`.
- dashboard-grid.test.tsx Test 9 (quick-260916-dyv): gespeicherter Eintrag `{ i: 'inst-1', x: 2, y: 4, w: 6, h: 6, minW: 8, minH: 8 }` in `lg` und `{ i: 'inst-1', x: 0, y: 0, w: 4, h: 4, minW: 4, minH: 4 }` in `md` fuer ein Widget vom Typ `clock` -> `captured.props.layouts.lg[0]` ist `{ i: 'inst-1', x: 2, y: 4, w: 6, h: 6, minW: 2, minH: 2 }` und `captured.props.layouts.md[0].minW === 2` (JEDER Breakpoint wird ueberschrieben, x/y/w/h bleiben); ein Eintrag fuer einen unbekannten Typ (`widgetType: 'unknown'`) bleibt unveraendert; die uebergebenen `layouts` enthalten KEINEN Schluessel `__gridVersion` (der Store liefert markerfrei — nur Durchreichung pruefen: `Object.keys(captured.props.layouts)` gleich den Eingabe-Schluesseln).
- Stoppuhr: bestehende 8 Tests bleiben gruen (nur Klassen geaendert).
</behavior>
<action>
RED zuerst: die vier Testaenderungen oben schreiben (Test A ersetzt den bwo-Tabellen-Test woertlich, Test 5 anpassen, Test 9 anhaengen), `pnpm -C apps/web exec vitest run src/components/dashboard/widget-registry.test.tsx src/components/dashboard/dashboard-grid.test.tsx` -> Test A, Test 5 und Test 9 rot, Zahlen der roten Tests notieren (Erwartung `3 failed`). Dann GREEN:
1. `widget-registry.tsx` (`WIDGET_CONSTRAINTS`, Zeile 35-46): Minima auf die Tabelle aus `<planning_measurements>` setzen (clock 2/2, search 6/2, calendar 3/3, note 4/4, calculator 3/9, favorites 3/3, link 3/2, stopwatch 4/3), `defaultW/defaultH` UNVERAENDERT lassen. Den bwo-Kommentar ersetzen durch einen deutschen ASCII-Kommentar: „quick-260916-dyv: minW/minH = kleinste noch bedienbare Kachel je Typ im 24-Spalten/20-px-Raster, aus dem Innenaufbau gerechnet (Suche: Auswahl 120 + Eingabe + Knopf; Rechner: Anzeige 40 + Speicherzeile 28 + 5 Tastenreihen 28 = 240 px -> 9 Zeilen; Stoppuhr: kompakte Bedienleiste). defaultW/defaultH = altes 12-Spalten-Mass x2, unveraendert. Gespeicherte minW/minH werden in dashboard-grid.tsx aus dieser Tabelle ueberschrieben.“ Keine weitere Aenderung in dieser Datei (die `WIDGET_REGISTRY`-Eintraege spreaden die Konstanten).
2. `dashboard-grid.tsx`: `useMemo` importieren. Vor dem `return` ein `effectiveLayouts` per `useMemo` ueber `[layouts, widgets]` berechnen: `Map` von Widget-Id auf `widgetType`; fuer jeden Schluessel von `layouts` (nur Array-Werte) jeden Eintrag kopieren und — falls `WIDGET_CONSTRAINTS[typ]` existiert — `minW`/`minH` aus den Konstanten setzen, sonst unveraendert lassen; Rueckgabetyp `Record<string, Array<LayoutItemShape>>` (den bestehenden Prop-Typ um optionale `minW?: number; minH?: number` erweitern). `layouts={effectiveLayouts as ResponsiveLayouts}` an `Responsive` uebergeben und im `data-grid`-Fallback `effectiveLayouts.lg?.find(...)` statt `layouts.lg?.find(...)` verwenden (die explizite `minW/minH`-Zuweisung im `data-grid` bleibt fuer Widgets ohne Eintrag). Kopfkommentar (deutsch, ASCII) mit dem Warum: RGL 2.2.3 `synchronizeLayoutWithChildren` nimmt gespeicherte Eintraege woertlich inklusive minW/minH und liest data-grid nur fuer Kinder ohne Eintrag; gespeicherte Anordnungen tragen die alten (verdoppelten) Minima; die Konstanten sind die einzige Quelle. Den Rest der Datei in diesem Task NICHT anfassen (dragConfig/compactor kommen in Task 2).
3. `stopwatch-widget.tsx` (Zeile 194-234): Bedienleiste kompakt — Zeilen-`div` von `gap-2 py-2` auf `gap-1 py-1`; alle vier Knoepfe (Start, Stop, Runde, Reset) von der bisherigen Groesse (waagerechter Innenabstand Stufe 4, senkrechter 1.5, Schrift `text-sm`) auf `px-2 py-1 text-xs`; Farben, `rounded-md`, `font-medium`, aria-labels und Handler unveraendert. Kommentar (deutsch, ASCII): „quick-260916-dyv: kompakte Bedienleiste, damit die laufende Stoppuhr (Stop + Runde + Reset) in 4 Spalten passt (ca. 151 px statt ca. 222 px) und die Kachel auf 4x3 schrumpfen kann.“ Rundenliste unveraendert.
4. Gruen: `pnpm -C apps/web exec vitest run src/components/dashboard` -> alle gruen; Zeilenzahlen notieren (Erwartung: widget-registry 11, dashboard-grid 6, stopwatch 8). `pnpm -C apps/web exec tsc --noEmit` -> 0.
5. Commit (nur diese 5 Dateien): `fix(quick-260916-dyv): Mindestgroessen inhaltsgetrieben (kleinste bedienbare Kachel je Typ), gespeicherte Minima ueberschrieben, Stoppuhr-Bedienleiste kompakt`.
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && pnpm -C apps/web exec vitest run src/components/dashboard 2>&1 | grep -E "^\s+(Test Files|Tests)" ; grep -c "minW: 3, minH: 9" apps/web/src/components/dashboard/widget-registry.tsx ; grep -c "minW: 2, minH: 2, defaultW: 4, defaultH: 4" apps/web/src/components/dashboard/widget-registry.tsx ; grep -c "defaultW: 12, defaultH: 4" apps/web/src/components/dashboard/widget-registry.tsx ; grep -c "effectiveLayouts" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "px-2 py-1 text-xs" apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx ; grep -c "px-4 py-1.5 text-sm" apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx ; pnpm -C apps/web exec tsc --noEmit >/dev/null 2>&1; echo "TSC_web=$?"</automated>
<fails_when>Die Dashboard-Suite ist nicht `Test Files 10 passed (10)` / `Tests 64 passed (64)` (heute 10 Dateien / 63 Tests, plus Test 9); einer der drei Registry-Greps ist nicht 1; `effectiveLayouts` kommt seltener als 3x vor (Definition, `layouts=`, Fallback); die Stoppuhr hat weniger als 4 Knoepfe mit `px-2 py-1 text-xs` oder noch einen mit der alten Groesse (letzter Grep nicht 0); `TSC_web` ist nicht 0.</fails_when>
</verify>
<done>
Dashboard-Suite `Test Files 10 passed (10)` / `Tests 64 passed (64)`; die drei Registry-Greps liefern 1/1/1; `effectiveLayouts` >= 3; Stoppuhr-Greps 4 und 0; `TSC_web=0`; RED-Lauf mit 3 roten Tests im SUMMARY notiert; Commit mit Scope `quick-260916-dyv` vorhanden.
</done>
</task>
<task type="auto" tdd="true">
<name>Task 2: Bearbeiten-Schalter in feste Leiste unten rechts (Rand 28 px), ganze Kachel als Griff mit Overlay-Kopfleiste, cancel-Selektor, kein Ueberlappen beim Ablegen</name>
<files>apps/web/src/components/dashboard/dashboard-grid.tsx, apps/web/src/components/dashboard/dashboard-grid.test.tsx, apps/web/src/components/dashboard/widgets/widget-wrapper.tsx, apps/web/src/components/dashboard/edit-mode-toggle.tsx, apps/web/src/app/(portal)/page.tsx, apps/web/src/app/(portal)/page.test.tsx, apps/web/src/messages/de.json, apps/web/src/messages/en.json</files>
<behavior>
- dashboard-grid.test.tsx Test 6 (dragConfig-Pin): im Bearbeitungsmodus ist `captured.props.dragConfig` gleich `{ enabled: true, handle: '.widget-drag-handle', cancel: 'input, textarea, select, button, a, [contenteditable], [data-no-drag], .widgetNoDrag', threshold: 3 }` (`toEqual`); im Ansichtsmodus `enabled: false` bei gleichem `handle`/`cancel`/`threshold`; `captured.props.resizeConfig` ist `{ enabled: true }` bzw. `{ enabled: false }`.
- dashboard-grid.test.tsx Test 7 (Compactor-Pin, echter `noCompactor` via `importOriginal`): `captured.props.compactor` erfuellt `toMatchObject({ type: null, allowOverlap: false, preventCollision: true })`, `typeof compactor.compact === 'function'`, und `compactor.compact([{ i: 'a', x: 0, y: 0, w: 2, h: 2 }], 24)` ist per `toEqual` gleich der Eingabe, aber nicht dieselbe Referenz (Identitaet als Kopie — freie Platzierung, keine Kompaktierung).
- dashboard-grid.test.tsx Test 8 (cancel/handle-Semantik im DOM, Bearbeitungsmodus, exportierte Konstanten `WIDGET_DRAG_HANDLE_SELECTOR`/`WIDGET_DRAG_CANCEL_SELECTOR` aus `./dashboard-grid`): die Karte `[data-widget-id="inst-2"]` erfuellt `matches(HANDLE)`; `card.closest(CANCEL)` ist `null`; der Loesch-Knopf (`getByLabelText('Remove widget')`) hat `closest(CANCEL) === button` und das Attribut `data-no-drag`; ein per `document.createElement('input')` in die Karte gehaengtes Eingabefeld hat `closest(CANCEL) === input`; ein angehaengtes `div.widgetNoDrag` ebenso; die Kopfleiste (`getByTitle('Drag the tile to move it')`) liegt in der Karte und hat die Klassen `absolute`, `h-5`; im Ansichtsmodus gibt es weder Kopfleiste noch `.widget-drag-handle`.
- dashboard-grid.test.tsx next-intl-Mock um `dragHint: 'Drag the tile to move it'` erweitert.
- page.test.tsx (NEU, Muster `groups-page.test.tsx`; Mocks: `next-intl` mit Namensraum `widgets` — `editMode: 'Dashboard bearbeiten'`, `saveChanges: 'Änderungen speichern'`, `addWidget: 'Widget hinzufügen'`, `layoutLoadError`; `@/lib/stores/dashboard-store` wie in `dashboard-grid.test.tsx` mit veraenderbarem `mockStore` inkl. `isLoading: false`, `error: null`, `setEditMode: vi.fn()`, `loadDashboard: vi.fn()`; `@/components/dashboard/dashboard-grid` -> `DashboardGrid: (p) => <div data-testid="dashboard-grid" data-edit={String(p.isEditMode)} />`; `@/components/dashboard/widget-catalog-modal` -> `WidgetCatalogModal: () => null`; die acht Widget-Module `@/components/dashboard/widgets/{clock,search,calendar,note,calculator,stopwatch,favorites,link}-widget` -> jeweils die benannte Komponente als `() => null`; `DashboardPage` je Test per `await import('./page')`, `cleanup` in `afterEach`):
- Test 1 (Ansichtsmodus): Knopf mit Name „Dashboard bearbeiten“ vorhanden, sein Elternelement hat die Klassen `fixed`, `bottom-6`, `right-6`, `z-20`; kein Knopf „Widget hinzufügen“; `document.querySelector('.mt-8')` und `document.querySelector('.top-2')` sind `null`; das Elternelement von `getByTestId('dashboard-grid')` hat die Klasse `p-2` (Grid direkt im Container).
- Test 2 (Bearbeitungsmodus, `mockStore.isEditMode = true`): Knopf „Änderungen speichern“ und Knopf „Widget hinzufügen“ haben DASSELBE Elternelement (die feste Leiste), und „Widget hinzufügen“ steht im DOM VOR dem Umschalter (`compareDocumentPosition` & `DOCUMENT_POSITION_FOLLOWING`); `getByTestId('dashboard-grid')` hat `data-edit="true"`.
- Test 3 (Umschalten): im Ansichtsmodus Klick auf „Dashboard bearbeiten“ -> `mockStore.setEditMode` einmal mit `true` gerufen.
</behavior>
<action>
RED zuerst: Tests 6-8 in `dashboard-grid.test.tsx` anhaengen (Mock auf `vi.mock('react-grid-layout', async (importOriginal) => ({ ...(await importOriginal<typeof import('react-grid-layout')>()), Responsive: MockResponsive }))` umstellen, damit `noCompactor` echt ist — bricht das in jsdom, Rueckfall: Objekt-Mock `noCompactor: { type: null, allowOverlap: false, compact: (l) => [...l] }` und Test 7 ohne Referenzvergleich, im SUMMARY begruenden), `page.test.tsx` anlegen; `pnpm -C apps/web exec vitest run src/components/dashboard/dashboard-grid.test.tsx "src/app/(portal)/page.test.tsx"` -> Tests 6, 7, 8 rot, page-Tests 1 und 2 rot (Test 3 kann gruen sein — der Umschalter existiert heute schon), Zahlen notieren. Dann GREEN:
1. `dashboard-grid.tsx`: exportierte Konstanten `WIDGET_DRAG_HANDLE_SELECTOR = '.widget-drag-handle'`, `WIDGET_DRAG_CANCEL_SELECTOR = 'input, textarea, select, button, a, [contenteditable], [data-no-drag], .widgetNoDrag'` und `FREE_PLACEMENT_COMPACTOR: Compactor = { ...noCompactor, preventCollision: true }` (Typ-Import `Compactor` neben `ResponsiveLayouts`). `dragConfig` = `{ enabled: isEditMode, handle: WIDGET_DRAG_HANDLE_SELECTOR, cancel: WIDGET_DRAG_CANCEL_SELECTOR, threshold: 3 }`; `compactor={FREE_PLACEMENT_COMPACTOR}`. Kommentare (deutsch, ASCII) mit den gemessenen Fundstellen: cancel gewinnt auch innerhalb des Griffs (react-draggable `Draggable.js:417`), RGL haengt `.react-resizable-handle` selbst voran; ohne `preventCollision` springt das gezogene Widget auf die Zeile des getroffenen und das getroffene um seine eigene Hoehe nach unten, Ueberlappungen bleiben, weil `noCompactor.compact` Identitaet ist (`chunk-76RTO6EO.mjs:279-328`); freie Platzierung bleibt (Commit c8f3361). Der `dragConfig`-Kommentar im JSDoc-Kopf („v2 API…“) darf bleiben.
2. `widget-wrapper.tsx`: Karte im Bearbeitungsmodus zusaetzlich mit `widget-drag-handle cursor-grab active:cursor-grabbing border-primary/40` (im Ansichtsmodus `border-primary/20` wie bisher; `className` per Template-String, beide Zweige als Literale). Den 6-px-Griffstreifen im Fluss ersetzen durch eine Overlay-Kopfleiste NUR im Bearbeitungsmodus: `div` mit `absolute inset-x-0 top-0 z-10 flex h-5 items-center justify-center bg-muted/70`, `title={t('dragHint')}`, `data-testid="widget-drag-head"`, darin ein Griff-Symbol (inline SVG 14x14, sechs Punkte in zwei Reihen: Kreise bei (5,9) (12,9) (19,9) (5,15) (12,15) (19,15), r 1.5, `fill="currentColor"`, `className="text-muted-foreground"`, `aria-hidden`). Den Loesch-Knopf IN diese Kopfleiste setzen: `absolute right-0.5 top-0 flex h-5 w-5 items-center justify-center rounded-full bg-card text-muted-foreground transition-colors hover:bg-destructive hover:text-destructive-foreground`, Symbol 12x12, `data-no-drag=""`, `aria-label`/`title` `t('deleteTooltip')`, `onClick` mit `stopPropagation` wie bisher. Rumpf: `@container-size h-full` OHNE die wirkungslose `pt-0`-Bedingung (Klasse als reines Literal); den bwo-Kommentar um einen Satz ergaenzen: die Kopfleiste liegt als Overlay ueber dem Rumpf und aendert die Hoehenkette nicht. JSDoc der Komponente anpassen (Karte ist der Griff, Kopfleiste ist Hinweis, cancel-Selektor in dashboard-grid.tsx).
3. `edit-mode-toggle.tsx`: Klassen — Basis `inline-flex items-center justify-center rounded-md p-2 shadow-lg transition-colors`; aktiv `bg-primary text-primary-foreground hover:opacity-90`; inaktiv `border border-border bg-card text-muted-foreground hover:bg-muted hover:text-foreground`. JSDoc: „schwebt in der festen Aktionsleiste unten rechts (quick-260916-dyv)“. Symbole, aria, title unveraendert.
4. `page.tsx`: den absolut positionierten Block oben rechts samt Kommentar entfernen; den Abstands-Wrapper um `DashboardGrid` samt bwo-Kommentar entfernen (Grid direkt im Container `p-2`; `relative` am Container darf bleiben); den bisherigen bedingten `fixed`-Block durch EINE immer gerenderte Leiste ersetzen: `div` `fixed bottom-6 right-6 z-20 flex items-center gap-2`, darin zuerst `{isEditMode && <button …>{t('addWidget')}</button>}` (Knopf-Klassen unveraendert), dann `<EditModeToggle … />`. Kommentar (deutsch, ASCII): „quick-260916-dyv: Umschalter unten rechts statt oben rechts, damit das Grid direkt unter der Kopfzeile beginnt (12 + 8 + 8 = 28 px statt 60 px).“ Der Stift ueberdeckt im Ansichtsmodus im schlimmsten Fall 36x36 px eines Widgets in der Ecke — hingenommen (im SUMMARY nennen).
5. `de.json`/`en.json`: unter `widgets` direkt nach `deleteTooltip` den Schluessel `dragHint` einfuegen — de „Ziehen Sie die Kachel, um sie zu verschieben“, en „Drag the tile to move it“. `umlaut-dictionary.ts` NICHT anfassen.
6. Gruen: `pnpm -C apps/web exec vitest run src/components/dashboard "src/app/(portal)/page.test.tsx" src/messages` -> alle gruen (Erwartung: dashboard-grid 9, page 3, messages 6). `pnpm -C apps/web exec tsc --noEmit` -> 0. Falsifizierung (b): `cancel` aus dem `dragConfig` entfernen -> Test 6 rot; `preventCollision` aus `FREE_PLACEMENT_COMPACTOR` entfernen -> Test 7 rot; Falsifizierung (c): den Abstands-Wrapper (`div` mit `mt-8`) um das Grid wieder einfuegen -> page-Test 1 rot. Jede einmal ausfuehren, Testnamen notieren, zuruecksetzen (`git diff --stat` danach nur die Arbeitsdateien).
7. Commit (nur diese 8 Dateien): `feat(quick-260916-dyv): Bearbeiten-Schalter unten rechts (Rand oben 28 px), ganze Kachel als Griff mit Kopfleiste, cancel-Selektor, kein Ueberlappen beim Ablegen`.
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && pnpm -C apps/web exec vitest run src/components/dashboard "src/app/(portal)/page.test.tsx" src/messages 2>&1 | grep -E "^\s+(Test Files|Tests)" ; grep -c "preventCollision: true" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "WIDGET_DRAG_CANCEL_SELECTOR" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "threshold: 3" apps/web/src/components/dashboard/dashboard-grid.tsx ; grep -c "mt-8" "apps/web/src/app/(portal)/page.tsx" ; grep -c "top-2" "apps/web/src/app/(portal)/page.tsx" ; grep -c "fixed bottom-6 right-6 z-20 flex items-center gap-2" "apps/web/src/app/(portal)/page.tsx" ; grep -c "h-\[6px\]" apps/web/src/components/dashboard/widgets/widget-wrapper.tsx ; grep -c "data-no-drag" apps/web/src/components/dashboard/widgets/widget-wrapper.tsx ; grep -c "cursor-grab" apps/web/src/components/dashboard/widgets/widget-wrapper.tsx ; grep -c '"dragHint"' apps/web/src/messages/de.json apps/web/src/messages/en.json ; W=$(git diff --stat -- apps/web/src/messages/umlaut-dictionary.ts); echo W_EXIT=$? ; test -z "$W"; echo W_EMPTY=$? ; pnpm -C apps/web exec tsc --noEmit >/dev/null 2>&1; echo "TSC_web=$?"</automated>
<fails_when>Die Teil-Suite ist nicht `Test Files 13 passed (13)` / `Tests 76 passed (76)` (Dashboard 10 Dateien / 64 Tests aus Task 1 plus Tests 6-8 = 67, `page.test.tsx` 1 Datei / 3 Tests, `src/messages` 2 Dateien / 6 Tests); `preventCollision: true`, `WIDGET_DRAG_CANCEL_SELECTOR` (>= 2: Definition und Verwendung) oder `threshold: 3` fehlen; `mt-8` oder `top-2` kommen in page.tsx noch vor (Grep nicht 0); die Leisten-Klasse fehlt; der alte 6-px-Streifen ist noch da; `data-no-drag` oder `cursor-grab` fehlen im Wrapper; `dragHint` fehlt in einer Sprachdatei (Ausgabe nicht `1` je Datei); `umlaut-dictionary.ts` ist geaendert (`W_EMPTY` ist 1) oder `W_EXIT` ist nicht 0; `TSC_web` nicht 0.</fails_when>
</verify>
<done>
Teil-Suite: Dashboard 10 Dateien / 67 Tests plus `page.test.tsx` 1 Datei / 3 Tests plus `src/messages` 2 Dateien / 6 Tests = `Test Files 13 passed (13)` / `Tests 76 passed (76)`; Greps: `preventCollision: true` 1, `WIDGET_DRAG_CANCEL_SELECTOR` >= 2, `threshold: 3` 1, `mt-8` 0, `top-2` 0, Leiste 1, alter Streifen 0, `data-no-drag` >= 1, `cursor-grab` >= 1, `dragHint` je 1, `W_EXIT=0`, `W_EMPTY=0`, `TSC_web=0`. RED-Lauf und Falsifizierungen (b) und (c) mit Testnamen im SUMMARY. Commit mit Scope `quick-260916-dyv` vorhanden.
</done>
</task>
<task type="auto">
<name>Task 3: Anwenderhandbuch, Abschluss-Gates, Push und Beobachtung des CI-Laufs</name>
<files>docs/anleitung-anwender.md</files>
<precondition>Gitea antwortet lokal: `curl -s --max-time 5 http://localhost:3002/api/v1/version` liefert `{"version":"1.26.2"}`, und `docker ps --format '{{.Names}}' | grep -c '^gitea-runner$'` liefert `1` (sonst Push trotzdem, Beobachtung als offenen Punkt ins SUMMARY).</precondition>
<action>
Schritt A — `docs/anleitung-anwender.md`, Abschnitt „Dashboard“ (echte Umlaute, Sie-Form, Ton der Datei), vier Stellen:
1. Zeile 61 „**Widgets hinzufügen und anordnen:** Oben rechts auf dem Dashboard befindet sich der Schalter **„Dashboard bearbeiten"**. Sobald der Bearbeitungsmodus aktiv ist:“ ersetzen durch „**Widgets hinzufügen und anordnen:** Unten rechts auf dem Dashboard schwebt der Stift-Schalter **„Dashboard bearbeiten"**; im Bearbeitungsmodus wird daraus ein Häkchen **„Änderungen speichern"**, und daneben erscheint **„Widget hinzufügen"**. Sobald der Bearbeitungsmodus aktiv ist:“ (die Anfuehrungszeichen wie in der Datei: „ und ").
2. Aufzaehlungspunkt „- Können Sie bestehende Widgets per Ziehen an eine neue Position verschieben.“ ersetzen durch „- Können Sie bestehende Widgets per Ziehen an eine neue Position verschieben. Fassen Sie die Kachel dazu an einer beliebigen Stelle an — Eingabefelder, Knöpfe und Links ausgenommen; ein grauer Griff am oberen Kachelrand zeigt, dass die Kachel beweglich ist. Abgelegt wird nur dort, wo Platz ist: über einer anderen Kachel springt sie an ihren Ausgangspunkt zurück.“
3. Im Aufzaehlungspunkt zur Größe den Klammertext „(jeder Widget-Typ hat eine Mindestgröße, damit der Inhalt lesbar bleibt)“ ersetzen durch „(jeder Widget-Typ hat eine Mindestgröße, bei der er gerade noch bedienbar bleibt — kleiner geht es nicht, größer jederzeit)“; Rest des Punktes unveraendert.
4. Aufzaehlungspunkt „- Erscheint an jedem Widget ein Symbol zum Entfernen.“ ersetzen durch „- Erscheint an jedem Widget rechts im Griff ein Symbol zum Entfernen.“
Schritt B — Gates, Commit, Push, Beobachtung:
1. `grep -c "Unten rechts auf dem Dashboard" docs/anleitung-anwender.md` -> 1; `grep -c "Oben rechts auf dem Dashboard" docs/anleitung-anwender.md` -> 0; `grep -c "gerade noch bedienbar" docs/anleitung-anwender.md` -> 1; `grep -c "an ihren Ausgangspunkt" docs/anleitung-anwender.md` -> 1.
2. Volle Suiten und tsc erneut: Web `Test Files 47 passed (47)` / `Tests 293 passed (293)`, API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`, `for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit; done` dreimal Exit 0; `pnpm install --frozen-lockfile` Exit 0.
3. `D=$(git diff --stat df16f46 -- . ':!.planning'); echo GIT_EXIT=$?; tail -n1 <<< "$D"` -> `12 files changed`; Unangetastet-Stichprobe `git diff --stat df16f46 -- '.env*' docker-compose.yml docker-compose.prod.yml docker-compose.dev.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard apps/web/src/app/globals.css apps/web/src/messages/umlaut-dictionary.ts apps/web/src/lib/stores/dashboard-store.ts apps/web/src/lib/grid-layout-migration.ts` -> leer.
4. Commit: `docs(quick-260916-dyv): Anwenderhandbuch — Bearbeiten-Schalter unten rechts, ganze Kachel ziehbar, Mindestgroessen` (nur diese Datei). Danach `git push` (schlichter Aufruf; die Push-URL zeigt auf localhost:3002; der lokale Vorsprung df16f46 geht mit); `git status -sb | head -n1` ohne `[ahead`.
5. Beobachtung des echten CI-Laufs (Token NIE ausgeben — nur in einer Shell-Variablen; Verfahren wie 260916-bwo Task 3): `PUSHED=$(git rev-parse HEAD); TOK=$(git config --get remote.origin.pushurl | sed -E 's#.*schalli:([^@]+)@.*#\1#')`; bis zu 12 Minuten alle 20 s `curl -s -H "Authorization: token $TOK" "http://localhost:3002/api/v1/repos/schalli/tessera-ctl/actions/runs?limit=5"` abfragen (Hintergrundbefehl, falls `sleep` im Vordergrund blockiert ist), Eintrag mit `head_sha == PUSHED`, auf `status == completed` warten; Erwartung `conclusion == success`, Dauer 4-6 Minuten. Danach Abbild-Probe: `docker run --rm --entrypoint node localhost:3002/schalli/tessera-ctl/api:beta -e 'console.log(process.env.APP_VERSION, process.env.APP_COMMIT)'` -> `APP_COMMIT` = kurzer SHA von `PUSHED` (`APP_VERSION` ist das `git describe`-Format, gemessen in 260916-bwo). Lauf-ID, Dauer, Ergebnis ins SUMMARY. Ist `conclusion` nicht `success`: Job-Log ueber `.../actions/runs/<id>/jobs` lesen, Ursache beheben, erneut pushen, erneut beobachten.
6. Wird das SUMMARY erst nach dem Push committet, den Push danach wiederholen (weiterer CI-Lauf erwartet, in Ordnung). SUMMARY-Pflichtinhalte: beide RED-Laeufe und die Falsifizierungen (a) — eine Konstante in `widget-registry.tsx` auf den bwo-Wert setzen -> Test A rot — (b) und (c) mit Testnamen; der Befund „gespeicherte minW/minH schlagen data-grid“ als zweiter Grund fuer ‚nicht klein genug'; die Kollisions-Messung und die Entscheidung `preventCollision` statt Kompaktierung (freie Platzierung bleibt, Commit c8f3361); die Mindestgroessen-Tabelle mit Rechnung je Typ und den bewusst benannten Grenzen (Link-Kachelansicht braucht 3 Zeilen, Rundenliste der Stoppuhr braucht mehr Hoehe, Rechner-Minimum 3x9 ist HOEHER als 4x8, weil der Rechner heute bei 8 Zeilen unten abgeschnitten ist); die Entscheidung „Overlay-Kopfleiste statt Kopfleiste im Fluss“ (Hoehenkette); die Stoppuhr-Bedienleiste als einzige Innen-Aenderung mit Begruendung; die Beobachtung „Stift unten rechts kann im Ansichtsmodus 36x36 px eines Eck-Widgets verdecken“; Abschnitt „Durchsicht Dashboard“ mit Befund je Widget bei Standard- und Mindestgroesse (gerechnet; Browser-Bestaetigung durch den Orchestrator) und einer Liste „bleibt als Todo“ (Rechner-Innenaufbau kompakter, damit weniger als 9 Zeilen reichen; Rundenliste/laufende Stoppuhr bei Minimum; hart englische Texte im Einstellungsformular aus 260916-bwo; Link-Kachelansicht); Abschnitt „Fuer den Changelog“ (Stichpunkte in Alltagssprache, siehe unten); die Anleitung fuer den Browser-Nachweis aus `<verification>`.
Changelog-Stichpunkte (woertlich ins SUMMARY unter „Fuer den Changelog“): „Widgets lassen sich wieder deutlich kleiner ziehen — jedes Widget hat jetzt genau die Mindestgroesse, bei der es gerade noch bedienbar ist; das gilt auch fuer bereits platzierte Widgets.“ / „Der Bearbeiten-Schalter des Dashboards sitzt jetzt unten rechts; dadurch beginnen die Widgets direkt unter der Kopfzeile.“ / „Verschieben ist einfacher: im Bearbeitungsmodus laesst sich jedes Widget an einer beliebigen Stelle anfassen (ausser an Eingabefeldern und Knoepfen), ein grauer Griff am oberen Rand zeigt das an. Widgets ueberlappen sich beim Ablegen nicht mehr — ueber einer belegten Stelle springt das Widget an seinen Ausgangspunkt zurueck.“ / „Die Stoppuhr hat kompaktere Knoepfe und passt so auch in kleine Kacheln.“ / „Das Anwenderhandbuch beschreibt den neuen Schalter, das Ziehen und die Mindestgroessen.“
</action>
<verify>
<automated>cd /home/vicolab/projects/tessera-ctl && grep -c "Unten rechts auf dem Dashboard" docs/anleitung-anwender.md ; grep -c "Oben rechts auf dem Dashboard" docs/anleitung-anwender.md ; grep -c "gerade noch bedienbar" docs/anleitung-anwender.md ; grep -c "an ihren Ausgangspunkt" docs/anleitung-anwender.md ; pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; pnpm -C apps/api exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)" ; for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit >/dev/null 2>&1; echo "TSC_$p=$?"; done ; pnpm install --frozen-lockfile >/dev/null 2>&1; echo FROZEN=$? ; D=$(git diff --stat df16f46 -- . ':!.planning'); echo GIT_EXIT=$? ; tail -n1 <<< "$D" ; U=$(git diff --stat df16f46 -- '.env*' docker-compose.yml docker-compose.prod.yml docker-compose.dev.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard apps/web/src/app/globals.css apps/web/src/messages/umlaut-dictionary.ts apps/web/src/lib/stores/dashboard-store.ts apps/web/src/lib/grid-layout-migration.ts); echo U_EXIT=$? ; test -z "$U"; echo U_EMPTY=$? ; S=$(git status -sb); head -n1 <<< "$S"</automated>
<fails_when>Die vier Handbuch-Greps sind nicht 1/0/1/1; eine Suite weicht von Web 47/293 bzw. API 67/1078 ab; ein TSC_* oder FROZEN oder GIT_EXIT ist nicht 0; die Summenzeile nennt nicht genau `12 files changed`; U_EMPTY ist 1 (eine unantastbare Datei wurde geaendert); die Statuszeile zeigt `[ahead` oder `[behind`.</fails_when>
</verify>
<done>
Handbuch-Greps 1/0/1/1; Web `Test Files 47 passed (47)` / `Tests 293 passed (293)`; API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`; dreimal `TSC_...=0`; `FROZEN=0`; `GIT_EXIT=0` und die Summenzeile nennt `12 files changed`; `U_EXIT=0`, `U_EMPTY=0`; die Status-Zeile enthaelt kein `[ahead`. Das SUMMARY traegt unter „CI-Lauf nach dem Push“ Lauf-ID, `conclusion`, Dauer und die Abbild-Probe — oder, falls Gitea/Runner nicht erreichbar waren, den Grund und den offenen Punkt — sowie alle Pflichtinhalte aus Schritt B.6.
</done>
</task>
</tasks>
<threat_model>
## Trust Boundaries
| Boundary | Description |
|----------|-------------|
| Gespeichertes Layout-JSON (`DashboardLayout.layouts`, vom Benutzer ueber `PUT /dashboard/layout` kontrolliert) -> `effectiveLayouts` -> react-grid-layout | Benutzerdaten (x/y/w/h/minW/minH) werden beim Rendern interpretiert; `minW/minH` werden jetzt aus Konstanten ueberschrieben |
| DOM-Ereignisse in der Widget-Kachel -> `cancel`/`handle`-Selektoren -> Drag-Start | Statische CSS-Selektoren entscheiden, ob ein Mausereignis ein Ziehen startet |
| Widget-Inhalte (Favoriten-/Link-Titel, Notiztext) -> Kachel | Unveraendert: kein neuer Pfad von Benutzerdaten in Klassen, Selektoren oder Styles |
## STRIDE Threat Register (ASVS Level 1, Blocking-Schwelle `high`)
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|-----------|----------|-----------|----------|-------------|-----------------|
| T-DYV-01 | Tampering | Gespeicherte `minW/minH` (eigene Anordnung, ungeprueft per `@IsObject()`) | low | mitigate | `effectiveLayouts` ersetzt `minW/minH` jedes Eintrags eines bekannten Typs durch die Konstanten — manipulierte Minima (z. B. `minW: 0` oder `minW: 1e9`) wirken nicht; unbekannte Typen bleiben unveraendert (kein Absturz, Test 9); wirkt ohnehin nur auf das eigene Dashboard |
| T-DYV-02 | Tampering | `cancel`/`handle`-Selektoren | low | accept | Statische Literale im Quelltext (`WIDGET_DRAG_CANCEL_SELECTOR`), keine Benutzerdaten in Selektoren; `Element.matches` mit ungueltigem Selektor wuerde werfen — Test 8 fuehrt `matches`/`closest` mit genau diesem Selektor in jsdom aus |
| T-DYV-03 | Denial of Service | `preventCollision` mit absurden gespeicherten Positionen (`x: 1e9`) | low | accept | react-grid-layout begrenzt ueber `correctBounds`; ein ueberlappend gespeichertes Widget laesst sich weiterhin auf freien Platz ziehen (Kollisionen werden nur am Zielort geprueft); wirkt nur auf das eigene Dashboard |
| T-DYV-04 | Information Disclosure | Tooltip `dragHint`, Kopfleiste | low | accept | Statischer Uebersetzungstext, keine Benutzerdaten |
| T-DYV-05 | Elevation of Privilege | Neue API-Pfade | low | accept | Keine API-Aenderung; `getLayout`/`saveLayout` bleiben `forTenant`-gebunden (Specs 260910-krx/260916-bwo unveraendert gruen) |
| T-DYV-SC | Tampering | npm/pip/cargo-Installationen | low | accept | Keine neuen Pakete, `pnpm-lock.yaml` unveraendert (`pnpm install --frozen-lockfile` als Gate in Task 3) |
</threat_model>
<verification>
Nach Task 3, alles aus `/home/vicolab/projects/tessera-ctl`:
- `pnpm -C apps/web exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)"` -> `Test Files 47 passed (47)` / `Tests 293 passed (293)`
- `pnpm -C apps/api exec vitest run 2>&1 | grep -E "^\s+(Test Files|Tests)"` -> `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`
- `for p in packages/shared apps/api apps/web; do pnpm -C $p exec tsc --noEmit; echo "TSC_$p=$?"; done` -> dreimal `=0`
- `pnpm install --frozen-lockfile; echo $?` -> `0`
- `D=$(git diff --stat df16f46 -- . ':!.planning'); tail -n1 <<< "$D"` -> `12 files changed`
- Falsifizierungen im SUMMARY benannt: (a) eine Konstante in `widget-registry.tsx` auf den bwo-Wert -> Test A rot; (b) `cancel` aus dem `dragConfig` -> Test 6 rot, `preventCollision` aus dem Compactor -> Test 7 rot; (c) Abstands-Wrapper um das Grid wieder eingefuegt -> page-Test 1 rot. Jede einmal durchfuehren, Testnamen rot notieren, zuruecksetzen.
- Human-Check (end-of-phase, nicht blockierend, durch den Verifizierer/Orchestrator mit Playwright MCP gegen die lokalen Container; VORHER `docker compose up -d --build web` — das Web-Abbild stammt aus 1aefaa3; die API braucht keinen Neubau; Bounding-Boxen per `boundingBox()`, nie per `fetch` aus der Seite):
1. Anmelden (Benutzername `admin`, Kennwort `admin123`). „Dashboard bearbeiten“ (Stift UNTEN RECHTS), nacheinander Uhr, Suchleiste, Rechner, Stoppuhr, Notizen, Kalender, Favoriten, Link hinzufuegen (jedes erscheint unter dem vorigen), Bearbeitungsmodus beenden (Haekchen unten rechts), Seite neu laden.
2. Rand oben: `main.app-shell-main` oben vs. erstes `[data-widget-id]` oben -> 28 px (+/-1; vorher 60). Linker Rand weiter 28 px, Luecke zwischen Nachbarn 8 px (unveraendert).
3. Feste Leiste: Bounding-Box des Stift-Knopfs (aria-label „Dashboard bearbeiten“): Abstand zum rechten Viewport-Rand 24 px, zum unteren 24 px, 36x36 px, mit Karten-Hintergrund und Rahmen; im Bearbeitungsmodus steht „Widget hinzufuegen“ links neben dem Haekchen in derselben Leiste; kein Element mehr oben rechts im Dashboard-Container.
4. Mindestgroessen: im Bearbeitungsmodus je Widget den Groessen-Griff unten rechts weit nach oben links ziehen, bis nichts mehr geht; Bounding-Box notieren und mit der Tabelle in `<planning_measurements>` vergleichen (bei Spaltenbreite `(Containerbreite - 200)/24` px): Uhr 2x2, Suche 6x2, Kalender 3x3, Notizen 4x4, Rechner 3x9, Favoriten 3x3, Link 3x2, Stoppuhr 4x3. Screenshot je Widget bei Minimum. Bedienbarkeit: Uhrzeit lesbar; Suchfeld >= 80 px breit, Knopf sichtbar; Rechner: ALLE fuenf Tastenreihen sichtbar inklusive „=“ (Vergleich: mit dem alten Abbild war die unterste Reihe bei 4x8 abgeschnitten — optional vorher pruefen); Stoppuhr starten -> Stop, Runde und Reset alle sichtbar und klickbar; Notiz: Titel und mindestens zwei Textzeilen; Kalender: Leertext oder eine Terminzeile; Favoriten: Umschaltzeile und Listenzeilen; Link: eine Listenzeile. Faellt ein Widget durch, die gemessene Kachelgroesse und den Grund notieren (dann Konstante + Test A anpassen — kleiner Korrekturlauf, keine Neuplanung).
5. Persistierte Minima: nach einem Speichern `docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT layouts->''lg'' FROM "DashboardLayout";'` -> die Eintraege tragen die neuen `minW/minH`. Gegenprobe: per SQL beim Uhr-Eintrag `minW: 8, minH: 8` setzen (jsonb_set), Seite neu laden, Uhr auf 2x2 verkleinern -> geht (die Konstanten schlagen die DB).
6. Ziehen: im Bearbeitungsmodus die Uhr an ihrer MITTE (nicht an der Kopfleiste) 200 px nach rechts ziehen -> sie rastet versetzt ein (Bounding-Box verglichen); Kopfleiste 20 px hoch mit Griff-Punkten und Tooltip „Ziehen Sie die Kachel, um sie zu verschieben“; `mousedown` im Suchfeld + 100 px Bewegung -> Text wird markiert, die Suchleiste bewegt sich NICHT; Klick auf das Loesch-Symbol rechts in der Kopfleiste -> Widget verschwindet, kein Ziehen; Groessen-Griff funktioniert weiter.
7. Ablegen auf belegter Stelle: die Uhr ueber die Suchleiste ziehen und loslassen -> die Uhr steht wieder an ihrem Ausgangsort, die Suchleiste ist nicht verschoben, nichts ueberlappt; die Suchleiste in Richtung Uhr vergroessern -> die Groesse stoppt vor der Uhr. Beobachtetes Verhalten woertlich notieren.
8. Durchsicht: jedes Widget bei Standard- und Mindestgroesse kurz beurteilen (gut / auffaellig / Todo), Liste in die VERIFICATION uebernehmen.
Nach der Probe: Probe-Datensaetze in der lokalen DB entfernen, falls angelegt; Playwright-Artefakte entfernen.
</verification>
<success_criteria>
- Minima: `WIDGET_CONSTRAINTS` traegt die inhaltsgetriebene Tabelle (Test A), `effectiveLayouts` ueberschreibt gespeicherte `minW/minH` in jedem Breakpoint (Test 9), Stoppuhr-Bedienleiste kompakt; Browser: jedes Widget schrumpft auf die Tabelle und bleibt bedienbar.
- Rand: Umschalter in fester Leiste unten rechts (page-Tests 1-3), Grid direkt im Container; Browser: erstes Widget 28 px unter der Kopfzeile.
- Ziehen: Karte ist Griff, Overlay-Kopfleiste mit Symbol und Tooltip, `cancel`-Selektor greift fuer Eingabefelder/Knoepfe/Links/`widgetNoDrag` (Tests 6 und 8), `threshold: 3`; `FREE_PLACEMENT_COMPACTOR` mit `preventCollision: true` (Test 7); Browser: Ziehen an der Mitte, kein Drag aus dem Suchfeld, kein Ueberlappen beim Ablegen, Vergroessern stoppt am Nachbarn.
- Web 47/293, API 67/1078, tsc dreimal 0, Lockfile unveraendert, genau 12 Dateien ausserhalb `.planning`, drei Commits mit Scope `quick-260916-dyv`, gepusht, CI-Lauf `success` beobachtet, Abbild-Probe notiert; Handbuch nennt Schalter unten rechts, ganze Kachel ziehbar, Ablegen nur auf freiem Platz, Mindestgroesse = gerade noch bedienbar; SUMMARY mit Durchsicht-Liste, Todos und Changelog-Stichpunkten.
</success_criteria>
<output>
Create `.planning/quick/260916-dyv-dashboard-nachbesserung-mindestgroessen-/260916-dyv-SUMMARY.md` when done
</output>
@@ -0,0 +1,395 @@
---
phase: quick-260916-dyv
plan: 01
subsystem: ui, dashboard
tags: [dashboard, react-grid-layout, react-draggable, drag-and-drop, tailwind, vitest, i18n]
requires:
- phase: quick-260916-bwo
provides: 24-Spalten/20-px-Raster, verdoppelte WIDGET_CONSTRAINTS, Container-Query-Widgets, gespeicherte Anordnungen mit minW/minH
provides:
- "WIDGET_CONSTRAINTS mit inhaltsgetriebenen Minima (clock 2/2, search 6/2, calendar 3/3, note 4/4, calculator 3/9, favorites 3/3, link 3/2, stopwatch 4/3), Vorgaben unveraendert, Test A pinnt alle 32 Werte"
- "effectiveLayouts in dashboard-grid.tsx: gespeicherte minW/minH werden in jedem Breakpoint aus den Konstanten ueberschrieben, zu kleine w/h auf das Minimum angehoben (Addendum des Plan-Pruefers)"
- "Feste Aktionsleiste unten rechts (Stift/Haekchen + Widget hinzufuegen), Grid direkt im Container p-2 — Rand oben 28 px statt 60 px"
- "Ganze Kachel als Griff, Overlay-Kopfleiste 20 px mit Griff-Symbol und Tooltip, cancel-Selektor fuer Eingabefelder/Knoepfe/Links/[data-no-drag]/.widgetNoDrag, threshold 3"
- "FREE_PLACEMENT_COMPACTOR = noCompactor + preventCollision: true — kein Ueberlappen beim Ablegen, Vergroessern stoppt am Nachbarn, freie Platzierung bleibt"
- "Stoppuhr-Bedienleiste kompakt (px-2 py-1 text-xs), damit die Kachel auf 4x3 schrumpfen kann"
- "Anwenderhandbuch: Schalter unten rechts, ganze Kachel ziehbar, Ablegen nur auf freiem Platz, Mindestgroesse = gerade noch bedienbar"
affects: [dashboard, anwenderhandbuch, changelog]
actuals:
tokens: 11339
tasks: 3
commits: 3
plan_head_before: ec1b0ce5823f5f5275d0e79e231e8378f04ad0ea
tech-stack:
added: []
patterns:
- "Konstanten schlagen persistierte Werte: gespeicherte Layout-Eintraege werden vor der Uebergabe an react-grid-layout aus WIDGET_CONSTRAINTS normalisiert (useMemo, keine Mutation der Store-Objekte)"
- "react-grid-layout-Mock per vi.mock(..., async (importOriginal) => ({ ...original, Responsive: Mock })) — echte Helfer (noCompactor) bleiben testbar"
- "Drag-Griff = ganze Karte, Ausnahmen per cancel-Selektor (exportierte Konstante, im DOM-Test mit matches/closest gegen den echten Selektor geprueft)"
- "Overlay-Kopfleiste (absolute) statt Kopfleiste im Fluss, damit die Hoehenkette Karte -> Rumpf fuer Container-Queries definit bleibt"
key-files:
created:
- apps/web/src/app/(portal)/page.test.tsx
modified:
- apps/web/src/components/dashboard/widget-registry.tsx
- apps/web/src/components/dashboard/widget-registry.test.tsx
- apps/web/src/components/dashboard/dashboard-grid.tsx
- apps/web/src/components/dashboard/dashboard-grid.test.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
- apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
- apps/web/src/components/dashboard/edit-mode-toggle.tsx
- apps/web/src/app/(portal)/page.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- docs/anleitung-anwender.md
key-decisions:
- "Gespeicherte minW/minH werden beim Rendern aus WIDGET_CONSTRAINTS ueberschrieben (effectiveLayouts) — RGL 2.2.3 nimmt gespeicherte Eintraege woertlich; ohne die Ueberschreibung aendert die Konstante fuer bestehende Widgets nichts"
- "Zu kleine gespeicherte w/h werden auf das Minimum angehoben (Plan-Pruefer-Addendum): RGL rendert eine zu kleine Kachel woertlich und klemmt erst beim naechsten Resize"
- "preventCollision statt Kompaktierung: freie Platzierung (Commit c8f3361) bleibt, Ablegen auf belegtem Feld springt an den Ausgangsort zurueck"
- "Overlay-Kopfleiste statt Kopfleiste im Fluss: Rumpf bleibt h-full, cqh loest weiter auf"
- "Stoppuhr-Bedienleiste als einzige Innen-Aenderung; Rechner bekommt statt Umbau ein hoeheres Minimum 3x9"
- "Test 7 pinnt die Identitaets-Kopie ueber die Kernfelder plus moved/static false (Messbefund: cloneLayoutItem normalisiert), nicht per toEqual gegen die Eingabe"
patterns-established:
- "Falsifizierungen an unkommittierten Dateien per sed/Python zuruecksetzen, nie per git checkout (das setzt die ganze Datei auf HEAD)"
requirements-completed: [QUICK-260916-DYV]
coverage:
- id: D1
description: "Inhaltsgetriebene Mindestgroessen je Widget-Typ, Vorgaben unveraendert"
requirement: QUICK-260916-DYV
verification:
- kind: unit
ref: "apps/web/src/components/dashboard/widget-registry.test.tsx#Test A (quick-260916-dyv)"
status: pass
human_judgment: false
- id: D2
description: "Gespeicherte minW/minH werden in jedem Breakpoint ueberschrieben, zu kleine w/h angehoben"
requirement: QUICK-260916-DYV
verification:
- kind: unit
ref: "apps/web/src/components/dashboard/dashboard-grid.test.tsx#quick-260916-dyv Test 9"
status: pass
- kind: unit
ref: "apps/web/src/components/dashboard/dashboard-grid.test.tsx#quick-260916-dyv Test 9b"
status: pass
human_judgment: false
- id: D3
description: "Bearbeiten-Schalter in fester Leiste unten rechts, Grid direkt im Container (Rand 28 px)"
requirement: QUICK-260916-DYV
verification:
- kind: unit
ref: "apps/web/src/app/(portal)/page.test.tsx#Test 1..3"
status: pass
- kind: automated_ui
ref: "Browser-Nachweis Schritt 2/3 (Orchestrator, Playwright MCP)"
status: unknown
human_judgment: true
rationale: "Die 28 px und die Lage der Leiste sind nur im gerenderten Browser messbar"
- id: D4
description: "Ganze Kachel als Griff, cancel-Selektor, Kopfleiste, kein Ueberlappen (preventCollision)"
requirement: QUICK-260916-DYV
verification:
- kind: unit
ref: "apps/web/src/components/dashboard/dashboard-grid.test.tsx#quick-260916-dyv Test 6/7/8"
status: pass
- kind: automated_ui
ref: "Browser-Nachweis Schritt 6/7 (Orchestrator)"
status: unknown
human_judgment: true
rationale: "Drag-Verhalten von react-draggable/RGL laeuft nicht in jsdom"
- id: D5
description: "Stoppuhr-Bedienleiste kompakt, Kachel auf 4x3 bedienbar"
requirement: QUICK-260916-DYV
verification:
- kind: unit
ref: "apps/web/src/components/dashboard/widgets/stopwatch-widget.test.tsx (8 Tests gruen)"
status: pass
- kind: automated_ui
ref: "Browser-Nachweis Schritt 4 (Stoppuhr bei Minimum)"
status: unknown
human_judgment: true
rationale: "Ob Stop/Runde/Reset in 4 Spalten passen, ist eine Layout-Messung im Browser"
- id: D6
description: "Anwenderhandbuch beschreibt Schalter, Ziehen, Mindestgroessen"
requirement: QUICK-260916-DYV
verification:
- kind: other
ref: "grep -c: Unten rechts 1 / Oben rechts 0 / gerade noch bedienbar 1 / an ihren Ausgangspunkt 1"
status: pass
human_judgment: false
duration: 15min
completed: 2026-09-16
status: complete
---
# Quick 260916-dyv: Dashboard-Nachbesserung — Mindestgroessen inhaltsgetrieben, Schalter unten rechts, ganze Kachel als Griff Summary
**Jedes Widget schrumpft wieder auf seine kleinste bedienbare Kachel — auch die bereits gespeicherten, weil `dashboard-grid.tsx` die in der Datenbank persistierten `minW/minH` beim Rendern aus `WIDGET_CONSTRAINTS` ueberschreibt (und zu kleine gespeicherte Groessen auf das Minimum anhebt); der Bearbeiten-Schalter sitzt in einer festen Leiste unten rechts, sodass das Grid 28 statt 60 px unter der Kopfzeile beginnt; im Bearbeitungsmodus ist die ganze Kachel der Griff, Eingabefelder/Knoepfe/Links/`.widgetNoDrag` starten kein Ziehen (`cancel`), und `preventCollision: true` am `noCompactor` verhindert Ueberlappen beim Ablegen und beim Vergroessern in einen Nachbarn. Drei Commits auf `main` (`dc992c9`, `dbbd54f`, `cf97b5b`), gepusht (`7a6f42e..cf97b5b`, nimmt die zwei Akten-Commits `df16f46`, `ec1b0ce` mit), CI-Lauf siehe unten.**
## Performance
- **Duration:** 15 min bis zum Push (Start 08:32:57Z, Push 08:43:00Z), CI-Ende 08:47:45Z
- **Tasks:** 3/3
- **Files:** 12 (11 Web, 1 Handbuch) — `git diff --stat df16f46 -- . ':!.planning'` -> `12 files changed, 538 insertions(+), 99 deletions(-)`
## Ausgangslage und Bezugspunkt
HEAD bei Start `ec1b0ce` (Plan-Commit), Arbeitsbaum sauber, `main` 2 Akten-Commits vor `origin/main` (`df16f46`, `ec1b0ce`). Code-Gates gegen `df16f46` (Code seit `1aefaa3` unveraendert). Vorbedingung Task 3: `curl localhost:3002/api/v1/version` -> `{"version":"1.26.2"}`, `docker ps | grep -c '^gitea-runner$'` -> `1`.
Baseline frisch (Dashboard-Suite): `Test Files 10 passed (10)` / `Tests 63 passed (63)` — identisch mit der Planung.
**Zweig-Hinweis:** Alle Commits liegen auf `main` — Projektpraxis (`branching_strategy: none` in `.planning/config.json`, alle Vorgaenger-Quick-Tasks und der Plan-Commit ebenfalls auf `main`), vom Orchestrator so vorgeschrieben (Commit + `git push`). Der generische Executor-Schutz „nicht auf den Default-Zweig committen“ wurde deshalb bewusst nicht angewandt.
## Abweichung von den Planzahlen (Addendum des Plan-Pruefers)
Der Plan-Pruefer hat eine Test-9-Variante verlangt (gespeicherte Groesse unter dem neuen Minimum wird angehoben). Umgesetzt als **Test 9b** in `dashboard-grid.test.tsx`. Dadurch verschieben sich alle Zaehlungen um **+1**:
| Gate | Plan | Gemessen | Befehl |
|---|---|---|---|
| Task 1 Dashboard-Suite | 10 / 64 | `Test Files 10 passed (10)` / `Tests 65 passed (65)` | `pnpm -C apps/web exec vitest run src/components/dashboard` |
| `dashboard-grid.test.tsx` nach Task 1 | 6 | `Tests 7 passed (7)` | `pnpm -C apps/web exec vitest run src/components/dashboard/dashboard-grid.test.tsx` |
| Task 2 Teil-Suite | 13 / 76 | `Test Files 13 passed (13)` / `Tests 77 passed (77)` | `pnpm -C apps/web exec vitest run src/components/dashboard "src/app/(portal)/page.test.tsx" src/messages` |
| `dashboard-grid.test.tsx` nach Task 2 | 9 | `Tests 10 passed (10)` | wie oben, einzelne Datei |
| Web gesamt | 47 / 293 | `Test Files 47 passed (47)` / `Tests 294 passed (294)` | `pnpm -C apps/web exec vitest run` |
Unveraendert wie geplant: `widget-registry.test.tsx` 11, `stopwatch-widget.test.tsx` 8, `page.test.tsx` 3, `src/messages` 6, API `Test Files 67 passed (67)` / `Tests 1078 passed (1078)`.
**Was react-grid-layout mit einem zu kleinen Eintrag sonst taete (gemessen, 2.2.3):** `synchronizeLayoutWithChildren` (`chunk-WGL5FSZH.mjs:559-562`) klont den gespeicherten Eintrag woertlich — `h: 8` bleibt `h: 8`, auch wenn `minH` (aus der Ueberschreibung) 9 ist. Geklemmt wird nur beim Vergroessern/Verkleinern: `minMaxSize.constrainSize` (`chunk-KDANGDDL.mjs:26-31`, `clamp(h, item.minH ?? 1, ...)`) und die Pixel-`minConstraints` an `Resizable` (`chunk-WGL5FSZH.mjs:472-475`). `correctBounds` (`chunk-76RTO6EO.mjs:257-277`) prueft nur Spaltenueberlauf, nicht Minima. Folge ohne Anhebung: ein gespeicherter Rechner mit `h: 8` bliebe bis zum ersten Anfassen des Groessen-Griffs unten abgeschnitten (unterste Tastenreihe fehlt) und spraenge dann auf 9. Mit der Anhebung in `applyConstraintMinima` (`w: Math.max(entry.w, minW)`, `h: Math.max(entry.h, minH)`) ist er sofort vollstaendig; beim naechsten Speichern landen 9 Zeilen in der DB.
## Task 1 — Mindestgroessen, Ueberschreibung, Stoppuhr (`dc992c9`, 5 Dateien)
**RED** `pnpm -C apps/web exec vitest run src/components/dashboard/widget-registry.test.tsx src/components/dashboard/dashboard-grid.test.tsx`:
```
× Test A (quick-260916-dyv): Minima = kleinste bedienbare Kachel je Typ, Vorgaben unveraendert
× quick-260916-bwo Test 5: Widget ohne gespeicherten Eintrag bekommt die Vorgaben und die inhaltsgetriebenen Minima als data-grid
× quick-260916-dyv Test 9: gespeicherte minW/minH werden in JEDEM Breakpoint aus WIDGET_CONSTRAINTS ueberschrieben, x/y/w/h bleiben, unbekannte Typen und Schluessel unveraendert
× quick-260916-dyv Test 9b: gespeicherte Groesse unter dem neuen Minimum wird auf das Minimum angehoben (Rechner h 8 -> 9, w bleibt wenn >= minW)
Tests 4 failed | 14 passed (18)
```
(Plan erwartete `3 failed`; +1 durch Test 9b.)
**GREEN** — `WIDGET_CONSTRAINTS` auf die Tabelle, `applyConstraintMinima` + `useMemo` (`effectiveLayouts`, vor dem Leerzustand wegen Hook-Reihenfolge) in `dashboard-grid.tsx`, `layouts={effectiveLayouts}` und `data-grid`-Fallback aus `effectiveLayouts.lg`, Stoppuhr-Knoepfe `px-2 py-1 text-xs` und Zeile `gap-1 py-1`.
Gates: Dashboard-Suite `10 passed (10)` / `65 passed (65)`; Greps `minW: 3, minH: 9` 1, `minW: 2, minH: 2, defaultW: 4, defaultH: 4` 1, `defaultW: 12, defaultH: 4` 1; `effectiveLayouts` 3; Stoppuhr `px-2 py-1 text-xs` 4, `px-4 py-1.5 text-sm` 0; `TSC_web=0`.
**Falsifizierung (a)** — `clock.minW/minH` in `widget-registry.tsx` auf den bwo-Wert 4/4: `Tests 3 failed | 15 passed (18)`: „Test A (quick-260916-dyv): Minima = kleinste bedienbare Kachel je Typ, Vorgaben unveraendert“, „quick-260916-bwo Test 5: …“, „quick-260916-dyv Test 9: …“. Zurueckgesetzt, gruen. (Lehre: `git checkout -- <Datei>` an der noch unkommittierten Datei hat die gesamte Task-1-Aenderung zurueckgesetzt — erneut angewandt, Gates erneut gruen; bei (b)/(c) deshalb per `sed`/Python zurueckgestellt.)
## Task 2 — Leiste unten rechts, Griff, cancel, preventCollision (`dbbd54f`, 8 Dateien)
**RED** `pnpm -C apps/web exec vitest run src/components/dashboard/dashboard-grid.test.tsx "src/app/(portal)/page.test.tsx"`:
```
× Test 1: Ansichtsmodus — Stift in fester Leiste unten rechts, kein "Widget hinzufuegen", kein mt-8/top-2, Grid direkt im Container p-2
× Test 2: Bearbeitungsmodus — "Widget hinzufuegen" links neben dem Haekchen in derselben Leiste, Grid im Bearbeitungsmodus
× quick-260916-dyv Test 6: dragConfig-Pin — handle Karte, cancel fuer Interaktives, threshold 3; resizeConfig folgt dem Bearbeitungsmodus
× quick-260916-dyv Test 7: Compactor-Pin — echter noCompactor plus preventCollision: true, compact ist Identitaets-Kopie (freie Platzierung)
× quick-260916-dyv Test 8: cancel/handle-Semantik im DOM — Karte ist Griff, Loesch-Knopf/Eingaben/widgetNoDrag passen auf cancel, Kopfleiste als Overlay nur im Bearbeitungsmodus
Tests 5 failed | 8 passed (13)
```
page-Test 3 (Umschalten) war wie vorhergesagt bereits gruen. `importOriginal` fuer `react-grid-layout` laeuft in jsdom — kein Rueckfall auf den Objekt-Mock noetig.
**Messbefund Test 7:** Der echte `noCompactor.compact` ist `cloneLayout` -> `cloneLayoutItem` (`chunk-76RTO6EO.mjs:204-223`): kopiert `i/x/y/w/h` unveraendert, normalisiert aber `moved`/`static` zu `false` und fuegt `minW/maxW/minH/maxH/...` als `undefined` hinzu. Das im Plan vorgesehene `toEqual` gegen die Eingabe scheitert deshalb an `moved: false, static: false` (erster GREEN-Lauf: `1 failed | 76 passed (77)`). Test 7 pinnt nun `toMatchObject({ i, x, y, w, h, moved: false, static: false })`, neue Referenzen fuer Array und Element, und dass die Eingabe unveraendert bleibt — inhaltlich dieselbe Aussage (Identitaet als Kopie, keine Verschiebung).
**GREEN** — `WIDGET_DRAG_HANDLE_SELECTOR`, `WIDGET_DRAG_CANCEL_SELECTOR`, `FREE_PLACEMENT_COMPACTOR: Compactor = { ...noCompactor, preventCollision: true }`, `dragConfig` mit `handle/cancel/threshold: 3`; `widget-wrapper.tsx` neu (Karte im Bearbeitungsmodus `widget-drag-handle cursor-grab active:cursor-grabbing border-primary/40`, Overlay-Kopfleiste `absolute inset-x-0 top-0 z-10 flex h-5 ... bg-muted/70` mit Sechs-Punkte-SVG, Tooltip `dragHint`, `data-testid="widget-drag-head"`, Loesch-Knopf `h-5 w-5` mit `data-no-drag=""`; Rumpf `@container-size h-full` als reines Literal); `edit-mode-toggle.tsx` `shadow-lg`, inaktiv `border border-border bg-card`; `page.tsx` feste Leiste `fixed bottom-6 right-6 z-20 flex items-center gap-2` (erst „Widget hinzufuegen“, dann Umschalter), Grid direkt im Container; `dragHint` in de/en direkt nach `deleteTooltip`.
Gates: Teil-Suite `13 passed (13)` / `77 passed (77)` (dashboard-grid 10, page 3, messages 6); Greps `preventCollision: true` 2 (Definition + Kommentar), `WIDGET_DRAG_CANCEL_SELECTOR` 2, `threshold: 3` 2 (Wert + Kommentar), `mt-8` 0, `top-2` 0, Leiste 1, `h-[6px]` 0, `data-no-drag` 3, `cursor-grab` 2, `"dragHint"` je 1, `W_EXIT=0`, `W_EMPTY=0`, `TSC_web=0`.
**Falsifizierungen (b) und (c)** (Rueckstellung per `sed`/Python, danach `Tests 13 passed (13)` und nur die Arbeitsdateien im Diff):
| Falsifizierung | Eingriff | Rot (Testname woertlich) |
|---|---|---|
| (b1) | Zeile `cancel: WIDGET_DRAG_CANCEL_SELECTOR,` aus `dragConfig` entfernt | `Tests 1 failed | 9 passed (10)`: „quick-260916-dyv Test 6: dragConfig-Pin — handle Karte, cancel fuer Interaktives, threshold 3; resizeConfig folgt dem Bearbeitungsmodus“ |
| (b2) | `FREE_PLACEMENT_COMPACTOR = { ...noCompactor }` (ohne `preventCollision`) | `Tests 1 failed | 9 passed (10)`: „quick-260916-dyv Test 7: Compactor-Pin — echter noCompactor plus preventCollision: true, compact ist Identitaets-Kopie (freie Platzierung)“ |
| (c) | `<div className="mt-8">` um `DashboardGrid` wieder eingefuegt | `Tests 1 failed | 2 passed (3)`: „Test 1: Ansichtsmodus — Stift in fester Leiste unten rechts, kein "Widget hinzufuegen", kein mt-8/top-2, Grid direkt im Container p-2“ |
## Task 3 — Handbuch, Abschluss-Gates, Push, CI (`cf97b5b`, 1 Datei)
Handbuch-Greps: `Unten rechts auf dem Dashboard` 1, `Oben rechts auf dem Dashboard` 0, `gerade noch bedienbar` 1, `an ihren Ausgangspunkt` 1.
Abschluss-Gates (alle nach dem Handbuch-Edit, vor dem Commit):
| Gate | Ergebnis |
|---|---|
| Web `pnpm -C apps/web exec vitest run` | `Test Files 47 passed (47)` / `Tests 294 passed (294)` (Plan 293, +1 Test 9b) |
| API `pnpm -C apps/api exec vitest run` | `Test Files 67 passed (67)` / `Tests 1078 passed (1078)` |
| `tsc --noEmit` shared / api / web | `TSC_packages/shared=0`, `TSC_apps/api=0`, `TSC_apps/web=0` |
| `pnpm install --frozen-lockfile` | `FROZEN=0` |
| `git diff --stat df16f46 -- . ':!.planning'` | `GIT_EXIT=0`, `12 files changed, 538 insertions(+), 99 deletions(-)` |
| Unantastbar-Stichprobe (`.env*`, Compose, Lockfile, package.json, prisma, api/src/dashboard, globals.css, umlaut-dictionary.ts, dashboard-store.ts, grid-layout-migration.ts) | `U_EXIT=0`, `U_EMPTY=0` (leer) |
| `git status -sb` vor Push / nach `git fetch` | `## main...origin/main [voraus 5]` / `## main...origin/main` |
Push: `7a6f42e..cf97b5b main -> main` (fuenf Commits: `df16f46`, `ec1b0ce` Akten; `dc992c9`, `dbbd54f`, `cf97b5b` Code/Handbuch).
### CI-Lauf nach dem Push
| Feld | Versuch 1 (einziger) |
|---|---|
| Lauf-ID | 353 (event `push`, ref `main`, `head_sha` `cf97b5b64b48ac08cb410966e98cf532f600681d`) |
| status / conclusion | `completed` / **`success`** |
| started_at / completed_at | 10:43:05 / 10:47:45 (+02:00) — **4 min 40 s** (15 Polls a 20 s; beim ersten Poll 7 s nach dem Push bereits `in_progress`, keine Warteschlange) |
| Jobs | Lint & Type Check `success` (08:43:05-08:43:53Z), Tests `success` (08:43:55-08:44:51Z), Build & Publish Images `success` (08:44:53-08:47:45Z) |
| `api:beta` node `APP_VERSION APP_CHANNEL APP_COMMIT` | `v1.0.0-16-gcf97b5b beta cf97b5b` — `APP_COMMIT` = `git rev-parse --short HEAD` = `cf97b5b`; `APP_VERSION` im `git describe`-Format (wie in 260916-bwo gemessen) |
| `docker image inspect Created` api:beta | `2026-09-16T10:46:42+02:00` (per `docker pull` geholt, kein Container gebaut oder gestartet) |
Beobachtung per Hintergrund-Skript (`watch-ci.sh` im Scratchpad, Token nur in einer Shell-Variablen, nie ausgegeben), Gitea-API `GET /repos/schalli/tessera-ctl/actions/runs?limit=5`, Eintrag mit `head_sha == PUSHED`. Keine Infrastruktur- oder Code-Fehler, kein erneuter Lauf noetig.
## Git-Stand vor dem SUMMARY (Wahrheit)
`git status --porcelain` (leer):
```
```
`git log --oneline ec1b0ce..HEAD`:
```
cf97b5b docs(quick-260916-dyv): Anwenderhandbuch — Bearbeiten-Schalter unten rechts, ganze Kachel ziehbar, Mindestgroessen
dbbd54f feat(quick-260916-dyv): Bearbeiten-Schalter unten rechts (Rand oben 28 px), ganze Kachel als Griff mit Kopfleiste, cancel-Selektor, kein Ueberlappen beim Ablegen
dc992c9 fix(quick-260916-dyv): Mindestgroessen inhaltsgetrieben (kleinste bedienbare Kachel je Typ), gespeicherte Minima ueberschrieben, Stoppuhr-Bedienleiste kompakt
```
`commits: 3` gemessen: `git rev-list --count ec1b0ce5823f5f5275d0e79e231e8378f04ad0ea..HEAD` -> `3`. `actuals.tokens` 11339 = Zeichen des Diffs `git diff df16f46 -- . ':!.planning'` (45356) / 4; zum Vergleich Zeichen der 12 geaenderten Dateien gesamt 170986 / 4 = 42746. Plan-Schaetzung 90000 (confidence low) — deutlich zu hoch fuer den Diff.
## Gemessene Befunde und Entscheidungen
- **Zweiter Grund fuer „nicht klein genug“ (der im Auftrag nicht genannte):** Gespeicherte `minW/minH` schlagen `data-grid`. `synchronizeLayoutWithChildren` liest `data-grid` nur fuer Kinder ohne Eintrag; alle bestehenden Widgets haben einen Eintrag mit den in 260916-bwo verdoppelten Minima. Ohne `effectiveLayouts` aendert die Konstantentabelle fuer den User NICHTS Sichtbares — Test 9 ist der entscheidende Test, nicht Test A.
- **Kollision und `preventCollision`:** `noCompactor = { type: null, allowOverlap: false, compact: cloneLayout }`, `preventCollision` fehlt (`false`). Beim Ziehen auf ein belegtes Feld (`moveElement` -> `moveElementAwayFromCollision`, `chunk-76RTO6EO.mjs:279-328`, Zweig `collisionNorth && compactType === null`): das GEZOGENE springt auf die Zeile des getroffenen (`collidesWith.y = itemToMove.y`), das getroffene rutscht um seine EIGENE Hoehe nach unten (`itemToMove.y += itemToMove.h`), keine Kaskade, keine Nachpruefung; `compact` ist Identitaet — Ueberlappungen bleiben. Beim Vergroessern mit dem `se`-Griff ist `shouldMoveItem` false, `moveElement` wird nicht gerufen: die Ueberlappung entsteht stumm. Mit `preventCollision: true`: `if (hasCollisions && preventCollision) { l.x = oldX; l.y = oldY; l.moved = false; return layout; }` — Platzhalter bleibt am Ursprung; Vergroessern prueft `getAllCollisions` am neuen Mass und behaelt das alte. Entscheidung: `preventCollision` statt `verticalCompactor`, weil die freie Platzierung (Commit `c8f3361`, „prevent auto-compaction on drag“) gewollt ist — Kompaktierung wuerde Luecken automatisch schliessen. `preventCollision` lebt am Compactor-Objekt (`compactor.preventCollision ?? false`, `chunk-WGL5FSZH.mjs:666`), daher ein eigenes Objekt.
- **Griff/cancel:** react-draggable 4.7.0 prueft `cancel` NACH `handle`, beides vom Ereignisziel aufwaerts bis zum RGL-Element (`Draggable.js:417`, `matchesSelectorAndParentsTo`). Die Karte ist Kind des RGL-Elements, also passt jedes Ziel in der Karte auf den Griff; `cancel` gewinnt fuer Eingabefelder/Knoepfe/Links/`[contenteditable]`/`[data-no-drag]`/`.widgetNoDrag`. RGL haengt `.react-resizable-handle` selbst voran (`chunk-WGL5FSZH.mjs:526`). Die 12 bislang toten `widgetNoDrag`-Stellen (Favoriten 5, Link 7) sind damit wirksam. Test 8 fuehrt `matches`/`closest` mit dem echten Selektor in jsdom aus (T-DYV-02: ungueltiger Selektor wuerfe dort).
- **Overlay-Kopfleiste statt Kopfleiste im Fluss:** Der Rumpf bleibt `h-full`, die Hoehenkette Karte -> Rumpf bleibt definit, `cqh` loest weiter auf (Grund fuer `h-full` in 260916-bwo). Eine Kopfleiste im Fluss haette den Rumpf im Bearbeitungsmodus um 20 px gekuerzt und den Rechner bei Mindestgroesse beschnitten. Preis: die obersten 20 px des Widget-Inhalts liegen im Bearbeitungsmodus unter der halbtransparenten Leiste (`bg-muted/70`) — im Ansichtsmodus gibt es keine Leiste.
- **Stoppuhr-Bedienleiste als einzige Innen-Aenderung:** Bei Mindestbreite 4 Spalten (lg 191 px, Rumpf 179 px) ueberlief die laufende Stoppuhr (Stop + Runde + Reset mit `px-4 text-sm` ca. 222 px) — Reset abgeschnitten; kompakt (`px-2 text-xs`) ca. 151 px passt, Zeile 32 statt 48 px. Ohne diese Aenderung waere das inhaltsgetriebene Minimum 6x4 — BREITER als heute, das Gegenteil des Auftrags. Der Rechner wird NICHT umgebaut: er bekommt das hoehere Minimum 3x9 (heute 4x8), weil bei 8 Zeilen (216 px) die unterste Tastenreihe (+/-, 0, Komma, =) abgeschnitten ist (Anzeige 40 + Speicherzeile 28 + 5 Reihen 28 + Abstaende = 240 px > 216 px).
- **Stift unten rechts:** Im Ansichtsmodus kann der 36x36-px-Stift (bei `bottom-6 right-6`) im schlimmsten Fall die untere rechte Ecke eines Widgets verdecken, das bis an den rechten Rand und bis unter den Viewport-Rand reicht — hingenommen (der bisherige „Widget hinzufuegen“-Knopf lag bereits dort, nur im Bearbeitungsmodus).
- **`fixed` und `z-20`:** `fixed` bezieht sich auf das Viewport (kein transformierter Vorfahr — der bisherige Knopf funktionierte an derselben Stelle); `z-20` liegt ueber RGL-Elementen (gezogenes Element `z-index: 3`).
- **Mock per `importOriginal`:** laeuft in jsdom; `noCompactor` ist echt, `Responsive` bleibt Mock.
## Mindestgroessen-Tabelle (gerechnet; Browser-Bestaetigung durch den Orchestrator)
Spaltenbreite lg bei 1200 px = 41,67 px (Kachelbreite(w) = 49,67w - 8), beim Orchestrator-Viewport von 260916-bwo 60 px; Kachelhoehe(h) = 28h - 8 px.
| Typ | bwo-Minimum | neu | px bei Spalte 41,67 / 60 | Rechnung | Bewusste Grenze |
|---|---|---|---|---|---|
| clock | 4/4 | **2/2** | 91x48 / 128x48 | Zeit `min(20cqw, 50cqh)` ca. 17-20 px, 8 Zeichen tabular ca. 80 px in 83 px | Datum (falls an) 10 px darunter, eng |
| search | 6/4 | **6/2** | 290x48 / 400x48 | Auswahl 120 + Eingabe >= 80 + Knopf 40 + Abstaende 28 = 268 <= 278 Rumpf; Eingabe `h-8` 32 px in 48 px | 3 Spalten (141 px) waeren unbrauchbar — Breite bleibt 6 |
| calendar | 6/6 | **3/3** | 141x76 / 196x76 | eine Terminzeile 48 px + `p-1.5` = 60 <= 76; Leertext 3 Zeilen text-sm 60 px | knapp; mehr Termine brauchen mehr Hoehe |
| note | 4/6 | **4/4** | 191x104 / 264x104 | Kopfzeile ca. 36 + Vorschau >= 2 Zeilen (40) = 76 <= 104; Editiermodus Werkzeugleiste ca. 29 + 2 Zeilen | — |
| calculator | 4/8 | **3/9** | 141x244 / 196x244 | Breite 4 Tasten x >= 30 + 3x4 + `p-1` 8 = 140 <= 141; Hoehe 40 + 4 + 28 + 4 + 5x28 + 4x4 = 156 + `p-1` 8 = 240 <= 244 | Minimum HOEHER als 4x8, weil bei 8 Zeilen die unterste Tastenreihe abgeschnitten ist; gespeicherte 4x8-Rechner werden auf h 9 angehoben |
| favorites | 4/6 | **3/3** | 141x76 / 196x76 | Umschaltzeile (nur Bearbeitungsmodus) ca. 110 <= 133; drei Listenzeilen (20 + 4) in 68 px; Kachelraster `grid-cols-3` ca. 40-px-Kacheln | — |
| link | 4/4 | **3/2** | 141x48 / 196x48 | Listenzeile Symbol 20 + Titel in 40 px Rumpf; Umschaltzeile <= 133 | Kachelansicht (Symbol 32 + Text 16 + Abstand) braucht 3 Zeilen — der User zieht eine Zeile hoeher |
| stopwatch | 4/4 | **4/3** | 191x76 / 264x76 | NUR mit kompakter Leiste: laufend Stop+Runde+Reset ca. 151 <= 179; Zeile 32 px; Anzeige `min(16cqw, 35cqh)` = 26,6 px im Rest von 32 px | Rundenliste (`max-h-32`) braucht mehr Hoehe — Nebenfunktion |
Vorgaben (`defaultW/defaultH`) unveraendert: clock 4/4, search 12/4, calendar 8/12, note 6/8, calculator 6/10, favorites 6/10, link 4/4, stopwatch 6/6 — neue Widgets erscheinen wie gewohnt; alle Minima <= Vorgabe (`it.each` prueft es).
## Durchsicht Dashboard (gerechnet; Browser-Bestaetigung durch den Orchestrator)
| Widget | Standardgroesse | Mindestgroesse | Befund |
|---|---|---|---|
| Uhr | 4x4, Zeit skaliert (bwo) | 2x2: Zeit ca. 17-20 px lesbar | gut |
| Suche | 12x4 | 6x2: Auswahl, Eingabe >= 80 px, Knopf | gut |
| Kalender | 8x12 | 3x3: Leertext oder eine Terminzeile | auffaellig: knapp, aber bedienbar |
| Notizen | 6x8 | 4x4: Titel + 2 Zeilen | gut |
| Rechner | 6x10, Tasten skalieren (bwo) | 3x9: alle 5 Tastenreihen inkl. „=“ | gut; Todo: Innenaufbau kompakter, damit < 9 Zeilen reichen |
| Favoriten | 6x10 | 3x3: Umschaltzeile + Listenzeilen | gut |
| Link | 4x4 | 3x2: eine Listenzeile | auffaellig: Kachelansicht braucht 3 Zeilen |
| Stoppuhr | 6x6 | 4x3: Anzeige 26,6 px, Stop/Runde/Reset sichtbar | gut; Todo: Rundenliste bei Minimum |
**Bleibt als Todo (nicht Teil dieses Auftrags):**
- Rechner-Innenaufbau kompakter (Speicherzeile/Anzeige), damit weniger als 9 Zeilen reichen.
- Rundenliste / laufende Stoppuhr bei Minimum 4x3: die Liste (`max-h-32`) hat dort keinen Platz.
- Hart englische Texte im Einstellungsformular (aus 260916-bwo: „Timezone“, „Saving...“, „Title“, englischer Kalender-Hinweis).
- Link-Kachelansicht bei 2 Zeilen (braucht 3).
## Deviations from Plan
### Auto-fixed Issues
**1. [Addendum des Plan-Pruefers] Zu kleine gespeicherte w/h werden angehoben**
- **Found during:** Task 1 (vom Pruefer vorgegeben)
- **Issue:** Ein gespeicherter Rechner mit `h: 8` bliebe trotz `minH: 9` unten abgeschnitten, bis er einmal angefasst wird (RGL klemmt nur beim Resize).
- **Fix:** `applyConstraintMinima` setzt `w: Math.max(w, minW)`, `h: Math.max(h, minH)` im selben Durchlauf; Test 9b.
- **Files modified:** `dashboard-grid.tsx`, `dashboard-grid.test.tsx`
- **Commit:** `dc992c9`
**2. [Rule 1 - Messbefund] Test 7 nicht per `toEqual` gegen die Eingabe**
- **Found during:** Task 2 GREEN
- **Issue:** Der echte `cloneLayoutItem` normalisiert `moved`/`static` zu `false`; `toEqual` scheiterte.
- **Fix:** `toMatchObject` auf Kernfelder + `moved: false, static: false`, Referenzen ungleich, Eingabe unveraendert.
- **Files modified:** `dashboard-grid.test.tsx`
- **Commit:** `dbbd54f`
**3. [Prozess] Falsifizierung (a) hat per `git checkout` die unkommittierte Registry-Aenderung mit zurueckgesetzt**
- **Fix:** Aenderung erneut angewandt, alle Task-1-Gates erneut gemessen (identisch), dann committet. (b)/(c) per `sed`/Python zurueckgestellt.
Sonst: Plan exakt wie geschrieben ausgefuehrt. Keine neuen Pakete, kein Schema, keine `.env*`/Compose/Lockfile-Aenderung, `umlaut-dictionary.ts` unangetastet.
## Threat Flags
Keine neue Angriffsflaeche ausserhalb des `<threat_model>`: keine API-Aenderung, keine Benutzerdaten in Selektoren oder Styles, `effectiveLayouts` ersetzt manipulierte Minima (T-DYV-01, Test 9 mit unbekanntem Typ ohne Absturz).
## Known Stubs
Keine.
## Was bewusst offen bleibt
- Der Browser-Nachweis (8 Schritte, unten) — Sache des Orchestrators/Verifizierers; das lokale Web-Abbild stammt aus `1aefaa3` und muss VORHER neu gebaut werden (`docker compose up -d --build web`).
- Die vier Todos aus der Durchsicht (Rechner-Innenaufbau, Rundenliste, englische Formulartexte, Link-Kachelansicht).
- Die 20 px hohe Overlay-Kopfleiste verdeckt im Bearbeitungsmodus den obersten Streifen des Widget-Inhalts halbtransparent — bewusst (Hoehenkette), im Browser beurteilen.
- Der Stift kann im Ansichtsmodus 36x36 px eines Eck-Widgets verdecken.
- Mandantenfaehigkeit/alpha/live: nichts geaendert; gespeicherte Anordnungen dort tragen die alten Minima, bis der Benutzer einmal speichert — sichtbar ist das nicht, weil `effectiveLayouts` sie beim Rendern ohnehin ersetzt.
## Fuer den Verifizierer/Orchestrator (Browser-Nachweis)
Vorher: `docker compose up -d --build web` (die API braucht keinen Neubau). Playwright MCP gegen `http://localhost:3000`, Bounding-Boxen per `boundingBox()`, nie per `fetch` aus der Seite. Anmelden `admin` / `admin123`.
1. **Aufbau:** „Dashboard bearbeiten“ (Stift UNTEN RECHTS), nacheinander Uhr, Suchleiste, Rechner, Stoppuhr, Notizen, Kalender, Favoriten, Link hinzufuegen (jedes erscheint unter dem vorigen), Bearbeitungsmodus beenden (Haekchen unten rechts), Seite neu laden.
2. **Rand oben:** `main.app-shell-main` oben vs. erstes `[data-widget-id]` oben -> 28 px (+/-1; vorher 60). Linker Rand 28 px, Luecke zwischen Nachbarn 8 px (unveraendert).
3. **Feste Leiste:** Bounding-Box des Stifts (aria-label „Dashboard bearbeiten“): Abstand zum rechten und unteren Viewport-Rand je 24 px, 36x36 px, Karten-Hintergrund + Rahmen + Schatten; im Bearbeitungsmodus „Widget hinzufuegen“ links neben dem Haekchen in derselben Leiste; kein Element mehr oben rechts im Dashboard-Container.
4. **Mindestgroessen:** je Widget den Groessen-Griff unten rechts weit nach oben links ziehen; Bounding-Box mit der Tabelle vergleichen (Spaltenbreite `(Containerbreite - 200)/24` px, Zeile 20 px + 8 px): Uhr 2x2, Suche 6x2, Kalender 3x3, Notizen 4x4, Rechner 3x9, Favoriten 3x3, Link 3x2, Stoppuhr 4x3. Screenshot je Widget. Bedienbarkeit: Uhrzeit lesbar; Suchfeld >= 80 px, Knopf sichtbar; Rechner ALLE fuenf Tastenreihen inkl. „=“; Stoppuhr starten -> Stop, Runde, Reset sichtbar und klickbar; Notiz Titel + 2 Zeilen; Kalender Leertext/Terminzeile; Favoriten Umschaltzeile + Listenzeilen; Link eine Listenzeile. Faellt ein Widget durch: Kachelgroesse und Grund notieren (dann Konstante + Test A anpassen — kleiner Korrekturlauf).
5. **Persistierte Minima:** nach einem Speichern (Haekchen) `docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT layouts->''lg'' FROM "DashboardLayout";'` -> Eintraege tragen die neuen `minW/minH` (und der Rechner `h >= 9`). **Gegenprobe A (jsonb_set):** beim Uhr-Eintrag `minW: 8, minH: 8` setzen, Seite neu laden, Uhr auf 2x2 verkleinern -> geht.
**Gegenprobe B (kompletter Probe-Datensatz in NEUEN Raster-Einheiten mit verdoppelten Minima und einem Rechner mit h 8)** — setzt voraus, dass fuer `admin` noch keine `DashboardLayout`-Zeile existiert (sonst vorher `DELETE FROM "DashboardLayout" WHERE "userId" = (SELECT id FROM "User" WHERE username = 'admin');`) und dass zwei `WidgetInstance`-Zeilen mit den Ids `probe-clock` und `probe-calc` angelegt werden; `__gridVersion: 2` ist Pflicht, sonst verdoppelt `migrateGridLayouts` beim Laden erneut:
```sql
INSERT INTO "WidgetInstance" (id, "userId", "tenantId", "widgetType", config, "createdAt", "updatedAt")
SELECT 'probe-clock', u.id, u."tenantId", 'clock', '{}'::jsonb, now(), now() FROM "User" u WHERE u.username = 'admin';
INSERT INTO "WidgetInstance" (id, "userId", "tenantId", "widgetType", config, "createdAt", "updatedAt")
SELECT 'probe-calc', u.id, u."tenantId", 'calculator', '{}'::jsonb, now(), now() FROM "User" u WHERE u.username = 'admin';
INSERT INTO "DashboardLayout" (id, "userId", "tenantId", layouts, "createdAt", "updatedAt")
SELECT gen_random_uuid()::text, u.id, u."tenantId",
'{"__gridVersion": 2,
"lg": [{"i":"probe-clock","x":0,"y":0,"w":4,"h":4,"minW":8,"minH":8},
{"i":"probe-calc","x":4,"y":0,"w":6,"h":8,"minW":4,"minH":8}],
"md": [{"i":"probe-clock","x":0,"y":0,"w":4,"h":4,"minW":8,"minH":8},
{"i":"probe-calc","x":4,"y":0,"w":6,"h":8,"minW":4,"minH":8}],
"sm": [], "xs": [], "xxs": []}'::jsonb,
now(), now()
FROM "User" u WHERE u.username = 'admin';
```
Erwartung nach Neuladen: die Uhr (gespeichert `minW/minH 8`, also groesser als ihre eigene Kachel 4x4) laesst sich auf 2x2 verkleinern; der Rechner wird SOFORT mit 9 Zeilen gerendert (Bounding-Box-Hoehe 244 px statt 216 px), alle fuenf Tastenreihen sichtbar, ohne dass er angefasst wurde. Nach einem Speichern zeigt die SQL-Abfrage `minW 2/minH 2` bei der Uhr und `h 9, minW 3, minH 9` beim Rechner. Danach aufraeumen: `DELETE FROM "DashboardLayout" WHERE "userId" = (SELECT id FROM "User" WHERE username = 'admin'); DELETE FROM "WidgetInstance" WHERE id IN ('probe-clock','probe-calc');`
6. **Ziehen:** im Bearbeitungsmodus die Uhr an ihrer MITTE (nicht an der Kopfleiste) 200 px nach rechts ziehen -> sie rastet versetzt ein; Kopfleiste 20 px hoch mit sechs Griff-Punkten und Tooltip „Ziehen Sie die Kachel, um sie zu verschieben“; `mousedown` im Suchfeld + 100 px Bewegung -> Text markiert, Suchleiste bewegt sich NICHT; Klick auf das Loesch-Symbol rechts in der Kopfleiste -> Widget verschwindet, kein Ziehen; Groessen-Griff funktioniert weiter.
7. **Ablegen auf belegter Stelle:** die Uhr ueber die Suchleiste ziehen und loslassen -> die Uhr steht wieder am Ausgangsort, die Suchleiste ist nicht verschoben, nichts ueberlappt; die Suchleiste in Richtung Uhr vergroessern -> die Groesse stoppt vor der Uhr. Beobachtetes Verhalten woertlich notieren.
8. **Durchsicht:** jedes Widget bei Standard- und Mindestgroesse (gut / auffaellig / Todo) in die VERIFICATION uebernehmen.
Nach der Probe: Probe-Datensaetze entfernen, Playwright-Artefakte entfernen.
## Fuer den Changelog
- Widgets lassen sich wieder deutlich kleiner ziehen — jedes Widget hat jetzt genau die Mindestgroesse, bei der es gerade noch bedienbar ist; das gilt auch fuer bereits platzierte Widgets.
- Der Bearbeiten-Schalter des Dashboards sitzt jetzt unten rechts; dadurch beginnen die Widgets direkt unter der Kopfzeile.
- Verschieben ist einfacher: im Bearbeitungsmodus laesst sich jedes Widget an einer beliebigen Stelle anfassen (ausser an Eingabefeldern und Knoepfen), ein grauer Griff am oberen Rand zeigt das an. Widgets ueberlappen sich beim Ablegen nicht mehr — ueber einer belegten Stelle springt das Widget an seinen Ausgangspunkt zurueck.
- Die Stoppuhr hat kompaktere Knoepfe und passt so auch in kleine Kacheln.
- Das Anwenderhandbuch beschreibt den neuen Schalter, das Ziehen und die Mindestgroessen.
## Self-Check: PASSED
Alle 12 Dateien vorhanden (10 Code/Handbuch-Pfade einzeln geprueft, de.json/en.json eingeschlossen), Commits `dc992c9`, `dbbd54f`, `cf97b5b` in `git log --all`; nach `git fetch`: `## main...origin/main` (nicht voraus, nicht zurueck); `git status --porcelain` zeigt nur das ungetrackte SUMMARY (Akten-Commit durch den Orchestrator).
@@ -0,0 +1,158 @@
---
phase: quick-260916-dyv
verified: 2026-09-16T10:53:00Z
status: passed
score: 6/6 code-Wahrheiten verifiziert (Browser-Nachweis steht aus, Sache des Orchestrators)
covered_files:
- .planning/quick/260916-dyv-dashboard-nachbesserung-mindestgroessen-/260916-dyv-PLAN.md
- .planning/quick/260916-dyv-dashboard-nachbesserung-mindestgroessen-/260916-dyv-SUMMARY.md
- apps/web/src/components/dashboard/widget-registry.tsx
- apps/web/src/components/dashboard/widget-registry.test.tsx
- apps/web/src/components/dashboard/dashboard-grid.tsx
- apps/web/src/components/dashboard/dashboard-grid.test.tsx
- apps/web/src/components/dashboard/widgets/stopwatch-widget.tsx
- apps/web/src/components/dashboard/widgets/widget-wrapper.tsx
- apps/web/src/components/dashboard/edit-mode-toggle.tsx
- apps/web/src/app/(portal)/page.tsx
- apps/web/src/app/(portal)/page.test.tsx
- apps/web/src/messages/de.json
- apps/web/src/messages/en.json
- docs/anleitung-anwender.md
human_verification:
- test: "Browser-Nachweis Schritt 1-8 (siehe SUMMARY.md, Abschnitt 'Fuer den Verifizierer/Orchestrator'): Aufbau aller acht Widgets, Rand oben 28 px, feste Leiste unten rechts, Mindestgroessen je Widget-Typ (inkl. Bedienbarkeit), persistierte Minima nach dem Speichern plus Gegenproben A/B (jsonb_set / kompletter Probe-Datensatz mit verdoppelten Minima und Rechner h=8), Ziehen an der Mitte, kein Drag aus dem Suchfeld, Ablegen auf belegter Stelle (kein Ueberlappen, Rueckfall an den Ausgangsort), Vergroessern stoppt am Nachbarn, abschliessende Durchsicht je Widget"
expected: "Alle acht Punkte wie im SUMMARY/PLAN beschrieben: 28 px Rand, Leiste unten rechts mit Stift/Haekchen + Widget hinzufuegen, jedes Widget schrumpft auf die Tabellenwerte und bleibt bedienbar, gespeicherte Minima werden nach dem Speichern durch die neuen Werte ersetzt (Gegenprobe A: manipulierte minW/minH in der DB werden von den Konstanten geschlagen; Gegenprobe B: ein zu kleiner gespeicherter Rechner (h=8) wird SOFORT mit 9 Zeilen gerendert, keine Ueberlappung beim Ablegen, Vergroessern stoppt am Nachbarn)"
why_human: "Layout-Geometrie (Pixelmasse, Bounding-Boxen), tatsaechliches Drag-Verhalten von react-draggable/react-grid-layout und visuelle Bedienbarkeit lassen sich nicht aus jsdom/Unit-Tests ableiten — laut PLAN.md ausdruecklich als 'Browser-Nachweis durch den Orchestrator (Playwright MCP)' vorgesehen, human_verify_mode: end-of-phase"
---
# Quick-Task 260916-dyv Verifikation
**Auftrag:** Dashboard-Nachbesserung — inhaltsgetriebene Mindestgroessen (mit Ueberschreibung gespeicherter Werte und Anhebung zu kleiner Werte), Bearbeiten-Schalter unten rechts (Rand 28 px), ganze Kachel als Griff mit cancel-Selektor und `preventCollision`, Anwenderhandbuch, gepusht, CI gruen.
**Verifiziert:** 2026-09-16, 10:41-10:53 UTC
**Status:** human_needed (alle Code-Wahrheiten VERIFIZIERT; der Browser-Nachweis ist explizit dem Orchestrator zugewiesen, siehe unten — dafuer allein wird NICHT `human_needed` vergeben, aber Steps 3/4/6/7 im SUMMARY sind noch offen und muessen protokolliert werden)
## 1. Git-Stand
| Pruefung | Befehl | Ergebnis |
|---|---|---|
| Commit-Reihenfolge | `git log --oneline ec1b0ce..HEAD` | `cf97b5b`, `dbbd54f`, `dc992c9` — exakt wie erwartet |
| Dateiumfang | `git diff --stat df16f46 -- . ':!.planning'` | `12 files changed, 538 insertions(+), 99 deletions(-)` — genau 12 |
| Unantastbare Pfade | `git diff --stat df16f46 -- '.env*' docker-compose*.yml pnpm-lock.yaml apps/web/package.json apps/api/package.json apps/api/prisma apps/api/src/dashboard apps/web/src/app/globals.css apps/web/src/messages/umlaut-dictionary.ts apps/web/src/lib/stores/dashboard-store.ts apps/web/src/lib/grid-layout-migration.ts` | leer, Exit 0 — nichts angefasst |
## 2. Testsuiten und Typprüfung
| Suite | Erwartung | Gemessen |
|---|---|---|
| Web `pnpm -C apps/web exec vitest run` | 47 Dateien / 294 Tests | `Test Files 47 passed (47)` / `Tests 294 passed (294)` |
| API `pnpm -C apps/api exec vitest run` | 67 Dateien / 1078 Tests | `Test Files 67 passed (67)` / `Tests 1078 passed (1078)` |
| `tsc --noEmit` (shared/api/web) | dreimal 0 | `TSC_shared=0`, `TSC_api=0`, `TSC_web=0` |
| `pnpm install --frozen-lockfile` | 0 | `FROZEN=0` |
Alle Zahlen decken sich mit der +1-Korrektur im SUMMARY (Test 9b, Plan-Pruefer-Addendum) — 293 (Plan) + 1 = 294 stimmt.
## 3. Code-Lektüre (Substanz und Verdrahtung)
### `widget-registry.tsx`
`WIDGET_CONSTRAINTS` traegt die Tabelle woertlich: clock 2/2/4/4, search 6/2/12/4, calendar 3/3/8/12, note 4/4/6/8, calculator 3/9/6/10, favorites 3/3/6/10, link 3/2/4/4, stopwatch 4/3/6/6 — deckt sich mit PLAN und SUMMARY. Kommentar deutsch/ASCII, erklaert die Herleitung. `defaultW/defaultH` unveraendert gegenueber `git diff df16f46` (nur die vier `min*`-Spalten geaendert).
### `widget-registry.test.tsx`
Test A pinnt `WIDGET_CONSTRAINTS` per `toEqual` exakt gegen das Objekt oben (Zeile 56-79). Der `it.each`-Test (min <= default) bleibt bestehen.
### `dashboard-grid.tsx`
`applyConstraintMinima` (Zeile 86-111): fuer jeden Breakpoint-Key, fuer jeden Eintrag mit bekanntem Typ wird `minW/minH` aus der Konstanten gesetzt UND `w`/`h` per `Math.max` auf das Minimum angehoben, sonst der Eintrag unveraendert kopiert (keine Mutation der Eingabe — per Kopie `{ ...entry }`/neues Objekt). `effectiveLayouts = useMemo(() => applyConstraintMinima(layouts, widgets), [layouts, widgets])` — greift fuer JEDEN Breakpoint, nicht nur `lg`. Wird an `Responsive` als `layouts={effectiveLayouts}` durchgereicht UND im `data-grid`-Fallback verwendet (`effectiveLayouts.lg?.find(...)`). `dragConfig` traegt `handle: WIDGET_DRAG_HANDLE_SELECTOR` (`.widget-drag-handle`), `cancel: WIDGET_DRAG_CANCEL_SELECTOR` (`'input, textarea, select, button, a, [contenteditable], [data-no-drag], .widgetNoDrag'`), `threshold: 3`. `compactor={FREE_PLACEMENT_COMPACTOR}` = `{ ...noCompactor, preventCollision: true }`. Alles wortgleich mit PLAN/SUMMARY.
### `dashboard-grid.test.tsx`
Tests 6-9b sind inhaltlich meaningful (nicht nur Zaehlung):
- Test 6: `toEqual` exakter Vergleich von `dragConfig`/`resizeConfig` in beiden Moden.
- Test 7: echter `noCompactor` via `importOriginal`, `compact()` als Funktionsaufruf mit echtem Rueckgabewert gepruefte, Referenzungleichheit UND Eingabe-Unveraenderlichkeit — nachvollziehbar begruendete Abweichung von `toEqual` zu `toMatchObject` (siehe unten).
- Test 8: echte DOM-Matches (`matches`/`closest`) gegen den exportierten Selektor, inklusive Eingabefeld und `.widgetNoDrag`-Element, die zur Laufzeit angehaengt werden — keine Attrappen.
- Test 9: zwei Breakpoints (`lg`, `md`), ein unbekannter Typ bleibt woertlich erhalten (kein Absturz), `Object.keys` der Layouts unveraendert.
- Test 9b: Rechner `h:8 -> 9` (unter dem neuen Minimum, angehoben), Suche `w:4 -> 6` (unter `minW`), Eingabeobjekt bleibt bei Pruefung nach dem Rendern unveraendert (`layouts.lg[0].h` immer noch `8`).
### `widgets/stopwatch-widget.tsx`
Diff zeigt die vier Knopf-Klassen `px-4 py-1.5 text-sm` -> `px-2 py-1 text-xs`, Zeile `gap-2 py-2` -> `gap-1 py-1`. Handler/aria-labels unveraendert (nicht Teil des Diffs).
### `widgets/widget-wrapper.tsx`
Karte traegt im Bearbeitungsmodus `widget-drag-handle cursor-grab active:cursor-grabbing border-primary/40` als Klassenliteral; im Ansichtsmodus `border-primary/20` (unveraendert). Kopfleiste `absolute inset-x-0 top-0 z-10 flex h-5 ...` — echtes Overlay, NICHT im Fluss. Rumpf bleibt `@container-size h-full` als reines Literal (keine wirkungslose `pt-0`-Bedingung mehr). Loesch-Knopf traegt `data-no-drag=""` und ist innerhalb der Kopfleiste.
### `apps/web/src/app/(portal)/page.tsx` + `page.test.tsx`
Kein `mt-8`, kein absolut positionierter Block oben rechts mehr. Grid direkt im Container `relative p-2`. Feste Leiste `fixed bottom-6 right-6 z-20 flex items-center gap-2`, DOM-Reihenfolge: „Widget hinzufuegen“ (nur im Bearbeitungsmodus) VOR `EditModeToggle` — Test 2 prueft das per `compareDocumentPosition`. `page.test.tsx` hat 3 meaningful Tests (nicht nur Existenzpruefung): Leisten-Klassen, fehlende Elemente (`mt-8`/`top-2`/Widget-hinzufuegen im Ansichtsmodus), Elternschaft der Knoepfe, Klick-Handler-Aufruf.
### i18n
`dragHint` in `de.json` (182: „Ziehen Sie die Kachel, um sie zu verschieben“) und `en.json` (182: „Drag the tile to move it“) vorhanden, direkt nach `deleteTooltip` (Zeilennummer identisch in beiden Dateien — Paritaet). `src/messages`-Suite (`umlaut-guard.spec.ts` eingeschlossen) gruen: `Test Files 2 passed (2)` / `Tests 6 passed (6)`.
### `docs/anleitung-anwender.md`
Enthaelt „Unten rechts auf dem Dashboard“ (1x), „Oben rechts auf dem Dashboard“ (0x), „gerade noch bedienbar“ (1x), „an ihren Ausgangspunkt“ (1x) — exakt wie im Plan gefordert. Echte Umlaute im Text bestaetigt beim Lesen.
## 4. Falsifizierung (eigenstaendig durchgefuehrt)
Arbeitsbaum vor Eingriff sauber (`git status --porcelain -- apps/` leer). `applyConstraintMinima` in `dashboard-grid.tsx` per Python-Skript so geaendert, dass `w`/`h` NICHT mehr per `Math.max` angehoben werden (nur `entry.w`/`entry.h` durchgereicht). Ergebnis:
```
Test Files 1 failed (1)
Tests 1 failed | 9 passed (10)
- Expected { h: 9, ... }
+ Received { h: 8, ... }
❯ ... Test 9b: gespeicherte Groesse unter dem neuen Minimum wird auf das Minimum angehoben
```
Test 9b wird rot, alle anderen bleiben gruen — bestaetigt, dass die Anhebung tatsaechlich von diesem Codepfad getragen wird und der Test sie wirklich prueft. Danach `git checkout -- apps/web/src/components/dashboard/dashboard-grid.tsx`; `git status --porcelain -- apps/` wieder leer; `dashboard-grid.test.tsx` erneut `10 passed (10)`. Arbeitsbaum unveraendert gegenueber dem Ausgangszustand.
## 5. CI und Registry
| Pruefung | Ergebnis |
|---|---|
| Gitea Actions Run 353 (`head_sha cf97b5b64b48ac08cb410966e98cf532f600681d`) | `status: completed`, `conclusion: success` |
| `docker run --rm --entrypoint node localhost:3002/schalli/tessera-ctl/api:beta -e '...APP_VERSION, APP_COMMIT'` | `v1.0.0-16-gcf97b5b cf97b5b` — `APP_COMMIT` entspricht dem gepushten Commit, das `beta`-Abbild ist NICHT veraltet |
| `git fetch -q && git status -sb` | `## main...origin/main` — kein `[ahead`, kein `[behind` |
Token wurde in eine Shell-Variable extrahiert und nirgends ausgegeben.
## 6. WINDOWS.md-Eintrag (Bewertung, nicht editiert)
Neuer Eintrag #39 (`quick-260916-dyv`, Status `open`): „Test 7 pinnt Identitaets-Kopie per `toMatchObject` statt `toEqual` (`cloneLayoutItem` normalisiert `moved`/`static`)“.
**Beurteilung:** Kein verschleierter Mangel, sondern eine korrekt dokumentierte, unausweichliche Anpassung. Gemessen (siehe Abschnitt 3, Test 7): der ECHTE `noCompactor.compact` (nicht der Mock) normalisiert beim Kopieren `moved`/`static` auf `false` und fuegt `undefined`-Felder fuer `minW/maxW/...` hinzu. Ein `toEqual` gegen die reine Eingabe (wie im PLAN woertlich vorgesehen) haette daher fast IMMER fehlgeschlagen — das ist ein Bibliotheksverhalten, keine Fehlfunktion des eigenen Codes. Der jetzige Test prueft inhaltlich dieselbe Aussage (Kernfelder identisch, neue Referenzen, `moved: false`/`static: false`, Eingabe unveraendert) — Identitaets-Kopie ohne Verschiebung, exakt die Intention aus dem Truth-Text „preventCollision lebt am Compactor-Objekt … Test importiert den echten noCompactor“. Der offene WINDOWS-Eintrag ist daher eine ehrliche, aber niedrigpriore Buchfuehrungsnotiz (Plan sagte `toEqual`, Code liefert `toMatchObject`) — kein Blocker fuer dieses Vorhaben. Empfehlung: als „waived“/„fixed“ mit Verweis auf diese Verifikation schliessen, sobald der Ledger-Verantwortliche zustimmt; nicht Teil dieses Verifikationsumfangs, daher nicht editiert.
## 7. Was noch fehlt: Vom Orchestrator im Browser zu pruefen
Laut PLAN.md (`<verification>`, Human-Check end-of-phase) und SUMMARY.md (Abschnitt „Fuer den Verifizierer/Orchestrator“) ist der komplette Browser-Nachweis explizit NICHT Teil des automatisierten Verifizierungsumfangs. Dieser Verifizierer hat KEINE Container gestartet/gestoppt, KEINEN Browser bedient und NICHT in die lokale Datenbank geschrieben (Auftrag). Vor dem Test: `docker compose up -d --build web` (das lokale Web-Abbild stammt noch aus `1aefaa3`).
1. **Aufbau:** Anmelden (`admin`/`admin123`), „Dashboard bearbeiten“ (Stift unten rechts), alle acht Widget-Typen nacheinander hinzufuegen, Bearbeitungsmodus beenden, Seite neu laden.
2. **Rand oben:** `main.app-shell-main` oben vs. erstes `[data-widget-id]` oben -> 28 px (+/-1; vorher 60). Linker Rand 28 px, Luecke 8 px.
3. **Feste Leiste:** Bounding-Box des Stifts: 24 px zu rechtem/unterem Viewport-Rand, 36x36 px, Karten-Hintergrund+Rahmen+Schatten; im Bearbeitungsmodus „Widget hinzufuegen“ links neben dem Haekchen in derselben Leiste; kein Element mehr oben rechts im Dashboard-Container.
4. **Mindestgroessen je Widget:** Groessen-Griff bis zum Anschlag ziehen, Bounding-Box gegen die Tabelle vergleichen (Uhr 2x2, Suche 6x2, Kalender 3x3, Notizen 4x4, Rechner 3x9, Favoriten 3x3, Link 3x2, Stoppuhr 4x3), Bedienbarkeit je Typ pruefen (Rechner: alle fuenf Tastenreihen inkl. „=“; Stoppuhr: Start -> Stop/Runde/Reset alle sichtbar und klickbar). Screenshot je Widget bei Minimum.
5. **Persistierte Minima + Gegenproben (SQL, in der lokalen Test-DB):**
- Nach Speichern: `docker exec tessera-ctl-db-1 psql -U tessera -d tessera -At -c 'SELECT layouts->''lg'' FROM "DashboardLayout";'` -> neue `minW/minH`.
- Gegenprobe A: Uhr-Eintrag per `jsonb_set` auf `minW: 8, minH: 8` setzen, neu laden, auf 2x2 verkleinerbar -> Konstanten schlagen die DB.
- Gegenprobe B (SQL aus dem SUMMARY, Abschnitt „Fuer den Verifizierer/Orchestrator“, Punkt 5): kompletter Probe-Datensatz mit `probe-clock`/`probe-calc`, `__gridVersion: 2`, verdoppelten Minima und Rechner `h: 8` einspielen; Erwartung: Uhr sofort auf 2x2 verkleinerbar, Rechner SOFORT mit 9 Zeilen gerendert (244 px Hoehe) ohne Anfassen; nach Speichern zeigt SQL `minW 2/minH 2` (Uhr) und `h 9, minW 3, minH 9` (Rechner). Danach Probe-Datensaetze wieder loeschen (`DELETE FROM ...` wie im SUMMARY vorgegeben).
6. **Ziehen:** Uhr an der Mitte (nicht Kopfleiste) 200 px ziehen -> Versatz; Kopfleiste 20 px mit sechs Punkten und Tooltip „Ziehen Sie die Kachel, um sie zu verschieben“; `mousedown` im Suchfeld + Bewegung -> Text markiert, KEIN Drag; Klick auf Loesch-Symbol -> Widget verschwindet, kein Ziehen ausgeloest; Groessen-Griff funktioniert weiter.
7. **Ablegen auf belegter Stelle:** Uhr ueber Suchleiste ziehen und loslassen -> Uhr springt an Ausgangsort zurueck, Suchleiste unveraendert, keine Ueberlappung; Suchleiste Richtung Uhr vergroessern -> stoppt vor der Uhr. Beobachtung woertlich notieren.
8. **Durchsicht:** jedes Widget bei Standard- und Mindestgroesse (gut/auffaellig/Todo) in die abschliessende VERIFICATION uebernehmen; danach Probe-Datensaetze/Playwright-Artefakte entfernen.
Faellt ein Widget bei Schritt 4 durch, ist laut PLAN ein kleiner Korrekturlauf (Konstante + Test A anpassen) vorgesehen, keine Neuplanung.
## Angenommene Risiken
- Der 20 px hohe Overlay-Kopfstreifen verdeckt im Bearbeitungsmodus die obersten 20 px des Widget-Inhalts halbtransparent — bewusste Entscheidung (Hoehenkette fuer Container-Queries bleibt definit), im Browser-Nachweis (Schritt 2/4) mitzupruefen, ob das bei den kleinsten Kacheln (z. B. Uhr 2x2 = 48 px hoch) stoerend wirkt.
- Der Stift kann im Ansichtsmodus im schlimmsten Fall 36x36 px der Ecke eines am Rand liegenden Widgets verdecken — bewusst hingenommen (der bisherige „Widget hinzufuegen“-Knopf lag bereits an derselben Stelle, nur im Bearbeitungsmodus sichtbar).
- Der Rechner braucht jetzt 3x9 (hoeher als die alten 4x8) statt eines Innenumbaus — bewusste, im SUMMARY begruendete Entscheidung; als Todo vermerkt (Innenaufbau kompakter machen), nicht Teil dieses Auftrags.
- Die Link-Kachelansicht braucht laut Rechnung 3 Zeilen bei einer Mindesthoehe von 2 — im SUMMARY als bewusste Grenze benannt („der User zieht eine Zeile hoeher“); im Browser-Nachweis (Schritt 4/8) zu bestaetigen.
- Der WINDOWS.md-Eintrag #39 (Test 7, `toMatchObject` statt `toEqual`) bleibt offen zur Buchfuehrung, ist aber inhaltlich durch einen Messbefund am echten `noCompactor` begruendet (Abschnitt 6) — kein Hinweis auf einen tatsaechlichen Fehler im produktiven Code.
- Alle acht Schritte des Browser-Nachweises (Abschnitt 7) sind ungeprueft — ausdruecklich dem Orchestrator zugewiesen (PLAN.md, `human_verify_mode: end-of-phase`), nicht Teil des automatisierten Umfangs dieses Verifizierers.
## Nachtrag des Orchestrators — Browser-Check durchgefuehrt (2026-09-16, 08:55-09:00Z)
Umgebung: lokale Container (web aus `cf97b5b`, danach aus `8792819`), Playwright MCP, Anmeldung als lokaler Admin; SQL-Probe aus dem SUMMARY (Anordnung mit `__gridVersion: 2`, verdoppelten Minima `minW/minH 8` an der Uhr, Rechner `h: 8`).
| Schritt | Beobachtung |
|---|---|
| Rand oben | Kopfzeilen-Unterrand 60, erstes Widget top 88 -> **28 px** (vorher 60) |
| Bearbeiten-Knopf | unten rechts, 24 px vom Rand; im Bearbeitungsmodus Leiste mit "Widget hinzufuegen" + Haekchen |
| Gespeicherte Minima | Uhr mit gespeichertem minW/minH 8 liess sich auf **126x48 px** (2x2) verkleinern, Uhrzeit 23 px; Rechner mit h 8 wurde beim Laden auf das Minimum angehoben |
| Ganze Kachel als Griff | Ziehen an der Kachelmitte verschiebt die Uhr um 280 px |
| cancel-Selektor | mousedown im Suchfeld + Bewegung: Such-Widget bleibt exakt an Ort und Stelle |
| Kollision | Rechner auf das belegte Such-Widget gezogen: stoppt unmittelbar davor (left 537 -> 671, rechte Kante 1066 < 1074), keine Ueberlappung, Such-Widget unveraendert |
| **Befund Rechner** | bei minH 9 (244 px) Inhalt 268 px, unterste Tastenreihe (0 / , / =) um 25 px abgeschnitten — der Planer hatte fuenf statt sechs Tastenreihen gezaehlt. **Behoben in `8792819`** (minH 10, Test 9b und Kommentare nachgezogen, Web 47/294 gruen, tsc 0): Kachel 272 px, Ueberlauf 0, "=" innerhalb. CI-Lauf fuer 8792819 `success` |
Nach der Probe: Probe-Zeilen entfernt (0/0), Playwright-Artefakte entfernt. Ledger #39 (Test-7-Anpassung, in-scope) als fixed.
@@ -0,0 +1,54 @@
---
created: 2026-09-15T19:39:37.195Z
title: Desktop-Client auslieferungsreif machen — Versions-Check, Windows-Installer, Abnahme, CI-Bau
area: desktop
severity: minor
trigger: Sobald der User eine Bau- und Testmoeglichkeit fuer Windows organisiert hat (User 2026-09-15: "Da finden wir was. Evtl. sogar so, dass du im Browser selbst testen kannst"). Reiner Komfort — der Betrieb im Browser braucht den Client nicht. Nicht von uns aus draengen.
files:
- apps/desktop/src-tauri/src/lib.rs:82-100
- apps/desktop/src-tauri/tauri.conf.json:4
- apps/desktop/src-tauri/tauri.conf.json:29
- apps/desktop/src/setup.html
- .gitea/workflows/ci.yml
- .planning/phases/06-desktop-client-ci-cd/06-02-SUMMARY.md
---
## Problem
Phase 6 (Juni 2026) hat den Tauri-Rahmen um die Web-Oberflaeche gebaut
(`apps/desktop`): Server-Adresse beim ersten Start, WebView auf die Installation,
Tray mit Schliessen-in-den-Tray, Fensterzustand, Autostart, Benachrichtigungen,
Versions-Check, Tessera-Symbol, Ziele AppImage + NSIS. Seit dem 2026-06-25 nicht
mehr angefasst. Vier Dinge stehen zwischen dem Stand und einer Auslieferung:
1. **Versions-Check ist seit 260914-ku1 falsch.** `lib.rs` vergleicht
`info.version` aus `GET /health/version` (jetzt z. B. `v1.0.0`, Stempel des
Server-Abbilds) mit `CARGO_PKG_VERSION` des Clients (`0.0.1`) und meldet bei
Ungleichheit "Eine neue Version ist verfuegbar" — also bei JEDEM Start.
Client- und Server-Version sind zwei verschiedene Dinge; der Check braucht
eine eigene Quelle fuer die Client-Version (z. B. ein Feld
`desktopVersion` in `/health/version` oder eine eigene Datei im Web-Abbild).
2. **Windows-Installer nie gebaut.** NSIS ist in `tauri.conf.json` konfiguriert,
gebaut wurde nur das Linux-AppImage (`Tessera_0.0.1_amd64.AppImage`), weil
auf dem Linux-Host keine Windows-Werkzeugkette existiert (06-02-SUMMARY).
Braucht einen Windows-Rechner, eine Windows-VM oder einen Windows-Runner.
3. **Keine Abnahme.** Phase 6 hat keine VERIFICATION.md; der Client wurde seit
Juni nicht gestartet, die Web-Oberflaeche hat sich seitdem stark veraendert
(Berechtigungen, Module, Kopfzeile mit Fehler-melden-Knopf, Versionsabzeichen).
Vollstaendig gegen `https://tessera.ctl.de` durchklicken: Erststart-Dialog,
Anmeldung, Tray, Schliessen, Benachrichtigung, Fehler-melden-Knopf (funktioniert
`html-to-image` in der Tauri-WebView?).
4. **Kein automatischer Bau.** `.gitea/workflows/ci.yml` baut nur die
Container. Desktop-Pakete muessten je Freigabe von Hand oder ueber einen
zusaetzlichen Runner gebaut und irgendwo abgelegt werden (Gitea-Release?).
## Solution
Eigene kleine Etappe als `/gsd-quick --validate`, sobald die Baumoeglichkeit
steht. Reihenfolge: (1) Versions-Check richtigstellen und `tauri.conf.json`
auf eine echte Client-Version bringen; (2) Bau auf Windows, Installer testen;
(3) Abnahme gegen tessera.ctl.de mit Protokoll; (4) entscheiden, ob der Bau in
die Pipeline kommt oder als dokumentierter Handgriff je Freigabe bleibt. Die
eine Produktfrage an den User: Wo wird gebaut und getestet (Windows-Rechner,
VM, Runner)? Wenn "im Browser testbar" eine per Browser erreichbare Windows-VM
meint, kann die Abnahme von Claude ueber Playwright MCP / Bildschirm laufen.
+41
View File
@@ -0,0 +1,41 @@
# Änderungen an Tessera
Diese Liste beschreibt in einfachen Worten, was sich von Version zu Version an Tessera geändert hat. Die neueste Version steht oben. Der Abschnitt „Unveröffentlicht“ nennt Änderungen, die bereits in der Beta enthalten, aber noch nicht als Version freigegeben sind.
## Unveröffentlicht
## 1.1.0 – 2026-09-16
### Neu
- Seite „Was ist neu“: Ein Klick auf die Versionsnummer unten in der Seitenleiste zeigt diese Liste. Auf dem Live-System sehen Sie nur freigegebene Versionen, auf der Beta zusätzlich den Abschnitt „Noch nicht freigegeben“.
- Uhr: Unter Einstellungen > Dashboard lässt sich die Schriftgröße der Uhrzeit fest in Punkt (8 bis 200) vorgeben. Lassen Sie das Feld leer, passt sich die Schrift weiterhin automatisch an.
### Geändert
- Dashboard-Raster und Mindestgrößen: Das Raster ist doppelt so fein, Widgets lassen sich in kleineren Schritten verschieben und in der Größe ziehen. Jedes Widget hat jetzt genau die Mindestgröße, bei der es gerade noch bedienbar ist – kleiner geht es nicht, größer jederzeit; das gilt auch für bereits platzierte Widgets. Gespeicherte Anordnungen werden beim ersten Aufruf automatisch übernommen und verrutschen nicht.
- Verschieben: Im Bearbeitungsmodus lässt sich jede Kachel an einer beliebigen Stelle anfassen (außer an Eingabefeldern, Knöpfen und Links); ein grauer Griff am oberen Rand zeigt das an. Kacheln überlappen sich beim Ablegen nicht mehr – über einer belegten Stelle springt die Kachel an ihren Ausgangspunkt zurück.
- Der Bearbeiten-Schalter des Dashboards sitzt jetzt unten rechts; die Widgets beginnen direkt unter der Kopfzeile.
- Uhrzeit, Stoppuhr und Rechner wachsen und schrumpfen mit ihrer Kachel – eine große Uhr-Kachel zeigt eine große Uhrzeit. Die Stoppuhr hat kompaktere Knöpfe und passt so auch in kleine Kacheln.
- Die Ränder sind überall enger: Der äußere Seitenrahmen auf allen Seiten, der Abstand zwischen den Widgets und die Innenabstände der Widgets sind halbiert.
- Das Anwenderhandbuch beschreibt das feine Raster, die mitwachsende Uhrzeit, die Schriftgrößen-Einstellung, den neuen Schalter, das Ziehen und die Mindestgrößen.
### Behoben
- Kalender-Einstellungen: Die Felder des Formulars für Kalenderquellen (Name, Typ, Adresse, Benutzername, Passwort, Domäne, Farbe) und die Knöpfe zeigten technische Schlüsselnamen statt Beschriftungen; ebenso die Rückmeldungen beim Speichern und ein Hinweis im Marktplatz. Alle Texte sind jetzt auf Deutsch und Englisch hinterlegt.
## 1.0.0 – 2026-09-15
### Neu
- Portal mit Kopfleiste und Seitenleiste: Dashboard, Marktplatz und die für Sie freigegebenen Module nach Kategorien mit Suchfeld. Die Seitenleiste lässt sich ein- und ausklappen, das Erscheinungsbild wechselt zwischen Hell, Dunkel und System, die Sprache zwischen Deutsch und Englisch.
- Persönliches Dashboard mit frei anordenbaren Kacheln: Uhr, Suchleiste, Kalender, Notizen, Taschenrechner, Favoriten, Link und Stoppuhr. Im Bearbeitungsmodus fügen Sie Kacheln hinzu, verschieben sie und ziehen ihre Größe; die Einstellungen je Kachel (Kalenderquellen, Suchanbieter, Links) finden Sie unter Einstellungen > Dashboard.
- Marktplatz mit den Zuständen „Aktiviert“ und „Verfügbar“, Suche, Filtern und einer Detailseite je Modul. Administratoren aktivieren ein Modul für das Unternehmen und geben es je Gruppe oder Benutzer frei (Freigaben-Matrix).
- Ausschreibungs-Radar: Trefferliste öffentlicher Ausschreibungen mit Filtern nach Frist, Postleitzahl, Bundesland, Branche und Auftragswert; Suchprofile mit Sofort-Alarm per E-Mail; Sammel-Mail täglich oder wöchentlich; Merken und Gelesen-Markierung; eigene Postfächer und RSS-Feeds als Quellen.
- DKV-Rechnung: Automatische Verarbeitung von DKV-Tankkarten-Rechnungen aus einem Postfach, Fahrzeug-Stammdaten mit CSV-Import, Verarbeitungshistorie und Exportdateien zum Herunterladen.
- Zertifikat-Manager (Zertifikate analysieren, aufteilen, zusammenführen und konvertieren) und Domaincheck (Verfügbarkeit von Internet-Domains prüfen).
- Benutzer-, Gruppen- und Rechteverwaltung: Rollen Benutzer, Admin und Super-Admin; lokale und verzeichnisgeführte Konten; Gruppen mit Standardgruppe; Anbindung an das Active Directory mit Import von Gruppen und Einzelbenutzern, Ausschlussliste und automatischer Synchronisation.
- E-Mail-Versand (SMTP) mit Testnachricht; „Passwort vergessen“ und Zurücksetzen per E-Mail; erzwungene Passwortänderung bei neuen Konten.
- Persönliche Einstellungen: Profilbild, Akzentfarbe und Passwort ändern für lokale Konten.
- Knopf „Fehler melden“ in der Kopfleiste: Bildschirmfoto, Beschreibung und technische Angaben gehen per E-Mail an den Administrator.
- Versionsanzeige unten in der Seitenleiste mit Versionsnummer und Kanal (Live oder Beta).
@@ -579,6 +579,48 @@ describe('DashboardService — Anordnung und Widgets gebunden an forTenant() (26
expect(result).toEqual([]);
});
// --- Durchreichung fuer das feinere Dashboard-Raster (quick-260916-bwo) ---
// Die API kennt weder die Raster-Einheiten noch den Marker; sie reicht das
// `layouts`-JSON (`@IsObject()`) unveraendert durch. Diese beiden Tests sind
// nach heutigem Code bereits gruen — sie PINNEN die Durchreichung, damit eine
// spaetere Bereinigung des JSON die Frontend-Umrechnung nicht unbemerkt
// bricht (fehlt der Marker beim Laden, verdoppelt das Frontend erneut).
it('quick-260916-bwo Test A: der Marker __gridVersion ueberlebt saveLayout -> getLayout unveraendert', async () => {
const prisma = makeFakePrisma({});
const moduleAccessService = makeFakeModuleAccessService(new Set());
const service = new DashboardService(prisma as any, moduleAccessService as any);
const stored = { lg: [{ i: 'w1', x: 0, y: 0, w: 4, h: 4 }], __gridVersion: 2 };
await service.saveLayout('user-1', 'tenant-1', { layouts: stored } as any);
const result = await service.getLayout('user-1', 'tenant-1');
expect(result).toEqual(stored);
expect((result as Record<string, unknown>).__gridVersion).toBe(2);
});
it('quick-260916-bwo Test B: timeFontSizePt wird in die Widget-Konfiguration gemischt, null ueberschreibt, timezone bleibt', async () => {
// Die API prueft Config-Felder nicht (`@IsObject()`); die Grenzen 8..200
// liegen im Frontend (`clock-font-size.ts`), ein Fremdwert faellt dort auf
// "automatisch" zurueck (T-BWO-01).
const widget = makeWidget({ id: 'w1', userId: 'user-1', config: { timezone: 'Europe/Berlin' } });
const prisma = makeFakePrisma({ widgets: [widget] });
const moduleAccessService = makeFakeModuleAccessService(new Set());
const service = new DashboardService(prisma as any, moduleAccessService as any);
const first = await service.updateWidgetConfig('w1', 'user-1', 'tenant-1', {
config: { timeFontSizePt: 36 },
} as any);
expect(first.config).toEqual({ timezone: 'Europe/Berlin', timeFontSizePt: 36 });
const second = await service.updateWidgetConfig('w1', 'user-1', 'tenant-1', {
config: { timeFontSizePt: null },
} as any);
expect((second.config as Record<string, unknown>).timeFontSizePt).toBeNull();
expect((second.config as Record<string, unknown>).timezone).toBe('Europe/Berlin');
});
});
// --- Bindung an forTenant() (260910-krx, Aufgabe 3: Suchmaschinen) ---------
+3
View File
@@ -22,6 +22,9 @@ COPY --from=deps /app/ ./
COPY apps/web/ ./apps/web/
COPY packages/shared/ ./packages/shared/
COPY tsconfig.base.json ./
# quick-260916-dcz: next.config.ts liest CHANGELOG.md zur Bauzeit (Seite "Was ist neu");
# .dockerignore schliesst *.md aus und macht fuer genau diese Datei eine Ausnahme.
COPY CHANGELOG.md ./
ENV NEXT_PUBLIC_API_URL=/api-proxy
# Muss VOR dem Build stehen: Next.js bettet NEXT_PUBLIC_* zur Bauzeit ins Bundle ein.
# So spaet wie moeglich, damit die COPY-Schichten darueber im Cache bleiben.
+26
View File
@@ -1,10 +1,36 @@
import { readFileSync } from 'node:fs';
import path from 'node:path';
import type { NextConfig } from 'next';
import createNextIntlPlugin from 'next-intl/plugin';
// Bauzeit-Einbettung der Aenderungsliste (quick-260916-dcz): CHANGELOG.md aus
// dem Wurzelverzeichnis wird hier gelesen und als `env.TESSERA_CHANGELOG_MD`
// abgelegt. Next.js ersetzt `process.env.TESSERA_CHANGELOG_MD` fuer webpack UND
// Turbopack ueber denselben Define-Mechanismus. Der Text bleibt nur im
// Server-Bundle, weil ausschliesslich die Server-Seite (changelog/page.tsx)
// `@/lib/changelog` importiert — Importdisziplin, kein Client-Chunk.
const withNextIntl = createNextIntlPlugin('./src/i18n/request.ts');
function readChangelog(): string {
const file = path.resolve(__dirname, '../../CHANGELOG.md');
try {
return readFileSync(file, 'utf8');
} catch (error) {
const reason = error instanceof Error ? error.message : String(error);
throw new Error(
`CHANGELOG.md konnte nicht gelesen werden (${file}): ${reason}. ` +
'Die Datei muss im Wurzelverzeichnis liegen; im Docker-Bau braucht sie die Ausnahme ' +
'`!CHANGELOG.md` in .dockerignore und die Zeile `COPY CHANGELOG.md ./` in apps/web/Dockerfile.',
);
}
}
const nextConfig: NextConfig = {
output: 'standalone' as const,
env: {
TESSERA_CHANGELOG_MD: readChangelog(),
},
async rewrites() {
const apiUrl = process.env.API_INTERNAL_URL || 'http://api:3001';
return [
@@ -0,0 +1,120 @@
import { cleanup, render, screen } from '@testing-library/react';
import { afterEach, describe, expect, it, vi } from 'vitest';
/**
* changelog-page.test — Seite "Was ist neu" unter /changelog (quick-260916-dcz).
*
* Die Seite ist eine async Server-Komponente (Vorbild module-access-gate.test:
* Funktion awaiten, Ergebnis rendern). `next-intl/server` bekommt eine
* Handtabelle, `@/lib/app-version` einen veraenderbaren Kanal, `@/lib/changelog`
* wird je Test per `vi.doMock` mit `importOriginal` (echte Filterfunktion,
* eigener `changelogMarkdown`) bereitgestellt, `@uiw/react-md-editor` als
* Modul mit `default.Markdown`, das die Quelle roh in ein <pre> schreibt.
*/
vi.mock('next-intl/server', () => ({
getTranslations: async () => (key: string) => {
const translations: Record<string, string> = {
title: 'Was ist neu',
intro: 'Alle Änderungen an Tessera, sortiert nach Version – die aktuelle Version steht oben.',
unreleasedHeading: 'Noch nicht freigegeben (Beta)',
unreleasedHint:
'Die Punkte unter „Noch nicht freigegeben“ sind in dieser Beta bereits enthalten, aber noch nicht als Version freigegeben.',
empty: 'Noch keine Einträge vorhanden.',
};
return translations[key] ?? key;
},
}));
let mockChannel: 'beta' | 'live' | 'dev' = 'live';
vi.mock('@/lib/app-version', () => ({
get appVersion() {
return { version: 'v1.2.3', channel: mockChannel, commit: 'abc1234' };
},
}));
vi.mock('@uiw/react-md-editor', () => ({
default: {
Markdown: ({ source }: { source?: string }) => <pre data-testid="md">{source}</pre>,
},
}));
vi.mock('next-themes', () => ({
useTheme: () => ({ resolvedTheme: 'light' }),
}));
const SAMPLE = [
'# Änderungen an Tessera',
'',
'Vorspann.',
'',
'## Unveröffentlicht',
'',
'### Neu',
'',
'- Punkt U1',
'',
'## 1.0.0 – 2026-09-15',
'',
'### Neu',
'',
'- Punkt A',
'',
].join('\n');
function mockChangelog(markdown: string) {
vi.doMock('@/lib/changelog', async (importOriginal) => {
const original = await importOriginal<typeof import('@/lib/changelog')>();
return { ...original, changelogMarkdown: markdown };
});
}
async function renderPage() {
const { default: ChangelogPage } = await import('./page');
const element = await ChangelogPage();
render(element);
}
afterEach(() => {
cleanup();
vi.resetModules();
vi.doUnmock('@/lib/changelog');
mockChannel = 'live';
});
describe('ChangelogPage /changelog (quick-260916-dcz)', () => {
it('Test 1 (live): Titel sichtbar, kein Hinweis, Markdown ohne Unveröffentlicht', async () => {
mockChannel = 'live';
mockChangelog(SAMPLE);
await renderPage();
expect(screen.getByRole('heading', { level: 1 })).toHaveTextContent('Was ist neu');
expect(screen.queryByTestId('changelog-unreleased-hint')).not.toBeInTheDocument();
const md = screen.getByTestId('md').textContent ?? '';
expect(md).toContain('1.0.0');
expect(md).not.toContain('Unveröffentlicht');
expect(md).not.toContain('Noch nicht freigegeben');
});
it('Test 2 (beta): Hinweis vorhanden, Markdown traegt "Noch nicht freigegeben (Beta)"', async () => {
mockChannel = 'beta';
mockChangelog(SAMPLE);
await renderPage();
expect(screen.getByTestId('changelog-unreleased-hint')).toHaveTextContent(
'Die Punkte unter „Noch nicht freigegeben“ sind in dieser Beta bereits enthalten, aber noch nicht als Version freigegeben.',
);
const md = screen.getByTestId('md').textContent ?? '';
expect(md).toContain('Noch nicht freigegeben (Beta)');
expect(md).toContain('- Punkt U1');
});
it('Test 3 (leer): ohne Text erscheint der Leer-Hinweis und kein Markdown-Element', async () => {
mockChannel = 'beta';
mockChangelog('');
await renderPage();
expect(screen.getByTestId('changelog-empty')).toHaveTextContent('Noch keine Einträge vorhanden.');
expect(screen.queryByTestId('md')).not.toBeInTheDocument();
});
});
@@ -0,0 +1,47 @@
import { getTranslations } from 'next-intl/server';
import { ChangelogView } from '@/components/changelog/changelog-view';
import { appVersion } from '@/lib/app-version';
import { changelogMarkdown, filterChangelogForChannel } from '@/lib/changelog';
/**
* Seite "Was ist neu" unter /changelog (quick-260916-dcz).
*
* Async Server-Komponente ohne 'use client' (Vorbild module-access-gate.tsx):
* der Text stammt aus der Bauzeit-Variable `TESSERA_CHANGELOG_MD`
* (next.config.ts liest CHANGELOG.md) und bleibt so im Server-Bundle. Die
* Kanalregel liegt in `filterChangelogForChannel`: auf Live fehlt der
* Abschnitt "Unveröffentlicht", auf Beta/Entwicklung erscheint er als "Noch
* nicht freigegeben (Beta)" samt Hinweis. Zugriff nur angemeldet — die
* bestehende middleware.ts schuetzt jede Route ausser /login und
* /reset-password; /changelog ist keine oeffentliche Route.
*/
export default async function ChangelogPage() {
const t = await getTranslations('changelog');
const { markdown, hasUnreleased } = filterChangelogForChannel(changelogMarkdown, appVersion.channel, {
unreleasedHeading: t('unreleasedHeading'),
});
return (
<div className="mx-auto max-w-3xl py-8 px-4">
<h1 className="text-2xl font-bold text-foreground mb-2">{t('title')}</h1>
<p className="text-sm text-muted-foreground mb-6">{t('intro')}</p>
{hasUnreleased && (
<div
data-testid="changelog-unreleased-hint"
className="rounded-md bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 px-4 py-3 text-sm text-yellow-800 dark:text-yellow-200 mb-6"
>
{t('unreleasedHint')}
</div>
)}
{markdown.trim() === '' ? (
<p data-testid="changelog-empty" className="text-sm text-muted-foreground">
{t('empty')}
</p>
) : (
<ChangelogView markdown={markdown} />
)}
</div>
);
}
+118
View File
@@ -0,0 +1,118 @@
import { cleanup, fireEvent, render, screen } from '@testing-library/react';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
// quick-260916-dyv: Dashboard-Seite — feste Aktionsleiste unten rechts
// (Stift/Haekchen + "Widget hinzufuegen"), Grid direkt im Container p-2,
// kein Abstands-Wrapper (mt-8) und kein Block oben rechts (top-2) mehr.
// Muster: admin/groups/groups-page.test.tsx (next-intl-Mock mit Namensraum).
const messages: Record<string, Record<string, string>> = {
widgets: {
editMode: 'Dashboard bearbeiten',
saveChanges: 'Änderungen speichern',
addWidget: 'Widget hinzufügen',
layoutLoadError: 'Dashboard konnte nicht geladen werden. Bitte laden Sie die Seite neu.',
},
};
vi.mock('next-intl', () => ({
useTranslations: (ns: string) => (key: string) => messages[ns]?.[key] ?? key,
}));
const mockStore = {
layouts: { lg: [], md: [], sm: [], xs: [], xxs: [] },
widgets: [] as Array<{ id: string; widgetType: string; config: Record<string, unknown> }>,
isEditMode: false,
isDirty: false,
isLoading: false,
error: null as string | null,
setEditMode: vi.fn(),
updateLayouts: vi.fn(),
addWidget: vi.fn(),
removeWidget: vi.fn(),
loadDashboard: vi.fn(),
saveLayout: vi.fn(),
};
vi.mock('@/lib/stores/dashboard-store', () => ({
useDashboardStore: (selector?: (state: typeof mockStore) => unknown) => {
if (selector) return selector(mockStore);
return mockStore;
},
}));
vi.mock('@/components/dashboard/dashboard-grid', () => ({
DashboardGrid: (p: { isEditMode: boolean }) => (
<div data-testid="dashboard-grid" data-edit={String(p.isEditMode)} />
),
}));
vi.mock('@/components/dashboard/widget-catalog-modal', () => ({
WidgetCatalogModal: () => null,
}));
vi.mock('@/components/dashboard/widgets/clock-widget', () => ({ ClockWidget: () => null }));
vi.mock('@/components/dashboard/widgets/search-widget', () => ({ SearchWidget: () => null }));
vi.mock('@/components/dashboard/widgets/calendar-widget', () => ({ CalendarWidget: () => null }));
vi.mock('@/components/dashboard/widgets/note-widget', () => ({ NoteWidget: () => null }));
vi.mock('@/components/dashboard/widgets/calculator-widget', () => ({ CalculatorWidget: () => null }));
vi.mock('@/components/dashboard/widgets/stopwatch-widget', () => ({ StopwatchWidget: () => null }));
vi.mock('@/components/dashboard/widgets/favorites-widget', () => ({ FavoritesWidget: () => null }));
vi.mock('@/components/dashboard/widgets/link-widget', () => ({ LinkWidget: () => null }));
beforeEach(() => {
mockStore.isEditMode = false;
mockStore.isLoading = false;
mockStore.error = null;
mockStore.setEditMode = vi.fn();
mockStore.loadDashboard = vi.fn();
});
afterEach(() => {
cleanup();
});
describe('DashboardPage (quick-260916-dyv)', () => {
it('Test 1: Ansichtsmodus — Stift in fester Leiste unten rechts, kein "Widget hinzufuegen", kein mt-8/top-2, Grid direkt im Container p-2', async () => {
const { default: DashboardPage } = await import('./page');
render(<DashboardPage />);
const toggle = screen.getByRole('button', { name: 'Dashboard bearbeiten' });
const bar = toggle.parentElement as HTMLElement;
expect(bar.classList.contains('fixed')).toBe(true);
expect(bar.classList.contains('bottom-6')).toBe(true);
expect(bar.classList.contains('right-6')).toBe(true);
expect(bar.classList.contains('z-20')).toBe(true);
expect(screen.queryByRole('button', { name: 'Widget hinzufügen' })).toBeNull();
expect(document.querySelector('.mt-8')).toBeNull();
expect(document.querySelector('.top-2')).toBeNull();
const grid = screen.getByTestId('dashboard-grid');
expect((grid.parentElement as HTMLElement).classList.contains('p-2')).toBe(true);
expect(grid.getAttribute('data-edit')).toBe('false');
});
it('Test 2: Bearbeitungsmodus — "Widget hinzufuegen" links neben dem Haekchen in derselben Leiste, Grid im Bearbeitungsmodus', async () => {
mockStore.isEditMode = true;
const { default: DashboardPage } = await import('./page');
render(<DashboardPage />);
const toggle = screen.getByRole('button', { name: 'Änderungen speichern' });
const add = screen.getByRole('button', { name: 'Widget hinzufügen' });
expect(add.parentElement).toBe(toggle.parentElement);
// "Widget hinzufuegen" steht im DOM VOR dem Umschalter (links daneben).
expect(add.compareDocumentPosition(toggle) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
expect(screen.getByTestId('dashboard-grid').getAttribute('data-edit')).toBe('true');
});
it('Test 3: Umschalten — Klick auf "Dashboard bearbeiten" ruft setEditMode(true) genau einmal', async () => {
const { default: DashboardPage } = await import('./page');
render(<DashboardPage />);
fireEvent.click(screen.getByRole('button', { name: 'Dashboard bearbeiten' }));
expect(mockStore.setEditMode).toHaveBeenCalledTimes(1);
expect(mockStore.setEditMode).toHaveBeenCalledWith(true);
});
});
+21 -24
View File
@@ -66,29 +66,22 @@ export default function DashboardPage() {
}
return (
<div className="relative p-4">
{/* Edit mode toggle — top right */}
<div className="absolute right-4 top-4 z-10">
<EditModeToggle
isEditMode={isEditMode}
onToggle={() => setEditMode(!isEditMode)}
/>
</div>
<div className="relative p-2">
{/* Dashboard grid — direkt im Container, ohne Abstands-Wrapper. */}
<DashboardGrid
layouts={layouts}
widgets={widgets}
isEditMode={isEditMode}
onLayoutChange={updateLayouts}
onRemoveWidget={removeWidget}
/>
{/* Dashboard grid */}
<div className="mt-8">
<DashboardGrid
layouts={layouts}
widgets={widgets}
isEditMode={isEditMode}
onLayoutChange={updateLayouts}
onRemoveWidget={removeWidget}
/>
</div>
{/* Add widget button (edit mode only) */}
{isEditMode && (
<div className="fixed bottom-6 right-6 z-20">
{/* Feste Aktionsleiste unten rechts.
quick-260916-dyv: Umschalter unten rechts statt oben rechts, damit das
Grid direkt unter der Kopfzeile beginnt (12 + 8 + 8 = 28 px statt 60 px).
Im Bearbeitungsmodus steht "Widget hinzufuegen" links neben dem Haekchen. */}
<div className="fixed bottom-6 right-6 z-20 flex items-center gap-2">
{isEditMode && (
<button
onClick={() => setCatalogOpen(true)}
className="flex items-center gap-2 rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground shadow-lg hover:opacity-90 transition-opacity"
@@ -109,8 +102,12 @@ export default function DashboardPage() {
</svg>
{t('addWidget')}
</button>
</div>
)}
)}
<EditModeToggle
isEditMode={isEditMode}
onToggle={() => setEditMode(!isEditMode)}
/>
</div>
{/* Widget catalog modal */}
<WidgetCatalogModal
@@ -0,0 +1,39 @@
'use client';
import { useEffect, useState } from 'react';
import MDEditor from '@uiw/react-md-editor';
import rehypeSanitize from 'rehype-sanitize';
import { useTheme } from 'next-themes';
/**
* Gerenderte Aenderungsliste fuer die Seite "Was ist neu" (quick-260916-dcz).
*
* Nutzt `MDEditor.Markdown` aus dem bereits installierten `@uiw/react-md-editor`
* (wie die Vorschau des Notiz-Widgets) mit `rehype-sanitize` — kein neues
* Paket, kein dangerouslySetInnerHTML. Der Farbmodus folgt `next-themes`
* erst nach dem Mount (vorher 'light'), damit Server- und Client-Markup
* uebereinstimmen (mounted-Guard wie in AppShell). Der Markdown-Text kommt
* als Prop von der Server-Seite; dieses Modul importiert `@/lib/changelog`
* bewusst NICHT, damit der Text nicht in Client-Chunks landet.
*/
export function ChangelogView({ markdown }: { markdown: string }) {
const { resolvedTheme } = useTheme();
const [mounted, setMounted] = useState(false);
useEffect(() => {
setMounted(true);
}, []);
const mode: 'light' | 'dark' = mounted && resolvedTheme === 'dark' ? 'dark' : 'light';
return (
<div data-testid="changelog-markdown" className="rounded-md border border-border bg-card p-4">
<MDEditor.Markdown
source={markdown}
rehypePlugins={[[rehypeSanitize]]}
wrapperElement={{ 'data-color-mode': mode }}
style={{ background: 'transparent' }}
/>
</div>
);
}
@@ -1,3 +1,4 @@
import { Children, isValidElement } from 'react';
import { cleanup, render, screen } from '@testing-library/react';
import { afterEach, describe, expect, it, vi } from 'vitest';
@@ -15,6 +16,7 @@ vi.mock('next-intl', () => ({
addWidget: 'Add widget',
catalogTitle: 'Add widget',
deleteTooltip: 'Remove widget',
dragHint: 'Drag the tile to move it',
'clock.name': 'Clock',
'clock.description': 'Shows the current time',
'search.name': 'Search',
@@ -34,14 +36,18 @@ vi.mock('next-intl', () => ({
},
}));
// Mock react-grid-layout Responsive to a simple passthrough for jsdom stability
vi.mock('react-grid-layout', () => ({
Responsive: ({
children,
}: {
children: React.ReactNode;
}) => <div data-testid="responsive-grid">{children}</div>,
noCompactor: () => null,
// Mock react-grid-layout Responsive to a simple passthrough for jsdom stability.
// quick-260916-bwo: der Mock faengt zusaetzlich die Props ein, damit die
// Raster-Konstanten (cols, rowHeight, margin, breakpoints) pruefbar sind.
// quick-260916-dyv: Mock per importOriginal, damit `noCompactor` das echte
// Objekt ist (Test 7 prueft compact als Identitaets-Kopie), nur Responsive ersetzt.
const captured = vi.hoisted(() => ({ props: null as Record<string, unknown> | null }));
vi.mock('react-grid-layout', async (importOriginal) => ({
...(await importOriginal<typeof import('react-grid-layout')>()),
Responsive: (props: Record<string, unknown> & { children: React.ReactNode }) => {
captured.props = props;
return <div data-testid="responsive-grid">{props.children}</div>;
},
}));
// Mock dashboard-api
@@ -153,4 +159,232 @@ describe('DashboardGrid', () => {
expect(screen.getByLabelText('Remove widget')).toBeInTheDocument();
expect(document.querySelector('.widget-drag-handle')).toBeInTheDocument();
});
it('quick-260916-bwo Test 4: Grid-Props — 24/20/12/8/2 Spalten, rowHeight 20, margin 8, Breakpoints unveraendert, containerPadding folgt dem margin', async () => {
captured.props = null;
const { DashboardGrid } = await import('./dashboard-grid');
render(
<DashboardGrid
layouts={{ lg: [{ i: 'inst-1', x: 0, y: 0, w: 4, h: 4 }], md: [], sm: [], xs: [], xxs: [] }}
widgets={[{ id: 'inst-1', widgetType: 'clock', config: {} }]}
isEditMode={false}
onLayoutChange={vi.fn()}
onRemoveWidget={vi.fn()}
/>,
);
expect(captured.props).not.toBeNull();
expect(captured.props?.cols).toEqual({ lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 });
expect(captured.props?.rowHeight).toBe(20);
expect(captured.props?.margin).toEqual([8, 8]);
expect(captured.props?.breakpoints).toEqual({ lg: 1200, md: 996, sm: 768, xs: 480, xxs: 0 });
expect(captured.props?.containerPadding).toBeUndefined();
});
it('quick-260916-bwo Test 5: Widget ohne gespeicherten Eintrag bekommt die Vorgaben und die inhaltsgetriebenen Minima als data-grid', async () => {
captured.props = null;
const { DashboardGrid } = await import('./dashboard-grid');
render(
<DashboardGrid
layouts={{ lg: [], md: [], sm: [], xs: [], xxs: [] }}
widgets={[{ id: 'inst-3', widgetType: 'clock', config: {} }]}
isEditMode={false}
onLayoutChange={vi.fn()}
onRemoveWidget={vi.fn()}
/>,
);
const children = Children.toArray(captured.props?.children as React.ReactNode);
expect(children).toHaveLength(1);
const first = children[0];
expect(isValidElement(first)).toBe(true);
const props = (first as React.ReactElement<Record<string, unknown>>).props;
// quick-260916-dyv: Uhr-Minimum 2x2 (vorher verdoppelt 4x4), Vorgabe 4x4 unveraendert.
expect(props['data-grid']).toEqual({ x: 0, y: 0, w: 4, h: 4, minW: 2, minH: 2 });
});
it('quick-260916-dyv Test 9: gespeicherte minW/minH werden in JEDEM Breakpoint aus WIDGET_CONSTRAINTS ueberschrieben, x/y/w/h bleiben, unbekannte Typen und Schluessel unveraendert', async () => {
captured.props = null;
const { DashboardGrid } = await import('./dashboard-grid');
const layouts = {
lg: [
{ i: 'inst-1', x: 2, y: 4, w: 6, h: 6, minW: 8, minH: 8 },
{ i: 'inst-x', x: 10, y: 0, w: 5, h: 5, minW: 7, minH: 7 },
],
md: [{ i: 'inst-1', x: 0, y: 0, w: 4, h: 4, minW: 4, minH: 4 }],
sm: [],
xs: [],
xxs: [],
};
render(
<DashboardGrid
layouts={layouts}
widgets={[
{ id: 'inst-1', widgetType: 'clock', config: {} },
{ id: 'inst-x', widgetType: 'unknown', config: {} },
]}
isEditMode={false}
onLayoutChange={vi.fn()}
onRemoveWidget={vi.fn()}
/>,
);
const passed = captured.props?.layouts as Record<string, Array<Record<string, unknown>>>;
expect(Object.keys(passed)).toEqual(Object.keys(layouts));
expect(passed.lg[0]).toEqual({ i: 'inst-1', x: 2, y: 4, w: 6, h: 6, minW: 2, minH: 2 });
expect(passed.md[0]).toEqual({ i: 'inst-1', x: 0, y: 0, w: 4, h: 4, minW: 2, minH: 2 });
expect(passed.md[0].minW).toBe(2);
// Unbekannter Typ: Eintrag bleibt woertlich erhalten (kein Absturz, T-DYV-01).
expect(passed.lg[1]).toEqual({ i: 'inst-x', x: 10, y: 0, w: 5, h: 5, minW: 7, minH: 7 });
expect(passed.sm).toEqual([]);
});
it('quick-260916-dyv Test 9b: gespeicherte Groesse unter dem neuen Minimum wird auf das Minimum angehoben (Rechner h 8 -> 10, w bleibt wenn >= minW)', async () => {
captured.props = null;
const { DashboardGrid } = await import('./dashboard-grid');
const layouts = {
lg: [
// Rechner: gespeichert mit h 8 (bwo-Minimum), neues Minimum 3x9 -> h wird 9, w 6 bleibt.
{ i: 'calc-1', x: 0, y: 0, w: 6, h: 8, minW: 4, minH: 8 },
// Suche: gespeichert mit w 4 (unter minW 6) -> w wird 6, h 4 bleibt.
{ i: 'srch-1', x: 6, y: 0, w: 4, h: 4, minW: 6, minH: 4 },
],
md: [{ i: 'calc-1', x: 0, y: 0, w: 3, h: 7, minW: 4, minH: 8 }],
sm: [],
xs: [],
xxs: [],
};
render(
<DashboardGrid
layouts={layouts}
widgets={[
{ id: 'calc-1', widgetType: 'calculator', config: {} },
{ id: 'srch-1', widgetType: 'search', config: {} },
]}
isEditMode={false}
onLayoutChange={vi.fn()}
onRemoveWidget={vi.fn()}
/>,
);
const passed = captured.props?.layouts as Record<string, Array<Record<string, unknown>>>;
expect(passed.lg[0]).toEqual({ i: 'calc-1', x: 0, y: 0, w: 6, h: 10, minW: 3, minH: 10 });
expect(passed.lg[1]).toEqual({ i: 'srch-1', x: 6, y: 0, w: 6, h: 4, minW: 6, minH: 2 });
// Jeder Breakpoint: md-Rechner 3x7 -> 3x10 (w schon = minW, h angehoben).
expect(passed.md[0]).toEqual({ i: 'calc-1', x: 0, y: 0, w: 3, h: 10, minW: 3, minH: 10 });
// Eingabe unveraendert (keine Mutation des Store-Objekts).
expect(layouts.lg[0].h).toBe(8);
expect(layouts.lg[0].minH).toBe(8);
});
const CANCEL = 'input, textarea, select, button, a, [contenteditable], [data-no-drag], .widgetNoDrag';
it('quick-260916-dyv Test 6: dragConfig-Pin — handle Karte, cancel fuer Interaktives, threshold 3; resizeConfig folgt dem Bearbeitungsmodus', async () => {
const { DashboardGrid } = await import('./dashboard-grid');
const widgets = [{ id: 'inst-2', widgetType: 'clock', config: {} }];
const layouts = { lg: [{ i: 'inst-2', x: 0, y: 0, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [] };
captured.props = null;
render(
<DashboardGrid layouts={layouts} widgets={widgets} isEditMode={true} onLayoutChange={vi.fn()} onRemoveWidget={vi.fn()} />,
);
expect(captured.props?.dragConfig).toEqual({
enabled: true,
handle: '.widget-drag-handle',
cancel: CANCEL,
threshold: 3,
});
expect(captured.props?.resizeConfig).toEqual({ enabled: true });
cleanup();
captured.props = null;
render(
<DashboardGrid layouts={layouts} widgets={widgets} isEditMode={false} onLayoutChange={vi.fn()} onRemoveWidget={vi.fn()} />,
);
expect(captured.props?.dragConfig).toEqual({
enabled: false,
handle: '.widget-drag-handle',
cancel: CANCEL,
threshold: 3,
});
expect(captured.props?.resizeConfig).toEqual({ enabled: false });
});
it('quick-260916-dyv Test 7: Compactor-Pin — echter noCompactor plus preventCollision: true, compact ist Identitaets-Kopie (freie Platzierung)', async () => {
captured.props = null;
const { DashboardGrid } = await import('./dashboard-grid');
render(
<DashboardGrid
layouts={{ lg: [{ i: 'inst-2', x: 0, y: 0, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [] }}
widgets={[{ id: 'inst-2', widgetType: 'clock', config: {} }]}
isEditMode={true}
onLayoutChange={vi.fn()}
onRemoveWidget={vi.fn()}
/>,
);
const compactor = captured.props?.compactor as {
type: unknown;
allowOverlap: boolean;
preventCollision?: boolean;
compact: (layout: Array<Record<string, unknown>>, cols: number) => Array<Record<string, unknown>>;
};
expect(compactor).toMatchObject({ type: null, allowOverlap: false, preventCollision: true });
expect(typeof compactor.compact).toBe('function');
const input = [{ i: 'a', x: 0, y: 0, w: 2, h: 2 }];
const out = compactor.compact(input, 24);
// Gemessen (RGL 2.2.3): noCompactor.compact = cloneLayout -> cloneLayoutItem
// kopiert i/x/y/w/h unveraendert und normalisiert moved/static zu false
// (minW/maxW/... als undefined). Keine Verschiebung, keine Kompaktierung.
expect(out).toHaveLength(1);
expect(out[0]).toMatchObject({ i: 'a', x: 0, y: 0, w: 2, h: 2, moved: false, static: false });
expect(out).not.toBe(input);
expect(out[0]).not.toBe(input[0]);
expect(input[0]).toEqual({ i: 'a', x: 0, y: 0, w: 2, h: 2 });
});
it('quick-260916-dyv Test 8: cancel/handle-Semantik im DOM — Karte ist Griff, Loesch-Knopf/Eingaben/widgetNoDrag passen auf cancel, Kopfleiste als Overlay nur im Bearbeitungsmodus', async () => {
const mod = await import('./dashboard-grid');
const { DashboardGrid, WIDGET_DRAG_HANDLE_SELECTOR, WIDGET_DRAG_CANCEL_SELECTOR } = mod;
expect(WIDGET_DRAG_HANDLE_SELECTOR).toBe('.widget-drag-handle');
expect(WIDGET_DRAG_CANCEL_SELECTOR).toBe(CANCEL);
const widgets = [{ id: 'inst-2', widgetType: 'clock', config: {} }];
const layouts = { lg: [{ i: 'inst-2', x: 0, y: 0, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [] };
render(
<DashboardGrid layouts={layouts} widgets={widgets} isEditMode={true} onLayoutChange={vi.fn()} onRemoveWidget={vi.fn()} />,
);
const card = document.querySelector('[data-widget-id="inst-2"]') as HTMLElement;
expect(card).not.toBeNull();
expect(card.matches(WIDGET_DRAG_HANDLE_SELECTOR)).toBe(true);
// Die Karte selbst darf NICHT auf cancel passen, sonst zieht nichts mehr.
expect(card.closest(WIDGET_DRAG_CANCEL_SELECTOR)).toBeNull();
const button = screen.getByLabelText('Remove widget');
expect(button.closest(WIDGET_DRAG_CANCEL_SELECTOR)).toBe(button);
expect(button.hasAttribute('data-no-drag')).toBe(true);
const input = document.createElement('input');
card.appendChild(input);
expect(input.closest(WIDGET_DRAG_CANCEL_SELECTOR)).toBe(input);
const noDrag = document.createElement('div');
noDrag.className = 'widgetNoDrag';
card.appendChild(noDrag);
expect(noDrag.closest(WIDGET_DRAG_CANCEL_SELECTOR)).toBe(noDrag);
const head = screen.getByTitle('Drag the tile to move it');
expect(card.contains(head)).toBe(true);
expect(head.classList.contains('absolute')).toBe(true);
expect(head.classList.contains('h-5')).toBe(true);
cleanup();
render(
<DashboardGrid layouts={layouts} widgets={widgets} isEditMode={false} onLayoutChange={vi.fn()} onRemoveWidget={vi.fn()} />,
);
expect(screen.queryByTitle('Drag the tile to move it')).toBeNull();
expect(document.querySelector('.widget-drag-handle')).toBeNull();
});
});
@@ -1,8 +1,8 @@
'use client';
import { useEffect, useRef, useState } from 'react';
import { useEffect, useMemo, useRef, useState } from 'react';
import { Responsive, noCompactor } from 'react-grid-layout';
import type { ResponsiveLayouts } from 'react-grid-layout';
import type { Compactor, ResponsiveLayouts } from 'react-grid-layout';
import 'react-grid-layout/css/styles.css';
import 'react-resizable/css/styles.css';
import { useTranslations } from 'next-intl';
@@ -10,17 +10,106 @@ import { WIDGET_CONSTRAINTS, type WidgetType } from './widget-registry';
import { WidgetWrapper } from './widgets/widget-wrapper';
import { TesseraLogo } from '@/components/brand/tessera-logo';
// quick-260916-bwo: Raster doppelt so fein wie zuvor (24 statt 12 Spalten,
// 20 statt 40 px Zeilenhoehe, 8 statt 16 px Abstand). Gespeicherte Anordnungen
// in alten Einheiten werden in `@/lib/grid-layout-migration` einmalig
// umgerechnet und mit `__gridVersion: 2` markiert. BREAKPOINTS unveraendert.
const BREAKPOINTS = { lg: 1200, md: 996, sm: 768, xs: 480, xxs: 0 };
const COLS = { lg: 12, md: 10, sm: 6, xs: 4, xxs: 1 };
const COLS = { lg: 24, md: 20, sm: 12, xs: 8, xxs: 2 };
// quick-260916-dyv: Ziehen zuverlaessig.
// - Griff ist die GANZE Karte (`widget-drag-handle` in widget-wrapper.tsx).
// - `cancel` verhindert den Drag-Start an Eingabefeldern, Knoepfen, Links,
// [contenteditable], [data-no-drag] und der Klasse `widgetNoDrag` (Favoriten/
// Link-Widget, bisher nirgends verdrahtet). react-draggable 4.7.0 prueft
// `cancel` NACH `handle` und vom Ereignisziel aufwaerts bis zum RGL-Element
// (Draggable.js:417 + matchesSelectorAndParentsTo) — cancel gewinnt also auch
// INNERHALB des Griffs. RGL haengt `.react-resizable-handle` selbst voran
// (chunk-WGL5FSZH.mjs:526), der Groessen-Griff funktioniert weiter.
// - `threshold: 3` = RGL-Standard (Klick vs. Ziehen).
export const WIDGET_DRAG_HANDLE_SELECTOR = '.widget-drag-handle';
export const WIDGET_DRAG_CANCEL_SELECTOR =
'input, textarea, select, button, a, [contenteditable], [data-no-drag], .widgetNoDrag';
// quick-260916-dyv: Kein Ueberlappen beim Ablegen, freie Platzierung bleibt.
// `noCompactor` (Commit c8f3361, "prevent auto-compaction on drag") ist gewollt:
// Luecken werden nicht geschlossen. OHNE `preventCollision` springt beim Ziehen
// auf ein belegtes Feld das gezogene Widget auf die Zeile des getroffenen und
// das getroffene rutscht um seine EIGENE Hoehe nach unten — ohne Kaskade und
// ohne Aufloesung, Ueberlappungen bleiben, weil `noCompactor.compact` die
// Identitaet ist (gemessen chunk-76RTO6EO.mjs:279-328); beim Vergroessern in
// einen Nachbarn entsteht die Ueberlappung stumm (chunk-WGL5FSZH.mjs:872-885).
// MIT `preventCollision: true` bleibt das gezogene Widget am Ausgangsort
// (`l.x = oldX; l.y = oldY`), und Vergroessern stoppt am Nachbarn.
// `preventCollision` lebt am Compactor-Objekt (chunk-WGL5FSZH.mjs:666).
export const FREE_PLACEMENT_COMPACTOR: Compactor = { ...noCompactor, preventCollision: true };
interface LayoutItemShape {
i: string;
x: number;
y: number;
w: number;
h: number;
minW?: number;
minH?: number;
}
interface DashboardGridProps {
layouts: Record<string, Array<{ i: string; x: number; y: number; w: number; h: number }>>;
layouts: Record<string, Array<LayoutItemShape>>;
widgets: Array<{ id: string; widgetType: string; config: Record<string, unknown> }>;
isEditMode: boolean;
onLayoutChange: (allLayouts: ResponsiveLayouts) => void;
onRemoveWidget: (id: string) => void;
}
/**
* quick-260916-dyv: Gespeicherte minW/minH aus den Konstanten ueberschreiben.
*
* Warum: react-grid-layout 2.2.3 nimmt in `synchronizeLayoutWithChildren`
* (chunk-WGL5FSZH.mjs:559-562) fuer jedes Kind MIT Eintrag im `layout` den
* Eintrag per `cloneLayoutItem` woertlich — inklusive minW/minH — und liest
* `data-grid` nur fuer Kinder OHNE Eintrag. Gespeicherte Anordnungen tragen
* minW/minH (RGL liefert sie in `onLayoutChange`, 260916-bwo hat sie verdoppelt
* persistiert). Eine Aenderung von WIDGET_CONSTRAINTS allein aendert fuer
* bestehende Widgets also NICHTS. Deshalb: in JEDEM Breakpoint minW/minH jedes
* Eintrags eines bekannten Typs aus der Tabelle setzen; die Konstanten sind
* die einzige Quelle (T-DYV-01: manipulierte Minima wirken nicht).
*
* Liegt die gespeicherte Groesse UNTER dem neuen Minimum (z. B. Rechner mit
* h 8, neues minH 10), wird w/h auf das Minimum angehoben: RGL selbst klemmt
* w/h nur beim Vergroessern/Verkleinern (`minMaxSize.constrainSize`,
* chunk-KDANGDDL.mjs:26-31; `minConstraints` an `Resizable`,
* chunk-WGL5FSZH.mjs:472-475), rendert die zu kleine Kachel aber woertlich —
* der Rechner bliebe bis zum ersten Anfassen unten abgeschnitten.
* Unbekannte Typen bleiben unveraendert; das Eingabeobjekt wird nicht mutiert.
*/
function applyConstraintMinima(
layouts: Record<string, Array<LayoutItemShape>>,
widgets: Array<{ id: string; widgetType: string }>,
): Record<string, Array<LayoutItemShape>> {
const typeById = new Map<string, string>();
for (const w of widgets) typeById.set(w.id, w.widgetType);
const result: Record<string, Array<LayoutItemShape>> = {};
for (const key of Object.keys(layouts)) {
const entries = layouts[key];
if (!Array.isArray(entries)) continue;
result[key] = entries.map((entry) => {
const type = typeById.get(entry.i);
const constraints = type ? WIDGET_CONSTRAINTS[type as WidgetType] : undefined;
if (!constraints) return { ...entry };
return {
...entry,
w: Math.max(entry.w, constraints.minW),
h: Math.max(entry.h, constraints.minH),
minW: constraints.minW,
minH: constraints.minH,
};
});
}
return result;
}
/**
* Dashboard grid wrapper using react-grid-layout v2 Responsive component.
* Renders widgets in a draggable/resizable grid when in edit mode.
@@ -49,6 +138,11 @@ export function DashboardGrid({
return () => observer.disconnect();
}, []);
// quick-260916-dyv: minW/minH (und zu kleine w/h) aus WIDGET_CONSTRAINTS —
// siehe applyConstraintMinima. Vor dem Leerzustand, damit die Hook-Reihenfolge
// stabil bleibt.
const effectiveLayouts = useMemo(() => applyConstraintMinima(layouts, widgets), [layouts, widgets]);
// Empty state (D-02)
if (widgets.length === 0) {
return (
@@ -73,17 +167,21 @@ export function DashboardGrid({
width={width}
breakpoints={BREAKPOINTS}
cols={COLS}
layouts={layouts as ResponsiveLayouts}
rowHeight={40}
margin={[16, 16] as [number, number]}
layouts={effectiveLayouts as ResponsiveLayouts}
rowHeight={20}
margin={[8, 8] as [number, number]}
// containerPadding bewusst nicht gesetzt: react-grid-layout 2.2.3 nimmt
// dann das margin (gemessen: effectiveContainerPadding = containerPadding ?? margin).
dragConfig={{
enabled: isEditMode,
handle: '.widget-drag-handle',
handle: WIDGET_DRAG_HANDLE_SELECTOR,
cancel: WIDGET_DRAG_CANCEL_SELECTOR,
threshold: 3,
}}
resizeConfig={{
enabled: isEditMode,
}}
compactor={noCompactor}
compactor={FREE_PLACEMENT_COMPACTOR}
onLayoutChange={(_currentLayout, allLayouts) => onLayoutChange(allLayouts)}
>
{widgets.map((widget) => {
@@ -92,14 +190,14 @@ export function DashboardGrid({
<div
key={widget.id}
data-grid={{
...(layouts.lg?.find((l) => l.i === widget.id) ?? {
...(effectiveLayouts.lg?.find((l) => l.i === widget.id) ?? {
x: 0,
y: 0,
w: constraints?.defaultW ?? 2,
h: constraints?.defaultH ?? 2,
w: constraints?.defaultW ?? 4,
h: constraints?.defaultH ?? 4,
}),
minW: constraints?.minW ?? 2,
minH: constraints?.minH ?? 2,
minW: constraints?.minW ?? 4,
minH: constraints?.minH ?? 4,
}}
>
<WidgetWrapper
@@ -10,6 +10,9 @@ interface EditModeToggleProps {
/**
* Pencil / Checkmark icon button to toggle dashboard edit mode (D-01).
* Active state (edit mode) uses primary background.
* Schwebt in der festen Aktionsleiste unten rechts (quick-260916-dyv):
* inaktiv mit Karten-Hintergrund, Rahmen und Schatten, damit der Stift
* ueber Widgets sichtbar bleibt.
*/
export function EditModeToggle({ isEditMode, onToggle }: EditModeToggleProps) {
const t = useTranslations('widgets');
@@ -17,10 +20,10 @@ export function EditModeToggle({ isEditMode, onToggle }: EditModeToggleProps) {
return (
<button
onClick={onToggle}
className={`inline-flex items-center justify-center rounded-md p-2 transition-colors ${
className={`inline-flex items-center justify-center rounded-md p-2 shadow-lg transition-colors ${
isEditMode
? 'bg-primary text-primary-foreground hover:opacity-90'
: 'text-muted-foreground hover:bg-muted hover:text-foreground'
: 'border border-border bg-card text-muted-foreground hover:bg-muted hover:text-foreground'
}`}
aria-pressed={isEditMode}
aria-label={isEditMode ? t('saveChanges') : t('editMode')}
@@ -52,4 +52,30 @@ describe('WIDGET_CONSTRAINTS (DASH-11)', () => {
expect(Object.keys(WIDGET_CONSTRAINTS)).toContain('link');
expect(Object.keys(WIDGET_CONSTRAINTS)).toContain('stopwatch');
});
it('Test A (quick-260916-dyv): Minima = kleinste bedienbare Kachel je Typ, Vorgaben unveraendert', () => {
// Raster 24 Spalten / 20 px (quick-260916-bwo). Die Minima sind seit
// quick-260916-dyv inhaltsgetrieben (Rechnung im Plan), die Vorgaben
// (defaultW/defaultH) bleiben das Doppelte der alten 12-Spalten-Werte.
// 3 und 9 sind ungerade — die bwo-Pruefung "jeder Wert ist gerade" entfaellt.
expect(WIDGET_CONSTRAINTS).toEqual({
clock: { minW: 2, minH: 2, defaultW: 4, defaultH: 4 },
search: { minW: 6, minH: 2, defaultW: 12, defaultH: 4 },
calendar: { minW: 3, minH: 3, defaultW: 8, defaultH: 12 },
note: { minW: 4, minH: 4, defaultW: 6, defaultH: 8 },
calculator: { minW: 3, minH: 10, defaultW: 6, defaultH: 10 },
favorites: { minW: 3, minH: 3, defaultW: 6, defaultH: 10 },
link: { minW: 3, minH: 2, defaultW: 4, defaultH: 4 },
stopwatch: { minW: 4, minH: 3, defaultW: 6, defaultH: 6 },
});
let counted = 0;
for (const type of ALL_WIDGET_TYPES) {
for (const field of ['minW', 'minH', 'defaultW', 'defaultH'] as const) {
expect(typeof WIDGET_CONSTRAINTS[type][field]).toBe('number');
counted++;
}
}
expect(counted).toBe(32);
});
});
@@ -32,16 +32,25 @@ export const WIDGET_CONSTRAINTS: Record<
WidgetType,
{ minW: number; minH: number; defaultW: number; defaultH: number }
> = {
// Existing widgets (values unchanged)
clock: { minW: 2, minH: 2, defaultW: 2, defaultH: 2 },
search: { minW: 3, minH: 2, defaultW: 6, defaultH: 2 },
calendar: { minW: 3, minH: 3, defaultW: 4, defaultH: 6 },
note: { minW: 2, minH: 3, defaultW: 3, defaultH: 4 },
// quick-260916-dyv: minW/minH = kleinste noch bedienbare Kachel je Typ im
// 24-Spalten/20-px-Raster, aus dem Innenaufbau gerechnet (Suche: Auswahl 120 +
// Eingabe + Knopf; Rechner: Anzeige 40 + Speicherzeile 28 + 5 Tastenreihen 28 =
// 268 px -> 10 Zeilen; Stoppuhr: kompakte Bedienleiste). defaultW/defaultH =
// altes 12-Spalten-Mass x2, unveraendert. Gespeicherte minW/minH werden in
// dashboard-grid.tsx aus dieser Tabelle ueberschrieben.
// Existing widgets
clock: { minW: 2, minH: 2, defaultW: 4, defaultH: 4 },
search: { minW: 6, minH: 2, defaultW: 12, defaultH: 4 },
calendar: { minW: 3, minH: 3, defaultW: 8, defaultH: 12 },
note: { minW: 4, minH: 4, defaultW: 6, defaultH: 8 },
// Phase 8 new widgets (D-01)
calculator: { minW: 2, minH: 4, defaultW: 3, defaultH: 5 },
favorites: { minW: 2, minH: 3, defaultW: 3, defaultH: 5 },
link: { minW: 2, minH: 2, defaultW: 2, defaultH: 2 },
stopwatch: { minW: 2, minH: 2, defaultW: 3, defaultH: 3 },
// minH 10, nicht 9 (260916-dyv, Browser-Messung des Orchestrators): der Rechner hat
// SECHS Tastenreihen (%/CE/C/Loeschen, 1/x/x2/Wurzel/Division, 7-9, 4-6, 1-3, 0/Komma/=),
// Inhalt 268 px; bei 9 Zeilen (244 px) fehlte die unterste Reihe um 25 px.
calculator: { minW: 3, minH: 10, defaultW: 6, defaultH: 10 },
favorites: { minW: 3, minH: 3, defaultW: 6, defaultH: 10 },
link: { minW: 3, minH: 2, defaultW: 4, defaultH: 4 },
stopwatch: { minW: 4, minH: 3, defaultW: 6, defaultH: 6 },
};
/**
@@ -82,4 +82,14 @@ describe('CalculatorWidget', () => {
expect(screen.getByLabelText('Anzeige')).toHaveTextContent('3');
});
it('quick-260916-bwo: Anzeige und Tasten tragen Container-Query-Klassen, Tasten fuellen ihre Zelle', () => {
render(<CalculatorWidget {...defaultProps} />);
expect(screen.getByLabelText('Anzeige').className).toMatch(/cqw/);
const seven = screen.getByRole('button', { name: '7' });
expect(seven.className).toMatch(/cqw/);
expect(seven.className).toContain('h-full');
expect(screen.getByRole('button', { name: 'CE' }).className).toMatch(/cqw/);
});
});
@@ -84,7 +84,7 @@ function CalcButton({ label, ariaLabel, className = '', onClick, disabled }: But
aria-label={ariaLabel ?? label}
onClick={onClick}
disabled={disabled}
className={`flex items-center justify-center rounded text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${className}`}
className={`flex items-center justify-center rounded font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${className}`}
>
{label}
</button>
@@ -307,16 +307,21 @@ export function CalculatorWidget({ isEditMode }: WidgetProps) {
}
}
const baseBtn = 'h-9 cursor-pointer select-none active:scale-95';
const numBtn = `${baseBtn} bg-background hover:bg-muted border border-border text-foreground`;
const opBtn = `${baseBtn} bg-muted hover:bg-muted/80 border border-border text-primary font-semibold`;
const utilBtn = `${baseBtn} bg-muted/50 hover:bg-muted border border-border text-muted-foreground text-xs`;
const eqBtn = `${baseBtn} bg-primary hover:bg-primary/90 text-primary-foreground font-semibold`;
// quick-260916-bwo: Tasten fuellen ihre Rasterzelle (h-full) und skalieren
// ihre Schrift per Container-Query mit der Kachel; jede Tastenart traegt genau
// EINE Schriftgroessen-Klasse (die Basis in CalcButton hat keine mehr). Alle
// Klassen stehen woertlich als Literale, damit der Tailwind-Scanner sie findet.
const baseBtn = 'h-full min-h-7 cursor-pointer select-none active:scale-95';
const numBtn = `${baseBtn} bg-background hover:bg-muted border border-border text-foreground text-[clamp(11px,min(4cqw,4.5cqh),40px)]`;
const opBtn = `${baseBtn} bg-muted hover:bg-muted/80 border border-border text-primary font-semibold text-[clamp(11px,min(4cqw,4.5cqh),40px)]`;
const utilBtn = `${baseBtn} bg-muted/50 hover:bg-muted border border-border text-muted-foreground text-[clamp(10px,min(3.2cqw,3.6cqh),32px)]`;
const eqBtn = `${baseBtn} bg-primary hover:bg-primary/90 text-primary-foreground font-semibold text-[clamp(11px,min(4cqw,4.5cqh),40px)]`;
// Speicherzeile bleibt bewusst klein (h-7 text-xs) — Nebenfunktion, kein Hauptinhalt.
const memBtn = 'h-7 cursor-pointer select-none rounded text-xs font-medium transition-colors hover:bg-muted text-muted-foreground disabled:opacity-30 disabled:cursor-default px-1';
return (
<div
className="flex h-full flex-col gap-1 p-2 select-none"
className="flex h-full flex-col gap-1 p-1 select-none"
tabIndex={0}
role="application"
aria-label={t('calculator.name')}
@@ -324,7 +329,7 @@ export function CalculatorWidget({ isEditMode }: WidgetProps) {
>
{/* Display */}
<output
className="flex min-h-[2.5rem] items-end justify-end rounded bg-muted px-3 py-1 font-mono text-xl font-semibold text-foreground overflow-hidden"
className="flex min-h-[2.5rem] items-end justify-end rounded bg-muted px-3 py-1 font-mono text-[clamp(14px,min(8cqw,10cqh),96px)] font-semibold text-foreground overflow-hidden"
aria-label="Anzeige"
>
<span className="truncate">{display}</span>
@@ -77,7 +77,7 @@ export function CalendarWidget({ config }: WidgetProps) {
// Loading state
if (isLoading) {
return (
<div className="flex h-full items-center justify-center p-4">
<div className="flex h-full items-center justify-center p-2">
<span className="text-sm text-muted-foreground">
{t('calendar.loading')}
</span>
@@ -88,7 +88,7 @@ export function CalendarWidget({ config }: WidgetProps) {
// No sources configured
if (hasSources === false) {
return (
<div className="flex h-full items-center justify-center p-4">
<div className="flex h-full items-center justify-center p-2">
<span className="text-sm text-muted-foreground">
{t('calendar.emptyNoSources')}
</span>
@@ -99,7 +99,7 @@ export function CalendarWidget({ config }: WidgetProps) {
// Sources exist but no events
if (events.length === 0) {
return (
<div className="flex h-full items-center justify-center p-4">
<div className="flex h-full items-center justify-center p-2">
<span className="text-sm text-muted-foreground">
{t('calendar.emptyNoEvents')}
</span>
@@ -109,7 +109,7 @@ export function CalendarWidget({ config }: WidgetProps) {
// Events list
return (
<div className="flex h-full flex-col overflow-y-auto p-3">
<div className="flex h-full flex-col overflow-y-auto p-1.5">
<ul className="space-y-2">
{events.map((event) => (
<li
@@ -0,0 +1,32 @@
/**
* clock-font-size — Grenzen und Aufloesung der festen Punktgroesse der
* Uhrzeit (quick-260916-bwo).
*
* Das Uhr-Widget skaliert seine Zeit standardmaessig automatisch ueber
* CSS-Container-Queries mit der Kachelgroesse. Optional legt der Benutzer
* unter Einstellungen -> Dashboard eine feste Schriftgroesse in Punkt fest
* (Config-Feld `timeFontSizePt`, Zahl oder null; leer = automatisch).
*
* T-BWO-01: Der Wert landet als Inline-Style im Widget. Die API prueft
* Config-Felder nicht (`@IsObject()`), deshalb entscheidet ALLEIN diese
* Funktion, was zum Style wird: nur ein `typeof number`, endlich und im
* Bereich MIN..MAX. Zeichenketten, NaN, Infinity und Werte ausserhalb fallen
* auf `null` = automatisch zurueck — kein Text aus der Konfiguration erreicht
* jemals den Style. Formular UND Widget benutzen dieselben Grenzen von hier.
*/
export const CLOCK_FONT_SIZE_MIN_PT = 8;
export const CLOCK_FONT_SIZE_MAX_PT = 200;
/** Das Datum unter der Uhrzeit bekommt diesen Anteil der festen Punktgroesse. */
export const CLOCK_DATE_FACTOR = 0.4;
export function resolveClockTimeFontSizePt(config: Record<string, unknown>): number | null {
const value = config.timeFontSizePt;
if (typeof value !== 'number' || !Number.isFinite(value)) {
return null;
}
if (value < CLOCK_FONT_SIZE_MIN_PT || value > CLOCK_FONT_SIZE_MAX_PT) {
return null;
}
return value;
}
@@ -1,5 +1,10 @@
import { cleanup, render, screen } from '@testing-library/react';
import { afterEach, describe, expect, it, vi } from 'vitest';
import {
CLOCK_FONT_SIZE_MAX_PT,
CLOCK_FONT_SIZE_MIN_PT,
resolveClockTimeFontSizePt,
} from './clock-font-size';
// Mock next-intl
vi.mock('next-intl', () => ({
@@ -65,4 +70,87 @@ describe('ClockWidget', () => {
vi.useRealTimers();
});
// --- quick-260916-bwo: Skalierung per Container-Query, feste Punktgroesse ---
// jsdom verwirft clamp()/min() in style.fontSize (gemessen) — deshalb liegt die
// automatische Groesse in einer Tailwind-KLASSE und nur die feste Punktgroesse
// im Inline-Style. Die Tests lesen fuer 'auto' die Klasse, fuer 'fixed' style.
it('Test 3 (quick-260916-bwo): resolveClockTimeFontSizePt laesst nur endliche Zahlen 8..200 durch (T-BWO-01)', () => {
expect(resolveClockTimeFontSizePt({ timeFontSizePt: 36 })).toBe(36);
expect(resolveClockTimeFontSizePt({ timeFontSizePt: 8 })).toBe(8);
expect(resolveClockTimeFontSizePt({ timeFontSizePt: 200 })).toBe(200);
expect(resolveClockTimeFontSizePt({ timeFontSizePt: 36.5 })).toBe(36.5);
expect(resolveClockTimeFontSizePt({ timeFontSizePt: 7 })).toBeNull();
expect(resolveClockTimeFontSizePt({ timeFontSizePt: 201 })).toBeNull();
expect(resolveClockTimeFontSizePt({ timeFontSizePt: '36' })).toBeNull();
expect(resolveClockTimeFontSizePt({ timeFontSizePt: Number.NaN })).toBeNull();
expect(resolveClockTimeFontSizePt({ timeFontSizePt: Number.POSITIVE_INFINITY })).toBeNull();
expect(resolveClockTimeFontSizePt({ timeFontSizePt: null })).toBeNull();
expect(resolveClockTimeFontSizePt({})).toBeNull();
expect(CLOCK_FONT_SIZE_MIN_PT).toBe(8);
expect(CLOCK_FONT_SIZE_MAX_PT).toBe(200);
});
it('Test 4 (quick-260916-bwo): feste Punktgroesse -> Inline-Style 36pt, Datum 14.4pt, data-font-mode fixed', async () => {
vi.useFakeTimers();
vi.setSystemTime(new Date('2026-06-24T12:30:00Z'));
const { ClockWidget } = await import('./clock-widget');
render(
<ClockWidget
instanceId="clock-3"
config={{ timezone: 'Europe/Berlin', showDate: true, timeFontSizePt: 36 }}
isEditMode={false}
/>,
);
const timeEl = screen.getByRole('time');
expect(timeEl.style.fontSize).toBe('36pt');
expect(timeEl.getAttribute('data-font-mode')).toBe('fixed');
expect(screen.getByTestId('clock-date').style.fontSize).toBe('14.4pt');
});
it('Test 5 (quick-260916-bwo): ohne Punktgroesse -> kein Inline-Style, data-font-mode auto, Container-Query-Klassen', async () => {
vi.useFakeTimers();
vi.setSystemTime(new Date('2026-06-24T12:30:00Z'));
const { ClockWidget } = await import('./clock-widget');
render(
<ClockWidget
instanceId="clock-4"
config={{ timezone: 'Europe/Berlin', showDate: true }}
isEditMode={false}
/>,
);
const timeEl = screen.getByRole('time');
expect(timeEl.style.fontSize).toBe('');
expect(timeEl.getAttribute('data-font-mode')).toBe('auto');
expect(timeEl.className).toMatch(/cqw/);
expect(timeEl.className).toMatch(/cqh/);
const dateEl = screen.getByTestId('clock-date');
expect(dateEl.className).toMatch(/cq[wh]/);
expect(dateEl.style.fontSize).toBe('');
});
it('Test 6 (quick-260916-bwo): Zeichenketten-Wert wird ignoriert — auto, kein Inline-Style (T-BWO-01)', async () => {
vi.useFakeTimers();
vi.setSystemTime(new Date('2026-06-24T12:30:00Z'));
const { ClockWidget } = await import('./clock-widget');
render(
<ClockWidget
instanceId="clock-5"
config={{ timezone: 'Europe/Berlin', showDate: true, timeFontSizePt: '36' }}
isEditMode={false}
/>,
);
const timeEl = screen.getByRole('time');
expect(timeEl.style.fontSize).toBe('');
expect(timeEl.getAttribute('data-font-mode')).toBe('auto');
expect(timeEl.className).toMatch(/cqw/);
expect(screen.getByTestId('clock-date').style.fontSize).toBe('');
});
});
@@ -2,6 +2,7 @@
import { useEffect, useState } from 'react';
import type { WidgetProps } from '../widget-registry';
import { CLOCK_DATE_FACTOR, resolveClockTimeFontSizePt } from './clock-font-size';
/**
* Digital clock widget displaying time in a configurable timezone.
@@ -10,10 +11,14 @@ import type { WidgetProps } from '../widget-registry';
* Config:
* - timezone: IANA timezone string (default 'Europe/Berlin')
* - showDate: boolean (default false) — show date below time
* - timeFontSizePt: number | null (quick-260916-bwo) — feste Schriftgroesse der
* Uhrzeit in Punkt; leer/null = automatisch ueber Container-Queries mit der
* Kachelgroesse. Grenzen 8..200 in `clock-font-size.ts` (T-BWO-01).
*/
export function ClockWidget({ config }: WidgetProps) {
const timezone = (config.timezone as string) || 'Europe/Berlin';
const showDate = config.showDate === true;
const fixedPt = resolveClockTimeFontSizePt(config);
const [now, setNow] = useState(() => new Date());
@@ -39,11 +44,16 @@ export function ClockWidget({ config }: WidgetProps) {
});
return (
<div className="flex h-full flex-col items-center justify-center gap-1 p-2">
<div className="flex h-full flex-col items-center justify-center gap-1 p-1">
{/* Automatisch = CSS (Container-Query-Klasse, skaliert mit der Kachel),
fest = Zahl als Inline-Style in pt. Die Trennung ist bewusst: jsdom
verwirft clamp() im Inline-Style, der Browser bekommt die Klasse
ohnehin — und "auto = Klasse, fest = Zahl" ist die einfachere Form. */}
<time
role="time"
className="font-semibold tabular-nums text-foreground"
style={{ fontSize: 'clamp(28px, 4vw, 40px)' }}
data-font-mode={fixedPt === null ? 'auto' : 'fixed'}
className="font-semibold tabular-nums leading-none text-foreground text-[clamp(12px,min(20cqw,50cqh),400px)]"
style={fixedPt === null ? undefined : { fontSize: `${fixedPt}pt` }}
dateTime={now.toISOString()}
>
{timeFormatter.format(now)}
@@ -51,7 +61,8 @@ export function ClockWidget({ config }: WidgetProps) {
{showDate && (
<span
data-testid="clock-date"
className="text-xs text-muted-foreground"
className="text-muted-foreground text-[clamp(10px,min(8cqw,20cqh),160px)]"
style={fixedPt === null ? undefined : { fontSize: `${fixedPt * CLOCK_DATE_FACTOR}pt` }}
>
{dateFormatter.format(now)}
</span>
@@ -171,7 +171,7 @@ export function FavoritesWidget({
// --- Render ---
return (
<div className="flex flex-col h-full overflow-auto p-2 gap-2">
<div className="flex flex-col h-full overflow-auto p-1 gap-2">
{/* View mode toggle (edit mode only) */}
{isEditMode && (
<div className="flex gap-1 widgetNoDrag" aria-label={t('favorites.name')}>
@@ -235,7 +235,7 @@ export function LinkWidget({
// --- Render ---
return (
<div className="flex flex-col h-full overflow-auto p-2 gap-2">
<div className="flex flex-col h-full overflow-auto p-1 gap-2">
{/* View mode toggle (edit mode only) */}
{isEditMode && (
<div className="flex gap-1 widgetNoDrag">
@@ -86,7 +86,7 @@ export function NoteWidget({ instanceId, config }: WidgetProps) {
return (
<div className="flex h-full flex-col overflow-hidden" data-color-mode="auto">
{/* Header: title + pencil toggle */}
<div className="relative flex items-center border-b border-border px-3 py-1.5 gap-2">
<div className="relative flex items-center border-b border-border px-1.5 py-1.5 gap-2">
<input
type="text"
className="flex-1 bg-transparent text-sm font-semibold text-foreground outline-none placeholder:text-muted-foreground"
@@ -86,7 +86,7 @@ export function SearchWidget({ instanceId, config }: WidgetProps) {
);
return (
<div className="flex h-full items-center gap-2 px-3">
<div className="flex h-full items-center gap-2 px-1.5">
{/* Provider dropdown (D-14: ~120px left) */}
<select
role="combobox"
@@ -195,4 +195,13 @@ describe('StopwatchWidget', () => {
const totalSeconds = minutes * 60 + seconds;
expect(totalSeconds).toBeGreaterThanOrEqual(5);
});
it('quick-260916-bwo: die Anzeige skaliert per Container-Query-Klasse, keine Fensterbreiten-Formel im Style', () => {
render(<StopwatchWidget instanceId="sw-cq" config={{}} isEditMode={false} />);
const display = screen.getByTestId('stopwatch-display');
expect(display.className).toMatch(/cqw/);
expect(display.className).toMatch(/cqh/);
expect(display.style.fontSize).toBe('');
});
});
@@ -189,26 +189,28 @@ export function StopwatchWidget({ instanceId, config, isEditMode: _isEditMode }:
const isRunning = sw.state === 'running';
return (
<div className="flex h-full flex-col overflow-hidden p-3">
{/* Timer display */}
<div className="flex h-full flex-col overflow-hidden p-1.5">
{/* Timer display — quick-260916-bwo: skaliert per Container-Query mit der Kachel */}
<div className="flex flex-1 items-center justify-center">
<span
data-testid="stopwatch-display"
className="font-mono font-semibold tabular-nums text-foreground"
style={{ fontSize: 'clamp(24px, 5vw, 48px)' }}
className="font-mono font-semibold tabular-nums leading-none text-foreground text-[clamp(14px,min(16cqw,35cqh),400px)]"
>
{formatMs(displayMs)}
</span>
</div>
{/* Controls */}
<div className="flex items-center justify-center gap-2 py-2">
{/* Controls
quick-260916-dyv: kompakte Bedienleiste, damit die laufende Stoppuhr
(Stop + Runde + Reset) in 4 Spalten passt (ca. 151 px statt ca. 222 px)
und die Kachel auf 4x3 schrumpfen kann. */}
<div className="flex items-center justify-center gap-1 py-1">
{!isRunning ? (
<button
type="button"
aria-label={t('stopwatch.start')}
onClick={handleStart}
className="rounded-md bg-primary px-4 py-1.5 text-sm font-medium text-primary-foreground hover:opacity-90 transition-opacity"
className="rounded-md bg-primary px-2 py-1 text-xs font-medium text-primary-foreground hover:opacity-90 transition-opacity"
>
{t('stopwatch.start')}
</button>
@@ -218,7 +220,7 @@ export function StopwatchWidget({ instanceId, config, isEditMode: _isEditMode }:
type="button"
aria-label={t('stopwatch.stop')}
onClick={handleStop}
className="rounded-md bg-muted px-4 py-1.5 text-sm font-medium text-foreground hover:opacity-90 transition-opacity"
className="rounded-md bg-muted px-2 py-1 text-xs font-medium text-foreground hover:opacity-90 transition-opacity"
>
{t('stopwatch.stop')}
</button>
@@ -226,7 +228,7 @@ export function StopwatchWidget({ instanceId, config, isEditMode: _isEditMode }:
type="button"
aria-label={t('stopwatch.lap')}
onClick={handleLap}
className="rounded-md bg-muted px-4 py-1.5 text-sm font-medium text-foreground hover:opacity-90 transition-opacity"
className="rounded-md bg-muted px-2 py-1 text-xs font-medium text-foreground hover:opacity-90 transition-opacity"
>
{t('stopwatch.lap')}
</button>
@@ -236,7 +238,7 @@ export function StopwatchWidget({ instanceId, config, isEditMode: _isEditMode }:
type="button"
aria-label={t('stopwatch.reset')}
onClick={handleReset}
className="rounded-md border border-border px-4 py-1.5 text-sm font-medium text-muted-foreground hover:text-foreground transition-colors"
className="rounded-md border border-border px-2 py-1 text-xs font-medium text-muted-foreground hover:text-foreground transition-colors"
>
{t('stopwatch.reset')}
</button>
@@ -15,7 +15,14 @@ interface WidgetWrapperProps {
/**
* Wrapper card for all dashboard widgets.
* In edit mode: shows drag handle (top) and delete button (top-right).
*
* quick-260916-dyv: Im Bearbeitungsmodus ist die GANZE Karte der Griff
* (`widget-drag-handle`, `cursor-grab`). Eine 20 px hohe Kopfleiste mit
* Griff-Symbol liegt als Overlay ueber dem oberen Kachelrand — nur optischer
* Hinweis (Tooltip `widgets.dragHint`), kein eigener Griff. Der Loesch-Knopf
* sitzt rechts in dieser Kopfleiste und traegt `data-no-drag`; welche Ziele
* KEIN Ziehen starten (Eingabefelder, Knoepfe, Links, [data-no-drag],
* .widgetNoDrag), entscheidet der cancel-Selektor in dashboard-grid.tsx.
* Renders the actual widget component via WIDGET_REGISTRY lookup.
*/
export function WidgetWrapper({ widget, isEditMode, onRemove }: WidgetWrapperProps) {
@@ -23,50 +30,80 @@ export function WidgetWrapper({ widget, isEditMode, onRemove }: WidgetWrapperPro
const definition = WIDGET_REGISTRY[widget.widgetType as WidgetType];
const WidgetComponent = definition?.component;
const cardClassName = isEditMode
? 'widget-drag-handle relative h-full w-full cursor-grab overflow-hidden rounded-lg border border-primary/40 bg-card shadow-sm active:cursor-grabbing'
: 'relative h-full w-full overflow-hidden rounded-lg border border-primary/20 bg-card shadow-sm';
return (
<div
className="relative h-full w-full overflow-hidden rounded-lg border border-primary/20 bg-card shadow-sm"
className={cardClassName}
data-widget-id={widget.id}
role="article"
aria-label={definition ? t(definition.nameKey) : widget.widgetType}
>
{/* Edit mode: drag handle */}
{/* Edit mode: Overlay-Kopfleiste (Griff-Hinweis) mit Loesch-Knopf rechts.
Bewusst `absolute` und NICHT im Fluss: der Rumpf bleibt h-full, die
Hoehenkette Karte -> Rumpf bleibt definit (cqh loest weiter auf). */}
{isEditMode && (
<div className="widget-drag-handle flex h-[6px] w-full cursor-grab items-center justify-center bg-muted active:cursor-grabbing">
<div className="h-[2px] w-8 rounded-full bg-muted-foreground/40" />
</div>
)}
{/* Edit mode: delete button */}
{isEditMode && (
<button
onClick={(e) => {
e.stopPropagation();
onRemove(widget.id);
}}
className="absolute right-1 top-1 z-10 flex h-6 w-6 items-center justify-center rounded-full bg-card text-muted-foreground transition-colors hover:bg-destructive hover:text-destructive-foreground"
aria-label={t('deleteTooltip')}
title={t('deleteTooltip')}
<div
className="absolute inset-x-0 top-0 z-10 flex h-5 items-center justify-center bg-muted/70"
title={t('dragHint')}
data-testid="widget-drag-head"
>
<svg
xmlns="http://www.w3.org/2000/svg"
width="14"
height="14"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth="2"
strokeLinecap="round"
strokeLinejoin="round"
fill="currentColor"
className="text-muted-foreground"
aria-hidden="true"
>
<line x1="18" y1="6" x2="6" y2="18" />
<line x1="6" y1="6" x2="18" y2="18" />
<circle cx="5" cy="9" r="1.5" />
<circle cx="12" cy="9" r="1.5" />
<circle cx="19" cy="9" r="1.5" />
<circle cx="5" cy="15" r="1.5" />
<circle cx="12" cy="15" r="1.5" />
<circle cx="19" cy="15" r="1.5" />
</svg>
</button>
<button
type="button"
onClick={(e) => {
e.stopPropagation();
onRemove(widget.id);
}}
className="absolute right-0.5 top-0 flex h-5 w-5 items-center justify-center rounded-full bg-card text-muted-foreground transition-colors hover:bg-destructive hover:text-destructive-foreground"
aria-label={t('deleteTooltip')}
title={t('deleteTooltip')}
data-no-drag=""
>
<svg
xmlns="http://www.w3.org/2000/svg"
width="12"
height="12"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth="2"
strokeLinecap="round"
strokeLinejoin="round"
>
<line x1="18" y1="6" x2="6" y2="18" />
<line x1="6" y1="6" x2="18" y2="18" />
</svg>
</button>
</div>
)}
{/* Widget body */}
<div className={`h-full ${isEditMode ? 'pt-0' : ''}`}>
{/* Widget body.
quick-260916-bwo: Groessen-Container (@container-size -> container-type: size),
damit die Widget-Inhalte per cqw/cqh mit der Kachel skalieren. Braucht eine
definite Hoehe — die kommt ueber h-full aus der Karte, die das RGL-Element
mit Pixelhoehe fuellt. Steht am Rumpf statt an der Karte, weil die Karte
im Bearbeitungsmodus zusaetzlich den Griff traegt.
quick-260916-dyv: Die Kopfleiste liegt als Overlay ueber dem Rumpf und
aendert die Hoehenkette nicht. */}
<div className="@container-size h-full">
{WidgetComponent ? (
<WidgetComponent
instanceId={widget.id}
+2 -1
View File
@@ -30,8 +30,9 @@ export function AppShell({ children }: { children: React.ReactNode }) {
<div className="min-h-screen bg-background">
<Header />
<Sidebar />
{/* Seitenrahmen seit quick-260916-bwo halbiert: p-3 (12 px) statt vorher 24 px (Stufe 6), gilt fuer alle Seiten. */}
<main
className="app-shell-main min-h-[calc(100vh-var(--header-height))] transition-all duration-200 p-6"
className="app-shell-main min-h-[calc(100vh-var(--header-height))] transition-all duration-200 p-3"
style={mounted ? { '--current-sidebar-width': sidebarWidth } as React.CSSProperties : undefined}
>
{children}
@@ -4,9 +4,33 @@ import { afterEach, describe, expect, it, vi } from 'vitest';
/**
* AppVersionBadge.test — die Versionszeile unten in der Seitenleiste
* (quick-260914-ku1). Vorlage: sidebar.test.tsx (next-intl-Mock, cleanup,
* dynamischer Import nach dem Setzen der Mocks).
* dynamischer Import nach dem Setzen der Mocks). Seit quick-260916-dcz ist die
* Zeile ein Link zur Seite "Was ist neu" — deshalb der `next/link`-Mock, der
* href, className, title, aria-label und data-testid durchreicht (Tests 5/6).
*/
vi.mock('next/link', () => ({
default: ({
children,
href,
className,
title,
'aria-label': ariaLabel,
'data-testid': testId,
}: {
children: React.ReactNode;
href: string;
className?: string;
title?: string;
'aria-label'?: string;
'data-testid'?: string;
}) => (
<a href={href} className={className} title={title} aria-label={ariaLabel} data-testid={testId}>
{children}
</a>
),
}));
vi.mock('next-intl', () => ({
useTranslations: (ns: string) => (key: string) => {
const map: Record<string, Record<string, string>> = {
@@ -14,6 +38,7 @@ vi.mock('next-intl', () => ({
'channel.beta': 'Beta',
'channel.live': 'Live',
'channel.dev': 'Entwicklung',
whatsNew: 'Was ist neu',
},
};
return map[ns]?.[key] ?? key;
@@ -95,4 +120,22 @@ describe('AppVersionBadge (quick-260914-ku1)', () => {
expect(el).toHaveTextContent('dev · Entwicklung');
expect(el.hasAttribute('title')).toBe(false);
});
it('Test 5 (Link): die Versionszeile ist ein Link auf /changelog', async () => {
mockLoad.mockResolvedValue(null);
const AppVersionBadge = await importBadge();
render(<AppVersionBadge />);
const el = screen.getByTestId('app-version');
expect(el.tagName).toBe('A');
expect(el).toHaveAttribute('href', '/changelog');
});
it('Test 6 (aria-label): der Link traegt den Namen "Was ist neu"', async () => {
mockLoad.mockResolvedValue(null);
const AppVersionBadge = await importBadge();
render(<AppVersionBadge />);
expect(screen.getByTestId('app-version')).toHaveAttribute('aria-label', 'Was ist neu');
});
});
@@ -1,6 +1,7 @@
'use client';
import { useEffect, useState } from 'react';
import Link from 'next/link';
import { useTranslations } from 'next-intl';
import { type ApiVersionInfo, appVersion, loadApiVersion } from '@/lib/app-version';
@@ -9,6 +10,8 @@ import { type ApiVersionInfo, appVersion, loadApiVersion } from '@/lib/app-versi
* `v1.0.0 · Beta` oder lokal `dev · Entwicklung` (quick-260914-ku1).
* Der Tooltip nennt den Web-Commit und, sobald geladen, die API-Version
* samt Kanal. "Commit" und "API" sind in beiden Sprachen gleich.
* Seit quick-260916-dcz ist die Zeile ein Link zur Seite "Was ist neu"
* (/changelog); der Tooltip bleibt, der Linkname steht im aria-label.
*/
export function AppVersionBadge() {
const t = useTranslations('sidebar');
@@ -30,8 +33,14 @@ export function AppVersionBadge() {
const title = parts.length > 0 ? parts.join(' · ') : undefined;
return (
<span data-testid="app-version" className="block truncate text-xs text-muted-foreground" title={title}>
<Link
href="/changelog"
data-testid="app-version"
aria-label={t('whatsNew')}
title={title}
className="block truncate text-xs text-muted-foreground transition-colors hover:text-foreground hover:underline"
>
{appVersion.version} · {t(`channel.${appVersion.channel}`)}
</span>
</Link>
);
}
@@ -0,0 +1,107 @@
import { cleanup, fireEvent, render, screen } from '@testing-library/react';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import de from '@/messages/de.json';
import { updateWidgetConfig } from '@/lib/dashboard-api';
import { WidgetSettingsPanel } from './widget-settings-panel';
/**
* widget-settings-panel.test — NEU (quick-260916-bwo). Das Einstellungsfeld
* hatte bisher keine Testdatei. Vier Tests fuer das Zahlenfeld
* „Schriftgroesse der Uhrzeit (Punkt)“: Vorbelegung, Uebernahme bei Blur,
* leer = automatisch (null) bei Enter, Grenzen 8..200 mit Fehlermeldung und
* OHNE Aufruf (T-BWO-01 — die Grenzen leben in clock-font-size.ts und gelten
* fuer Formular und Widget gleichermassen). Texte aus der echten de.json.
*/
vi.mock('next-intl', async () => {
const messages = (await import('@/messages/de.json')).default as Record<string, unknown>;
const lookup = (path: string): string | undefined =>
path.split('.').reduce<unknown>((o, k) => (o && typeof o === 'object' ? (o as any)[k] : undefined), messages) as
| string
| undefined;
return {
useTranslations: (ns?: string) => (key: string) => lookup(ns ? `${ns}.${key}` : key) ?? key,
};
});
vi.mock('@/lib/dashboard-api', () => ({
updateWidgetConfig: vi.fn().mockResolvedValue(undefined),
}));
vi.mock('next/link', () => ({
default: ({ href, children }: { href: string; children: React.ReactNode }) => <a href={href}>{children}</a>,
}));
vi.mock('@/components/settings/search-provider-form', () => ({
SearchProviderForm: () => null,
}));
const clockTexts = (de as { widgets: { clock: Record<string, string> } }).widgets.clock;
const WIDGET = { id: 'c1', widgetType: 'clock', config: { timezone: 'Europe/Berlin', timeFontSizePt: 24 } };
function renderExpanded() {
const onWidgetUpdate = vi.fn();
render(<WidgetSettingsPanel widgets={[WIDGET]} onWidgetUpdate={onWidgetUpdate} />);
fireEvent.click(screen.getByRole('button', { name: /Uhr #1/ }));
const input = screen.getByLabelText(clockTexts.fontSizeLabel) as HTMLInputElement;
return { onWidgetUpdate, input };
}
beforeEach(() => {
vi.clearAllMocks();
});
afterEach(() => {
cleanup();
});
describe('WidgetSettingsPanel — Schriftgroesse der Uhrzeit (quick-260916-bwo)', () => {
it('Test 1: das Zahlenfeld ist aus der Konfiguration vorbelegt, mit Grenzen, Platzhalter und Hilfetext', () => {
const { input } = renderExpanded();
expect(input.value).toBe('24');
expect(input.type).toBe('number');
expect(input.min).toBe('8');
expect(input.max).toBe('200');
expect(input.placeholder).toBe(clockTexts.fontSizeAuto);
expect(screen.getByText(clockTexts.fontSizeHint)).toBeInTheDocument();
});
it('Test 2: eine Zahl im Bereich wird beim Verlassen des Felds uebernommen', async () => {
const { input, onWidgetUpdate } = renderExpanded();
fireEvent.change(input, { target: { value: '36' } });
fireEvent.blur(input);
await vi.waitFor(() => expect(onWidgetUpdate).toHaveBeenCalledWith('c1', { timeFontSizePt: 36 }));
expect(updateWidgetConfig).toHaveBeenCalledTimes(1);
expect(updateWidgetConfig).toHaveBeenCalledWith('c1', { timeFontSizePt: 36 });
});
it('Test 3: leeres Feld plus Enter -> automatisch (timeFontSizePt null), keine Fehlermeldung', async () => {
const { input } = renderExpanded();
fireEvent.change(input, { target: { value: '' } });
fireEvent.keyDown(input, { key: 'Enter' });
await vi.waitFor(() => expect(updateWidgetConfig).toHaveBeenCalledWith('c1', { timeFontSizePt: null }));
expect(screen.queryByRole('alert')).not.toBeInTheDocument();
});
it('Test 4: ausserhalb 8..200 -> Fehlermeldung, aria-invalid, KEIN Aufruf', () => {
const { input } = renderExpanded();
fireEvent.change(input, { target: { value: '300' } });
fireEvent.blur(input);
expect(updateWidgetConfig).not.toHaveBeenCalled();
expect(screen.getByRole('alert')).toHaveTextContent(clockTexts.fontSizeInvalid);
expect(input.getAttribute('aria-invalid')).toBe('true');
fireEvent.change(input, { target: { value: '7' } });
fireEvent.blur(input);
expect(updateWidgetConfig).not.toHaveBeenCalled();
expect(screen.getByRole('alert')).toBeInTheDocument();
});
});
@@ -6,6 +6,11 @@ import Link from 'next/link';
import { WIDGET_REGISTRY, type WidgetType } from '@/components/dashboard/widget-registry';
import { SearchProviderForm } from '@/components/settings/search-provider-form';
import { updateWidgetConfig } from '@/lib/dashboard-api';
import {
CLOCK_FONT_SIZE_MAX_PT,
CLOCK_FONT_SIZE_MIN_PT,
resolveClockTimeFontSizePt,
} from '@/components/dashboard/widgets/clock-font-size';
/**
* IANA timezones offered for clock configuration (D-12).
@@ -206,6 +211,35 @@ function ClockConfig({
const timezone = (config.timezone as string) || 'Europe/Berlin';
const showDate = config.showDate === true;
// quick-260916-bwo: feste Schriftgroesse der Uhrzeit in Punkt (leer = automatisch).
// Entwurf als Text im Feld, Uebernahme bei Blur oder Enter; Grenzen aus
// clock-font-size.ts — dieselben, die das Widget beim Rendern anwendet (T-BWO-01).
const [fontSizeDraft, setFontSizeDraft] = useState(() => {
const pt = resolveClockTimeFontSizePt(config);
return pt === null ? '' : String(pt);
});
const [fontSizeError, setFontSizeError] = useState(false);
const commitFontSize = () => {
const raw = fontSizeDraft.trim();
if (raw === '') {
setFontSizeError(false);
if (resolveClockTimeFontSizePt(config) !== null) {
onChange({ timeFontSizePt: null });
}
return;
}
const n = Number(raw);
if (!Number.isFinite(n) || n < CLOCK_FONT_SIZE_MIN_PT || n > CLOCK_FONT_SIZE_MAX_PT) {
setFontSizeError(true);
return;
}
setFontSizeError(false);
if (n !== resolveClockTimeFontSizePt(config)) {
onChange({ timeFontSizePt: n });
}
};
return (
<div className="space-y-4">
{/* Timezone select (D-12) */}
@@ -243,6 +277,42 @@ function ClockConfig({
{t('clock.dateHint')}
</label>
</div>
{/* Schriftgroesse der Uhrzeit in Punkt (quick-260916-bwo) */}
<div>
<label htmlFor="clock-font-size" className="mb-1 block text-sm text-foreground">
{t('clock.fontSizeLabel')}
</label>
<input
id="clock-font-size"
type="number"
inputMode="decimal"
min={CLOCK_FONT_SIZE_MIN_PT}
max={CLOCK_FONT_SIZE_MAX_PT}
step={1}
placeholder={t('clock.fontSizeAuto')}
value={fontSizeDraft}
onChange={(e) => setFontSizeDraft(e.target.value)}
onBlur={commitFontSize}
onKeyDown={(e) => {
if (e.key === 'Enter') {
e.preventDefault();
commitFontSize();
}
}}
aria-invalid={fontSizeError || undefined}
aria-describedby="clock-font-size-hint"
className="h-9 w-full max-w-xs rounded border border-border bg-background px-3 text-sm text-foreground"
/>
<p id="clock-font-size-hint" className="mt-1 text-xs text-muted-foreground">
{t('clock.fontSizeHint')}
</p>
{fontSizeError && (
<p role="alert" className="mt-1 text-xs text-destructive">
{t('clock.fontSizeInvalid')}
</p>
)}
</div>
</div>
);
}
+190
View File
@@ -0,0 +1,190 @@
import { afterEach, describe, expect, it, vi } from 'vitest';
import { filterChangelogForChannel } from './changelog';
/**
* changelog.test — Kanalregel fuer die Seite "Was ist neu" (quick-260916-dcz).
*
* `filterChangelogForChannel` ist eine reine Funktion ueber dem Markdown-Text
* von CHANGELOG.md: auf `live` verschwindet der Abschnitt "Unveröffentlicht",
* auf `beta`/`dev` bleibt er mit der Ueberschrift "Noch nicht freigegeben
* (Beta)"; H1 und Vorspann entfallen immer. Test 1 ist die Falsifizierung (a)
* des Plans: er wird rot, sobald die Funktion den Abschnitt nicht entfernt.
* Tests 9/10 pruefen die Bauzeit-Einbettung ueber `TESSERA_CHANGELOG_MD`
* (Muster: app-version.test.ts — stubEnv + resetModules + dynamischer Import).
*/
const SAMPLE = [
'# Änderungen an Tessera',
'',
'Vorspann: die neueste Version steht oben.',
'',
'## Unveröffentlicht',
'',
'### Geändert',
'',
'- Punkt U1 (noch nicht freigegeben)',
'- Punkt U2 (noch nicht freigegeben)',
'',
'## 1.0.0 – 2026-09-15',
'',
'### Neu',
'',
'- Punkt A der Version 1.0.0',
'- Punkt B der Version 1.0.0',
'',
'## 0.9.0 – 2026-09-01',
'',
'### Neu',
'',
'- Punkt C der Version 0.9.0',
'',
].join('\n');
afterEach(() => {
vi.unstubAllEnvs();
});
describe('filterChangelogForChannel (quick-260916-dcz)', () => {
it('Test 1 (live): entfernt den Abschnitt Unveröffentlicht samt Punkten, behaelt die Versionen in Reihenfolge', () => {
const result = filterChangelogForChannel(SAMPLE, 'live');
expect(result.hasUnreleased).toBe(false);
expect(result.markdown).not.toContain('## Unveröffentlicht');
expect(result.markdown).not.toContain('Punkt U1');
expect(result.markdown).not.toContain('Punkt U2');
expect(result.markdown).toContain('## 1.0.0 – 2026-09-15');
expect(result.markdown).toContain('## 0.9.0 – 2026-09-01');
expect(result.markdown).toContain('- Punkt A der Version 1.0.0');
expect(result.markdown).toContain('- Punkt C der Version 0.9.0');
expect(result.markdown.indexOf('## 1.0.0')).toBeLessThan(result.markdown.indexOf('## 0.9.0'));
});
it('Test 2 (beta): ersetzt die Ueberschrift durch "Noch nicht freigegeben (Beta)", Punkte bleiben', () => {
const result = filterChangelogForChannel(SAMPLE, 'beta');
expect(result.hasUnreleased).toBe(true);
expect(result.markdown).toContain('## Noch nicht freigegeben (Beta)');
expect(result.markdown).not.toContain('## Unveröffentlicht');
expect(result.markdown).toContain('- Punkt U1');
expect(result.markdown).toContain('- Punkt U2');
expect(result.markdown).toContain('## 1.0.0 – 2026-09-15');
});
it('Test 3 (dev): verhaelt sich wie beta', () => {
const result = filterChangelogForChannel(SAMPLE, 'dev');
expect(result.hasUnreleased).toBe(true);
expect(result.markdown).toContain('## Noch nicht freigegeben (Beta)');
expect(result.markdown).not.toContain('## Unveröffentlicht');
expect(result.markdown).toContain('- Punkt U1');
});
it('Test 4 (eigenes Label): options.unreleasedHeading bestimmt die Ueberschrift', () => {
const result = filterChangelogForChannel(SAMPLE, 'beta', {
unreleasedHeading: 'Not yet released (beta)',
});
expect(result.markdown).toContain('## Not yet released (beta)');
expect(result.markdown).not.toContain('## Noch nicht freigegeben (Beta)');
});
it('Test 5 (leerer Abschnitt, beta): Unveröffentlicht ohne Listenpunkt wird ausgeblendet', () => {
const empty = [
'# Titel',
'',
'## Unveröffentlicht',
'',
'### Neu',
'',
'## 1.0.0 – 2026-09-15',
'',
'- Punkt A der Version 1.0.0',
'',
].join('\n');
const result = filterChangelogForChannel(empty, 'beta');
expect(result.hasUnreleased).toBe(false);
expect(result.markdown).not.toContain('Unveröffentlicht');
expect(result.markdown).not.toContain('Noch nicht freigegeben');
expect(result.markdown).toContain('## 1.0.0 – 2026-09-15');
expect(result.markdown).toContain('- Punkt A der Version 1.0.0');
});
it('Test 6 (kein Abschnitt): ohne Unveröffentlicht bleiben die Versionsabschnitte unveraendert', () => {
const noUnreleased = [
'# Titel',
'',
'## 1.0.0 – 2026-09-15',
'',
'### Neu',
'',
'- Punkt A der Version 1.0.0',
'',
'## 0.9.0 – 2026-09-01',
'',
'- Punkt C der Version 0.9.0',
'',
].join('\n');
const expected = [
'## 1.0.0 – 2026-09-15',
'',
'### Neu',
'',
'- Punkt A der Version 1.0.0',
'',
'## 0.9.0 – 2026-09-01',
'',
'- Punkt C der Version 0.9.0',
'',
].join('\n');
const beta = filterChangelogForChannel(noUnreleased, 'beta');
const live = filterChangelogForChannel(noUnreleased, 'live');
expect(beta.hasUnreleased).toBe(false);
expect(live.hasUnreleased).toBe(false);
expect(beta.markdown).toBe(expected);
expect(live.markdown).toBe(expected);
});
it('Test 7 (Hierarchie): H1 und Vorspann fehlen, Ergebnis beginnt mit "## ", "### " bleibt', () => {
const result = filterChangelogForChannel(SAMPLE, 'beta');
expect(result.markdown).not.toContain('# Änderungen an Tessera');
expect(result.markdown).not.toContain('Vorspann:');
expect(result.markdown.trim().startsWith('## ')).toBe(true);
expect(result.markdown).toContain('### Geändert');
expect(result.markdown).toContain('### Neu');
});
it('Test 8 (CRLF): Windows-Zeilenenden werden normalisiert, live entfernt den Abschnitt ebenfalls', () => {
const crlf = SAMPLE.replace(/\n/g, '\r\n');
const result = filterChangelogForChannel(crlf, 'live');
expect(result.hasUnreleased).toBe(false);
expect(result.markdown).not.toContain('\r');
expect(result.markdown).not.toContain('Unveröffentlicht');
expect(result.markdown).toContain('## 1.0.0 – 2026-09-15');
});
it('Test 9 (Einbettung): changelogMarkdown ist exakt der Wert von TESSERA_CHANGELOG_MD', async () => {
const text = '# T\n\n## 1.0.0 – 2026-01-01\n\n- x';
vi.stubEnv('TESSERA_CHANGELOG_MD', text);
vi.resetModules();
const mod = await import('./changelog');
expect(mod.changelogMarkdown).toBe(text);
});
it('Test 10 (ohne Variable): changelogMarkdown ist ein leerer String', async () => {
vi.stubEnv('TESSERA_CHANGELOG_MD', '');
vi.resetModules();
const empty = await import('./changelog');
expect(empty.changelogMarkdown).toBe('');
vi.stubEnv('TESSERA_CHANGELOG_MD', undefined);
vi.resetModules();
const unset = await import('./changelog');
expect(unset.changelogMarkdown).toBe('');
});
});
+84
View File
@@ -0,0 +1,84 @@
import type { AppChannel } from './app-version';
/**
* Aenderungsliste fuer die Seite "Was ist neu" (quick-260916-dcz).
*
* Quelle ist CHANGELOG.md im Wurzelverzeichnis; `apps/web/next.config.ts` liest
* die Datei zur Bauzeit und legt den Text als `env.TESSERA_CHANGELOG_MD` ab.
* Dieses Modul darf NUR von der Server-Seite (`app/(portal)/changelog/page.tsx`)
* importiert werden — sonst landet der Text in oeffentlich abrufbaren
* Client-Chunks unter /_next/static.
*
* Kanalregel (`filterChangelogForChannel`): auf `live` fehlt der Abschnitt
* "Unveröffentlicht" vollstaendig; auf `beta` und `dev` bleibt er und traegt
* die Ueberschrift "Noch nicht freigegeben (Beta)" (uebersetzbar). Ein leerer
* Abschnitt (ohne Listenpunkt) wird auf allen Kanaelen ausgeblendet. H1 und
* Vorspann vor der ersten `## `-Ueberschrift entfallen — die Seite hat ihren
* eigenen Titel. Reine Funktion ohne React/Next, deshalb direkt testbar.
*/
export type ChangelogChannel = AppChannel;
export interface FilteredChangelog {
markdown: string;
hasUnreleased: boolean;
}
export const UNRELEASED_HEADING = 'Unveröffentlicht';
const DEFAULT_UNRELEASED_LABEL = 'Noch nicht freigegeben (Beta)';
/**
* Wie in app-version.ts: Next.js ersetzt `process.env.<NAME>` zur Bauzeit nur,
* wenn der Ausdruck woertlich mit vollem Namen im Code steht — kein
* Destructuring, kein `process.env[name]`.
*/
export const changelogMarkdown: string = process.env.TESSERA_CHANGELOG_MD ?? '';
const SECTION_RE = /^## /;
const UNRELEASED_RE = new RegExp(`^## ${UNRELEASED_HEADING}\\s*$`);
const LIST_ITEM_RE = /^\s*[-*] /;
function splitSections(lines: string[]): string[][] {
const sections: string[][] = [];
let current: string[] | null = null;
for (const line of lines) {
if (SECTION_RE.test(line)) {
current = [line];
sections.push(current);
} else if (current) {
current.push(line);
}
// Zeilen vor der ersten `## `-Ueberschrift (H1, Vorspann) werden verworfen.
}
return sections;
}
export function filterChangelogForChannel(
markdown: string,
channel: AppChannel,
options?: { unreleasedHeading?: string },
): FilteredChangelog {
const normalized = markdown.replace(/\r\n?/g, '\n');
const sections = splitSections(normalized.split('\n'));
let hasUnreleased = false;
const kept: string[][] = [];
for (const section of sections) {
if (!UNRELEASED_RE.test(section[0])) {
kept.push(section);
continue;
}
const isEmpty = !section.slice(1).some((line) => LIST_ITEM_RE.test(line));
if (isEmpty || channel === 'live') {
continue;
}
hasUnreleased = true;
const label = options?.unreleasedHeading ?? DEFAULT_UNRELEASED_LABEL;
kept.push([`## ${label}`, ...section.slice(1)]);
}
const joined = kept.map((section) => section.join('\n')).join('\n').trim();
return { markdown: joined ? `${joined}\n` : '', hasUnreleased };
}
@@ -0,0 +1,123 @@
import { describe, expect, it } from 'vitest';
import {
GRID_SCALE_FACTOR,
GRID_VERSION,
GRID_VERSION_KEY,
migrateGridLayouts,
withGridVersion,
} from './grid-layout-migration';
/**
* grid-layout-migration.test — NEU (quick-260916-bwo, feineres Dashboard-Raster).
*
* Sieben Tests fuer die einmalige Umrechnung gespeicherter Anordnungen von
* den alten Einheiten (12 Spalten / 40 px) in die neuen (24 Spalten / 20 px).
* Kern ist T-BWO-02: die Verdopplung darf GENAU EINMAL geschehen. Der Marker
* `__gridVersion` steht dafuer im gespeicherten JSON, nie im Zustand — Test 4
* (Idempotenz) wird rot, sobald jemand die Marker-Pruefung entfernt.
*/
function altLayouts() {
return {
lg: [
{ i: 'a', x: 1, y: 2, w: 2, h: 3, minW: 2, minH: 2, moved: false, static: false },
{ i: 'b', x: 2, y: 0, w: 6, h: 2, maxW: 12, maxH: 8 },
],
md: [{ i: 'a', x: 0, y: 0, w: 2, h: 2 }],
sm: [],
xs: [],
xxs: [],
};
}
describe('grid-layout-migration (quick-260916-bwo)', () => {
it('Test 1: alte Anordnung ohne Marker -> alle Positionen und Groessen x2, migrated true, kein Marker im Ergebnis', () => {
const { layouts, migrated } = migrateGridLayouts(altLayouts());
expect(layouts.lg[0]).toEqual({
i: 'a', x: 2, y: 4, w: 4, h: 6, minW: 4, minH: 4, moved: false, static: false,
});
expect(layouts.lg[1]).toEqual({ i: 'b', x: 4, y: 0, w: 12, h: 4, maxW: 24, maxH: 16 });
expect(layouts.md[0]).toEqual({ i: 'a', x: 0, y: 0, w: 4, h: 4 });
expect(layouts.sm).toEqual([]);
expect(layouts.xs).toEqual([]);
expect(layouts.xxs).toEqual([]);
expect(migrated).toBe(true);
expect(Object.keys(layouts)).not.toContain(GRID_VERSION_KEY);
expect(GRID_SCALE_FACTOR).toBe(2);
});
it('Test 2: markierte Anordnung (__gridVersion 2) bleibt unveraendert, migrated false', () => {
const alt = altLayouts();
const { layouts, migrated } = migrateGridLayouts({ ...alt, __gridVersion: 2 });
expect(layouts).toEqual(alt);
expect(migrated).toBe(false);
expect(Object.keys(layouts)).not.toContain(GRID_VERSION_KEY);
});
it('Test 3: leere Anordnung bleibt leer, migrated false (kein Speichern noetig)', () => {
const empty = { lg: [], md: [], sm: [], xs: [], xxs: [] };
const r1 = migrateGridLayouts(empty);
expect(r1.layouts).toEqual(empty);
expect(r1.migrated).toBe(false);
const r2 = migrateGridLayouts({});
expect(r2.layouts).toEqual({});
expect(r2.migrated).toBe(false);
});
it('Test 4: Idempotenz — einmal umgerechnet und markiert wird nicht erneut verdoppelt (T-BWO-02)', () => {
const once = migrateGridLayouts(altLayouts());
const twice = migrateGridLayouts(withGridVersion(once.layouts));
expect(twice.layouts).toEqual(once.layouts);
expect(twice.migrated).toBe(false);
});
it('Test 5: withGridVersion haengt den Marker an, ohne die Eingabe zu veraendern', () => {
const { layouts } = migrateGridLayouts(altLayouts());
const marked = withGridVersion(layouts);
expect(marked[GRID_VERSION_KEY]).toBe(GRID_VERSION);
expect(GRID_VERSION).toBe(2);
expect(marked.lg).toBe(layouts.lg);
expect(marked.md).toBe(layouts.md);
expect(Object.keys(layouts)).not.toContain(GRID_VERSION_KEY);
expect((layouts as Record<string, unknown>)[GRID_VERSION_KEY]).toBeUndefined();
});
it('Test 6: Zukunft und Robustheit — Marker 3 bleibt, Zeichenketten-Marker zaehlt nicht, nicht-numerische Felder bleiben', () => {
const alt = altLayouts();
const future = migrateGridLayouts({ ...alt, __gridVersion: 3 });
expect(future.layouts).toEqual(alt);
expect(future.migrated).toBe(false);
const stringMarker = migrateGridLayouts({ ...alt, __gridVersion: '2' });
expect(stringMarker.migrated).toBe(true);
expect(stringMarker.layouts.lg[0].x).toBe(2);
expect(Object.keys(stringMarker.layouts)).not.toContain(GRID_VERSION_KEY);
const odd = migrateGridLayouts({
lg: [{ i: 'c', x: 'kaputt', y: 1, w: 2, h: 2, resizeHandles: ['se'], moved: true, static: false }],
});
expect(odd.layouts.lg[0]).toEqual({
i: 'c', x: 'kaputt', y: 2, w: 4, h: 4, resizeHandles: ['se'], moved: true, static: false,
});
expect(Number.isNaN(odd.layouts.lg[0].x)).toBe(false);
expect(odd.migrated).toBe(true);
});
it('Test 7: Fremdwerte — Nicht-Arrays werden weggelassen, Nicht-Objekte liefern eine leere Anordnung', () => {
const r = migrateGridLayouts({ lg: 'kaputt', md: null, sm: [{ i: 'a', x: 1, y: 1, w: 1, h: 1 }] });
expect(Object.keys(r.layouts)).toEqual(['sm']);
expect(r.layouts.sm[0]).toEqual({ i: 'a', x: 2, y: 2, w: 2, h: 2 });
expect(r.migrated).toBe(true);
expect(migrateGridLayouts(null)).toEqual({ layouts: {}, migrated: false });
expect(migrateGridLayouts(undefined)).toEqual({ layouts: {}, migrated: false });
expect(migrateGridLayouts(42)).toEqual({ layouts: {}, migrated: false });
expect(migrateGridLayouts([1, 2])).toEqual({ layouts: {}, migrated: false });
});
});
+98
View File
@@ -0,0 +1,98 @@
/**
* grid-layout-migration — einmalige Umrechnung gespeicherter Dashboard-
* Anordnungen in die feineren Raster-Einheiten (quick-260916-bwo).
*
* Warum: Das Raster wurde von 12 Spalten / 40 px Zeilenhoehe auf 24 Spalten /
* 20 px verdoppelt (`dashboard-grid.tsx`). Eine in ALTEN Einheiten gespeicherte
* Anordnung wuerde im neuen Raster halb so gross und an der halben Position
* erscheinen. Deshalb werden `x, y, w, h` (und, falls vorhanden, `minW, minH,
* maxW, maxH`) jedes Elements in jedem Breakpoint GENAU EINMAL mit 2
* multipliziert.
*
* Marker: Damit die Verdopplung nur einmal geschieht, traegt das gespeicherte
* JSON den Schluessel `__gridVersion: 2`. Der Marker lebt NUR im persistierten
* JSON (Spalte `DashboardLayout.layouts`, Json, kein Schema noetig) — nie im
* Zustand des Stores, der mit `Object.keys` ueber die Breakpoints iteriert und
* `.filter` auf jedem Wert aufruft (ein Zahlwert wuerde dort abstuerzen).
* `migrateGridLayouts` entfernt den Marker beim Laden, `withGridVersion`
* haengt ihn beim Speichern wieder an. Fehlt der Marker beim Speichern, wird
* beim naechsten Laden ERNEUT verdoppelt — deshalb muss JEDER Speichervorgang
* `withGridVersion` benutzen (T-BWO-02, Store-Tests pinnen das).
*
* Idempotenz: `migrateGridLayouts(withGridVersion(migrateGridLayouts(alt).layouts))`
* liefert dasselbe Ergebnis wie `migrateGridLayouts(alt)` mit `migrated: false`.
*
* Ort: Frontend, weil die Raster-Einheiten Frontend-Konstanten sind, die API
* das JSON nur durchreicht (`@IsObject()`) und so kein Schreiben auf einem
* GET und keine Aenderung am API-Dienst noetig ist. Reine Funktionen ohne
* React- oder Store-Abhaengigkeit.
*/
export const GRID_VERSION = 2;
export const GRID_VERSION_KEY = '__gridVersion';
export const GRID_SCALE_FACTOR = 2;
export interface GridLayoutItem {
i: string;
x: number;
y: number;
w: number;
h: number;
[key: string]: unknown;
}
export type GridLayouts = Record<string, GridLayoutItem[]>;
const SCALED_FIELDS = ['x', 'y', 'w', 'h', 'minW', 'minH', 'maxW', 'maxH'] as const;
function isPlainObject(value: unknown): value is Record<string, unknown> {
return typeof value === 'object' && value !== null && !Array.isArray(value);
}
/**
* Rechnet eine rohe (aus der API geladene) Anordnung in die aktuellen
* Raster-Einheiten um. Liefert die Anordnung OHNE Marker und die Angabe, ob
* etwas verdoppelt wurde (dann muss der Aufrufer sofort mit Marker speichern).
*/
export function migrateGridLayouts(raw: unknown): { layouts: GridLayouts; migrated: boolean } {
if (!isPlainObject(raw)) {
return { layouts: {}, migrated: false };
}
const markerValue = raw[GRID_VERSION_KEY];
// Nur eine Zahl ist ein Marker; alles andere (fehlend, Zeichenkette) zaehlt als alt.
const version = typeof markerValue === 'number' ? markerValue : 1;
const needsScaling = version < GRID_VERSION;
const layouts: GridLayouts = {};
let migrated = false;
for (const key of Object.keys(raw)) {
if (key === GRID_VERSION_KEY) continue;
const value = raw[key];
if (!Array.isArray(value)) continue;
layouts[key] = value.map((item) => {
const copy = { ...(item as GridLayoutItem) };
if (needsScaling) {
for (const field of SCALED_FIELDS) {
const n = copy[field];
if (typeof n === 'number') {
copy[field] = n * GRID_SCALE_FACTOR;
}
}
migrated = true;
}
return copy;
});
}
return { layouts, migrated };
}
/**
* Haengt den Marker fuer das Speichern an, ohne die Eingabe zu veraendern.
*/
export function withGridVersion(layouts: GridLayouts): Record<string, unknown> {
return { ...layouts, [GRID_VERSION_KEY]: GRID_VERSION };
}
@@ -0,0 +1,127 @@
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
/**
* dashboard-store.test — NEU (quick-260916-bwo, feineres Dashboard-Raster).
*
* Sechs Tests fuer die Anbindung der einmaligen Umrechnung im Store:
* `loadDashboard` rechnet alte Anordnungen um und speichert SOFORT mit
* Marker; `saveLayout` traegt den Marker bei JEDEM Speichern (T-BWO-02 —
* fehlt er, wuerde das naechste Laden erneut verdoppeln); der Zustand
* selbst bleibt markerfrei (der Store iteriert mit Object.keys ueber die
* Breakpoints); `addWidget` legt neue Eintraege in den verdoppelten
* Vorgabegroessen an. Der Store hatte bisher keine Testdatei.
*/
vi.mock('@/lib/dashboard-api', () => ({
fetchLayout: vi.fn(),
fetchWidgets: vi.fn(),
saveLayout: vi.fn(),
addWidget: vi.fn(),
removeWidget: vi.fn(),
updateWidgetConfig: vi.fn(),
}));
import * as api from '@/lib/dashboard-api';
const { useDashboardStore } = await import('./dashboard-store');
const EMPTY = { lg: [], md: [], sm: [], xs: [], xxs: [] };
beforeEach(() => {
useDashboardStore.setState({
layouts: { lg: [], md: [], sm: [], xs: [], xxs: [] },
widgets: [],
isEditMode: false,
isDirty: false,
isLoading: false,
error: null,
});
vi.clearAllMocks();
vi.mocked(api.fetchWidgets).mockResolvedValue([]);
vi.mocked(api.saveLayout).mockResolvedValue(undefined);
});
afterEach(() => {
vi.restoreAllMocks();
});
describe('dashboard-store — einmalige Umrechnung mit Marker (quick-260916-bwo)', () => {
it('Test 1: alte Anordnung wird beim Laden umgerechnet und SOFORT mit Marker gespeichert', async () => {
vi.mocked(api.fetchLayout).mockResolvedValue({
lg: [{ i: 'a', x: 1, y: 1, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [],
});
await useDashboardStore.getState().loadDashboard();
const state = useDashboardStore.getState();
expect(state.layouts.lg[0]).toEqual({ i: 'a', x: 2, y: 2, w: 4, h: 4 });
expect(Object.keys(state.layouts)).not.toContain('__gridVersion');
expect(api.saveLayout).toHaveBeenCalledTimes(1);
expect(api.saveLayout).toHaveBeenCalledWith(
expect.objectContaining({ __gridVersion: 2, lg: [{ i: 'a', x: 2, y: 2, w: 4, h: 4 }] }),
);
expect(state.isDirty).toBe(false);
expect(state.isLoading).toBe(false);
expect(state.error).toBeNull();
});
it('Test 2: markierte Anordnung bleibt unveraendert, kein Speichern, kein Marker im Zustand', async () => {
vi.mocked(api.fetchLayout).mockResolvedValue({
lg: [{ i: 'a', x: 1, y: 1, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [], __gridVersion: 2,
});
await useDashboardStore.getState().loadDashboard();
const state = useDashboardStore.getState();
expect(state.layouts.lg[0]).toEqual({ i: 'a', x: 1, y: 1, w: 2, h: 2 });
expect(api.saveLayout).not.toHaveBeenCalled();
expect(Object.keys(state.layouts)).not.toContain('__gridVersion');
});
it('Test 3: leere Vorgabe-Anordnung ohne Marker -> kein Speichern', async () => {
vi.mocked(api.fetchLayout).mockResolvedValue({ ...EMPTY });
await useDashboardStore.getState().loadDashboard();
expect(api.saveLayout).not.toHaveBeenCalled();
expect(useDashboardStore.getState().layouts).toEqual(EMPTY);
});
it('Test 4: jedes Speichern traegt den Marker (T-BWO-02), der Zustand bleibt markerfrei', async () => {
const layouts = { lg: [{ i: 'a', x: 2, y: 2, w: 4, h: 4 }], md: [], sm: [], xs: [], xxs: [] };
useDashboardStore.getState().updateLayouts(layouts);
expect(useDashboardStore.getState().isDirty).toBe(true);
await useDashboardStore.getState().saveLayout();
expect(api.saveLayout).toHaveBeenCalledTimes(1);
expect(api.saveLayout).toHaveBeenCalledWith(expect.objectContaining({ __gridVersion: 2, ...layouts }));
expect(useDashboardStore.getState().isDirty).toBe(false);
expect(Object.keys(useDashboardStore.getState().layouts)).not.toContain('__gridVersion');
});
it('Test 5: scheitert das Sofort-Speichern, bleibt der Zustand umgerechnet, kein Fehlerzustand, console.error einmal', async () => {
vi.mocked(api.fetchLayout).mockResolvedValue({
lg: [{ i: 'a', x: 1, y: 1, w: 2, h: 2 }], md: [], sm: [], xs: [], xxs: [],
});
vi.mocked(api.saveLayout).mockRejectedValue(new Error('PUT failed'));
const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
await expect(useDashboardStore.getState().loadDashboard()).resolves.toBeUndefined();
const state = useDashboardStore.getState();
expect(state.layouts.lg[0].x).toBe(2);
expect(state.error).toBeNull();
expect(state.isLoading).toBe(false);
expect(errorSpy).toHaveBeenCalledTimes(1);
});
it('Test 6: neues Widget wird in den neuen (verdoppelten) Vorgabegroessen angelegt', async () => {
vi.mocked(api.addWidget).mockResolvedValue({ id: 'n1', widgetType: 'clock', config: {} });
await useDashboardStore.getState().addWidget('clock');
const state = useDashboardStore.getState();
expect(state.layouts.lg).toContainEqual({ i: 'n1', x: 0, y: 0, w: 4, h: 4 });
expect(state.isDirty).toBe(true);
});
});
+23 -3
View File
@@ -2,6 +2,7 @@ import { create } from 'zustand';
import * as api from '@/lib/dashboard-api';
import type { WidgetType } from '@/components/dashboard/widget-registry';
import { WIDGET_CONSTRAINTS } from '@/components/dashboard/widget-registry';
import { migrateGridLayouts, withGridVersion } from '@/lib/grid-layout-migration';
export interface WidgetInstance {
id: string;
@@ -28,6 +29,14 @@ interface DashboardState {
/**
* Dashboard Zustand store. NO persist middleware — layout comes from DB (D-05).
* Save only on exiting edit mode (D-01), not on every drag.
*
* quick-260916-bwo: Gespeicherte Anordnungen in alten Raster-Einheiten werden
* beim Laden einmalig umgerechnet (`migrateGridLayouts`) und sofort mit dem
* Marker `__gridVersion` zurueckgeschrieben. Der Marker lebt NUR im
* gespeicherten JSON, nie im Zustand (dieser Store iteriert mit Object.keys
* ueber die Breakpoints). Fehlt der Marker beim Speichern, wird beim naechsten
* Laden erneut verdoppelt — deshalb `withGridVersion` an BEIDEN Speicherstellen
* (Sofort-Speichern nach der Umrechnung und `saveLayout`), T-BWO-02.
*/
export const useDashboardStore = create<DashboardState>()((set, get) => ({
layouts: { lg: [], md: [], sm: [], xs: [], xxs: [] },
@@ -108,15 +117,26 @@ export const useDashboardStore = create<DashboardState>()((set, get) => ({
loadDashboard: async () => {
set({ isLoading: true, error: null });
try {
const [layouts, widgets] = await Promise.all([
const [rawLayouts, widgets] = await Promise.all([
api.fetchLayout(),
api.fetchWidgets(),
]);
const { layouts: migratedLayouts, migrated } = migrateGridLayouts(rawLayouts);
set({
layouts: layouts as DashboardState['layouts'],
layouts: migratedLayouts,
widgets,
isLoading: false,
});
// Umgerechnete Anordnung SOFORT mit Marker persistieren — nach dem set,
// damit die Oberflaeche unabhaengig vom Speichern rendert; eigener
// try/catch, damit ein Speicherfehler NICHT als Ladefehler erscheint.
if (migrated) {
try {
await api.saveLayout(withGridVersion(migratedLayouts));
} catch (err) {
console.error('Failed to persist migrated layout:', err);
}
}
} catch {
set({
error: 'Failed to load dashboard',
@@ -127,7 +147,7 @@ export const useDashboardStore = create<DashboardState>()((set, get) => ({
saveLayout: async () => {
try {
await api.saveLayout(get().layouts);
await api.saveLayout(withGridVersion(get().layouts));
set({ isDirty: false });
} catch (err) {
console.error('Failed to save layout:', err);
+38 -4
View File
@@ -109,7 +109,8 @@
"beta": "Beta",
"live": "Live",
"dev": "Entwicklung"
}
},
"whatsNew": "Was ist neu"
},
"dashboard": {
"title": "Dashboard",
@@ -179,6 +180,7 @@
"addWidget": "Widget hinzufügen",
"catalogTitle": "Widget hinzufügen",
"deleteTooltip": "Widget entfernen",
"dragHint": "Ziehen Sie die Kachel, um sie zu verschieben",
"editMode": "Dashboard bearbeiten",
"saveChanges": "Änderungen speichern",
"layoutLoadError": "Dashboard konnte nicht geladen werden. Bitte laden Sie die Seite neu.",
@@ -186,7 +188,11 @@
"clock": {
"name": "Uhr",
"description": "Zeigt die aktuelle Uhrzeit an",
"dateHint": "Datum anzeigen"
"dateHint": "Datum anzeigen",
"fontSizeLabel": "Schriftgröße der Uhrzeit (Punkt)",
"fontSizeAuto": "automatisch",
"fontSizeHint": "Leer lassen, dann richtet sich die Uhrzeit nach der Größe der Kachel. Ein Wert zwischen 8 und 200 legt die Schrift fest, unabhängig von der Kachelgröße.",
"fontSizeInvalid": "Bitte geben Sie eine Zahl zwischen 8 und 200 ein oder lassen Sie das Feld leer."
},
"search": {
"name": "Suchleiste",
@@ -205,7 +211,27 @@
"connectionSuccess": "Verbindung erfolgreich",
"connectionError": "Verbindung fehlgeschlagen. Bitte überprüfen Sie die URL und Zugangsdaten.",
"addSource": "Quelle hinzufügen",
"sourceEmpty": "Keine Kalenderquellen eingerichtet. Fügen Sie eine Quelle hinzu, um Termine anzuzeigen."
"sourceEmpty": "Keine Kalenderquellen eingerichtet. Fügen Sie eine Quelle hinzu, um Termine anzuzeigen.",
"formFieldName": "Name",
"formFieldType": "Typ",
"formFieldExchangeMode": "Exchange-Anbindung",
"formFieldDomain": "Domäne",
"formFieldDomainHint": "Optional – nur nötig, wenn Ihr Exchange-Server die Anmeldung als DOMÄNE\\Benutzer erwartet.",
"formFieldUrl": "Adresse (URL)",
"formFieldUsername": "Benutzername",
"formFieldPassword": "Passwort",
"formFieldColor": "Farbe",
"formSave": "Speichern",
"formSaving": "Wird gespeichert …",
"formTestConnection": "Verbindung testen",
"formTesting": "Verbindung wird geprüft …",
"formTestSuccess": "Verbindung erfolgreich.",
"formTestFailed": "Verbindung fehlgeschlagen. Bitte prüfen Sie Adresse und Zugangsdaten.",
"formCancel": "Abbrechen",
"formUrlErrorHttps": "Die Adresse muss mit https:// beginnen.",
"formUrlErrorInvalid": "Bitte geben Sie eine gültige Adresse ein.",
"saveSuccess": "Kalenderquelle gespeichert.",
"saveError": "Die Kalenderquelle konnte nicht gespeichert werden."
},
"note": {
"name": "Notizen",
@@ -507,6 +533,13 @@
"errorSendFailed": "Die E-Mail konnte nicht gesendet werden. Bitte versuchen Sie es später erneut oder wenden Sie sich an Ihren Administrator.",
"errorGeneric": "Die Meldung konnte nicht gesendet werden."
},
"changelog": {
"title": "Was ist neu",
"intro": "Alle Änderungen an Tessera, sortiert nach Version – die aktuelle Version steht oben.",
"unreleasedHeading": "Noch nicht freigegeben (Beta)",
"unreleasedHint": "Die Punkte unter „Noch nicht freigegeben“ sind in dieser Beta bereits enthalten, aber noch nicht als Version freigegeben.",
"empty": "Noch keine Einträge vorhanden."
},
"locale": {
"de": "Deutsch",
"en": "English"
@@ -661,7 +694,8 @@
"detailStatusInactive": "Nicht aktiviert",
"accessDenied": "Zugriff verweigert",
"statusNoAccess": "Kein Zugriff",
"toastNoAccess": "Kein Zugriff auf dieses Modul — wenden Sie sich an Ihren Administrator."
"toastNoAccess": "Kein Zugriff auf dieses Modul — wenden Sie sich an Ihren Administrator.",
"notFound": "Dieses Modul wurde nicht gefunden."
},
"certManager": {
"title": "Zertifikat-Manager",
+38 -4
View File
@@ -109,7 +109,8 @@
"beta": "Beta",
"live": "Live",
"dev": "Development"
}
},
"whatsNew": "What's new"
},
"dashboard": {
"title": "Dashboard",
@@ -179,6 +180,7 @@
"addWidget": "Add widget",
"catalogTitle": "Add widget",
"deleteTooltip": "Remove widget",
"dragHint": "Drag the tile to move it",
"editMode": "Edit dashboard",
"saveChanges": "Save changes",
"layoutLoadError": "Could not load dashboard. Please reload the page.",
@@ -186,7 +188,11 @@
"clock": {
"name": "Clock",
"description": "Shows the current time",
"dateHint": "Show date"
"dateHint": "Show date",
"fontSizeLabel": "Font size of the time (pt)",
"fontSizeAuto": "automatic",
"fontSizeHint": "Leave empty and the time follows the size of the tile. A value between 8 and 200 fixes the font size regardless of the tile size.",
"fontSizeInvalid": "Please enter a number between 8 and 200 or leave the field empty."
},
"search": {
"name": "Search",
@@ -205,7 +211,27 @@
"connectionSuccess": "Connection successful",
"connectionError": "Connection failed. Please check the URL and credentials.",
"addSource": "Add source",
"sourceEmpty": "No calendar sources configured. Add a source to display events."
"sourceEmpty": "No calendar sources configured. Add a source to display events.",
"formFieldName": "Name",
"formFieldType": "Type",
"formFieldExchangeMode": "Exchange connection",
"formFieldDomain": "Domain",
"formFieldDomainHint": "Optional – only needed if your Exchange server expects DOMAIN\\user for sign-in.",
"formFieldUrl": "Address (URL)",
"formFieldUsername": "Username",
"formFieldPassword": "Password",
"formFieldColor": "Color",
"formSave": "Save",
"formSaving": "Saving …",
"formTestConnection": "Test connection",
"formTesting": "Checking connection …",
"formTestSuccess": "Connection successful.",
"formTestFailed": "Connection failed. Please check the address and credentials.",
"formCancel": "Cancel",
"formUrlErrorHttps": "The address must start with https://.",
"formUrlErrorInvalid": "Please enter a valid address.",
"saveSuccess": "Calendar source saved.",
"saveError": "The calendar source could not be saved."
},
"note": {
"name": "Notes",
@@ -507,6 +533,13 @@
"errorSendFailed": "The e-mail could not be sent. Please try again later or contact your administrator.",
"errorGeneric": "The report could not be sent."
},
"changelog": {
"title": "What's new",
"intro": "All changes to Tessera, sorted by version – the current version is at the top.",
"unreleasedHeading": "Not yet released (beta)",
"unreleasedHint": "The items under “Not yet released” are already part of this beta but have not been released as a version yet.",
"empty": "No entries yet."
},
"locale": {
"de": "Deutsch",
"en": "English"
@@ -661,7 +694,8 @@
"detailStatusInactive": "Not activated",
"accessDenied": "Access denied",
"statusNoAccess": "No Access",
"toastNoAccess": "No access to this module — please contact your administrator."
"toastNoAccess": "No access to this module — please contact your administrator.",
"notFound": "This module was not found."
},
"certManager": {
"title": "Certificate Manager",
+15 -8
View File
@@ -17,7 +17,8 @@ Diese Anleitung richtet sich an alle Kolleginnen und Kollegen, die Tessera im Ar
- [Domaincheck](#domaincheck)
7. [Persönliche Einstellungen](#persönliche-einstellungen)
8. [Einen Fehler melden](#einen-fehler-melden)
9. [Häufige Stolpersteine](#häufige-stolpersteine)
9. [Was ist neu](#was-ist-neu)
10. [Häufige Stolpersteine](#häufige-stolpersteine)
---
@@ -52,17 +53,17 @@ Links steht das Tessera-Logo, in der Mitte der aktuelle Seitentitel. Rechts find
**Seitenleiste (links)**
Ganz oben stehen zwei feste Einträge: **Dashboard** (Ihre Startseite) und **Marktplatz**. Darunter folgt ein Suchfeld „Module suchen…", mit dem Sie die Modulliste filtern können, und darunter die Liste der für Sie freigegebenen Module, gruppiert nach **Kategorien**. Ein Klick auf eine Kategorie klappt sie auf und zeigt die einzelnen Module darin. Sind für Sie noch keine Module aktiv, steht dort „Keine Module".
Unten in der Seitenleiste finden Sie die Sprachumschaltung (Deutsch/English) sowie Ihren Namen mit Rolle. Über den Pfeil-Button am unteren Rand können Sie die Seitenleiste ein- und wieder ausklappen — im eingeklappten Zustand bleiben nur die Symbole sichtbar, das spart Platz auf kleineren Bildschirmen.
Unten in der Seitenleiste finden Sie die Sprachumschaltung (Deutsch/English) sowie Ihren Namen mit Rolle. Über den Pfeil-Button am unteren Rand können Sie die Seitenleiste ein- und wieder ausklappen — im eingeklappten Zustand bleiben nur die Symbole sichtbar, das spart Platz auf kleineren Bildschirmen. Ganz unten steht die Versionsnummer von Tessera; ein Klick darauf öffnet die Seite [Was ist neu](#was-ist-neu).
## Dashboard
Das Dashboard ist Ihre persönliche Startseite und öffnet sich automatisch nach der Anmeldung. Es zeigt ein Raster aus Kacheln — den **Widgets**. Ist noch kein Widget platziert, sehen Sie nur das Tessera-Symbol mit dem Hinweis „Keine Widgets aktiv".
**Widgets hinzufügen und anordnen:** Oben rechts auf dem Dashboard befindet sich der Schalter **„Dashboard bearbeiten"**. Sobald der Bearbeitungsmodus aktiv ist:
**Widgets hinzufügen und anordnen:** Unten rechts auf dem Dashboard schwebt der Stift-Schalter **„Dashboard bearbeiten"**; im Bearbeitungsmodus wird daraus ein Häkchen **„Änderungen speichern"**, und daneben erscheint **„Widget hinzufügen"**. Sobald der Bearbeitungsmodus aktiv ist:
- Erscheint der Button **„Widget hinzufügen"**, der eine Auswahl aller verfügbaren Widget-Typen als Kachel-Katalog öffnet. Ein Klick auf einen Eintrag fügt das Widget sofort dem Dashboard hinzu.
- Können Sie bestehende Widgets per Ziehen an eine neue Position verschieben.
- Können Sie Widgets an der Ecke in der Größe ziehen (jeder Widget-Typ hat eine Mindestgröße, damit der Inhalt lesbar bleibt).
- Erscheint an jedem Widget ein Symbol zum Entfernen.
- Können Sie bestehende Widgets per Ziehen an eine neue Position verschieben. Fassen Sie die Kachel dazu an einer beliebigen Stelle an — Eingabefelder, Knöpfe und Links ausgenommen; ein grauer Griff am oberen Kachelrand zeigt, dass die Kachel beweglich ist. Abgelegt wird nur dort, wo Platz ist: über einer anderen Kachel springt sie an ihren Ausgangspunkt zurück.
- Können Sie Widgets an der Ecke in der Größe ziehen (jeder Widget-Typ hat eine Mindestgröße, bei der er gerade noch bedienbar bleibt — kleiner geht es nicht, größer jederzeit). Position und Größe rasten dabei in feinen Schritten ein, sodass sich auch kleine Anpassungen vornehmen lassen.
- Erscheint an jedem Widget rechts im Griff ein Symbol zum Entfernen.
Ihre Änderungen werden über **„Änderungen speichern"** übernommen. Verlassen Sie den Bearbeitungsmodus, ist das Dashboard wieder fest — Verschieben und Größenänderung sind dann gesperrt, damit Sie es im normalen Gebrauch nicht versehentlich verstellen.
@@ -70,7 +71,7 @@ Ihre Änderungen werden über **„Änderungen speichern"** übernommen. Verlass
| Widget | Zweck |
|---|---|
| Uhr | Zeigt die aktuelle Uhrzeit an (optional mit Datum) |
| Uhr | Zeigt die aktuelle Uhrzeit an (optional mit Datum). Die Uhrzeit wächst und schrumpft mit der Kachel; wer eine feste Größe möchte, stellt sie unter Einstellungen > Dashboard als Schriftgröße in Punkt ein |
| Suchleiste | Schnellsuche im Web über frei konfigurierbare Suchanbieter |
| Kalender | Zeigt kommende Termine aus Ihren verbundenen Kalenderquellen |
| Notizen | Freitext-Notizen mit Markdown-Formatierung |
@@ -79,7 +80,7 @@ Ihre Änderungen werden über **„Änderungen speichern"** übernommen. Verlass
| Link | Schnellzugriff auf genau einen einzelnen Link |
| Stoppuhr | Zeitmessung mit Rundenzeiten |
Für Suchleiste, Kalender, Favoriten und Link gibt es zusätzliche Einstellungen (z. B. eigene Suchanbieter, Kalenderquellen, hinterlegte Links) — diese finden Sie unter **Einstellungen > Dashboard**, siehe [Persönliche Einstellungen](#persönliche-einstellungen).
Für Uhr, Suchleiste, Kalender, Favoriten und Link gibt es zusätzliche Einstellungen (z. B. Zeitzone und Schriftgröße der Uhr, eigene Suchanbieter, Kalenderquellen, hinterlegte Links) — diese finden Sie unter **Einstellungen > Dashboard**, siehe [Persönliche Einstellungen](#persönliche-einstellungen).
## Marktplatz
@@ -169,6 +170,12 @@ Mit **Senden** gehen folgende Angaben als E-Mail an Ihren Administrator: das Bil
Nach dem Senden erscheint „Vielen Dank, die Meldung wurde gesendet." Falls das nicht klappt, sagt Ihnen Tessera, warum: Entweder ist noch kein Postfach für Fehlermeldungen eingerichtet (dann sprechen Sie Ihren Administrator an), oder Sie haben in kurzer Zeit zu viele Meldungen geschickt (höchstens fünf in zehn Minuten), oder die E-Mail konnte gerade nicht gesendet werden (dann versuchen Sie es später noch einmal). Mit **Abbrechen** oder der Escape-Taste schließen Sie das Fenster, ohne etwas zu senden.
## Was ist neu
Ein Klick auf die Versionsnummer ganz unten in der Seitenleiste öffnet die Seite **Was ist neu**. Sie zeigt die Änderungsliste von Tessera: Für jede Version steht dort in einfachen Worten, was neu hinzugekommen ist, was sich geändert hat und was behoben wurde — gegliedert in die Gruppen **Neu**, **Geändert** und **Behoben**. Die neueste Version steht oben.
Auf dem Live-System sehen Sie nur freigegebene Versionen. Auf der Beta erscheint zusätzlich der Abschnitt **Noch nicht freigegeben (Beta)** mit einem gelben Hinweis: Diese Punkte sind in der Beta bereits enthalten, aber noch nicht als Version freigegeben.
## Häufige Stolpersteine
- **Die Anmeldung schlägt fehl, obwohl Passwort und E-Mail stimmen.** Prüfen Sie, ob Sie im Feld „Benutzername" tatsächlich Ihren Benutzernamen eingegeben haben — nicht Ihre E-Mail-Adresse. Das ist mit Abstand der häufigste Grund für eine scheinbar kaputte Anmeldung.
+30 -8
View File
@@ -421,15 +421,22 @@ docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d --force-recreate api web
```
Hinweis: Die Vorlage `.env.prod.example` im Repository enthält die Zeile
`IMAGE_TAG` noch nicht. Wer eine neue `.env` aus der Vorlage anlegt, ergänzt die
Zeile von Hand.
Hinweis: Die Vorlage `.env.prod.example` im Repository enthält die Zeilen
`IMAGE_TAG=live` und `COMPOSE_FILE=docker-compose.prod.yml` bereits. Wer eine neue
`.env` aus der Vorlage anlegt, setzt `IMAGE_TAG` nur noch auf den gewünschten
Kanal; auf einer älteren, von Hand gepflegten `.env` (wie auf alpha) werden die
Zeilen einmal ergänzt.
### Eine Version freigeben
Das Freigeben erledigt Claude; Sie sagen nur „Version X freigeben“. Zur Einordnung,
was dabei passiert:
1. **Änderungsliste abschließen:** In `CHANGELOG.md` wird der Abschnitt
„Unveröffentlicht“ in „X.Y.Z – JJJJ-MM-TT“ umbenannt, darüber ein neues, leeres
„Unveröffentlicht“ angelegt, und das Ganze auf `main` committet und gepusht.
Erst dann wird zusammengeführt und getaggt:
```bash
git checkout live
git merge --ff-only main
@@ -443,6 +450,14 @@ weigert, ist eine frühere Korrektur (siehe Hotfix, Schritt 5) noch nicht zurüc
Zweig `live` wird nur geprüft, der Tag `vX.Y.Z` wird gebaut und als `live` und
`vX.Y.Z` abgelegt. Das dauert etwa vier bis sechs Minuten.
Beim Tag legt die Pipeline zusätzlich einen **Release in Gitea** an: Name
„Tessera X.Y.Z“, Text ist der Abschnitt dieser Version aus `CHANGELOG.md`. Sie
finden ihn im Repository unter „Releases“. Fehlt der Abschnitt in der
Änderungsliste, schlägt genau dieser letzte Schritt fehl – die Abbilder sind dann
trotzdem gebaut und abgelegt. Der Release wird nachgeholt, sobald der Abschnitt
nachgetragen ist: entweder durch erneutes Auslösen des Tag-Laufs oder lokal per
Skript (`.gitea/scripts/publish-release.sh --tag vX.Y.Z`).
Danach spielen Sie die Version auf dem Live-Server ein – Kapitel 4 gilt unverändert:
```bash
@@ -450,10 +465,12 @@ docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d --force-recreate api web
```
**Erstfreigabe v1.0.0:** Den Zweig `live` gibt es noch nicht. Er entsteht beim
ersten Mal aus `main` (`git checkout -b live main`), bekommt den Tag `v1.0.0` und
wird zusammen mit dem Tag gepusht. Das erfolgt, sobald der Knopf „Fehler melden“
eingebaut ist – nicht in diesem Durchlauf.
**Erstfreigabe v1.0.0:** Die erste Freigabe ist erfolgt. Der Zweig `live`
entstand am 2026-09-14 aus `main` (`git checkout -b live main`), bekam den Tag
`v1.0.0` und wurde zusammen mit dem Tag gepusht; seit 2026-09-15 läuft diese
Version auf dem Live-Server. Der Release „Tessera 1.0.0“ in Gitea wurde
nachträglich mit dem Skript angelegt, weil die Änderungsliste erst danach
eingeführt wurde.
### Einen Fehler auf Live beheben (Hotfix)
@@ -481,7 +498,7 @@ eine Datenbankänderung, wird sie als reguläre Version über `main` freigegeben
### Woran Sie erkennen, welche Version läuft
Drei Wege, vom einfachsten zum genauesten:
Vier Wege, vom einfachsten zum genauesten:
1. **In der Oberfläche:** Unten in der Seitenleiste steht `v1.0.0 · Live` bzw.
`v1.0.0-12-gabc1234 · Beta`. Wenn Sie die Maus darüber halten, erscheinen die
@@ -503,6 +520,11 @@ Drei Wege, vom einfachsten zum genauesten:
```
Zeigt die Startzeile `Tessera API v1.0.0 (live) abc1234` (siehe Kapitel 7).
4. **Was sich geändert hat:** Ein Klick auf die Versionszeile unten in der
Seitenleiste öffnet die Seite „Was ist neu“ mit der Änderungsliste. Auf Live
sehen Sie nur freigegebene Versionen; auf der Beta steht zusätzlich der
Abschnitt „Noch nicht freigegeben (Beta)“ mit dem, was seit der letzten
Freigabe dazugekommen ist.
### Den neuen Live-Server einrichten
+15
View File
@@ -437,6 +437,21 @@ dokumentiert das an jeder betroffenen Stelle explizit im Kommentar (`source-conf
jedem neuen `@Get(':id')`/`@Put(':id')`/`@Delete(':id')` in einem Controller mit weiteren statischen
GET-Routen: statische Routen zuerst deklarieren.
**Änderungsliste (`CHANGELOG.md`):** Jede Änderung, die Anwender oder Betrieb bemerken, wird sofort
im selben Auftrag in `CHANGELOG.md` unter „Unveröffentlicht“ eingetragen — in Alltagssprache für
Anwender, Sie-Form, echte Umlaute, gegliedert in „Neu“, „Geändert“ und „Behoben“; keine Dateinamen,
keine Commit-Kürzel, keine unerklärten Fachbegriffe. Bei der Freigabe wird der Abschnitt in
„X.Y.Z – JJJJ-MM-TT“ umbenannt und darüber ein neues leeres „Unveröffentlicht“ angelegt (siehe
Betriebshandbuch Kapitel 9). Die Seite „Was ist neu“ (`apps/web/src/app/(portal)/changelog/page.tsx`)
liest den Text zur Bauzeit aus `env.TESSERA_CHANGELOG_MD`, das `apps/web/next.config.ts` aus der
Datei befüllt — deshalb steht `COPY CHANGELOG.md ./` im Web-Dockerfile und `!CHANGELOG.md` als
Ausnahme in `.dockerignore`. Nur `page.tsx` darf `@/lib/changelog` importieren, damit der Text im
Server-Bundle bleibt und nicht in öffentlich abrufbare Client-Chunks gelangt. Die Kanalregel (Live
ohne „Unveröffentlicht“, Beta/Entwicklung mit „Noch nicht freigegeben (Beta)“) liegt in
`filterChangelogForChannel` (`apps/web/src/lib/changelog.ts`) mit Tests. Beim Tag `vX.Y.Z`
schneidet `.gitea/scripts/publish-release.sh` den Abschnitt der Version heraus und legt daraus den
Gitea-Release an — fehlt der Abschnitt, bricht dieser CI-Schritt mit Exit 1 ab.
**i18n — Schlüsselparität zwischen de.json und en.json:** Jeder benutzersichtbare Text gehört in
beide Sprachdateien, `apps/web/src/messages/de.json` und `apps/web/src/messages/en.json`. Ein
strukturelle Wächter-Test, `apps/web/src/messages/tenderRadar-parity.spec.ts`, prüft für den
+13 -5
View File
@@ -85,7 +85,7 @@ fuer die Pipeline konfiguriert. Benoetigt wird genau eines:
| Secret | Beschreibung |
|--------|--------------|
| `REGISTRY_TOKEN` | Gitea-Zugangstoken (Access Token) mit Schreibrecht auf Pakete (`package: write`). Wird im Job `publish` fuer `docker login localhost:3002 --password-stdin` verwendet. |
| `REGISTRY_TOKEN` | Gitea-Zugangstoken (Access Token) mit Schreibrecht auf Pakete (`package: write`) und zusaetzlich auf das Repository (`repository: write`, fuer Releases). Wird im Job `publish` fuer `docker login localhost:3002 --password-stdin` verwendet und im Release-Schritt ueber `env` als `GITEA_TOKEN` an `.gitea/scripts/publish-release.sh` gereicht -- nie als Argument. |
Das Token erscheint nie im Log: es wird per `--password-stdin` uebergeben und
Gitea maskiert Secret-Werte in der Job-Ausgabe. Das Veroeffentlichungs-Skript
@@ -118,10 +118,18 @@ aus drei aufeinander aufbauenden Jobs:
veroeffentlichen
Ablauf: `quality` -> `test` -> `publish` (jeder Job nur bei Erfolg des
vorherigen). Der Job `publish` besteht aus drei Schritten: `actions/checkout@v4`
vorherigen). Der Job `publish` besteht aus vier Schritten: `actions/checkout@v4`
mit `fetch-depth: 0` (volle Historie samt Tags, sonst liefert `git describe`
nichts), Login in die Registry (siehe Abschnitt 3) und der Aufruf von
`.gitea/scripts/publish-images.sh`.
nichts), Login in die Registry (siehe Abschnitt 3), der Aufruf von
`.gitea/scripts/publish-images.sh` und der Aufruf von
`.gitea/scripts/publish-release.sh` (legt bei Tags `v*` den Gitea-Release aus dem
CHANGELOG-Abschnitt an; auf `main` endet er mit "nichts zu tun").
Das Release-Skript spricht die Gitea-API ueber `GITHUB_API_URL` bzw.
`GITHUB_SERVER_URL/api/v1` an -- im Job-Container ist das
`https://git.vicolab.de`; `localhost:3002` ist von dort NICHT erreichbar (nur der
Docker-Daemon des Hosts erreicht die Registry so). Lokal laesst sich das Skript
mit `--dry-run --tag vX.Y.Z` pruefen, ohne Netzaufruf und ohne Token.
### Zwei Kanaele: Etiketten je Anlass
@@ -131,7 +139,7 @@ Das Skript `.gitea/scripts/publish-images.sh` entscheidet allein anhand
| Anlass | Kanal (`APP_CHANNEL`) | Etiketten in der Registry |
|--------|----------------------|---------------------------|
| Push auf `main` | `beta` | `beta` und `latest` (`latest` ist nur ein Alias fuer `beta` und entfaellt spaeter) |
| Tag `vX.Y.Z` | `live` | `live` und `vX.Y.Z` |
| Tag `vX.Y.Z` | `live` | `live` und `vX.Y.Z` + Gitea-Release `Tessera X.Y.Z` mit dem CHANGELOG-Abschnitt |
| Push auf `live` ohne Tag | -- | keine; der Lauf prueft nur (`quality`, `test`), das Skript endet mit "nichts zu tun" |
Das Kanalmodell fuer den Betrieb (welcher Server welches Etikett zieht, Freigabe,