Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P14C.md
T
2026-07-08 16:15:37 +02:00

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) von CrmService.getContact/getContactsInRowIds/validate auf 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 die CrmService-Reader). — Variante A: erfüllt durch Entfernung statt Neubau. Die CrmService-Reader-Konsumenten (EmailMarketingService) wurden gelöscht; Akeshans typisierte Segment-/Send-Engine (CampaignSendService liest tx.kontakt direkt) deckt den Versand ab. getKontakteByIds wurde 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 über OutboundEmail.kontaktId (+ RecipientSegment). Keine Daten-Migration nötig (Pre-Launch, keine contactRowId-Kampagnen in Prod/Staging; Demo-Seed legt keine an).
  • WorkflowEngine + formulas (+ codeGenerator/onboarding nach Prüfung) nutzen EntitiesSingleton/Entity/Property nicht mehr. — Erfüllt über R-P14C-T2 + R-P6B-β: WorkflowEngine läuft über die typisierte Modell-Registry (Kontakt als erster Adapter), onboarding ist entkoppelt, formulas + codeGenerator wurden bewusst mit β geschnitten.
  • modules/crm/CrmService-Legacy entfernt. — modules/crm vollstä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-beta ist in main, der aktuelle Branch feat/R-P6B-drop-migration ergä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.md AD-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 (auf main HEAD 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 CampaignSendService liest tx.kontakt direkt, Empfänger via RecipientSegment) steht schon → keine Funktionalität geht verloren, nur die alte UI-Hülle.

    Slices/Commits (5):

    • ebef2ea17 S2: 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 typisierte countOutboundEmails umgestellt. Activity-Log behalten und vom Entity-Builder befreit (getAllEntities/contactRow/RowHelper raus, Empfänger über email-Feld, Kampagnen-Spalte de-linkt). Decision-Report-Verifier (crm/email-marketing) + plugin-candidates.json + beide Reports nachgezogen.
    • 0368ffc3b S3: CrmService.validate-Gate aus app- + admin-email-marketing.tsx entfernt → CrmService ohne Runtime-Konsumenten.
    • d866ca767 S4: contactRow-Joins aus campaigns.db.server + outboundEmails.db.server entfernt; recipients über kontaktId; orphaned createOutboundEmail gelöscht.
    • 95f65f85a S5: OutboundEmail.contactRowId + contactRow-Relation aus email.prisma gedroppt + Row-Back-Relation in entityBuilder.prisma; AD-21 prisma db push (kein Migration-File), Client regeneriert + mitcommittet.
    • 3b654597a S6: modules/crm (CrmService + ProductCoreCrmEntities + Tests) vollständig gelöscht (0-Konsumenten-Beweis); users.mfa.test vi.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/crm konnte vollständig gelöscht werden.

  • 2026-06-30: HIVEGRID-169 Abschluss nachgezogen — 7/7 DoD = 100 % done. Teil 2 wurde über R-P14C-T2 abgeschlossen: R-P14D (WorkflowEngine → typisierte Modell-Registry) + R-P14F (onboarding entkoppelt) sind erledigt; R-P14E (formulas) + R-P14G (codeGenerator) wurden mit R-P6B-β bewusst entfernt. R-P6B-β ist via PR #25 auf main; aktueller Proof-Zusatz: e6a7252ed ergänzt die forward-only DROP-Migration 20260630120000_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.