Files
HiveGrid-Wireframes/hivegrid-cloud/docs/boilerplate-mapping/M03-sales-pipeline.md
T

21 KiB
Raw Blame History

Boilerplate-Abgleich: M03 — Sales-Pipeline (Verkaufsfälle / Deals)

Abgleich-Report: Was liefert die Boilerplate (/Users/raffaelsheikh/Documents/GitHub/boilerplate) für M03 fertig, was muss angepasst werden, was fehlt komplett. Quellen: Detail-Spec _bmad-output/specs/M03-sales-pipeline.md, Pflichtenheft block3.md (3.1–3.13), Milestones M059–M064, AGENTS.md, INTEGRATION-CONTRACTS.md, Boilerplate-Inventur. Eigene Greps/Reads in der Boilerplate verifiziert (keine Inventur-Blind-Übernahme).

Feld Wert
Modul-ID M03
Name Sales-Pipeline (Verkaufsfälle / Deals)
Milestones M059 (Pipeline-Konfig + SHK-Seed), M060 (Verkaufsfall-CRUD + Pflicht-Vertriebler), M061 (Kanban-UI + Drag&Drop), M062 (Verlust/Gewinn-Gründe), M063 (Auto-Auftragsprojekt + Setter-Closer), M064 (Reporting + Stuck/Auto-Archiv + KWP-Sync)
Block Block 3 — Workflow-Kern (Vertrieb & Auftrag)
Reuse-Level low (solides Querschnitt-Fundament + Bau-Vorlagen, aber kein Sales-Domänen-Modell vorhanden — Datenkern komplett neu)

