21 KiB
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, Pflichtenheftblock3.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/*.prismanachDeal|Pipeline|Stage|Forecast|Kanban|SalesPipelineliefert null Treffer bei Modellen. Treffer fürLead/LeadEventbetreffen das marketing-scopedLead-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→ zentraleActivityaus M1) undINTEGRATION-CONTRACTS §5(logActivity) verlangen. Vorhanden sind nurLeadEvent(Lead-Timeline,marketingLeads.prisma) undRowComment/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; nurdocs/,_bmad*, leeresprisma/). 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, M059PipelineStage(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_idPflicht,company_idoptional,lead_id,lost_reason_id,won_handoff_project_id,volume numeric(12,2),expected/actual_close_date,deal_number) — 3.1, M060LostReasonund Gewinn-Gründe (WinReason) — Tenant-pflegbar, archivierbar, Pflicht/Optional-Toggle pro Liste [N8] — 3.3, M062 (in Boilerplate gar nichts)HiveNumberSeqmitprefix/format(D-2026-0042) + Reset-Strategie — 3.1.1, M060 (Boilerplate hat nurfolio-Counter ohne Format-Layer)- Zentrale
Activity/DealActivitymit Typen (deal_stage_changedinkl.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 leererui-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 Äquivalentpackages/db/src/search/indexed-entities.ts(M056) — existiert nicht (nur statischesearch/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 neupackages/entitlements/src/permissions.ts-Keyssales.*/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)
-
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. -
M059 — Daten + Pipeline-Konfig (neu, mit Vorlagen):
Pipeline/PipelineStageinapp.prisma(bzw.sales.prisma) neu modellieren. Stage-Reorder-UI via @dnd-kit (Vorlage: formWidgetSortableField/Canvas). Won/Lost-Validation alsCatalogError(foundation/errors). SHK-Seed als Konfig-Datei (Bauprinzip A.3) im Seed-Pfad (prisma/seed.ts-Muster). Soft-Archive-Pattern übernehmen.user-fk-map.tsfür neue User-FKs ergänzen (CI-Gate). -
M060 — Verkaufsfall-CRUD (neu):
Deal+DealFormmodellieren;HiveNumberSeqneu (Sequenz-Mechanik als-Vorlage ausrows.server.ts:getNextRowMutationNumber, Prefix/Format-Layer neu). Deal-Anlage-Quellen überwithIdempotency+ Outbox. Pflicht-Vertriebler [N6] überwithOwnerCheck/Default aus Routing. Stage-Wechsel + 24h-Reverse transaktional (runDbTransaction+publishOutboxEvent). View-Model-Layer (view-models/sales/*.vm.ts) + Smoke-Test + Hot-Swap-Drill (DoD). -
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-Indexdealsregistrieren. -
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). -
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.. -
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-storeDB-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).