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
This commit is contained in:
2026-09-16 10:29:11 +02:00
parent df16f4682a
commit ec1b0ce582
@@ -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>