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

33 KiB
Raw Blame History

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

  • EIN konfigurierbarer Kanban (serverseitiger Board-Contract, Stage-Wechsel-Validation, gewonnen/verloren-Workflow mit Lost-Reason-Pflicht, Pipeline-Switcher) + SSE-Realtime
  • Listen-View mit Filter / Sort / Bulk-Contract / Spalten-Konfig-Contract / CSV-Export / Pagination
  • 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")
  • Field-Level-Permissions (Volumen/Aggregate): primär PipelineFieldVisibility, Backstop deals.read_volume_*/read_aggregates; Volumen ohne Recht → „—"
  • 24h-Rückgängig-Banner aus gewonnen/verloren-Stages (serverseitig via undoStageChangeUntil)
  • deal.won-Event emittiert (Extension-Point für P9/Reporting)
  • 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):

  • D18 VM-Unit-Tests (projects.vm.test.ts deckt buildKanbanVM/buildProjectListVM ab)
  • D19 e2e-Smoke (tests/e2e/projekt-smoke.spec.ts, gemeinsam für R-P8a/R-P8b)
  • D20 Hot-Swap-Drill (createProjektBoardInterimFixture* in packages/ui-mock + M017-Drill)
  • 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)

  • 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.