5.2 KiB
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-T2Quer-Entscheidung + typisierte Modell-Registry (geteilt mitR-P14D). - blocks:
R-P6B-β. - eng gekoppelt an: die Entity-Builder-UI —
formulaswird heute ausadmin/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]
— Cut, kein Rebuild.FormulaService+FormulaRowServiceauf typisierte Modelle/Registry - [n/a]
— Cut.FormulaVariableValueDtoauf typisierte Feld-Referenzen - [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. - AD-2: keine Entity-Builder-Importe im Modul — Modul ist entfernt.
- CUT:
apps/web/app/modules/formulas/**+ die zugehörigenadmin/entities/formulas*-Routen (Teil des gelöschtenadmin/entities/**-Baums) sauber entfernt; Permissionsadmin.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; dieadmin/entities/formulas*-Routen fielen mit demadmin/entities/**-Baum; Formula/FormulaComponent/FormulaLog-Modelle mitentityBuilder.prismaentfernt;admin.formulas.*-Default-Permissions ausDefaultPermissions.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 — ersetztPropertyWithDetails+RowHelper.getPropertyValue. - Wert-Zugriff: statt
RowHelper.getPropertyValue({entity,item,property})→ direkter typisierter Feldzugriff (record[field]) mit Typ-Coercion über dasfieldSchema. - FormulaLog (falls vorhanden,
prisma/schema): prüfen, ob anRow/Propertygebunden; ggf. auf typisierte Referenzen umstellen oder belassen. - Querschnitt: M001-Audit, M002-Klartext, M004-Tenant-Scope.
Offene Entscheidungen (vor Bau klären)
- 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.
- Welche Modelle dürfen berechnete Felder haben (= Quer-Entscheidung T2).
- 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.mdAD-2 ·.planning/ENTITY-MODEL.md.