Kernbefund (Realität)

  • Es existiert KEIN Sales-/Deal-/Pipeline-Datenmodell in der Boilerplate. Grep über prisma/schema/*.prisma nach Deal|Pipeline|Stage|Forecast|Kanban|SalesPipeline liefert null Treffer bei Modellen. Treffer für Lead/LeadEvent betreffen das marketing-scoped Lead-Modell (operator-scoped, NICHT tenant-scoped, email @unique) — das ist die M01/M02-Funnel-Welt, nicht der tenant-scoped Verkaufsfall aus M03.
  • Es existiert KEIN zentrales Activity-Modell wie es M03 (DealActivity → zentrale Activity aus M1) und INTEGRATION-CONTRACTS §5 (logActivity) verlangen. Vorhanden sind nur LeadEvent (Lead-Timeline, marketingLeads.prisma) und RowComment/Entity.hasActivity-Flag im EntityBuilder — kein generischer, cross-entity Activity-Stream. → M045 (Activity-Service) ist Vorbedingung und muss separat existieren.
  • HiveGrid-Cloud-Repo enthält derzeit noch KEINEN Boilerplate-Code (packages/, apps/, prisma/schema/ sind leer/abwesend; nur docs/, _bmad*, leeres prisma/). Der Abgleich erfolgt also gegen das separate Boilerplate-Repo; die Übernahme = Code aus Boilerplate als Fundament + neue Sales-Schicht darauf.
  • Das stärkste vorhandene Sales-nahe Asset ist der EntityBuilder (board-View = Kanban, groupBy, Row/Property/ Tag/Task/Comment/RowPermission, Custom-Felder). Er ist als Vorlage/Pattern sehr wertvoll, aber für ein Kern-Vertriebsmodul mit Pflicht-FKs (Kontakt/Firma/Lead/Projekt), Stage-Probabilities, Won/Lost-Reverse-Window, Forecast und Field-Level-Volumen-Permissions nicht 1:1 als Datenmodell tauglich (LP-4: Commodity sauber bauen, kein Über-Engineering über generischen No-Code-Layer).

Übernehmbar aus Boilerplate

Querschnitt / Foundation (1:1 nutzbar)

Boilerplate-Pfad Was Wie nutzbar
packages/foundation/src/permissions.ts withTenantScope(), withPermission(), withOwnerCheck(), requirePermission(); 404-statt-403 bei Deny 1:1 — deckt Block I (read_own/read_all, 404 für nicht-eigenen Deal, Stage-Change-Gate)
packages/foundation/src/audit.ts auditEvent(), withAuditMiddleware() (AuditEvent-Hash-Kette) 1:1 — AV #6 Audit-Default für Stage-Wechsel u. a. (S/W außerhalb Prisma manuell)
packages/foundation/src/notifications.ts notify(), bundleNotifications(), Preference-Check, i18n-Key-Zwang 1:1 — deal.won/deal.stuck-Notifications (INTEGRATION-CONTRACTS §7)
packages/foundation/src/errors.ts CatalogError, foundationErrors, toPinoLogObject 1:1 — Klartext-Diagnostik (3.13, LP-10): Stage-Validation, Stuck, Won/Lost-Confirm
packages/foundation/src/idempotency.ts withIdempotency() 1:1 — idempotente Deal-Anlage aus Lead/Form/Email/Anruf/Automation (3.7)
packages/foundation/src/flags.ts + packages/feature-flags/* Feature-Flag-Engine (defineFlag/evaluateFlag, React-Hooks) 1:1 — DoD „Modul ohne Deploy abschaltbar"; Sidebar-feature_flag
packages/view-models/src/index.ts VMState, ActionCallbacks, RegistryGate, SidebarRegistryItem, assertI18nLabel 1:1 — VM-Layer-Vertrag (AGENTS A.1–A.5, INTEGRATION §11/§13)
packages/i18n/src/index.ts Locales (de/en), formatCurrency/formatNumber/formatDate, ICU, useTranslate 1:1 — Volumen-/Datum-Formatierung, i18n-Keys sales.*
packages/logger, packages/observability, packages/error-reporter, packages/metrics Pino-Redaction, PII-Span-Scrub, Sentry, prom-Counter 1:1 — Logging/Tracing/Error-Querschnitt
packages/url/src/canonical.ts appPath/appUrl host-aware 1:1 — Deal-Routes/Links (/deals/...)
packages/db/src/client.server.ts getReadDbClient() (Replica) / getWriteDbClient() / getExtendedDbClient() 1:1 — Read-heavy Kanban/Listen via Read-Replica (Performance-Anforderung Block D)
packages/db/src/transactions.server.ts + packages/db/src/outbox.ts runDbTransaction(), publishOutboxEvent() (atomic Side-Effects) 1:1 — Stage-Wechsel + Activity + Notification + Automation-Trigger transaktional (deal.stage_changed, deal.won)
packages/db/src/dsgvo/user-fk-map.ts Pflicht-Karte aller User-FKs (CI-Gate) anpassen — neue Deal-FKs auf User (created_by, assigned_to) MÜSSEN ergänzt werden, sonst bricht CI

Apps / Infra (1:1 / als-Vorlage)

Boilerplate-Pfad Was Wie nutzbar
apps/worker/src/jobs/* + apps/worker/src/group-runtime.ts BullMQ-Cron-Pattern (single-instance, Gruppen, DI HandlerDependencies) als-vorlage — Daily-Cron für Stuck-Detection (3.8.1/3.8.2), Auto-Archiv Won 30d / Lost 90d (3.8.3/3.8.4, M064)
apps/worker/src/outbox/{dispatcher,event-router}.ts Outbox-Dispatcher (FOR UPDATE SKIP LOCKED) + Prefix-Routing anpassen — neues Prefix deal. / sales. in DEFAULT_OUTBOX_ROUTING für Automation-Trigger (3.6/H/M075)
packages/queue/src/* Queue-Namen, typisierte Producer, buildIdempotentJobId, Plan-Prioritäten 1:1 — Cron-/Job-Infrastruktur für Stuck/Archiv/Forecast-Cache
packages/realtime/src/{events,server,client}.ts SSE-Serialisierung + Client/Server-Helfer anpassen — Live-Kanban-Updates (3.4.11, M061). Achtung: Boilerplate hat nur SSE, kein WebSocket — der „WebSocket vs SSE"-Offene-Punkt der Spec ist faktisch auf SSE zu entscheiden; REALTIME_EVENT_NAMES um Deal-Events erweitern
packages/exports/src/csv/* + packages/exports/src/limits.ts + Worker export.ts CSV-Export (Streaming, Plan-Row-Caps, Injection-Safety) 1:1 — CSV-Export gefilterter Deals (3.4.10, M061)
packages/search/src/schemas/ (crm-contacts.ts, rows.ts als Muster) + outbox-publisher.ts Meilisearch tenant-scoped Index + Outbox-Reindex als-vorlage — neues Index-Schema deals (Titel/Description/Kontakt-/Firmen-Name, 3.4.5); Registrierung in indexed-entities.ts (INTEGRATION §8)

UI / App-Shell (als-Vorlage / anpassen)

Boilerplate-Pfad Was Wie nutzbar
apps/web/app/components/layouts/sidebars/shadcn/* + apps/web/app/application/sidebar/{AppSidebar,SidebarItem}.tsx Datengetriebene Sidebar mit Permission-/Feature-Gating, data-ui-id als-vorlage — Sidebar-Eintrag „Verkaufsfälle" (Gruppe ARBEITEN) + „Pipelines" (Gruppe EINSTELLUNGEN); HiveGrid nutzt packages/ui-hivegrid/src/app-shell/sidebar.config.ts (neu)
apps/web/app/components/ui/* (shadcn/Radix: table, tabs, dialog, sheet, drawer, badge, card, command, multi-select, pagination, calendar) Primitive-Bibliothek (~707 Komponenten) 1:1 / als-vorlage — Deal-Detail-Tabs, Bulk-Select, Filter-Bar, Confirm-Dialoge (Won/Lost), Listen-Tabelle
apps/web/app/components/ui/tables/* (TableNew, TablePagination, ColumnSelector, RowsLoadMoreCard) Tabellen-Bausteine: Cursor-Pagination, Spalten-Konfig, „Mehr laden" 1:1 — Listen-View (3.4.8 Spalten-Konfig pro User, Cursor-Pagination, Default „zuletzt geändert"
apps/web/package.json → @dnd-kit/core 6.3.1, @dnd-kit/sortable, @dnd-kit/utilities Drag&Drop bereits als Dependency vorhanden 1:1 — Kanban-D&D (3.4.3, M061) und Pipeline-/Stage-Reorder (3.2.7, M059). Hinweis M061 nennt react-beautiful-dnd — faktisch ist @dnd-kit vorhanden, das nutzen
apps/web/app/modules/formWidget/builder/{Canvas,SortableField,palette}.tsx Drag&Drop-Sortier-Editor (SortableField) als konkretes @dnd-kit-Beispiel als-vorlage — Stage-Liste-Reorder im Pipeline-Editor (M059)
packages/ui-mock/src/index.ts (MockPage, generateMockArtifacts) + apps/web/.../hot-swap/HotSwapPageRenderer.tsx Hot-Swap-Drill + Visual-Snapshot-Fundament 1:1 — DoD Hot-Swap-Drill (M017) + Visual-Regression (M016) für Kanban/Detail
apps/storybook/* (lost-pixel, axe a11y, i18n-Decorator) Visual-Regression + a11y-Gate 1:1 — Snapshot der Hauptansicht (M016)

Domänen-nahe Bau-Vorlagen (als-Vorlage)

Boilerplate-Pfad Was Wie nutzbar
prisma/schema/entityBuilder.prisma — EntityView (layout="board", groupByPropertyId, pageSize, EntityViewFilter/Sort/Property) Generische Kanban/Board-View-Konfiguration als-vorlage — Pattern für Stage-Spalten + Filter/Sort/Spalten-Konfig (NICHT als Deal-Datenmodell übernehmen)
prisma/schema/entityBuilder.prisma — Property + PropertyOption/PropertyAttribute (typisierte Custom-Felder, applicable_to via entityId) Custom-Felder mit Typen/Optionen anpassen — Deal-Custom-Felder „Anlagen-Typ"/„Wärmebedarf kW"/„Bestandsanlage" (3.1.14, Block H). Entweder über EntityBuilder koppeln (applicable_to=deal) oder eigene schlanke Deal-Custom-Field-Tabelle
prisma/schema/entityBuilder.prisma — RowTag/EntityTag, RowTask, RowComment Tags / Aufgaben-Link / Notizen an Rows als-vorlage — Deal-Tags (3.1.13), Deal↔Task-Link (M26/3.9.1), Notizen
packages/db/src/rows.server.ts — getNextRowMutationNumber() / Row.folio (aggregate _max.folio + 1, tenant+entity-scoped) Fortlaufende Nummer pro Tenant/Entity als-vorlage — Sequenz-Mechanik für HiveNumberSeq / deal_number. Lücke: kein Prefix-/Format-Layer (D-2026-0042), keine konfigurierbare Reset-Strategie — neu zu bauen (M060)
prisma/schema/marketingLeads.prisma — Lead + LeadEvent (Timeline, convertedToTenantId) Lead-Modell + Event-Timeline (operator-scoped) als-vorlage — Lead→Deal-Promotion-Wiring (3.7.2, Block H/M1). Achtung: dies ist das Marketing-Lead; M03 lead_id zeigt vermutlich auf das M01/M02-Lead-Konstrukt — Mapping mit M01/M02-Team klären
prisma/schema/helpDesk.prisma — Feedback/SupportTicket (archived-/status-Muster) & prisma/schema/entityBuilder.prisma — Row.deletedAt/ExportJob (Soft-Archiv) Soft-Archive-Muster (archived_at statt Hard-Delete) als-vorlage — Deal/Pipeline/Stage/LostReason-Archivierung (3.2.3/3.3.4/3.8)
apps/api/src/routes/entity-row-routes.ts + route-access-inventory.ts REST-CRUD + Auth-Klassen-Matrix als-vorlage — falls Deals über Public-API exponiert werden (INTEGRATION §3 api/v1)
apps/web/app/utils/services/.server/* + application/dtos/* Muster Service-/DTO-/View-Model-Schichtung (SaasRock-Stil) als-vorlage — Struktur für app/domain/sales/*, view-models/sales/*.vm.ts

Vorhandene Daten-Modelle (konkret, mit Pfad)

Direkt für M03 wiederverwendbar/anbindbar (kein Deal-Modell darunter):

Modell Pfad Rolle für M03
Tenant, User, TenantUser prisma/schema/accounts.prisma Tenant-Scope-Anker; assigned_to_user_id, created_by_user_id, Vertriebler-Pflicht [N6]
Role, Permission, RolePermission, UserRole, Group prisma/schema/permissions.prisma RBAC-Fundament für deals.*-Bundles (Block I) — neue Permission-Keys einseeden
AuditEvent prisma/schema/core.prisma:55 Audit-Trail Stage-Wechsel (Hash-Kette, AV #6)
IdempotencyKey prisma/schema/core.prisma:84 Idempotente Deal-Anlage aus Quellen (3.7)
FileObject / FileUploadProgress / FileChunk prisma/schema/core.prisma Verknüpfte Files am Deal (Block E, Won-Handoff-Files)
NotificationDelivery, UserNotificationPreference prisma/schema/notifications.prisma deal.won/deal.stuck-Notifications
OutboxEvent prisma/schema/outbox.prisma Atomic Side-Effects (Stage-Change → Activity/Notify/Automation)
FeatureFlag (+ Filter/Audit) prisma/schema/featureFlags.prisma Modul-Kill-Switch
Form, FormSubmission prisma/schema/formWidget.prisma Quelle „Deal aus Form" (3.7.3) + DealForm-Verknüpfung (Block A)
Lead, LeadEvent prisma/schema/marketingLeads.prisma Lead-Origin-Bezug (lead_id), Promotion-Pattern (3.7.2)
Entity/EntityView/Property/Row/RowTag/RowTask/RowComment/RowPermission prisma/schema/entityBuilder.prisma NUR als Pattern/optionale Custom-Feld-Kopplung — nicht als Deal-Kernmodell
ExportJob (+ Enum) prisma/schema/queue.prisma CSV-Export-Job-Tracking

Ablageort für die neuen HiveGrid-Modelle: prisma/schema/app.prisma ist der vorgesehene leere Platzhalter (// custom database models) — dort gehören Pipeline, PipelineStage, Deal, DealActivity/Activity, DealForm, LostReason/WinReason, HiveNumberSeq hinein (bzw. eigene sales.prisma).


Lücken / komplett neu zu bauen

Datenmodell (komplett neu, kein Boilerplate-Äquivalent):

  • Pipeline (Multi-Pipeline ab Tag 1, is_default, position, archived_at) — 3.2, M059
  • PipelineStage (stage_kind open|won|lost, win_probability, auto_archive_after_days, color, position)
    • Validierung „mind. 1 won + 1 lost" — 3.2.5/3.2.6, M059
  • Deal (alle Pflicht-FKs: contact_id Pflicht, company_id optional, lead_id, lost_reason_id, won_handoff_project_id, volume numeric(12,2), expected/actual_close_date, deal_number) — 3.1, M060
  • LostReason und Gewinn-Gründe (WinReason) — Tenant-pflegbar, archivierbar, Pflicht/Optional-Toggle pro Liste [N8] — 3.3, M062 (in Boilerplate gar nichts)
  • HiveNumberSeq mit prefix/format (D-2026-0042) + Reset-Strategie — 3.1.1, M060 (Boilerplate hat nur folio-Counter ohne Format-Layer)
  • Zentrale Activity/DealActivity mit Typen (deal_stage_changed inkl. from/to_stage_id + duration_in_previous_stage_seconds, deal_won/deal_lost, …) — Block A/M045. Vorbedingung M045 prüfen.

Domänen-Logik (neu):

  • Stage-Wechsel-Engine inkl. Vorwärts/Rückwärts (Klartext-Hinweis), Won/Lost-Confirm-Workflow, 24h-Reverse-Window (Soft-Revert vs. neue Stage-Activity — Offener-Punkt der Spec), change_stage-Gate — 3.5
  • Won-Handoff zu M4 (Projekt-Anlage, Feld-Mapping Deal→Projekt, Ziel-Pipeline-/Start-Stage-Wahl, won_handoff_project_id, Mehrfach-Projekte aus einem Deal, Option A vs. B [N7], Wartung/Service kein Projekt [N9]) — 3.6, M063. Hängt an M065 (Auftragspipeline) — noch nicht vorhanden.
  • Setter-Closer-Termin-Anlage mit konfigurierbarem Feld-Mapping Deal→Termin [N17] — 3.9.5, M063. Hängt an M119/M25 (Calendar-Sync) — nicht vorhanden.
  • Forecast-Berechnung (volume × win_probability/100, Zeitraum-Split, realisierter Umsatz), Vertriebler-KPIs, Stage-Conversion-Rates, Lost-Reason-Verteilung + Aggregat-/Forecast-Cache — 3.10, M064. Kein generischer KPI-Builder in Boilerplate für diese Sales-Metriken vorhanden.
  • Field-Level-Volumen-Permission-Redaction (read_volume_own/all, read_aggregates) — Volumen „—" je Rolle in Kanban-Karte/Detail/Liste/Aggregat — 3.11.2–3.11.4, Block I. Boilerplate kennt nur Object-Level + Row-Level ACL (RowPermission), kein Field-Level-Redaction-Pattern → neu.
  • Stuck-Detection-Logik + Stage-Verweildauer-Berechnung aus Stage-Change-Activities — 3.8, M064.

UI (neu, auf Boilerplate-Primitiven aufbauend):

  • Kanban-Board-Komponente mit @dnd-kit (Spalten=Stages, Aggregat pro Spalte, Karten-Redaction, Live-SSE-Update, „Mehr laden" pro Spalte ab 100+) — M061. (EntityBuilder-board-View ist nicht der HiveGrid-Kanban.)
  • Pipeline-Switcher + „Nur meine Deals"-Quickfilter + Filter-Bar (Multi-Select) — M061
  • Deal-Detail mit Stage-Pipeline-Komponente, Inline-Edit, Tab-Navigation, Klartext-Bannern (Won/Lost/Stuck/ Kontakt-archiviert) — Block E
  • Pipeline-Editor (Stage-Liste D&D, Won/Lost-Validation-Anzeige) + Lost-/Win-Reason-Editor — M059/M062
  • packages/ui-hivegrid/ selbst existiert in der Boilerplate nicht (nur leerer ui-subframe-Stub + Adapter-Metadaten in @toolctrl/ui) — der Adapter-Layer + Sidebar-/Breadcrumb-Config muss als HiveGrid- Infrastruktur erst angelegt werden (Querschnitt M013–M017, nicht M03-spezifisch).

Querschnitt-Wiring, das M03 voraussetzt, aber in Boilerplate fehlt:

  • @hivegrid/activity (logActivity, M045) — kein Äquivalent
  • packages/db/src/search/indexed-entities.ts (M056) — existiert nicht (nur statische search/schemas/*)
  • packages/ui-hivegrid/src/app-shell/sidebar.config.ts / breadcrumbs/ / mobile/tab-bar.config.ts / customer-portal/portal-shell.config.ts (INTEGRATION §2/§4/§13/§14) — alle neu
  • packages/entitlements/src/permissions.ts-Keys sales.*/deals.* (INTEGRATION §10) — neu zu definieren

