54 lines
5.2 KiB
Markdown
54 lines
5.2 KiB
Markdown
# R-P14E · formulas vom Entity-Builder typisiert ablösen
|
||
|
||
| | |
|
||
|---|---|
|
||
| **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** | **M** (Audit-Schätzung ~3–4 Wochen; Risiko: 0 Unit-Tests im Modul) |
|
||
| **Status** | **ENTSCHIEDEN: CUT mit β (Raffael 2026-06-30)** — kein typisierter Rebuild; formulas wird mit dem Entity-Builder in R-P6B-β entfernt. |
|
||
|
||
## Abhängigkeiten & Parallelität
|
||
- **blocked-by:** `R-P14C-T2` Quer-Entscheidung + typisierte **Modell-Registry** (geteilt mit `R-P14D`).
|
||
- **blocks:** `R-P6B-β`.
|
||
- **eng gekoppelt an:** die Entity-Builder-UI — `formulas` wird heute aus `admin/entities/**` + `app.$tenant/settings/entities/**` gerendert (Property-Config einer Entity). Diese Routen löscht β. ⇒ **Klärungsbedarf:** Bleiben Formeln als Feature der **typisierten** Modelle (berechnete Felder auf Kontakt/Projekt) erhalten, oder sterben sie mit der Entity-Builder-UI? (siehe §Offene Entscheidungen).
|
||
|
||
## Was wir bauen
|
||
`FormulaService` evaluiert heute Formeln **über die generische Entity-Struktur**: lädt `getAllEntities()`, iteriert `EntityWithDetails`/`PropertyWithDetails`, liest Werte aus `RowWithDetails` via `RowHelper.getPropertyValue(...)`. `FormulaRowService` zieht Komponenten-Inputs ebenso. `FormulaVariableValueDto` typt die Variablen auf `EntityWithDetails`/`RowWithDetails`.
|
||
|
||
Ziel (sofern Formeln v1-Feature bleiben, §Offene Entscheidungen): Evaluation auf **typisierte Modelle** umstellen — Formel-Variablen referenzieren typisierte Felder (über die Modell-Registry-`fieldSchema`), Werte werden direkt aus typisierten Prisma-Records gelesen statt aus `RowValue`-Zeilen.
|
||
|
||
## Benötigte Screens
|
||
Abhängig von der Disposition: Wenn Formeln als „berechnete Felder" auf typisierten Modellen bleiben, braucht es eine Stelle, sie zu konfigurieren (heute Teil der EB-Property-UI, die β entfernt). **Davids Delta** klären — evtl. eigener kleiner Formel-Editor je Modell, oder Cut.
|
||
|
||
## Definition of Done
|
||
> **Disposition CUT mit β (Raffael 2026-06-30):** Kein typisierter Rebuild. Die typisierten DoD-Punkte unten sind damit **gegenstandslos** (n/a) — relevant ist nur der Cut-Punkt.
|
||
- [n/a] ~~`FormulaService` + `FormulaRowService` auf typisierte Modelle/Registry~~ — Cut, kein Rebuild.
|
||
- [n/a] ~~`FormulaVariableValueDto` auf typisierte Feld-Referenzen~~ — Cut.
|
||
- [n/a] ~~Unit-Tests neu für die Evaluation~~ — Cut.
|
||
- [n/a] ~~Klartext-Fehler bei unbekanntem Feld/Modell~~ — Cut.
|
||
- [n/a] ~~Formel-Route-Tests angepasst~~ — Routen mit β gelöscht.
|
||
- [x] **AD-2: keine Entity-Builder-Importe im Modul** — Modul ist entfernt.
|
||
- [x] **CUT:** `apps/web/app/modules/formulas/**` + die zugehörigen `admin/entities/formulas*`-Routen (Teil des gelöschten `admin/entities/**`-Baums) sauber entfernt; Permissions `admin.formulas.*` aus allen 4 Registries + i18n nachgezogen; Konsumenten/Tests grün. Voller CI-Scope grün.
|
||
|
||
## Umsetzung
|
||
- 2026-06-30 (autonomer Lauf, Branch `feat/R-P6B-beta`): **CUT mit β umgesetzt.** `modules/formulas` (14 Dateien) gelöscht; die `admin/entities/formulas*`-Routen fielen mit dem `admin/entities/**`-Baum; Formula/FormulaComponent/FormulaLog-Modelle mit `entityBuilder.prisma` entfernt; `admin.formulas.*`-Default-Permissions aus `DefaultPermissions.ts` + `roleDisplay.ts` + `permissions-seed.server.ts` + `translations.json` (de+en) entfernt. Kein typisierter Rebuild (Formeln sind keine v1-Entität im ENTITY-MODEL; reine Entity-Builder-Funktion). Falls „berechnete Felder" auf typisierten Modellen später gewünscht sind → neues Ticket. Teil von R-P6B-β; voller CI-Scope grün.
|
||
|
||
## Technische Bausteine
|
||
- **Modell-Registry** `fieldSchema` (aus T2) liefert typisierte Feld-Metadaten je Modell — ersetzt `PropertyWithDetails` + `RowHelper.getPropertyValue`.
|
||
- **Wert-Zugriff:** statt `RowHelper.getPropertyValue({entity,item,property})` → direkter typisierter Feldzugriff (`record[field]`) mit Typ-Coercion über das `fieldSchema`.
|
||
- **FormulaLog** (falls vorhanden, `prisma/schema`): prüfen, ob an `Row`/`Property` gebunden; ggf. auf typisierte Referenzen umstellen oder belassen.
|
||
- Querschnitt: M001-Audit, M002-Klartext, M004-Tenant-Scope.
|
||
|
||
## Offene Entscheidungen (vor Bau klären)
|
||
1. **Bleiben Formeln v1?** Formeln sind heute eine **Entity-Builder-Funktion** (berechnete Properties auf generischen Entities). Wenn der Entity-Builder stirbt (β) und es keine „berechneten Felder" auf typisierten Modellen geben soll → **Cut** (mit β löschen), kein Rebuild. Wenn doch → Rebuild als berechnete Felder auf adressierbaren Modellen. **Das ist die Kern-Produktfrage dieses Tickets.**
|
||
2. **Welche Modelle** dürfen berechnete Felder haben (= Quer-Entscheidung T2).
|
||
3. **Persistenz:** Werden Formel-Ergebnisse gespeichert (heute `FormulaLog`/RowValue) oder on-read berechnet?
|
||
|
||
## Quellen
|
||
- `R-P14C-T2.md` (Übersicht + Quer-Entscheidung + Registry).
|
||
- `FormulaService.ts`, `FormulaRowService.ts`, `FormulaVariableValueDto.ts` (Bestand).
|
||
- `R-P6B.md` §Rückwirkungs-Audit (formulas kritisch).
|
||
- `docs/ARCHITECTURE-DECISIONS.md` AD-2 · `.planning/ENTITY-MODEL.md`.
|