# 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.