51 lines
4.8 KiB
Markdown
51 lines
4.8 KiB
Markdown
# R-P14F · onboarding vom Entity-Builder entkoppeln
|
||
|
||
| | |
|
||
|---|---|
|
||
| **Typ** | Dev (Code) |
|
||
| **Owner** | Raffael (+ Agent) |
|
||
| **Phase** | P6 / P14 (Entity-Builder-Ablösung, AD-2) — **Teil 2** |
|
||
| **Plane** | kein eigenes Ticket — getrackt über `R-P14C` (HIVEGRID-169) · Child von `R-P14C-T2` (Audit 2026-07-19) |
|
||
| **Größe** | **S–M** (peripher; nur 2 Touchpoints) |
|
||
| **Status** | **ENTSCHIEDEN (Raffael 2026-06-30): entity-basierte Filter-Bedingungen entfernen** (kein Rebuild). Baubar. |
|
||
|
||
> **Entscheidung 2026-06-30:** Die EB-Kopplung ist die Onboarding-Filter-Bedingung „Nutzer hat (k)eine Reihe einer generischen Entität angelegt" (`entity.hasCreated`/`entity.hasNotCreated` in `OnboardingFiltersService` + die `entities`-Liste in `OnboardingService.getMetadata`). Ohne Entity-Builder ist das bedeutungslos → **diese Bedingungen + die `entities`-Metadata entfernen**, der Rest von onboarding (Flows, andere Filter: user/tenant/role/subscription/apiKeyLogs) bleibt unverändert. Falls später „Nutzer hat Kontakt angelegt" als Bedingung gewünscht ist → neuer typisierter Filter über die Registry (eigenes Mini-Ticket).
|
||
|
||
## Abhängigkeiten & Parallelität
|
||
- **blocked-by:** ggf. `R-P14C-T2` Quer-Entscheidung — nur, falls onboarding weiter „Entities" auflisten/zählen können soll (dann braucht es das adressierbare Modell-Set). Falls die Touchpoints schlicht entfernt/ersetzt werden können, **früh + parallel baubar**.
|
||
- **blocks:** `R-P6B-β` (mit-blockierend, solange `getAllEntities`/`RowsApi` im Modul).
|
||
- Slug `onboarding` ist in `disabledPluginRouteSlugs` (nav-versteckt); `admin/onboarding/**` + public `/onboarding/$id` existieren.
|
||
|
||
## Was wir bauen
|
||
Nur **zwei** periphere Entity-Builder-Stellen entkoppeln:
|
||
1. **`OnboardingService.ts:3,225`** — `getAllEntities({ tenantId: null })` füllt ein `entities`-Feld der Onboarding-Config (Liste der verfügbaren Entities, vermutlich für Step-/Filter-Auswahl).
|
||
2. **`OnboardingFiltersService.ts`** — `RowsApi.count({...})` zählt generische Reihen für die Filter-Vorschau.
|
||
|
||
Beide hängen am generischen Entity-Begriff. Optionen je Stelle: durch die typisierte Modell-Registry ersetzen (adressierbare Modelle/Counts) **oder** entfernen, falls onboarding den Entity-Bezug in v1 gar nicht braucht.
|
||
|
||
## Definition of Done
|
||
- [x] `OnboardingService` ohne `getAllEntities`/`~/utils/db/entities`-Import; `entities`-Metadata aus `getMetadata()` + `OnboardingFilterMetadataDto` entfernt.
|
||
- [x] `OnboardingFiltersService` ohne `RowsApi`; die `entity.hasCreated`/`hasNotCreated`-Filter-Cases entfernt (statt Count-Vorschau).
|
||
- [x] `OnboardingFiltersService.test.ts` + die onboarding-Modul-Tests grün (35 Tests); `verify-onboarding-flow.mjs` grün.
|
||
- [x] Public `/onboarding/$id` + `admin/onboarding/**` bleiben konsistent (entity-InputSelector in `filters.tsx` + `OnboardingFilterUtils`-Parse-Zweig entfernt; `appOrAdminData.entities` nicht mehr referenziert).
|
||
- [x] Voller CI-Scope grün; AD-2: 0 Entity-Builder-Importe im Modul.
|
||
|
||
## Umsetzung
|
||
- 2026-06-30 (autonomer Lauf, Branch `feat/R-P14C-teil2`): **Slice A2 umgesetzt, 5/5 DoD = 100 %.** Die zwei Filter-Typen `tenant.user.entity.hasCreated`/`hasNotCreated` (Enum `OnboardingFilterTypes`), der `RowsApi.count`-Case (`OnboardingFiltersService`), das `entities`-Metadata-Feld (`OnboardingService.getMetadata` + `OnboardingFilterMetadataDto`), der Parse-Zweig (`OnboardingFilterUtils`) und der entity-InputSelector (`onboardings.$id/filters.tsx`) entfernt; Filter-Beschreibung in `translations.json` (de+en) nachgezogen. Restliche onboarding-Filter (user/tenant/role/subscription/apiKeyLogs) unverändert. Test-Mocks für `RowsApi`/`getAllEntities` aus den zwei Suites entfernt. Proof: 35 onboarding-Tests grün, `verify:onboarding-flow` EXIT 0, voller CI-Scope grün.
|
||
- *(Hinweis: Falls „Nutzer hat Kontakt angelegt" später als Onboarding-Bedingung gewünscht ist → neuer typisierter Filter über die Modell-Registry, eigenes Mini-Ticket.)*
|
||
|
||
## Technische Bausteine
|
||
- Modell-Registry (T2) für „verfügbare Modelle/Counts", falls onboarding diese Auswahl behält.
|
||
- Tenant-Scope: `RowsApi.count` trug Tenant-Kontext → typisierter Count via `withTenantScope()`/RLS.
|
||
- Querschnitt M001/M002/M004 wie üblich.
|
||
|
||
## Offene Entscheidungen (vor Bau klären)
|
||
1. **Braucht onboarding den Entity-Bezug überhaupt?** Wenn die Onboarding-Flows in v1 keine generischen Entities mehr referenzieren (typisierte Modelle reichen / Bezug war Boilerplate), → beide Stellen **entfernen** (kleinster Pfad). Sonst über Registry typisieren.
|
||
2. Modell-Set = Quer-Entscheidung T2 (nur relevant bei Option „typisieren").
|
||
|
||
## Quellen
|
||
- `R-P14C-T2.md` (Übersicht + Registry).
|
||
- `OnboardingService.ts:3,225`, `OnboardingFiltersService.ts` (Bestand).
|
||
- `R-P6B.md` §Rückwirkungs-Audit (onboarding low-prio).
|
||
- `docs/ARCHITECTURE-DECISIONS.md` AD-2.
|