65 lines
9.1 KiB
Markdown
65 lines
9.1 KiB
Markdown
# 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
|
|
- [x] 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).
|
|
- [x] 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).
|
|
- [x] 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.
|
|
- [x] `modules/crm/CrmService`-Legacy entfernt. — `modules/crm` **vollständig gelöscht** (CrmService.ts + ProductCoreCrmEntities.server.ts + Tests); 0-Konsumenten-Beweis per repo-weitem grep.
|
|
- [x] Keine neuen Entity-Builder-Konsumenten eingeführt (AD-2).
|
|
- [x] Voller CI-Test-Scope grün (typecheck + lint + test:foundation/packages/mobile + test + verify:i18n + verify:cross-cutting-models).
|
|
- [x] 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.
|
|
- 2026-07-19: **Stand-Audit (Code vs. Plane vs. Doc) — Befund + Restwork.** Alle 7 DoD-Punkte gegen den realen Code auf `main` verifiziert (Commits `ebef2ea17`…`3b654597a` + `e6a7252ed` auf `main`; `modules/crm`/`formulas`/`codeGenerator`/`rows`, `utils/db/entities`, `EntitiesSingleton`, `entityBuilder.prisma` real weg; Registry-Tests 9/9 grün; kanonischer Web-Typecheck grün). **Ein Rest zu DoD-3 gefunden:** `apps/web/app/utils/helpers/.server/TemplateApiService.ts` importierte noch `EntityWithDetails`/`RowHelper` (tote Datei, 0 Importer; entging dem Typecheck, weil tsc-Include-Globs Dot-Ordner `.server/` überspringen) → gelöscht in `08f87538c` (Branch `fix/r-p14c-audit-restwork`). Zwischenstand während des Audits 6/7 = ~86 %; **nach Restwork wieder 7/7 = 100 % done.** RLS-Nachprüfung (Cutover 14.07.): `kontaktAdapter` → `crmService.server` bindet `withTenantRLS` selbst — kein Regressions-Befund. Hinweis Tracking: `R-P14C-T2`/`D`/`E`/`F`/`G` haben kein eigenes Plane-Ticket; sie werden über HIVEGRID-169 getrackt (Header der Child-Docs entsprechend korrigiert).
|