8.0 KiB
R-P14C · EmailMarketing-Typisierung + rückwirkende Entity-Builder-Ablösung
| Typ | Dev (Code) |
| Owner | Raffael (+ Agent) — übernimmt das EmailMarketing-Modul von Akeshan |
| Phase | P14 / P6 (Entity-Builder-Ablösung, AD-2) |
| Plane | HIVEGRID-169 · blocked-by AK-P14a (#42) + AK-P14b (#43) |
| Status | erledigt · 7/7 DoD = 100 % done |
Plan-Entscheidung (2026-06-29, Raffael)
Akeshan baut AK-P14a (#42) + AK-P14b (#43) planmäßig auf dem bestehenden Entity-Builder fertig (das ist OK — sie werden hier ohnehin migriert). Danach stoppt Akeshan kurz, und Raffael (+ Agent) übernimmt das EmailMarketing-Modul mit diesem Ticket. R-P14C ist der gebündelte Migrations-Schritt: EmailMarketing typisieren und die übrigen rückwirkenden Builder-Konsumenten gleich „im Vorhinein" mitnehmen, damit die nächsten Tickets sauber typisiert aufsetzen.
Was wir bauen
Teil 1 — EmailMarketing typisiert (löst die CrmService-Legacy ab):
- Contact-Repo-Template: typisierte Lese-API (
getContactsByIds(ids, tenantId): Kontakt[]o.ä.) auf dem R-P6-Kontakt-Modell. modules/emailMarketing/services/EmailMarketingService.ts(+ email-marketing-Routes) vonCrmService.getContact/getContactsInRowIds/validateauf die typisierte API umstellen.- Daten: prüfen, ob bestehende Kampagnen contact-Row-IDs referenzieren → ggf. kleine Daten-Migration (Row-ID → Kontakt-ID), nicht nur Code.
- Danach:
modules/crm/CrmService(Legacy-Reader) entfernbar.
Teil 2 — rückwirkende Migration der übrigen gebauten Builder-Konsumenten (siehe R-P6B §Rückwirkungs-Audit):
- WorkflowEngine (
modules/workflowEngine):EntitiesSingleton.getEntity()→ typisierte Workflow-Registry. - formulas (
modules/formulas):EntityWithDetails/PropertyWithDetails→ typisiertes Evaluations-Modell. - codeGenerator / onboarding: prüfen, ob noch aktiv/nötig; sonst typisieren oder entfernen.
Erst wenn Teil 1+2 durch sind, kann R-P6B-β (EntitiesSingleton raus → modules/rows/utils/db/entities/Routen/Schema löschen) gefahren werden.
Definition of Done
- Typisierte Contact-Lese-API auf dem
Kontakt-Modell (ersetzt dieCrmService-Reader). — Variante A: erfüllt durch Entfernung statt Neubau. DieCrmService-Reader-Konsumenten (EmailMarketingService) wurden gelöscht; Akeshans typisierte Segment-/Send-Engine (CampaignSendService liesttx.kontaktdirekt) deckt den Versand ab.getKontakteByIdswurde nicht hinzugefügt, da keine verbleibende Stelle einen typisierten Batch-Kontakt-Lookup braucht (nichts erfinden, AD-2). - EmailMarketing nutzt keine Entity-Builder-/
CrmService-Reader mehr; Kampagnen-Empfänger typisiert. — Empfänger überOutboundEmail.kontaktId(+RecipientSegment). Keine Daten-Migration nötig (Pre-Launch, keinecontactRowId-Kampagnen in Prod/Staging; Demo-Seed legt keine an). - WorkflowEngine + formulas (+ codeGenerator/onboarding nach Prüfung) nutzen
EntitiesSingleton/Entity/Propertynicht mehr. — Erfüllt über R-P14C-T2 + R-P6B-β: WorkflowEngine läuft über die typisierte Modell-Registry (Kontaktals erster Adapter), onboarding ist entkoppelt, formulas + codeGenerator wurden bewusst mit β geschnitten. modules/crm/CrmService-Legacy entfernt. —modules/crmvollständig gelöscht (CrmService.ts + ProductCoreCrmEntities.server.ts + Tests); 0-Konsumenten-Beweis per repo-weitem grep.- Keine neuen Entity-Builder-Konsumenten eingeführt (AD-2).
- Voller CI-Test-Scope grün (typecheck + lint + test:foundation/packages/mobile + test + verify:i18n + verify:cross-cutting-models).
- R-P6B-β danach entsperrt (EntitiesSingleton-Removal + Schema-Löschung möglich). — Entsperrt und umgesetzt;
feat/R-P6B-betaist inmain, der aktuelle Branchfeat/R-P6B-drop-migrationergänzt die forward-only DROP-Migration.
Koordination / Sperre
- Solange R-P14C läuft, ruht/abgestimmt:
modules/emailMarketing,modules/workflowEngine,modules/formulas(Akeshan baut dort nicht parallel). - Akeshan wird bei Änderungen an seinen Modulen eingebunden.
Quellen
R-P6B.md§Migrationskette & Ownership + §Rückwirkungs-Audit (Konsumenten-Liste, Reihenfolge).docs/ARCHITECTURE-DECISIONS.mdAD-2 (verbindlich: keine neuen Konsumenten, Ablöse-Pflicht).
Umsetzung
-
2026-06-29: Ticket angelegt (Plan-Entscheidung Raffael). Bau startet, sobald AK-P14a/b fertig + Akeshan stoppt.
-
2026-06-30: Teil 1 (EmailMarketing) gebaut — Variante A (alten Entity-Builder-Editor-Pfad ENTFERNEN, nicht migrieren). Branch
feat/R-P14C(aufmainHEAD nach AK-P14b #21). Noch KEIN Push/PR/Merge (Raffael reviewt lokal, entscheidet über PR).Stand: 5/7 DoD = ~71 % des Gesamt-Tickets R-P14C. Der Teil-1-EmailMarketing-Scope dieses Durchlaufs ist zu 100 % erfüllt. Offen sind nur DoD-3 (WorkflowEngine/formulas/codeGenerator/onboarding) + DoD-7 (R-P6B-β-Entsperrung) = R-P14C Teil 2, ausdrücklich separater Durchlauf → in diesem Variante-A-Auftrag 0 selbst machbar.
Begründung Variante A: Der alte Editor ist Boilerplate-Legacy, den David (D-KAMP) ohnehin durch einen bespoke Editor ersetzt; ihn zu migrieren wäre Wegwerf-Arbeit. Das typisierte Backend (Versand via
CampaignSendServiceliesttx.kontaktdirekt, Empfänger viaRecipientSegment) steht schon → keine Funktionalität geht verloren, nur die alte UI-Hülle.Slices/Commits (5):
ebef2ea17S2: Entity-Builder-Kampagnen-Editor entfernt —EmailMarketingService(CrmService/EntityViewsApi/contactRow),Campaigns_New/Edit/List+ Components +campaignDefaults, app- und admin-Kampagnen-Routen, Campaigns-Nav-Tab (app+admin). Overview-Summary auf typisiertecountOutboundEmailsumgestellt. Activity-Log behalten und vom Entity-Builder befreit (getAllEntities/contactRow/RowHelperraus, Empfänger überemail-Feld, Kampagnen-Spalte de-linkt). Decision-Report-Verifier (crm/email-marketing) +plugin-candidates.json+ beide Reports nachgezogen.0368ffc3bS3:CrmService.validate-Gate aus app- + admin-email-marketing.tsxentfernt →CrmServiceohne Runtime-Konsumenten.d866ca767S4:contactRow-Joins auscampaigns.db.server+outboundEmails.db.serverentfernt; recipients überkontaktId; orphanedcreateOutboundEmailgelöscht.95f65f85aS5:OutboundEmail.contactRowId+contactRow-Relation ausemail.prismagedroppt + Row-Back-Relation inentityBuilder.prisma; AD-21prisma db push(kein Migration-File), Client regeneriert + mitcommittet.3b654597aS6:modules/crm(CrmService + ProductCoreCrmEntities + Tests) vollständig gelöscht (0-Konsumenten-Beweis);users.mfa.testvi.mock +visible-shell-copy-i18n.test-Listeneintrag + CRM-Verifier nachgezogen.
Verifikation (voller CI-Scope, pro Slice grün):
pnpm typecheck+lint+test:foundation(404) +test:packages(452) +test:mobile(62) +pnpm test(Core, 3663 nach Entfernung der CrmService-Tests) +verify:i18n+verify-cross-cutting-models(112/112) — alle grün.Übergangs-Vorbehalt (D-KAMP): Bis Davids bespoke Kampagnen-Editor (D-KAMP) da ist, gibt es im Übergang keine grafische Kampagnen-ERSTELL-UI; Segmente-Route + Backend-Versand (CampaignSendService) bleiben. Pre-Launch unkritisch (keine echten Kampagnen; Demo-Seed legt keine
contactRowId-Kampagnen an).modules/crmkonnte vollständig gelöscht werden. -
2026-06-30: HIVEGRID-169 Abschluss nachgezogen — 7/7 DoD = 100 % done. Teil 2 wurde über
R-P14C-T2abgeschlossen:R-P14D(WorkflowEngine → typisierte Modell-Registry) +R-P14F(onboarding entkoppelt) sind erledigt;R-P14E(formulas) +R-P14G(codeGenerator) wurden mitR-P6B-βbewusst entfernt.R-P6B-βist via PR #25 aufmain; aktueller Proof-Zusatz:e6a7252edergänzt die forward-only DROP-Migration20260630120000_drop_entity_builder. Verifikation laut R-P14C-T2/R-P6B: voller CI-Scope grün; Gitea-Actions für T1, R-P14C-teil2 und R-P6B-beta grün. Selbst machbar offen: 0.