Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
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.**
|
||||
Reference in new issue
Block a user