4.7 KiB
R-P6C · CRM-Querschnitt-Nachzüge (projektweite Verdrahtung)
| Typ | Dev (Code) |
| Owner | Raffael (+ Agent) — nur wir, kein Akeshan |
| Phase | P6 — CRM-Kern (Zwischenticket R-P6 → R-P6B) |
| Status | geplant |
Warum dieses Ticket
R-P6 hat die typisierten CRM-Modelle eingeführt und ist querschnittlich zu ~80 % verdrahtet (Audit 2026-06-29). Drei projektweite Cross-Cutting-Stellen sind aber noch offen — sie gehören NICHT in die große Entity-Builder-Ablösung (R-P6B, durch AK-P14 blockiert), sondern sind kleine, nicht-blockierte CRM-Nachzüge, die wir selbst bündeln. Auslöser war u.a. der TENANT_SCOPED_MODELS-CI-Bruch (ein Symptom der projektweiten Registry-Pflicht).
Abgrenzung: Dies ist KEIN Entity-Builder-Abbau (das ist R-P6B-β). Hier wird nur die fehlende Querschnitt-Verdrahtung der NEUEN typisierten CRM-Entitäten ergänzt.
Was bereits erledigt ist (R-P6, nur zur Abgrenzung)
✅ TENANT_SCOPED_MODELS, Tenant-Snapshot, Audit (auditCrmEvent), Activity-Stream (contact/company + contact_*), Notifications-fähig, Sidebar + Permission-Gate, Command-Registry, Such-Schema (crm-contacts in ALL_SEARCH_INDEXES).
Definition of Done
- Such-Index Registry verdrahtet (AGENTS DoD 16, Teilerfüllung):
contactinpackages/search/src/indexed-entities.tsregistriert (TabelleKontakt, Indexcrm-contacts, permission-gatedcrm.read_all; EIN Eintrag deckt Privatperson + Organisation ab, daKontaktOberbegriff ist — kein separater Company-Index). Befund: Die funktionale Indexierung der typisierten Kontakte ist NICHT trivial isolierbar — dercrm-contacts-Index wird aktuell noch vom Entity-Builder-Row-Feeder (rowSearchOutbox+ Row-createCrmContactsPager) befüllt, nicht vom typisiertenKontakt-Modell. Den Feeder auf typisiert umzustellen löst den Row-Feeder ab → gehört zu R-P6B-β (siehe unten). Die Registry-Zeile ist vorbereitend + harmlos (gated nur, triggert keine kollidierende Indexierung). - DSGVO-Verdrahtung entschieden + umgesetzt: Konsistenter, dokumentierter Verzicht (Option 1) —
Kontakt.createdByUserId/zustaendigerUserIdsind bare Scalars (kein@relation), wie tasks/hr repo-weit; KEINuser-fk-map-Eintrag (Sonderweg vermieden). Entscheidung sichtbar im Kopfkommentar vonpackages/db/src/dsgvo/user-fk-map.tsdokumentiert; projektweite Pseudonymisierung bare-scalar-User-FKs als separates Querschnitt-Härtungs-Thema (wenn DSGVO-Lösch-Flow live geht) geparkt. - Footgun-Prävention:
scripts/verify-cross-cutting-models-complete.mjs(+.test.mjs+verify:cross-cutting-modelsnpm-Script + ci.yml „Quality Static Verify 2/2"). Erzwingt: jedes tenantId-Prisma-Modell ist inTENANT_SCOPED_MODELS— klare Fehlermeldung statt kryptischem packages/cli-Test. Aktuell104/104 models, 0 missing. - Lokal grün inkl. vollem CI-Test-Scope (typecheck + lint + test:foundation + test:packages + test:mobile + test + verify:i18n + verify:cross-cutting-models) — alle exit 0; PR mit grüner CI nach main.
Out of Scope (→ R-P6B-β + dessen Migrationskette)
Die Entity-Builder-Ablösung ist verbindlich (AD-2): kein „optional", und ab sofort keine neuen Konsumenten — siehe AGENTS.md + R-P6B.md §Rückwirkungs-Audit.
- Entity-Builder-Abbau (modules/rows, utils/db/entities, entityBuilder.prisma, EntitiesSingleton).
- Die Migrationskette davor (EmailMarketing/Workflows/API/Worker weg von Entity-Builder-
contact→ typisiert; Ownership in Klärung, siehe R-P6B.md §Migrationskette & Ownership). - Funktionale typisierte-Kontakt-Indexierung (incremental emit in
crmService+ Kontakt-Bulk-Pager + DE→EN-Feld-Projektion, Ablösung des Row-Feeders aufcrm-contacts) — gehört zur Entity-Builder-Ablösung, da es den Row-Feeder ersetzt. → R-P6B-β (z.B. zusammen mit β2). - Mobile-Tab-Bar / Customer-Portal-Sichtbarkeit für CRM (separat, falls überhaupt Phase-1-relevant).
Quellen
- Cross-Cutting-Audit der R-P6-CRM-Modelle (2026-06-29) — siehe Konversation/Plane #21.
AGENTS.mdDoD B (Reachability) + C (Querschnitt-Wiring), insb. DoD 16 (Search-Index).- Memory
feedback-ci-test-scope-gap(TENANT_SCOPED_MODELS-Footgun).
Umsetzung
- 2026-06-29: Ticket angelegt nach Cross-Cutting-Audit. Scope-Entscheidung (Raffael): nur wir zwei, ein Zwischenticket, kein Akeshan.
- 2026-06-29: Umgesetzt. DSGVO-Entscheidung (konsistenter Verzicht, dokumentiert) + Footgun-Verify-Check (
verify:cross-cutting-models, in ci.yml) + Such-Index-Registry-Eintrag. Such-Index-Erkenntnis: die funktionale typisierte-Kontakt-Indexierung ist an die Entity-Builder-Row-Feeder-Ablösung gekoppelt (R-P6B-β) — Registry-Zeile ist vorbereitend gesetzt, Indexierung dort geflaggt. Voller CI-Test-Scope lokal grün.