33 KiB
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 ingewonnen/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, Backstopdeals.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.tsdecktbuildKanbanVM/buildProjectListVMab) - D19 e2e-Smoke (
tests/e2e/projekt-smoke.spec.ts, gemeinsam für R-P8a/R-P8b) - D20 Hot-Swap-Drill (
createProjektBoardInterimFixture*inpackages/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-HandoffREQUIREMENTS.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-P8baktualisiert
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-webauf mehr als eine Instanz skaliert, mussprojectBoardEvents.server.tsauf 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/OrgMerkmalwirklich 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
FilterBarsind im Export totes Markup ohne Handler, die Checkboxen der Multi-Select-Einträge spiegeln die Auswahl nicht, undDropdownItemschließt als Radix-Menu-Item das Menü bei jedem Klick — für ein Multi-Select unbrauchbar. Ebenso hardcodetProjectCarddie 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:PipelineKanbanPageauf die neueKanbanCard-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),ProjektListPageS03a-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 inR-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.
- 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.
- „Hängt N T"-Chip ist von der Karte weg. Davids Karte trägt Tag-Katalog und Projekttyp,
sonst nichts.
stuckDaysbleibt im VM (andere Leser), nur die Karte rendert es nicht mehr. - Dropdown-Panels liegen jetzt über der Karte. Das Tags-Dropdown öffnete unter dem
Preisblock der
ProjectCard: die Kit-Panels öffnen in einem Portal-Wrapper ohnez-index, undProjectCardhat eine positioniertez-10-Zeile.DropdownMenuundDropdownMenuMultiSelecttragen jetztrelative z-50(lokale Kit-Anpassung, kommentiert). - Spalten-Farbtint raus. Davids S01 zeichnet alle Spalten auf derselben neutralen Fläche; die Stage-Farbe bleibt der Stage-Leiste der Detailansicht.
- 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.
- 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.PageHeaderhat 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. - 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.