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

51 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.