Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -8,6 +8,8 @@
| **Cycle/Fenster** | W2 — Plattform & CRM · fällig 2026-06-24 · Gate W2 (Noah-Demo #1) |
| **Status** | geplant |
**🎨 design-nachzug: offen** (seit 2026-07-08) — Interim-UI aus `~/ui` steht (alle 7 CRM-Screens auf `~/ui`, AD-28); finale Subframe-Optik aus `D-CRM` ausstehend.
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P5` (Apps-Engine), `AK-P4b` (Files/Tasks + EntityLink), `R-REFIT` (ER-Modell-Re-Fit — ✅ erledigt 16.06.)
- **Blocks:** `R-P7` (Lead-Inbox), `AK-P14a` (Email/BCC), `AK-P15a` (Telefonie/Auto-Lead)
@@ -46,7 +48,6 @@ Den CRM-Kern: **Kontakte, Firmen/Organisationen und Leads als typisierte First-C
- `REQUIREMENTS.md` → `REQ-crm-*` (Modul 1)
- `ROADMAP.md` → Phase 6
- `designer-briefs/P06-crm-kern.md` (Screens + UI-Elemente, Pivot-Vorrang-Hinweis)
- `_bmad-output/specs/M01-crm-kern.md` (⚠ teils pre-pivot — ENTITY-MODEL hat Vorrang)
## Scope-Entscheidung Entity-Builder-Ablösung (2026-06-29)
Der Entity-Builder ist tiefer verankert als nur CRM (auch `settings/entities`, `new-account`-Tenant-Seed, Hocuspocus-Row-Collab). Aufteilung:
@@ -85,7 +86,98 @@ Owner-Freigabe für die crm.prisma-Berührung liegt vor, 2026-07-06). Nullable,
(null = Tenant-Default), **kein UI-Editor in v1** — Outbound-Nutzung kommt erst mit v2 (`REQ-i18n-outbound`).
Bestehende CRM-Services/VMs bleiben unberührt (Feld wird nicht selektiert/geschrieben).
## Interim-UI-Nachzug (AD-28, 2026-07-08 — Akeshan)
Die ursprüngliche R-P6-Umsetzung (Raffael) lieferte den Backend-Kern + eine **minimale
Inline-Swap-UI** (handgeschriebenes Tailwind, kein `~/ui`). Das erfüllte die AD-28-Golden-Rule
noch nicht. Nachgezogen (Branch `feat/AK-crm-lead-interim-ui`, ab `origin/main`):
- **Alle 7 CRM-Screens** als AD-28-Interim-Screens aus `~/ui` (VM als Prop, kein hand-Tailwind),
in `apps/web/app/components/screens/crm/`:
- `KontaktListPage` (Liste + Firmen-Variante), `KontaktDetailPage` (Kontakt + Org-Detail,
Master-Template A3), `KontaktNewPage` (Live-Duplikat-Banner), `CustomFieldAdminPage`,
`TagAdminPage`, `DuplicateToolPage`.
- Alte `components/crm/KontaktListView.tsx` + `KontaktDetailView.tsx` entfernt; Admin-/New-Routen
von Inline-JSX auf Screen-Komponenten umgestellt (Loader baut VM, Route ownt Navigation/POST).
- **Proof:** Commits `871993fd2` (Liste), `9f1baeb9e` (Detail), `3735b0628` (New+Admin);
`pnpm --filter @hivegrid/web typecheck` + `verify:i18n` grün; 21 Screen-Unit-Tests grün
(`data-ui-id`-Muster wie HR). Kein Schema-Change → keine Merge-Migration.
- **%-Stand Interim-UI:** Screens + VM-Anbindung + Unit-Tests (D18) = **selbst machbar erledigt**.
- **Finale Subframe-Optik** bleibt getrackter Nachzug (`design-nachzug`), nicht Done-blockierend.
## Interim-UI Test-Tail nachgezogen (AD-28, 2026-07-17 — Akeshan, Audit-Restarbeit)
Das Audit R-P6/R-P6B/R-P6C (2026-07-17) fand: R-P6 stand auf Done, aber die von AD-28
(Interim-Done) + AGENTS.md Block D geforderten Pflicht-Tests D19/D20/D21 fehlten (waren nur im
Nachzug-Fliesstext oben als offen vermerkt, nie als DoD-Punkt erfasst). Nachgezogen auf Branch
`feat/r-p6-interim-test-tail`, PR #151:
- [x] **D19 e2e-Smoke** `tests/e2e/crm-interim-smoke.spec.ts`: Login -> `/contacts` -> "Kontakt
anlegen" -> Create-Form + Live-Duplikat-Check-Control sichtbar. Skip-guarded auf
`crm-basic`-Entitlement, Muster wie dashboard/email-marketing-interim-smoke.
- [x] **D20 Hot-Swap-Drill** (M017): `createCrmInterimFixturePage()` in `@hivegrid/ui-mock`
(deterministische typisierte `KontaktListVM`, VM-as-Prop) in `verify:ui-hot-swap` verdrahtet;
`pnpm run test:hot-swap` gruen.
- [x] **D21 Interim-Visual-Baseline** (M016): CRM in `verify:ui-mock-visual` registriert, Baseline
`packages/ui-mock/visual-baseline/r-p6-crm-interim.{html,mock.ts,snapshot.json}` generiert
(AD-28 interim, Re-Baseline beim D-CRM-Nachzug). `pnpm run verify:ui-visual` 124 passed.
- **Proof:** `verify:ui-visual` (124 passed) · `verify:ui-hot-swap` + `test:hot-swap` gruen ·
ui-mock-Suiten 49 passed · `pnpm typecheck` exit 0 · `verify:i18n` exit 0 (12491 keys, de/en
parity, `mock.r-p6.crm.*` in beiden Locales) · Playwright kompiliert/entdeckt die CRM-Spec.
- **%-Stand:** 12/12 (8 fachliche DoD + D18-D21) = **100 % AD-28-Interim-Done** (vorher ~75 % gegen
die volle AD-28-Messlatte, D19/D20/D21 offen). Live-Playwright-Lauf gegen den lokalen Stack
(E2E-Env + `crm-basic`-Tenant) bleibt manueller Schritt wie bei den Peer-Interim-Smokes (CI fuehrt
Playwright nicht aus). Hinweis Windows-Memory galt fuer den Original-Dev; hier (macOS) liefen die
Drills lokal gruen.
## Dev-Nachzug (nach Davids `D-CRM`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [ ] Plane-Ticket `R-P6` aktualisiert
- [ ] `<XPage>`-Interna gegen Subframe-Delta tauschen (VM/Loader/Route unangetastet), Visual-Baseline neu ziehen
## Fremd-Änderung an `crm.prisma` (2026-07-30, aus `R-P8a` / PR #286 — Akeshan)
**Was:** WF-P8 S02 (Projekt-Detailansicht) zeigt Firmen- und Ansprechpartner-Stammdaten. Die
gehören zum `Kontakt`, nicht zum Projekt — dieselbe Firma hängt an vielen Projekten, und eine
Kopie je Projekt würde die Wahrheit gabeln. Daher **additiv** in `crm.prisma`:
- `Kontakt`: `website`, `ustIdNr`, `handelsregister`, `kundennummer`, `kundeSeit`, `branche`,
`mitarbeiterzahl` (Firmenfelder) sowie `position`, `erreichbarkeit` (Ansprechpartner-Felder).
Alle nullable, keine Semantik-Änderung an bestehenden Spalten.
- `KontaktTelefon`: neues `typ` (`haupt`/`durchwahl`/`mobil`/`fax`, Default `haupt`) plus Enum
`KontaktTelefonTyp`. S02 fragt nach „Durchwahl“ und „Mobil“; das ist eine **Art** von Nummer,
kein Paar weiterer Skalare an `Kontakt` — ein Kontakt kann mehrere davon haben.
**Wer schreibt sie:** derzeit niemand. S02 rendert sie **read-only** und verlinkt zum Pflegen in
die CRM-Detailscreens. Die Editoren gehören zu P6.
**Konsequenz für R-P6:** Die CRM-Screens kennen diese Felder noch nicht. Wenn `D-CRM` nachgezogen
wird, sollten Firmen-Stammdaten und Position/Erreichbarkeit dort editierbar werden, sonst bleiben
sie dauerhaft leer. `KontaktTelefon.typ` hat einen Default, bestehende Zeilen und der bestehende
Schreibpfad bleiben also gültig; ein Typ-Selektor in der Telefonnummern-Pflege ist der Nachzug.
**Migration:** liegt im WF-P8-Branch-Migrationsfile `20260728120000_wf_p8_subframe_baseline`
(AD-21: eine Migration pro Phase, beim Merge). Gegen eine leere DB replaybar nachgewiesen.
Policy-Vertrag 376 → 377 (die neue Tabelle ist `ProjektAdressDetail` in `projekt.prisma`, nicht
CRM). **An Raffael gemeldet.**
**Nachtrag 2026-07-30 (zweiter Durchgang WF-P8, ebenfalls user-beauftragt):** zwei weitere
Eingriffe in `crm.prisma`, beide additiv und in derselben Branch-Migration.
1. `Kontakt.notizen` (Text, nullable) — die stehenden Absprachen mit einem Kontakt. Davids S02
zeigt sie auf Firmen- und Ansprechpartner-Karte, dort **read-only**; nicht die
Activity-Timeline, die hält fest was passiert ist, das Feld was gilt.
2. `CustomFieldDatentyp` um fünf Werte erweitert: `prozent`, `datum_zeit`, `person_team`,
`adresse`, `link` (`ALTER TYPE … ADD VALUE`, PostgreSQL 12+ im Migrations-Transaktionsrahmen
zulässig, weil in derselben Transaktion keiner davon gespeichert wird). Davids S05-Feldtyp-Picker
listet 17 Typen; das Enum hatte 12. Für keinen der 17 Typen existiert heute ein eigener Renderer
oder Validator — jeder Wert ist ein String im Textfeld.
**Nachzug in P6 (Raffael), außerhalb dieses Durchgangs:** `updateKontakt` trägt **keine** der
Stufe-B-Spalten und auch `notizen` nicht, das heißt Website, USt-IdNr., Handelsregister,
Kundennummer, Kunde-seit, Branche, Mitarbeiterzahl, Position, Erreichbarkeit und Notizen sind
aktuell nur über Seed/DB pflegbar. Ebenso offen: ein Typ-Selektor für `KontaktTelefon.typ` und —
falls gewünscht — eine zweite Adress-FK am `Kontakt` für die „Rechnungsadresse", die Davids
Firmenkarte zeigt (bewusst nicht angelegt: eine Spalte, die kein Editor füllt). **An Raffael
gemeldet.**