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

54 lines
5.2 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-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`.