Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P6C.md
T

41 lines
5.5 KiB
Markdown

# 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
- [x] **Such-Index Registry verdrahtet (AGENTS DoD 16, Teilerfüllung):** `contact` in `packages/search/src/indexed-entities.ts` registriert (Tabelle `Kontakt`, Index `crm-contacts`, permission-gated `crm.read_all`; EIN Eintrag deckt Privatperson + Organisation ab, da `Kontakt` Oberbegriff ist — kein separater Company-Index). **Befund:** Die *funktionale* Indexierung der typisierten Kontakte ist NICHT trivial isolierbar — der `crm-contacts`-Index wird aktuell noch vom Entity-Builder-`Row`-Feeder (`rowSearchOutbox` + Row-`createCrmContactsPager`) befüllt, nicht vom typisierten `Kontakt`-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).
- [x] **DSGVO-Verdrahtung entschieden + umgesetzt:** Konsistenter, dokumentierter Verzicht (Option 1) — `Kontakt.createdByUserId`/`zustaendigerUserId` sind bare Scalars (kein `@relation`), wie tasks/hr repo-weit; KEIN `user-fk-map`-Eintrag (Sonderweg vermieden). Entscheidung sichtbar im Kopfkommentar von `packages/db/src/dsgvo/user-fk-map.ts` dokumentiert; projektweite Pseudonymisierung bare-scalar-User-FKs als separates Querschnitt-Härtungs-Thema (wenn DSGVO-Lösch-Flow live geht) geparkt.
- [x] **Footgun-Prävention:** `scripts/verify-cross-cutting-models-complete.mjs` (+ `.test.mjs` + `verify:cross-cutting-models` npm-Script + ci.yml „Quality Static Verify 2/2"). Erzwingt: jedes tenantId-Prisma-Modell ist in `TENANT_SCOPED_MODELS` — klare Fehlermeldung statt kryptischem packages/cli-Test. Bei Umsetzung `104/104 models`; Stand Audit 2026-07-17: `290/290 klassifiziert · 215/215 direkt-tenantId registriert · 0 missing` (Estate seither breit ausgebaut, Gate + `.test.mjs` mitgezogen).
- [x] 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 auf `crm-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.md` DoD 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.
- **2026-07-17 (Audit):** Die oben geflaggte Kopplung ist inzwischen durch **R-P6B-β** aufgelöst — der `crm-contacts`-Index wird real vom typisierten `Kontakt`-Modell gespeist (bulk `search-indexer-bulk-pagers.ts` `prisma.kontakt.findMany`, inkrementell `publishKontaktSearchUpsert`), der Row-Feeder ist entfernt. DoD-1-Notiz „noch vom Row-Feeder befüllt" ist damit überholt. 💡 Klein-Nachzug (außerhalb R-P6C-Scope): der Kommentar `packages/search/src/indexed-entities.ts:83-85` zitiert noch das gelöschte `rowSearchOutbox.server.ts`/`rowToContactDocument` — bei nächster Berührung korrigieren.