Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P8b.md
T

278 lines
33 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# R-P8b · P8 Konfigurierbarer Kanban + Forecast/Reporting
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-28 → 2026-06-29 · Gate W3 |
| **Status** | Umgesetzt — 10/10 DoD (Audit 2026-07-18), Restarbeiten-PR offen · design-nachzug offen |
**🎨 design-nachzug: offen** (seit 2026-07-08) — Interim-UI aus `~/ui` (AD-28); S01/S03 des `WF-P8`-Flows am 2026-07-11 integriert, **Delta-Nachzug 2026-07-18** (PR #154: S01a/S03a-Empty-States, S01b 2-Spalten-Umbruch, M03 Kontextmenü, Karten auf neue `KanbanCard`-Slot-API). **Baseline-Nachzug 2026-07-28/29 (PR #286):** Board und Liste sind gegen Davids Handoff vom 2026-07-28 **neu** gebaut — `ProjectCard` statt `KanbanCard`, die S01-Filterleiste mit vier Facetten und Chips, S03 als Davids Tabelle; Interim-UI abgelöst. Offen bleiben nur noch: Demo-Seed für die neuen Zustände, Re-Baseline der Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik und die visuelle Abnahme auf Staging nach Merge.
> 🔴 **Pivot-Vorrang (AD-20):** EIN konfigurierbarer Pipeline-Kanban (ein Board für **alle** Pipeline-Typen sales/auftrag/custom) statt getrenntem Sales-Kanban + Projekt-Kanban. Karten = Projekte des `Projekt`-Kerns. Drop in `gewonnen`/`verloren`-Stage = Pipeline-internes Stage-Event, **kein Won-Handoff**.
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P8a` (Projekt-Kern + Pipeline-Engine + PipelineAccess/-FieldConfig/-FieldVisibility)
- **Blocks:** `R-P9a` (Auftrags-Welt baut auf demselben Kern auf; `deal.won`-Event), `R-P11b` (Dashboard verbraucht Sales-Aggregate)
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell — P8b ist Glied 4 (`R-P8a → R-P8b → R-P9a …`).
- **Läuft parallel zu:** Akeshans Module W3. Schema-Trennung nach **AD-21**.
**Dependency-Stand 2026-07-01:** `R-P8a` ist serverseitig umgesetzt (Projekt-Kern, Pipeline-Engine, Field-Level-Konfig, Lost-Reasons, Permissions, M049 Auto-Projektanlage) und bleibt nur wegen fehlender `D-KANBAN`/`D-P8` Screens auf On Hold. `R-P8b` kann backendseitig auf `prisma/schema/projekt.prisma` und `projectService.server.ts` aufsetzen; visuelle Kanban-/Listen-Abnahme bleibt screen-blockiert.
## Was wir bauen
Den **EINEN konfigurierbaren Kanban** über dem Projekt-Kern: Spalten = Stages der gewählten Pipeline, Drag&Drop-Stage-Wechsel mit Validation, gewonnen/verloren-Workflow (Lost-Reason-Pflicht), Pipeline-Switcher, SSE-Realtime. Dazu die **Listen-View** (Filter/Bulk/CSV/Spalten-Konfig), **Forecast/KPIs/Stage-Conversion/Lost-Verteilung** mit Aggregat-Cache und **Field-Level-Sichtbarkeit** (Volumen/Aggregate) über `PipelineFieldVisibility` (Backstop `deals.read_aggregates`). Emittiert `deal.won` für nachgelagerte Phasen.
## Benötigte Screens (Backend bedient — Design liefert `D-KANBAN` + `D-P8`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Pipeline-Kanban (konfigurierbar) [`/projects` · `/projects/pipelines/:id`] | Spalten = Stages (Name, Projekt-Anzahl, Aggregat-Volumen gegated, Win-%); Projekt-Karten (Titel, gegatetes Volumen, Avatar, Datum, max. 3 Tags, Stuck-Marker); **Drag&Drop** mit Stage-Validation; Drop `gewonnen` → Bestätigung, Drop `verloren` → Lost-Reason-Pflicht; **Pipeline-Switcher**; Filter + „nur meine"; Bulk-Select; Pagination pro Spalte (100+); SSE-Realtime |
| Projekt-Liste [`/projects/list`] | Cross-Pipeline-Sicht (Pipeline-Spalte + -Filter), Projekt-Nummer/Titel/Stage/Volumen (gegated)/Kontakt/Zeitraum/letzte Activity, sortierbar, Spalten-Konfig, Bulk, CSV-Export, Pagination |
| Forecast/KPI-Quellen (Widgets in P11) | Datenquellen: Pipeline-Forecast (Volumen × Win-%), realisierter Umsatz, KPIs pro Verantwortlichem, Stage-Conversion-Rates, Lost-Reason-Verteilung — Aggregat-Cache (kein eigener Screen, Widgets in P11) |
## Definition of Done
- [x] **EIN konfigurierbarer Kanban** (serverseitiger Board-Contract, Stage-Wechsel-Validation, gewonnen/verloren-Workflow mit Lost-Reason-Pflicht, Pipeline-Switcher) + **SSE-Realtime**
- [x] **Listen-View** mit Filter / Sort / Bulk-Contract / Spalten-Konfig-Contract / CSV-Export / Pagination
- [x] **Forecast/KPIs** (Volumen × Win-%, realisierter Umsatz, KPIs pro Verantwortlichem) + **Stage-Conversion-Rates** + Lost-Reason-Verteilung — alles mit **Aggregat-Cache** *(Audit 2026-07-18 wieder geöffnet — Rebuild-Trigger + Owner-KPIs fehlten — und am selben Tag geschlossen, siehe Notiz „Forecast-Verdrahtung")*
- [x] **Field-Level-Permissions** (Volumen/Aggregate): primär `PipelineFieldVisibility`, Backstop `deals.read_volume_*`/`read_aggregates`; Volumen ohne Recht → „—"
- [x] 24h-Rückgängig-Banner aus gewonnen/verloren-Stages (serverseitig via `undoStageChangeUntil`)
- [x] **`deal.won`-Event** emittiert (Extension-Point für P9/Reporting)
- [x] Konnektor `tenantHasModule('projects')` (Kanban/Listen/Actions gated)
**Audit-Nachtrag 2026-07-18 (AD-28-Interim-Messlatte, AGENTS.md DoD D18–21 — waren nie als DoD-Punkte erfasst):**
- [x] **D18 VM-Unit-Tests** (`projects.vm.test.ts` deckt `buildKanbanVM`/`buildProjectListVM` ab)
- [x] **D19 e2e-Smoke** (`tests/e2e/projekt-smoke.spec.ts`, gemeinsam für R-P8a/R-P8b)
- [x] **D20 Hot-Swap-Drill** (`createProjektBoardInterimFixture*` in `packages/ui-mock` + M017-Drill)
- [x] **D21 Interim-Visual-Baseline** (`r-p8-projects-interim.*`, als „interim" markiert, Re-Baseline beim David-Nachzug)
## Umsetzungs-Notiz
**2026-07-01 — Server-/Contract-Umsetzung ohne finale Screens:** `ProjektStageChange` und `PipelineAggregateSnapshot` in `prisma/schema/projekt.prisma` ergänzt, RLS-Artefakt und Tenant-Snapshot-Registry nachgezogen. `projectService.server.ts` liefert jetzt Board-VM (`loadProjectBoard`), Stage-Move mit Validation, Lost-Reason-Pflicht, 24h-Undo (`undoLastProjectStageChange`), Listen-Query mit Filter/Sort/Pagination/CSV, Forecast/KPI-Aggregat-Cache, Field-Level-Backstop für Volumen/Aggregate und `deal.won` via Workflow-Outbox. Routes: `/projects`, `/projects/list`, `/projects/pipelines/:pipelineId`, `/projects/pipelines/:pipelineId/stream`.
**Proof:** `pnpm typecheck`, `pnpm lint`, `pnpm run verify:i18n`, `pnpm run verify:tenant-isolation-report`, `pnpm --filter @hivegrid/web test -- app/utils/integrations/projects/projectService.test.ts` und full `pnpm test` grün.
**Stand:** R-P8b: 7/7 DoD = 100 % serverseitig done. Ticket bleibt fachlich **On Hold**, bis `D-KANBAN`/`D-P8` final geliefert und die Drag&Drop-/Listen-/Banner-UI visuell abgenommen ist.
**2026-07-08 — Interim-UI aus `~/ui` (AD-28, Akeshan):** Auf der vorhandenen Backend-Basis zwei Interim-Screens (VM als Prop, kein handgeschriebenes Tailwind): **konfigurierbarer Kanban** `/projects` + `/projects/pipelines/:id` (`PipelineKanbanPage` aus `KanbanColumn`/`KanbanCard` — Spalten=Stages mit gegatetem Aggregat, Karten, Pipeline-Switcher, „nur meine", Stage-Move per Karten-Control mit gewonnen-Bestätigung/verloren-Lost-Reason-Pflicht-Dialog, Bulk-Move, Quick-Create), **Projekt-Liste** `/projects/list` (`ProjektListPage` — Filter/Sort/Spalten-Konfig/CSV-Export/Pagination, Volumen gegated). Geteilter Loader/Action `projectBoardRoute.server`. Pure VMs `project-board.vm`/`project-list.vm`; Bulk via `bulkMoveProjectStage`. Interim-Deckung DoD B 6–10 / E 22–25 grün. **Proof:** Commits `45a78df29` (Kanban), `de51eac10` (Liste); `pnpm --filter @hivegrid/web typecheck` grün, i18n-parity/`verify:sidebar-routes`/`verify:cross-cutting-models` grün; Screen-RTL (`PipelineKanbanPage` 2, `ProjektListPage` 2) + VM-Unit (`projects.vm.test`, 11) grün. **Offen (getrackter Nachzug):** finale Subframe-Optik (`design-nachzug`), echtes HTML5-**Drag&Drop** + **Live-SSE-Client** (Endpoint `…/stream` existiert, `data-sse-href` als Hinweis gesetzt), Bulk-Mutation auf der Liste (Cross-Pipeline-Semantik), Forecast/KPI-**Widgets** (bewusst **P11**), e2e-Smoke/Hot-Swap/Visual-Interim-Baseline (CI/Windows). %-Stand unverändert 7/7 serverseitig; Interim-UI-DoD steht, finale Optik bleibt Nachzug.
**2026-07-08 (Interim-Nachzug 2):** Kanban um echtes HTML5-**Drag&Drop** ergänzt (Karte ziehen → Zielspalte; Drop auf gewonnen/verloren löst weiter Bestätigungs- bzw. Lost-Reason-Pflicht-Dialog aus; Karten-Select bleibt als Fallback/a11y), **Freitext-Suche** (serverseitig über `loadProjectBoard({ q })` → `projectListWhere`) und **Demo-Daten-Toggle** (`?demo=show`) — Projekt-Liste ebenfalls mit Demo-Toggle. Board rendert bei unbekannter Pipeline-ID jetzt **404 statt 500** (`loadKanbanData` fängt den `CatalogError` ab). Proof: `pnpm --filter @hivegrid/web typecheck` grün, `PipelineKanbanPage.test` (5) + `ProjektListPage.test` (3) + `projectService.test` (25) grün. **Weiterhin offen (Nachzug):** Live-SSE-Client — der Stream (`…/stream`) sendet nur Snapshot-on-connect + 30s-Heartbeat, **keine Change-Events**; echtes Realtime braucht Backend-Pub/Sub (moveStage → publish), also über Interim hinaus. Ebenfalls offen: Bulk-Mutation auf der **Liste** (Cross-Pipeline-Semantik; interim nur auf dem Board), **finale Subframe-Optik** (`design-nachzug`), e2e/Hot-Swap/Visual-Baseline. **Bewusst v2:** Forecast/KPI-Widgets → P11.
**2026-07-11 — P8-Subframe-Nachzug:** S01 Kanban und S03 Projekt-Liste aus `WF-P8 Pipelines` in die vorhandenen Screens übernommen: Subframe-nahe Header-, Ansichtswechsel-, Filter-, Tabellen- und Board-Struktur, ohne Router-/DB-Zugriff im Screen. `canAdmin` wird im servergebauten Board-VM ausgewertet; Board, Liste und Pipeline-Konfiguration sind über tenant-spezifische Pfade verbunden. **Proof:** Tenant-Routen-Typecheck grün; `PipelineKanbanPage` 7/7, `ProjektListPage` 3/3 und `projectService` 25/25 Tests grün; `verify:i18n` grün; fokussiertes ESLint ohne Warnungen. **Stand:** 7/7 DoD = 100 % done · 0 DoD-Punkte offen. Nachzug: visuelle Browser-/Snapshot-Abnahme und der bereits dokumentierte echte Live-SSE-Publish/Client.
**2026-07-11 — Staging-Demo-Proof:** Sieben Business-Demo-Projekte sind über offene, gewonnene und verlorene Sales-Stages sowie Montage/Abnahme der Auftragspipeline verteilt. Werte, Prioritäten und relative Deadlines decken Karten, Aggregate, Stuck-Marker, Pipeline-Wechsel und Tabellenansicht ab; die UI zeigt sie bewusst erst mit aktiviertem Demo-Daten-Filter. **Proof:** idempotenter `stagingDomainDemoSeed` mit fokussiertem 2/2-Test. **Stand:** 7/7 DoD = 100 % done.
## Technische Bausteine
- **Erweitert `prisma/schema/projekt.prisma`** (keine neuen Kern-Entities — Kanban/Forecast lesen auf Projekt/Pipeline/Stage aus R-P8a); Aggregat-Cache-Tabelle bzw. materialisierte Sicht für Forecast/KPIs.
- **RLS** durchgängig (AD-1); Kanban-Query filtert über `PipelineAccess` + `PipelineFieldVisibility` (server-seitig, nie durchsickern).
- **SSE-Realtime** für Karten-Bewegung + Spalten-Aggregate; Stage-Wechsel append-only in **Activity** (P6) + `deal.won`-Event.
- **HiveNumberSeq** (aus R-P8a) bleibt Quelle der Projekt-Nummern; hier nicht neu.
- **Konnektor** `tenantHasModule('projects')` gated.
- `is_demo_data`-Flag auf Demo-Projekten respektiert (Aggregate filtern bei Echt-Start-Bereinigung).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 5** (Projekt/Pipeline/Stage + PipelineFieldVisibility für gegatete Aggregate) — 🔴 **Pivot-Vorrang (AD-20)**: ein Board für alle Pipeline-Typen, kein Won-Handoff
- `REQUIREMENTS.md` → `REQ-projekt-kanban-listen-view`, `REQ-projekt-forecast-kpis`, `REQ-pipeline-rechte-config` (Field-Level) (Phase 8)
- `ROADMAP.md` → Phase 8 (+ Pivot-Note)
- `designer-briefs/P08-projekt-pipelines-kern.md` (Kanban BESPOKE, Pivot-Vorrang-Hinweis)
## Dev-Nachzug (nach Davids `D-KANBAN`/`D-P8`-Delta)
- [x] S01 Kanban und S03 Liste gegen den Subframe-Flow integriert
- [ ] Visuelle Browser-/Visual-Regression-Abnahme
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [ ] Plane-Ticket `R-P8b` aktualisiert
### 2026-07-15 — e2e-Smoke nachgezogen (RA-B3)
DoD-19-Smoke für die Projekt-Pipeline (Kanban) ergänzt: `tests/e2e/projekt-smoke.spec.ts` (gemeinsam für R-P8a/R-P8b). Flow: Login → `/projects` (Board) öffnen → Board-Toolbar sichtbar (`ui.projects.board.toolbar`) → Hauptaktion: Board-Suche `smoke` eintragen + „Anwenden" → Loader-Roundtrip (`?q=smoke` in der URL). Auth/Skip-Muster exakt wie `files`/`tasks`/`calendar`/`booking`, keine Produkt-Code-Änderung (bestehende `data-ui-id`-Hooks genutzt).
**Proof:** `pnpm exec playwright test tests/e2e/projekt-smoke.spec.ts --list` sammelt den Spec (chromium); `pnpm exec eslint tests/e2e/projekt-smoke.spec.ts --max-warnings=0` grün; `pnpm --filter @hivegrid/web typecheck` grün. Voller Playwright-Lauf braucht einen laufenden Stack + im Test-Tenant aktiv geschaltetes Projekt-Modul; ohne E2E-Credentials/Modul skippt der Smoke sauber. Interim-Visual-Baseline (D21) bleibt offen.
### 2026-07-15 — Nachzug: echter SSE-Publish + Listen-Bulk (Restarbeiten RA-C2)
Die beiden zuletzt offenen Nachzüge aus der Notiz vom 2026-07-08 sind geschlossen.
**1. Echter Live-SSE-Publish/Client (vorher nur Snapshot + 30s-Heartbeat).** Als Pub/Sub wird der **bereits vorhandene** In-Process-`EventEmitter` (`~/utils/stream/emitter.server`) genutzt — derselbe, der schon den Workflow-Execution-SSE-Stream trägt. **Keine neue Infra-Abhängigkeit.** Neu: `projectBoardEvents.shared.ts` (reiner Wire-Contract: Event-Name + Change-Payload, ohne Server-Imports, damit der Client-Hook ihn importieren darf) und `projectBoardEvents.server.ts` (`projectBoardChannel(tenantId, pipelineId)` = `projectBoard:<tenantId>:<pipelineId>`, `subscribeToProjectBoard`, `publishProjectBoardChange`; hebt einmalig das 10-Listener-Limit, da viele Board-Viewer denselben Kanal abonnieren). Publish-Punkte liegen bewusst in der **Orchestrierungs-Schicht** (`projectBoardRoute.server`, `projectDetailRoute.server`, `projects.list`-Action), nicht im `projectService.server` — so bleibt der Service frei von `emitter.server` (dessen `loadRequiredWebConfig()` beim Modul-Load sonst in den reinen Service-Test-Importgraph gezogen würde). Abgedeckte Mutationen: Stage-Move (Board **und** Detail), Bulk-Move, Quick-Create, Stammdaten-Update, 24h-Undo, Listen-Bulk-Archiv. `bulkMoveProjectStage` liefert dafür jetzt zusätzlich die betroffenen `pipelineIds`. Der Stream (`…/stream`) sendet weiterhin Snapshot-on-connect + Heartbeat, **plus** echte `projects.board.changed`-Events. Client: neuer Hook `useBoardLiveUpdates` (EventSource auf `sseHref`, revalidiert die Route bei jedem Change-Event), verdrahtet in **beiden** Board-Routes. Der Screen bleibt pur (kein Router-Hook in `PipelineKanbanPage`), das VM wird weiter serverseitig gebaut — Loader/VM-Grenze unverändert. Heartbeat/Snapshot lösen keine Revalidierung aus, also keine Poll-Schleife.
**2. Cross-Pipeline-Bulk auf der Liste.** Bewusst **Bulk-Archiv** statt Bulk-Stage-Change: Stages gehören zu genau einer Pipeline, ein Stage-Wechsel ist also pipeline-gebunden und über eine Cross-Pipeline-Auswahl nicht sinnvoll definiert — Archivieren gilt dagegen einheitlich für jedes Projekt, unabhängig von seiner Pipeline. Neu im Service: `archiveProject` + `bulkArchiveProjects` (gated über `projects.delete`, RLS via `withTenantRLS`). **Cross-Pipeline-Semantik:** jedes Projekt wird einzeln gegen seinen **eigenen** Pipeline-Edit-Scope geprüft (`projectEditScopeWhere` wertet `PipelineAccess` pro Projekt aus) — eine Auswahl über mehrere Pipelines hinweg wird also Projekt für Projekt korrekt autorisiert, statt pauschal gegen eine Board-Pipeline. Reuse von `normalizeBulkProjectIds` (100er-Limit) und `publishProjectSearchUpsert` (setzt `archived` aus `archivedAt`, Zeile fällt aus der aktiven Suche). Die `/projects/list`-Route bekommt eine `action` (`bulkArchive`-Intent nach dem bestehenden Single-Mutation-Muster der Board-Route) und publiziert pro betroffener Pipeline ein Board-Change-Event. VM: `ProjectListData.canArchive` (aus `projects.delete`, optionales Input-Perm, Default `false`). Screen: Zeilen-Auswahl + „Alle auswählen", Bulk-Bar mit Anzahl, Archiv-Button mit Bestätigungs-Dialog; ohne `projects.delete` erscheint keine Auswahl-Spalte. Neue i18n-Keys unter `projects.listView.*` (de + en).
**Proof:** `pnpm --filter @hivegrid/web typecheck` und `pnpm --filter @hivegrid/view-models typecheck` grün (Exit 0); `pnpm lint` grün (Exit 0, `--max-warnings=0`); `pnpm run verify:i18n` grün (Exit 0); Unit-Tests grün: Projekt-Screens + `projectService` + `projects.list`-Route **74/74** (u.a. neu `ProjektListPage` „cross-pipeline bulk-archives the selected rows" und „hides bulk-archive selection without the archive permission"), view-models **433/433**. Kein Schema-Change (AD-21: kein `db push`, keine Migration) — `archivedAt` existiert bereits. **Einschränkung, bewusst:** Der End-to-End-Beweis des Live-Streams (zwei Browser-Sessions, Karte bewegen, zweites Board aktualisiert sich) braucht einen laufenden Stack und ist lokal nicht gelaufen; verifiziert sind Contract, Verdrahtung und Typen. **Scope-Hinweis:** Der Emitter ist **prozess-lokal** — bei einer einzelnen `hivegrid-web`-Instanz (aktueller Stand) erreichen die Events alle Board-Clients; horizontale Skalierung von web bräuchte einen prozessübergreifenden Transport (z.B. Redis-Pub/Sub) hinter derselben publish/subscribe-API.
**Stand:** R-P8b: 7/7 DoD = **100 % done** (unverändert; die beiden Punkte waren Nachzüge, keine offenen DoD-Boxen). Offen bleiben nur: visuelle Browser-/Visual-Regression-Abnahme (Interim-Baseline, Staging) und die finale Subframe-Optik (`design-nachzug`, wartet auf David).
> 💡 Vorschlag (außerhalb Ticket-Scope): Sobald `hivegrid-web` auf mehr als eine Instanz skaliert, muss `projectBoardEvents.server.ts` auf einen prozessübergreifenden Transport (Redis-Pub/Sub) umgestellt werden — die publish/subscribe-API ist dafür bereits die einzige Nahtstelle. Betrifft genauso den bestehenden Workflow-SSE-Stream, der denselben Emitter nutzt. Eigenes Ticket, falls gewünscht.
### 2026-07-18 — Audit: gestrandete Restarbeiten geborgen + Interim-Test-Tail (Branch `feat/r-p8-restarbeiten`)
**Audit-Befund:** Die RA-C2-Nachzüge (echter SSE-Publish + Listen-Bulk-Archiv, Commit `fa56081e9` vom 2026-07-16) lagen **nur auf lokalen `worktree-agent-*`-Branches** — nie gepusht, nie gemergt; der Plane-Kommentar vom 16.07. meldete sie trotzdem als erledigt. Der Working Tree hatte weiterhin nur Snapshot+Heartbeat-SSE und eine Action-lose Liste. Zusätzlich fehlte der komplette Interim-Test-Tail (D19/D20/D21), und DoD 3 (Forecast/KPIs) ist real nur teilweise erfüllt (Cache ohne Rebuild-Trigger, keine Owner-KPIs) — real also 4/10 statt der gemeldeten 100 %.
**Umsetzung:** (1) RA-C2 vollständig geborgen (ohne `RESTARBEITEN-TRACKER.md`): `projectBoardEvents.server/.shared`, `useBoardLiveUpdates`, Stream-/Board-/List-Routen, `archiveProject`/`bulkArchiveProjects`, Listen-Bulk-UI, `canArchive`-VM, i18n `projects.listView.*` — Commit-Nachweis auf diesem Branch. (2) D19/D20/D21 wie in der R-P8a-Notiz vom 2026-07-18 (gemeinsamer Smoke, Kanban-Fixture, Visual-Baseline `r-p8-projects-interim`).
**Proof:** `pnpm --filter @hivegrid/web typecheck` + `@hivegrid/view-models` + `@hivegrid/ui-mock` grün · `verify:i18n` Exit 0 · Projekt-Screens/Service/VM-Suiten 89/89 grün · `pnpm run test:hot-swap` grün · `verify:ui-visual` 130 passed / 0 failed.
**Stand:** R-P8b: **9/10 DoD = 90 % done** (vorher gemeldet: 100 %). Offen: DoD 3 (Forecast-Aggregat-Cache ohne Rebuild-Trigger + fehlende Owner-KPIs — Scope-Entscheid „jetzt vs. P11-Widgets" steht aus, siehe DoD-Anmerkung) sowie der getrackte `design-nachzug`. Kein Schema-Change, keine Migration.
### 2026-07-18 — Forecast-Verdrahtung: Rebuild-Trigger + Owner-KPIs (DoD 3 geschlossen)
**Scope-Entscheid:** DoD 3 gehört nach Quellenlage zu R-P8b (`REQ-projekt-forecast-kpis` ist Phase 8; `R-P11b` konsumiert die Aggregate nur als `blocked-by`-Abhängiger). Entsprechend jetzt hier verdrahtet, kein Schema-Change (`scopeKey` ist freier String).
**1. Rebuild-Trigger.** Neuer Helfer `refreshPipelineAggregatesAfterMutation` (`projectService.server.ts`): läuft **nach** der committeten Mutations-Transaktion, aggregiert also den committeten Stand; Fehler sind fail-open (strukturierter `project-aggregate-refresh-failed`-Log über den scoped Logger, die Schreibaktion schlägt nie deswegen fehl — Cache ist abgeleitete Daten). Verdrahtet an allen Forecast-relevanten Mutationen: `moveProjectStage`, `bulkMoveProjectStage`, `undoLastProjectStageChange`, `createProject`, `createProjectFromQualifiedLead` (M049), `updateProjectStammdaten` (Volumen/Owner), `archiveProject`/`bulkArchiveProjects`, `upsertPipelineStage`/`archivePipelineStage` (Win-%-Änderungen). Bulk-Pfade refreshen einmal pro betroffener Pipeline (internes `refreshAggregates: false` an der Einzel-Mutation), nicht pro Projekt.
**2. Owner-KPIs.** `rebuildPipelineAggregateCache` schreibt zusätzlich `owner:<userId>`-Snapshot-Zeilen je `zustaendigePersonId` (projectCount, Potenzial-/Auftragsvolumen, gewichteter Forecast, realisierter Umsatz, lostCount + Lost-Reason-Verteilung); Owner ohne Projekte werden per Stale-Cleanup (`deleteMany` auf `owner:*` not-in) entfernt. `getPipelineForecast` liefert die Zeilen als `ownerKpis`, Geldwerte weiter über die Aggregat-Sichtbarkeit gegated (`PipelineFieldVisibility` + `deals.read_aggregates`-Backstop); der `projects.read_all`-Guard des Forecast-Readers bleibt unverändert.
**Kein eigener Screen** — die Ticket-Doc legt fest „kein eigener Screen, Widgets in P11"; die Interim-UI-Stilvorgabe greift daher nicht (kein UI-Anteil). `R-P11b` kann sein `sales.forecast`-Widget (rechnet aktuell live per `groupBy`) beim P11-Nachzug auf `getPipelineForecast` umstellen — dependency-aware vermerkt.
**Proof:** `pnpm --filter @hivegrid/web typecheck` grün · fokussiertes ESLint grün · `projects`-Suiten 133/133 grün, darunter neuer Contract-Test „populates the aggregate cache after mutations and exposes owner KPIs" (prüft Owner-Scope, Stale-Cleanup, fail-open-Log und dass ALLE zehn Mutationspfade den Refresh rufen). Commit `a8d33e43c`.
**Stand:** R-P8b: **10/10 DoD = 100 % done** (nach PR-Merge). Offen bleibt nur der getrackte `design-nachzug`.
### 2026-07-29 — WF-P8-Baseline: Board und Liste neu aus Davids Export (Branch `feat/wf-p8-subframe-baseline`, PR #286, Akeshan, dependency-aware)
Davids Handoff `D-P8 + D-KANBAN` vom 2026-07-28 ist die neue Baseline; die Interim-UI aus
`~/ui` ist damit auf der R-P8b-Strecke abgelöst. Haupt-Querverweis und der Backend-/Schema-Anteil
stehen in `R-P8a.md`. **Loader/VM-/Intent-Grenze, Stage-Move-Pfad, SSE-Wiring und der
Forecast-Cache blieben unangetastet** — geändert wurde die Screen-Schicht plus additive
Board-Backing-Felder.
**S01 Kanban.** Davids neue Design-System-Komponente **`ProjectCard`** ersetzt `KanbanCard` auf
dem Board. Dafür ist das Board-Backing additiv gewachsen: Untertitel (primärer Kontakt · Ort des
Projektstandorts), Projekttyp als Tag, Start-/Enddatum als Datumsband, nächster Termin als Pille;
die Priorität trägt jetzt die Kartenfarbe statt eines Badges. Die Begleitdaten kommen über **vier
feste Queries pro Board** (kein N+1 bei bis zu 100 Karten je Spalte), alle in der RLS-Transaktion
des Aufrufers. Der Untertitel wird im VM gejoint, damit bei nur einer vorhandenen Hälfte kein
einzelnes „·" stehenbleibt; Datumswerte bleiben bis zum Screen ISO und werden erst dort in der
App-Zeitzone formatiert. Griff und Mehrfachauswahl liegen in einer eigenen Zeile im Tag-Slot,
weil Davids Karte keinen Platz dafür vorsieht.
**S01-Filterleiste.** Davids `FilterBar` und `DropdownMenuMultiSelect` sind ins `~/ui`-Kit
übernommen (neuer Screen-Baustein `BoardFilterBar`) — genau die beiden Komponenten, deren Fehlen
bei S00 und S07 noch der Grund für die einfachen Selects war. Der Board-Umschalter ist ein
Header-Chip, die Freitextsuche sitzt in der Leiste, jeder aktive Filter erscheint als
entfernbarer Chip mit „Zurücksetzen". Vier Facetten sind end-to-end verdrahtet — **Sachbearbeiter**
(inkl. „Ohne Zuordnung"), **Kundentyp**, **Zeitraum** (inkl. eigenem Von/Bis) und **Auftragswert**;
alle laufen durch `projectListWhere`, damit Board, Liste und CSV **eine** Filterdefinition teilen
statt drei. Parameter: `owner` · `kundentyp` · `zeitraum` (+`von`/`bis`) · `wert`.
**S03 Projekt-Liste** ist auf Davids Tabelle neu gebaut; sie zieht ihre Begleitdaten über
denselben Batch wie die Board-Karte, aber **opt-in** — der CSV-Export rendert keine dieser
Spalten und soll die drei Zusatz-Queries über bis zu 10.000 Zeilen nicht bezahlen.
**Bewusste Deltas (nicht stillschweigend weggelassen):**
- **Tags** fehlen sowohl als S03-Spalte als auch als Facette — es gibt kein Projekt-Tag-Modell.
- **Zeitraum** ist Single-Select: zwei Perioden gleichzeitig bedeuten nur „die weitere von
beiden", was aus Checkboxen niemand ablesen kann.
- **Auftragswert** rendert nur mit `deals.read_volume_all` — eine Bandauswahl verrät sonst genau
die Zahl, die das Karten-Gate zurückhält.
- **Kundentyp** bietet die drei Zustände, die `KontaktTyp`/`OrgMerkmal` wirklich unterscheiden;
der Export listet „Organisation" und „Unternehmen" nebeneinander, was bei uns dieselben Zeilen
liefert.
- S03: das Zeilen-Kebab entfällt (sein einziger echter Eintrag würde den Zeilen-Link doppeln);
„Kontaktrolle" ist nicht gespeichert, die Kunden-Unterzeile trägt daher Projekttyp und Ort.
- **Vier Abweichungen an den Kit-Komponenten, an David gemeldet:** Freitextfeld und
„Zurücksetzen"-Knopf der `FilterBar` sind im Export totes Markup ohne Handler, die Checkboxen
der Multi-Select-Einträge spiegeln die Auswahl nicht, und `DropdownItem` schließt als
Radix-Menu-Item das Menü bei jedem Klick — für ein Multi-Select unbrauchbar. Ebenso hardcodet
`ProjectCard` die deutschen Prioritätswörter im Badge; das Label ist lokal ein Prop.
**Umsetzungsdetails:** Kundentyp löst seine Kontakte in einer eigenen Query auf, weil
`ProjektKontakt` nur eine nackte `kontaktId` ohne Relation zu `Kontakt` hält; die
Sachbearbeiter-Optionen kommen aus der **ungefilterten** Board-Population, sonst würde die
Auswahl eines Sachbearbeiters alle anderen aus dem Dropdown entfernen; „Zurücksetzen" verwirft
Suche, Nur-meine und alle Facetten in **einer** Navigation.
**Browser-Abnahme 2026-07-29 — zwei echte Fehler gefunden und behoben:** die Datumsfelder des
eigenen Zeitraums lagen im Zeitraum-Dropdown, dessen Panel nicht mitwächst (das Board schien
durch) und das ein nativer Datepicker schließt → sie stehen jetzt inline in der Leiste; und ein
per URL gesetztes „Ohne Zuordnung" filterte ohne Chip weiter, wenn kein Projekt unzugeordnet war.
**Proof:** Commits `40b39f013` (`ProjectCard` ins Kit) · `ad6cdeb6f` (Karte aufs Board) ·
`f6e73aeba` (S03) · `3b5b31d97` (Zähler-Pluralisierung) · `d3b05c56f` (Kit-Sync FilterBar +
DropdownMenuMultiSelect) · `a38ce506b` (pure Facetten-Logik) · `fdd03476e` (Filterleiste) ·
`ae900e368` (Browser-Abnahme-Fixes). Volle lokale Gates: `pnpm typecheck` 0 · `pnpm lint` 0
Warnungen · `pnpm test` **7876 Tests grün** (1125 Dateien) · `verify:ui-visual` 130 passed /
0 failed · `verify:hardcoded-strings` Exit 0. Neu: `projectFilterFacets.test.ts` (18 Fälle für
Datums-/Geld-Mathematik und Owner-Prädikate), `PipelineKanbanPage.test.tsx` auf 34 Fälle
(Facetten-Rendering, Toggle, Wert-Gate, Chips, klebende „Ohne Zuordnung"-Option).
**Stand:** R-P8b: **10/10 DoD = 100 % done** (unverändert — dieser Nachzug ersetzt die
Interim-Optik, er ändert die DoD nicht). Offen bleiben: Demo-Seed für die neuen Zustände,
Re-Baseline der Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik (DoD 21) und die
visuelle Abnahme auf Staging nach Merge.
> **Querverweis (2026-07-18, Akeshan, dependency-aware — Subframe-Delta-Nachzug, Branch `feat/subframe-p8-delta-nachzug`):**
> UI-Nachzug der neuen P8-Subframe-Seiten (10 → 17) betrifft auch die R-P8b-Strecke: `PipelineKanbanPage` auf die neue `KanbanCard`-Slot-API
> migriert (S01a Filter-Empty + Spalten-Placeholder, S01b 2-Spalten-Umbruch ab 6 Karten inkl. `showSum`-Fix nach Component-Sync,
> M03 Kontextmenü mit bestehenden Stage-Move-Ops), `ProjektListPage` S03a-Empty-Karte + Paritäts-Footer. Loader/VM/Intents unverändert;
> SSE-Wiring aus R-P8b bleibt unangetastet. Details + Rest-Delta: `.planning/SUBFRAME-FLOW-INVENTAR.md`; Haupt-Querverweis in `R-P8a.md`.
### 2026-07-30 — Live-Abnahme S01, Charge 1 (Branch `fix/wf-p8-kanban-abnahme-charge1`, Akeshan)
Sieben Punkte aus der gemeinsamen Abnahme des gemergten WF-P8-Standes (Staging vs. Subframe
`S01 Kanban-Board`, `52699d37…`, + Wireframe-Doc `WF-P8 Pipelines/Screens/S01 Kanban-Board.md`).
Reine Screen-/Kit-Schicht: Loader, VM, Intents, Stage-Move-Pfad und SSE-Wiring unberührt.
1. **Leeres Filterergebnis zeigt keine Spalten mehr.** Bisher blieb die Spaltenreihe unter dem
Banner stehen; eine Reihe leerer Stages sagt nichts über den Filter aus, der sie geleert hat.
2. **„Hängt N T"-Chip ist von der Karte weg.** Davids Karte trägt Tag-Katalog und Projekttyp,
sonst nichts. `stuckDays` bleibt im VM (andere Leser), nur die Karte rendert es nicht mehr.
3. **Dropdown-Panels liegen jetzt über der Karte.** Das Tags-Dropdown öffnete *unter* dem
Preisblock der `ProjectCard`: die Kit-Panels öffnen in einem Portal-Wrapper ohne `z-index`,
und `ProjectCard` hat eine positionierte `z-10`-Zeile. `DropdownMenu` und
`DropdownMenuMultiSelect` tragen jetzt `relative z-50` (lokale Kit-Anpassung, kommentiert).
4. **Spalten-Farbtint raus.** Davids S01 zeichnet alle Spalten auf derselben neutralen Fläche;
die Stage-Farbe bleibt der Stage-Leiste der Detailansicht.
5. **Neues Spalten-Dropdown im Kopf** blendet Stages ein/aus; **„Verloren" ist per Default aus**.
Die Stage bleibt Move-Ziel im Karten-Kontextmenü, damit M01 nicht davon abhängt, dass die
Spalte sichtbar ist. Sichtwahl der Session, nicht persistiert, kein Permission-Gate.
6. **Kopf ist Davids Kopfzeile:** eine dichte Zeile (`py-3`) mit Modul-Icon + „Pipelines",
vertikalem Strich, Board-Auswahl, dann Board/Liste, Spalten, CSV-Export,
**Board-Einstellungen** und „Projekt anlegen". Kein Subtext. `PageHeader` hat dafür zwei
additive Props (`dense`, `titleTrailing`) — andere Screens bleiben unverändert.
Der Button führt auf die **Einstellungen dieses Boards** (S04, `/admin/pipelines/:id`) statt
auf die Board-Tabelle; gilt für beide Board-Routen.
7. **Einklappen ist reversibel.** Der Pfeil der eingeklappten Spalte war totes Markup und das
Kebab, das eingeklappt hatte, ist im eingeklappten Zustand versteckt — die Spalte ließ sich
nicht wieder öffnen. Der eingeklappte Kopf ist jetzt selbst das Ausklapp-Control (Klick,
Enter/Space, `aria-label`), und die Kartenzahl steht vertikal wie der Spaltenname.
**Proof:** Commits `74c855fd0` (Dropdown-Stacking) · `b6a3c4784` (Einklappen reversibel) ·
`d030ae77e` (Board-Kopf + Spalten-Deltas). Volle lokale Gates: `pnpm typecheck` 0 ·
`pnpm lint` 0 Warnungen · `pnpm test` **8036 Tests grün** (1143 Dateien) · `verify:i18n`,
`verify:ci-baseline`, `verify:source-health`, `test:hot-swap` je Exit 0.
`PipelineKanbanPage.test.tsx` deckt die neuen Fälle ab (Spalten-Picker inkl. Default-aus für
Verloren, Kopf-Button nur für Admin, weggefiltertes Board ohne Spalten, kein Staleness-Chip).
Lokale Browser-Abnahme aller sieben Punkte auf `app.localhost:3001` (Demo-Daten): Kopf wie im
Export, Panels über der Karte, Einklappen/Ausklappen, Verloren ein-/ausblendbar, weggefiltertes
Board ohne Spalten, Board-Einstellungen landet auf S04 des gezeigten Boards.
**Stand:** R-P8b: **10/10 DoD = 100 % done** (unverändert — Abnahme-Nachzug an der Optik).
Offen bleiben wie zuvor: Demo-Seed für die neuen Zustände, Re-Baseline `r-p8-projects-interim`
auf die Subframe-Optik (DoD 21, jetzt zusätzlich durch den neuen Kopf betroffen) und die
visuelle Abnahme auf Staging nach Merge dieser Charge.
### 2026-08-03 — UX-/Performance-Nachzug: Suche und Drag-Revalidierung
Die Board- und Listen-Suche hält den Text jetzt als lokalen Draft in der Filterleiste. Tippen
rendert damit weder das schwere Board neu noch schreibt es fortlaufend `q` in die URL. Erst
Enter oder der explizite Such-Button committed den getrimmten Wert in die weiterhin teilbare,
serverseitig ausgewertete URL. Facetten und Reset behalten ihren bisherigen Contract.
Beim Drag priorisiert die Kollisionserkennung den Pointer und nutzt `closestCorners` nur noch
als Keyboard-Fallback. Karten und Spalten werden über vorberechnete Maps statt wiederholter
linearer Suchen aufgelöst; `will-change` gilt nur für die tatsächlich transformierte Karte.
Zusätzlich pausieren die beiden Board-Routen ihren SSE-Client während Navigation oder Submit.
Damit löst die eigene Stage-Mutation nicht mehr gleichzeitig eine SSE-Revalidierung und die
normale Router-Action-Revalidierung aus. Der serverseitige Stage-/Event-Contract blieb
unverändert.
**Proof:** Commits `5ce31009a` (expliziter Search-Commit) · `3d644e4b0` (Drag-/SSE-Pfad) sowie
der querschnittliche UI-Nachzug `855188c4c`, `c6758f034`, `093e96bb5`, `8e79def0f` und die
Visual-Re-Baseline `2d848d36f`. `pnpm typecheck` und `pnpm lint` Exit 0; `pnpm test` **8336
Tests grün** in 1198 Dateien (60 Integrationstests bewusst geskippt); `verify:i18n`,
`verify:sidebar-routes`, `verify:source-health`, `test:hot-swap` und `verify:ui-visual` Exit 0
(`130 passed / 0 failed`). Frische lokale DB: Rollenvertrag + 33 Migrationen grün; HTTP-Smoke
auf `admin.localhost` und `app.localhost` Login jeweils 200. Die interaktive Browser-Steuerung
war in der Session nicht als Tool verfügbar; deshalb keine neue visuelle Live-Abnahme behauptet.
**Stand:** R-P8b bleibt **10/10 DoD = 100 % done**. Der hier beauftragte UX-/Performance-Nachzug
ist vollständig umgesetzt; die zuvor dokumentierte visuelle Staging-Abnahme bleibt unverändert
ein separater Nachzug.