Integrationen mit anderen Modulen (out of M03-scope, aber harte Abhängigkeiten):

  • M4/M065 Auftragspipeline (Won-Handoff-Ziel) · M045 Activity · M042/M043 CRM-Kontakt/Firma · M048 Lead-Routing (Default-Vertriebler) · M25/M119 Kalender (Setter-Closer) · M147 Dashboard (KPI-Widgets) · M5/M9/M12/M17 (Deal-Quellen) — keines davon in der Boilerplate fertig; M03 baut die Hooks/Producer, die Gegenseite separat.

Empfohlenes Vorgehen (Reihenfolge)

  1. Fundament aktivieren (vor M03): Boilerplate-Code als HiveGrid-Codebase übernehmen (AGENTS Pre-Flight), Querschnitt-Pakete (foundation, view-models, feature-flags, i18n, db, queue, realtime, exports, search, logger) 1:1 nutzen. Sicherstellen, dass die HiveGrid-Querschnitt-Milestones (M001 Audit, M004 Permissions, M013–M017 UI/VM/Adapter/Hot-Swap, M045 Activity, M056/M057 Search) vorhanden sind — M03 setzt sie laut DoD/INTEGRATION-CONTRACTS voraus.

  2. M059 — Daten + Pipeline-Konfig (neu, mit Vorlagen): Pipeline/PipelineStage in app.prisma (bzw. sales.prisma) neu modellieren. Stage-Reorder-UI via @dnd-kit (Vorlage: formWidget SortableField/Canvas). Won/Lost-Validation als CatalogError (foundation/errors). SHK-Seed als Konfig-Datei (Bauprinzip A.3) im Seed-Pfad (prisma/seed.ts-Muster). Soft-Archive-Pattern übernehmen. user-fk-map.ts für neue User-FKs ergänzen (CI-Gate).

  3. M060 — Verkaufsfall-CRUD (neu): Deal + DealForm modellieren; HiveNumberSeq neu (Sequenz-Mechanik als-Vorlage aus rows.server.ts:getNextRowMutationNumber, Prefix/Format-Layer neu). Deal-Anlage-Quellen über withIdempotency + Outbox. Pflicht-Vertriebler [N6] über withOwnerCheck/Default aus Routing. Stage-Wechsel + 24h-Reverse transaktional (runDbTransaction + publishOutboxEvent). View-Model-Layer (view-models/sales/*.vm.ts) + Smoke-Test + Hot-Swap-Drill (DoD).

  4. M061 — Kanban/Listen-UI (neu auf Primitiven): Kanban mit @dnd-kit; Listen-View mit TableNew/ ColumnSelector/TablePagination (1:1). Live-Updates über @toolctrl/realtime (SSE, neue Deal-Events). Server-side Filter (getReadDbClient). CSV-Export via @toolctrl/exports. Field-Level-Volumen-Redaction im VM-Builder (neu) — Volumen „—" je Permission. Search-Index deals registrieren.

  5. M062 — Verlust/Gewinn-Gründe (neu, klein): LostReason/WinReason (Soft-Archive, Pflicht/Optional-Toggle pro Liste [N8]) + 5+5 SHK-Seeds + Aggregations-Auswertung (gehört konzeptionell zu M064-Reporting).

  6. M063 — Won-Handoff + Setter-Closer (neu, abhängig): Erst nach M065 (Auftragspipeline) und M119/M25 (Kalender). Won-Handoff-Modal + Feld-Mapping Deal→Projekt + Option A/B [N7] + Wartung/Service-kein-Projekt [N9]; Setter-Closer-Termin mit konfigurierbarem Mapping [N17]. Automation-Trigger über Outbox-Prefix deal..

  7. M064 — Reporting + Jobs (neu): Forecast/KPIs/Conversion/Lost-Verteilung + Aggregat-/Forecast-Cache; Daily-Cron (Stuck-Detection, Auto-Archiv Won 30d/Lost 90d) nach BullMQ-Cron-Pattern (Worker-Vorlage). Optionaler KWP-Sync (Wartung ausgenommen [N9]) — externe Adapter-Schicht.

Querschnitt-Entscheidungen, die die Spec offen lässt und durch Boilerplate-Realität präjudiziert sind:

  • Real-Time-Kanban: SSE (@toolctrl/realtime), kein WebSocket (in Boilerplate nicht vorhanden).
  • Cache-Invalidierung Aggregate: über Outbox/Pub-Sub (shared-store DB-Index 2) bei Stage-Wechsel.
  • Custom-Felder: Kopplung an EntityBuilder-Property (applicable_to=deal) prüfen vs. schlanke eigene Tabelle — Entscheidung mit M044-Team (LP-4: kein Über-Engineering).