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
@@ -6,7 +6,9 @@
|
||||
| **Owner** | Raffael |
|
||||
| **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) |
|
||||
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-27 → 2026-06-28 · Gate W3 |
|
||||
| **Status** | On Hold — serverseitig umgesetzt, Screen-Delta `D-KANBAN`/`D-P8` offen |
|
||||
| **Status** | Umgesetzt — 13/13 DoD (Audit 2026-07-18), Restarbeiten-PR offen · design-nachzug offen |
|
||||
|
||||
**🎨 design-nachzug: offen** (seit 2026-07-08) — Interim-UI aus `~/ui` (AD-28); Subframe-Muster aus `WF-P8 Pipelines` am 2026-07-11 integriert, **Delta-Nachzug der 7 neuen Flow-Seiten (10 → 17) am 2026-07-18** (PR #154: S00 Boards-Start, S01a/S03a/S02a/S07a-States, S01b 2-Spalten-Umbruch, M03 Kontextmenü, neue `KanbanCard`-Slot-API). **Baseline-Nachzug 2026-07-28/29 (17 → 23 Seiten, PR #286):** Davids Handoff `D-P8 + D-KANBAN` ist die neue Baseline — die 6 neuen Screens inkl. Datenmodell gebaut (M04-Übergabe, S02-Schnellaktionen, S05/M05 Detail-Schablone) **und** alle Bestands-Screens neu aus dem Export gebaut (S00, S01 inkl. Filterleiste, S03, S04, S06, S07/S07-D/S07a, M01, M03); Interim-UI abgelöst. Offen bleiben nur noch: Demo-Seed für die neuen Zustände, Re-Baseline der Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik und die visuelle Abnahme auf Staging nach Merge.
|
||||
|
||||
> 🔴 **Pivot-Vorrang (AD-20):** Das Snapshot-Ticket heißt noch „Deal-CRUD". Korrekt projekt-zentrisch: Es gibt **EINEN `Projekt`-Kern** (typisierte Superset-Tabelle, Deal- + Auftrags-Felder in einer Tabelle). **„Deal" ist ein Pipeline-Typ** (`Pipeline.typ_hint = sales`), **KEINE eigene Entität**. „Projekt-CRUD in Sales-Pipeline-Sicht" statt „Deal-CRUD". `Status` ist immer pipeline-intern (`PipelineStage.stage_kind = offen/gewonnen/verloren`) — kein globaler Projektstatus.
|
||||
|
||||
@@ -37,6 +39,12 @@ Den **`Projekt`-Kern als eine typisierte Tabelle** (Superset der Felder + `Custo
|
||||
- [x] Konnektor `tenantHasModule('projects')` (Sidebar + Routes + Actions gated)
|
||||
- [x] `projects.*`/`deals.read_volume_*`-Permission-Backstop (Field-Level primär über PipelineFieldVisibility; Volumen ohne Recht → „—")
|
||||
|
||||
**Audit-Nachtrag 2026-07-18 (AD-28-Interim-Messlatte, AGENTS.md DoD D18–21 — waren nie als DoD-Punkte erfasst):**
|
||||
- [x] **D18 VM-Unit-Tests** (`packages/view-models/src/projects/projects.vm.test.ts` — Detail/List/Kanban/Admin-Builder)
|
||||
- [x] **D19 e2e-Smoke** (`tests/e2e/projekt-smoke.spec.ts`, gemeinsam für R-P8a/R-P8b)
|
||||
- [x] **D20 Hot-Swap-Drill** (`createProjektBoardInterimFixture*` in `packages/ui-mock` + M017-Drill `scripts/verify-ui-hot-swap.ts`)
|
||||
- [x] **D21 Interim-Visual-Baseline** (`packages/ui-mock/visual-baseline/r-p8-projects-interim.*`, als „interim" markiert, Re-Baseline beim David-Nachzug)
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
**2026-07-01 — Server-/Contract-Umsetzung ohne finale Screens:** `Projekt`/Pipeline-Schema in `prisma/schema/projekt.prisma`, RLS-Artefakt `prisma/rls/projekt-isolation.sql`, Tenant-Snapshot-Registry, `projects`-Entitlement, Default-Permissions, Sidebar-Gate und minimale Routes ergänzt. Project-Service baut lückenlose `HiveNumberSeq`-Projekt-Nummern via `SELECT ... FOR UPDATE`, Default-Sales-Pipeline + SHK-Lost-Reasons, Pipeline CRUD/duplicate/archive, PipelineAccess, PipelineFieldConfig, PipelineFieldVisibility, Lost-Reason CRUD und M049 `lead.qualified` → automatische Projektanlage. Der Lead-Detail-Convert-Pfad ruft bei fehlender Projekt-ID direkt `createProjectFromQualifiedLead` auf.
|
||||
@@ -45,6 +53,23 @@ Den **`Projekt`-Kern als eine typisierte Tabelle** (Superset der Felder + `Custo
|
||||
|
||||
**Stand:** R-P8a: 9/9 DoD = 100 % serverseitig done. Ticket bleibt fachlich **On Hold**, bis `D-KANBAN`/`D-P8` final geliefert und die Screen-Implementierung/visuelle Abnahme nachgezogen ist.
|
||||
|
||||
**2026-07-08 — Interim-UI aus `~/ui` (AD-28, Akeshan):** Auf der vorhandenen Backend-Basis drei Interim-Screens (VM als Prop, kein handgeschriebenes Tailwind) ergänzt: **Projekt-Detail** `/projects/:id` (`ProjektDetailPage` — Inline-Edit Stammdaten, klickbare Stage-Bar, Gewonnen/Verloren-Banner mit 24h-Undo, Lost-Reason-Dialog, Kontakte, Activity-Stream; additiv über den unveränderten P9-Sektionen), **Pipeline-Config-Admin** `/admin/pipelines` (`PipelineAdminPage` — Stage-Editor add/archive/reorder, PipelineAccess/-FieldConfig/-FieldVisibility, create/duplicate/archive, Validity-Hinweis), **Lost-Reasons** `/admin/pipelines/lost-reasons` (`LostReasonAdminPage` — add/rename/archive). Pure VMs in `packages/view-models/src/projects/*`. Minimal ergänztes Backend (kein Schema-Change): `updateProjectStammdaten`, `loadProjectDetail`, `listPipelinesForAdmin`, `upsertPipelineStage`, `archivePipelineStage`; neuer Activity-Typ `project_updated`. Interim-Deckung DoD B 6–10 / E 22–25 grün. **Proof:** Commits `e12dd4c03` (Detail + VMs + Backend), `b97634226` (Admin/Lost-Reasons); `pnpm --filter @hivegrid/web typecheck` + `@hivegrid/view-models` grün, `verify:i18n`/i18n-parity, `verify:sidebar-routes` (26), `verify:cross-cutting-models` (178/178) grün; VM-Unit (`projects.vm.test`, 11) + Screen-RTL (`ProjektDetailPage` 5, `PipelineAdminPage` 4, `LostReasonAdminPage` 4) grün. **Offen (getrackter Nachzug):** finale Subframe-Optik (`design-nachzug`), Stage-Reorder als echtes Drag&Drop, e2e-Smoke/Hot-Swap-Drill/Visual-Interim-Baseline (CI/Windows-blockiert), Custom-Feld-Werte am Projekt (kein Storage im Schema). %-Stand unverändert 9/9 serverseitig; Interim-UI-DoD steht, finale Optik bleibt Nachzug.
|
||||
|
||||
**2026-07-08 (Interim-Nachzug 2):** Projekt-Detail (`/projects/:id`) rendert bei unbekannter/nicht-sichtbarer Projekt-ID jetzt **404 statt 500** (Loader fängt den `CatalogError` ab → `projectNotFoundResponse`). **RBAC-Lücke behoben (querschnittlich):** die `projects.*`/`deals.*`-Permissions waren zwar definiert, aber in keiner Rollen-Matrix zugewiesen (`packages/db/src/permissions-seed.server.ts`) → kein Rolle konnte das Modul öffnen (500 auf `/projects`). Grants für SuperUser/Admin (alle) + User (read_own/-member/write/change_stage + `deals.read_volume_own`) ergänzt; greift idempotent beim `SEED_ON_BOOT`-Deploy. **Weiterhin offen (Nachzug):** Stage-Reorder als echtes Drag&Drop im Pipeline-Admin (interim: Hoch/Runter), **Custom-Feld-Werte am Projekt** (kein `CustomFieldValue`-Storage am Projekt im Schema), **finale Subframe-Optik** (`design-nachzug`), e2e/Hot-Swap/Visual-Baseline.
|
||||
|
||||
**2026-07-11 — P8-Subframe-Nachzug:** Den MCP-Flow `WF-P8 Pipelines` (10 Pages) auditiert und die kanonischen Muster in die bestehenden VM-/Action-Grenzen integriert. `PipelineAdminPage` übernimmt S04/S07 (Header-Navigation, Dialog zum Anlegen, vorhandene Stage-/Access-/Feld-Konfiguration), `LostReasonAdminPage` S06. Die zwischenzeitlich gelöschten, laut aktuellem Ticket weiterhin verbindlichen Admin-Routen `/admin/pipelines` und `/admin/pipelines/lost-reasons` wurden wiederhergestellt, mit `projects.admin`, Meta-Titeln und gegenseitiger Erreichbarkeit verdrahtet. **Proof:** Tenant-Routen-Typecheck grün; `PipelineAdminPage` 4/4, `LostReasonAdminPage` 4/4 und `projectService` 25/25 Tests grün; `verify:i18n` grün; fokussiertes ESLint ohne Warnungen. **Stand:** 9/9 DoD = 100 % done · 0 DoD-Punkte offen; außerhalb der Ticket-DoD bleiben Browser-/Visual-Regression-Abnahme und echtes Drag&Drop im Admin-Stage-Editor als Nachzug.
|
||||
|
||||
**2026-07-11 — Staging-Demo-Proof:** Der bereits doppelt gegatete Staging-Boot-Seed (`SEED_DEMO_DATA=true` + `ALLOW_STAGING_DEMO_SEED=true`) legt im Business-Demo-Tenant idempotent zwei Pipelines mit zehn Stages, drei Verlustgründe sowie eine Owner-Access- und Field-Visibility-Konfiguration an. Alle Zeilen tragen `isDemoData=true`; ein erneuter Seed stellt archivierte Demo-Konfiguration wieder her. **Proof:** `stagingDomainDemoSeed.server.test.ts` 2/2 und `SeedService.test.ts` 14/14 grün. **Stand:** 9/9 DoD = 100 % done.
|
||||
|
||||
**2026-07-16 — Dependency-Impact aus AK-P15b:** Projektanlage, idempotenter M049-Replay,
|
||||
Stage-Wechsel/-Undo sowie relevante Stammdaten-/Projektleiter-Änderungen synchronisieren den
|
||||
entity-linked Projekt-Chat jetzt innerhalb der bestehenden Tenant-/RLS-Transaktion über
|
||||
`ensureAndSyncProjectChannelIfEnabledWithTx`. Bei deaktiviertem Chat-Modul ist der Hook ein No-op.
|
||||
`projekt.prisma`, Pipeline-, Nummern- und Projekt-Pivot-Verträge bleiben unverändert. Das Projekt-Detail
|
||||
erhält additiv einen optionalen Chat-Link; ohne Modul, Permission oder aktive Mitgliedschaft bleibt die
|
||||
Affordance verborgen. Proof: `project-sync.server.test.ts`, `projectChatLink.server.test.ts` und
|
||||
`projects.vm.test.ts`. **R-P8a bleibt 9/9 DoD = 100 % done; keine DoD-Regression.**
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (eigene `prisma/schema/projekt.prisma`): `Projekt` (Superset, `stage_id`=Status, `konvertiert_aus_lead_id`, Adress-Slots), `Pipeline` (`typ_hint`), `PipelineStage` (`stage_kind`/win_probability/color), **`PipelineFieldConfig`** (pipeline_id/stage_id NULL=pipeline-weit/field_key System ODER `custom:<id>`/sichtbar/pflicht/reihenfolge), **`PipelineFieldVisibility`** (field_config_id/principal_type rolle|gruppe|user/principal_id/kann_sehen/kann_bearbeiten), **`PipelineAccess`** (pipeline_id/principal/kann_sehen/kann_bearbeiten), `ProjektKontakt` (M:N-Brücke, Rolle), `Adresse`, Lost-Reason. `leads.prisma`/`crm.prisma` nur über Relationen berühren (AD-21).
|
||||
- **HiveNumberSeq** für Projekt-Nummern: `SELECT … FOR UPDATE`-Row-Lock, **lückenlos** (keine Postgres-Sequence wegen Rollback-Lücken), pro `tenant_id` + `entity_type`.
|
||||
@@ -56,11 +81,418 @@ Den **`Projekt`-Kern als eine typisierte Tabelle** (Superset der Felder + `Custo
|
||||
## Quellen (granular)
|
||||
- `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Projekt/Pipeline/PipelineStage/**PipelineFieldConfig**/**PipelineFieldVisibility**/**PipelineAccess**/ProjektKontakt) + Kern-Ketten-Diagramm + Modellierungs-Fragen 3 (Pipeline-Rechte) & 4 (HiveNumberSeq) — 🔴 **Pivot-Vorrang (AD-20)**: ein Projekt-Kern, Deal = Pipeline-Typ, kein Won-Handoff
|
||||
- `REQUIREMENTS.md` → `REQ-projekt-kern-datenmodell`, `REQ-pipeline-rechte-config`, `REQ-projekt-pipeline-wechsel` (Phase 8)
|
||||
- `ROADMAP.md` → Phase 8 (+ Pivot-Note) · `PHASE-SOURCES.md` → P8
|
||||
- `ROADMAP.md` → Phase 8 (+ Pivot-Note)
|
||||
- `designer-briefs/P08-projekt-pipelines-kern.md` (Screens + UI-Elemente, Pivot-Vorrang-Hinweis)
|
||||
- `_bmad-output/specs/M03-sales-pipeline.md` (⚠ teils pre-pivot: „Deal"/„won_handoff_project_id" überholt — ENTITY-MODEL hat Vorrang)
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-KANBAN`/`D-P8`-Delta)
|
||||
- [x] Subframe-Flow inventarisiert und Screen-Muster in die bestehenden Adapter-/VM-Grenzen integriert
|
||||
- [ ] Visuelle Browser-/Visual-Regression-Abnahme
|
||||
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] REQUIREMENTS/ROADMAP nachgezogen
|
||||
- [ ] Plane-Ticket `R-P8a` aktualisiert (Titel von „Deal-CRUD" auf projekt-zentrisch nachziehen)
|
||||
|
||||
### 2026-07-15 — e2e-Smoke nachgezogen (RA-B3)
|
||||
DoD-19-Smoke für die Projekt-Pipeline (Kanban) ergänzt: `tests/e2e/projekt-smoke.spec.ts` (gemeinsam für R-P8a/R-P8b). Flow: Login → `/projects` (Board) öffnen → Board-Toolbar sichtbar (`ui.projects.board.toolbar`) → Hauptaktion: Board-Suche `smoke` eintragen + „Anwenden" → Loader-Roundtrip (`?q=smoke` in der URL). Auth/Skip-Muster exakt wie `files`/`tasks`/`calendar`/`booking`, keine Produkt-Code-Änderung (bestehende `data-ui-id`-Hooks genutzt).
|
||||
|
||||
**Proof:** `pnpm exec playwright test tests/e2e/projekt-smoke.spec.ts --list` sammelt den Spec (chromium); `pnpm exec eslint tests/e2e/projekt-smoke.spec.ts --max-warnings=0` grün; `pnpm --filter @hivegrid/web typecheck` grün. Voller Playwright-Lauf braucht einen laufenden Stack + im Test-Tenant aktiv geschaltetes Projekt-Modul; ohne E2E-Credentials/Modul skippt der Smoke sauber. Interim-Visual-Baseline (D21) bleibt offen.
|
||||
|
||||
### 2026-07-15 — Nachzug: CustomFieldValue-Storage + echtes Drag&Drop (Restarbeiten RA-C1)
|
||||
|
||||
Zwei versteckte Rest-Positionen aus dem Dev-Nachzug (2026-07-08) geschlossen. **Kein Schema-Change nötig** (also kein `prisma db push`/Migration): beide Lücken waren reine Verdrahtung.
|
||||
|
||||
**1) Custom-Feld-Werte am Projekt (Storage + Wiring).** Wichtiger Befund: der Nachzug-Vermerk „kein CustomFieldValue-Storage im Schema" war überholt — das **polymorphe `CustomFieldValue`** (in `crm.prisma`, ENTITY-MODEL Domäne 5) trägt `projekt` bereits im `CustomFieldEntityType`-Enum („so P7/P8 attach without a migration"), ist tenant-scoped (`TENANT_SCOPED_MODELS`) und RLS-policied (`crm-isolation.sql`). Kein neues, projekt-spezifisches Modell angelegt (das wäre eine Duplizierung gegen das LOCKED ENTITY-MODEL und ein PR-Block). Stattdessen die bestehende Struktur verdrahtet:
|
||||
- Neuer Service `setProjectCustomFieldValue` (`projectService.server.ts`): prüft `projects.write` + Projekt-Edit-Scope, validiert Definition-Existenz + entityType-Match, upsertet in `CustomFieldValue` (auto-audit via M001), loggt `project_updated`-Activity (DoD 14). RLS-gebunden via `withTenantRLS`.
|
||||
- Loader `loadProjektDetailP8` liest jetzt `getCustomFieldValues` + `listCustomFieldDefinitions` (entityType `projekt`) und liefert `customFieldDefs`; VM `ProjektDetailData` um `customFields` erweitert; `ProjektDetailPage` rendert eine Custom-Felder-Karte (Read-only-Liste + Set-Formular, nur bei `canWrite`). Intent `setCustomField` im Route-Action + `projects.write`-Gate.
|
||||
|
||||
**2) Echtes Drag&Drop im Admin-Stage-Editor.** Die Interim-Hoch/Runter-Buttons durch echtes Drag&Drop ersetzt — `@dnd-kit` (bereits Dependency, gleiches Muster wie `formWidget`-Canvas/`PipelineKanbanPage`): `PipelineAdminPage` hat jetzt `StageList` (DndContext + verticalListSortingStrategy) mit Greif-Handle je Stage. Beim Drop persistiert der neue Intent `reorderStages` die komplette Reihenfolge über den neuen Service `reorderPipelineStages` (Positionen in 10er-Schritten neu vergeben, RLS-gebunden). VM/Loader/Action-Grenze unangetastet (Component ruft nur `onSubmit`).
|
||||
|
||||
**Proof (lokal, Worktree):** `pnpm --filter @hivegrid/web typecheck` grün · `pnpm --filter @hivegrid/db typecheck` grün · `pnpm lint` grün (0 Warnungen) · `pnpm run verify:tenant-policy-contract` PASS 268/268 (kein neues RLS-Modell) · `pnpm run verify:i18n` grün. Tests: `projects.vm.test` 16/16 (inkl. 2 neue customFields-Fälle), `ProjektDetailPage` 10/10 (2 neue: setCustomField + Perm-Gate), `PipelineAdminPage` 5/5 (1 neu: Drag-Handle statt Up/Down), `projectService` 28/28. i18n-Keys ergänzt (de+en): `projects.detail.section.customFields`, `projects.detail.customFieldsEmpty`, `projects.fields.customField`, `projects.admin.dragStageAria`.
|
||||
|
||||
**Stand:** DoD unverändert 9/9 = 100 %. Zwei Dev-Nachzug-Residuen (Custom-Feld-Werte am Projekt · echtes Drag&Drop) sind damit **erledigt**. Weiter offen (getrackter Nachzug, außerhalb DoD): finale Subframe-Optik (`design-nachzug`), e2e-Smoke/Hot-Swap-Drill/Visual-Interim-Baseline (CI-blockiert).
|
||||
|
||||
### 2026-07-18 — Audit: gestrandete Restarbeiten geborgen + Interim-Test-Tail (Branch `feat/r-p8-restarbeiten`)
|
||||
|
||||
**Audit-Befund:** Die oben dokumentierten Nachzüge vom 2026-07-15 (Custom-Feld-Wiring + Admin-Drag&Drop, Commit `7f4a99ffd`) lagen **nur auf lokalen `worktree-agent-*`-Branches** — nie gepusht, nie gemergt; der Plane-Kommentar vom 15.07. meldete sie trotzdem als erledigt. Zusätzlich fehlte gegen die AD-28-Interim-Messlatte der komplette Test-Tail (D19/D20/D21) im Repo — real also 10/13 statt der gemeldeten 100 %.
|
||||
|
||||
**Umsetzung:** (1) RA-C1 path-scoped aus `7f4a99ffd` geborgen (nur P8-Pfade; VR-P22b-/Forms-/Tracker-Anteile bewusst nicht übernommen), i18n-Keys chirurgisch gespliced — Commit `429a45d44`. (2) D19-Smoke aus demselben Commit übernommen (`tests/e2e/projekt-smoke.spec.ts`). (3) D20: `createProjektBoardInterimFixtureViewModel/-Page` via echtem `buildKanbanVM` in `@hivegrid/ui-mock` + M017-Hot-Swap-Drill-Registrierung. (4) D21: Interim-Visual-Baseline `r-p8-projects-interim` erzeugt und in `verify:ui-visual` verdrahtet (Pass-Count 127 → 130).
|
||||
|
||||
**Proof:** `pnpm --filter @hivegrid/web typecheck`, `@hivegrid/view-models`, `@hivegrid/ui-mock` grün · `verify:i18n` Exit 0 · `projects.vm.test` 17, Projekt-Screens+Service 43, `ui-mock/index.test` 20, `verify-ui-mock-visual.test` 32 grün · `pnpm run test:hot-swap` grün · `verify:ui-visual` 130 passed / 0 failed · `playwright --list` sammelt den Projekt-Smoke.
|
||||
|
||||
**Stand:** R-P8a: **13/13 DoD = 100 % done** (9 Original + 4 Audit-Nachtrag D18–21). Kein Schema-Change, keine Migration. Offen bleibt ausschließlich der getrackte `design-nachzug` (finale Subframe-Optik + visuelle Browser-Abnahme, siehe Tag).
|
||||
|
||||
> **Querverweis (2026-07-18, Akeshan, dependency-aware — Subframe-Delta-Nachzug, Branch `feat/subframe-p8-delta-nachzug`):**
|
||||
> Der P8-Flow in Subframe ist von 10 auf 17 Seiten gewachsen; der `design-nachzug` wurde UI-seitig weitgehend abgetragen:
|
||||
> S00 Boards-Startseite (neuer Screen `BoardsStartPage` + Route `/projects/boards` + Sidebar-Eintrag, gleiche Read-Permission wie `/projects`),
|
||||
> S01a/S03a Empty-States, S01b 2-Spalten-Umbruch (Component-Sync `KanbanColumn`/`KanbanCard`; **Breaking-Card-API** → `PipelineKanbanPage`
|
||||
> und `LeadBoardPage` auf Slot-API migriert, `SortableKanbanBoard` forwarded `showSum/twoColumn/wrapAfter`), S02a Edit-Modus-Banner +
|
||||
> System-Feld-Tags, S07a Dialog-Error-State (inkl. minimaler Server-Duplikat-Check in `projectService.createPipeline`,
|
||||
> Key `projects.error.pipelineNameDuplicate`), M03 Karten-Kontextmenü. Demo-Seed um 6 „Neu"-Projekte erweitert (P-00009…P-00014, 2× idempotent
|
||||
> verifiziert). Engine/Schema/Worker unangetastet, keine Migration. Rest-Delta und Details: `.planning/SUBFRAME-FLOW-INVENTAR.md` (5. Update).
|
||||
> Die visuelle Browser-Abnahme auf Staging bleibt offen (nach Merge/Deploy).
|
||||
|
||||
> **Querverweis (2026-07-18, Akeshan, dependency-aware — Polish nach Staging-Sichtung, Branch `feat/subframe-p8-boards-hierarchy`):**
|
||||
> Drei Befunde aus der Staging-Sichtung umgesetzt: (1) **Navigations-Hierarchie aufgelöst** — die P8-Wireframes (Stand 2026-07-08,
|
||||
> kein S00, Einstieg = Kanban mit „zuletzt genutztes Board") sind älter als Davids Subframe-„S00 Boards-Startseite" (2026-07-15,
|
||||
> „Wähle ein Board aus"); die neueste Aussage gewinnt: **ein** konsolidierter Sidebar-Eintrag „Boards" → `/projects/boards`
|
||||
> (`activePaths: ["projects"]` hält ihn auf Kanban/Liste/Detail aktiv), der bisherige „Projekte"-Eintrag entfällt.
|
||||
> Mit David rückbestätigen; Wireframes-Nachzug (S00 in WF-P8) offen. (2) Boards-Seite auf geteilte `PageShell`/`PageHeader`-Primitives
|
||||
> + volle Breite gehoben (`max-w-7xl`-Wrapper der Route entfernt) — Headline/Container jetzt wie die übrigen Screens bzw. Subframe-S00.
|
||||
> (3) S01b-Umbruch-Bug: `wrapAfter` war fix 6 — bei >12 Karten erzeugte `grid-flow-col` überzählige Tracks mit überlappenden Karten
|
||||
> (auf Staging sichtbar); jetzt `max(6, ceil(Karten/2))`.
|
||||
|
||||
> **Querverweis (2026-07-18, Akeshan, dependency-aware — Backend-Nachzug fürs P8-Rest-Delta, Branch `feat/p8-boards-backend-nachzug`, von Akeshan explizit beauftragt trotz R-P8-Ownership):**
|
||||
> (1) **S00-Sperr-/Anfrage-Semantik:** Neues Modell `PipelineAccessRequest` in eigener `prisma/schema/pipelineAccessRequest.prisma`
|
||||
> (AD-21, bare-String-Refs — `projekt.prisma` unangetastet), RLS-Vertrag 292→293 (`tenant-scope-manifest` + Generator), Migration
|
||||
> `20260718090000_wf_p8_pipeline_access_request` (DO-guarded, Inverse-SQL, FORCE RLS + Policy). Gesperrte Boards (deny-Regel)
|
||||
> erscheinen auf `/projects/boards` ausgegraut mit „Nutzung anfragen"; Anfrage → Notification an `projects.admin` (M011) + Audit
|
||||
> `pipeline.access_requested`; User-Freigabe in den Board-Einstellungen resolved offene Anfragen (approved). (2) **„Hängt N T"**:
|
||||
> Karten-Tag ab 7 Tagen Verweildauer im Stage (Batch aus `ProjektStageChange`, kein N+1; nur offene Spalten). (3) **Kontextmenü**:
|
||||
> Duplizieren (`duplicateProject` — neue HiveNumber, Stammdaten + Kontakt-Links, keine Won/Lost/Undo-Felder) + Archivieren
|
||||
> (Confirm-Dialog → bestehendes `archiveProject`, Gate `projects.delete`). `handleKanbanIntent` mit `kanbanIntentPermission`.
|
||||
> Offen: Schwester-Route `projects.pipelines.$pipelineId` ohne die neuen Menü-Items; Kontextmenü-Undo bewusst ausgelassen.
|
||||
|
||||
---
|
||||
|
||||
## Querverweis-Notiz — WF-P8 Subframe-Baseline (2026-07-28, Akeshan)
|
||||
|
||||
**Warum diese Notiz hier steht:** `R-P8a` gehört Raffael. Der Nachzug unten wurde
|
||||
vom User beauftragt und geht über reinen UI-Nachzug hinaus (Schema + Services),
|
||||
darum die dependency-aware Dokumentation nach AGENTS.md §„Ticket-Änderungen".
|
||||
|
||||
**Auslöser.** Davids Handoff `D-P8 + D-KANBAN` vom 2026-07-28 hat den Subframe-Flow
|
||||
`WF-P8 Pipelines` von 17 auf **23 Seiten** neu geschnitten. `S01b` und `S02a` sind
|
||||
entfallen; 6 fachlich neue Screens sind dazugekommen, die vorher **kein Backing**
|
||||
hatten. Lokaler Wireframe-Stand ist Source of Truth (neuer als das Origin-Repo).
|
||||
|
||||
**Was gebaut wurde** (Branch `feat/wf-p8-subframe-baseline`):
|
||||
|
||||
- **M04/M04a/M04b/M04c Pipeline-Übergabe** — ein Dialog mit vier Tabs. Neue Modelle
|
||||
`PipelineHandover` / `PipelineHandoverItem`, neues Feld `Pipeline.nachfolgePipelineId`,
|
||||
neue Permission `projects.handover`. Trigger ist statusbasiert (letzte Stage der
|
||||
Pipeline), **kein** Button — so von David validiert.
|
||||
- **S02-A/N/T/F Schnellaktionsmodale** — neues Modell `ProjektNotiz` mit
|
||||
Sichtbarkeits-Gate (`alle` / `innendienst` / `nur_ich`) + Permission
|
||||
`projects.notes.read_internal`; neues Feld `ProjektTermin.typ`.
|
||||
- **S05 Detail-Schablone + M05 Modal Bestandsfeld** — neues Modell
|
||||
`PipelineFieldGroup`, `PipelineFieldConfig` um
|
||||
`groupId/pflichtAbStageId/hinweis/istSystem/gesperrt` erweitert, neue Route
|
||||
`/admin/pipelines/:pipelineId/fields`.
|
||||
- **S02 Detailansicht** — Felder Quelle/Projekttyp/Promotion sowie
|
||||
Projektkontaktdaten (`Projekt.email/telefon/fax`) ergänzt.
|
||||
|
||||
**Was bewusst unangetastet blieb.** Die Pipeline-Engine, der Stage-Move-Pfad
|
||||
(`moveProjectStage`), Forecast/Aggregate und der Worker. `updatePipeline` wurde nur
|
||||
additiv um die Nachfolge-Pipeline erweitert; bestehende Aufrufer bleiben gültig,
|
||||
weil das Feld nur übernommen wird, wenn das Formular es tatsächlich mitschickt.
|
||||
|
||||
**Entscheidungen, die Raffael kennen sollte:**
|
||||
|
||||
1. **M04 löscht nichts.** Die Wireframes sagen nicht, was mit abgewählten
|
||||
Begleitdaten passiert. Umgesetzt als explizites Übergabe-Paket (was das nächste
|
||||
Team bekommt); abgewählte Notizen/Dateien/Aufgaben/Termine bleiben unverändert am
|
||||
Projekt. Nicht-destruktiv, weil ein stilles Löschen aus dem Screen nicht ableitbar ist.
|
||||
2. **Nachfolge-Pipeline sitzt in den Board-Einstellungen.** Kein Subframe-Screen zeigt
|
||||
dieses Control, aber M04 kann ohne es nicht auslösen. Fachlich gehört es zur
|
||||
Board-Konfiguration. Selbstreferenz wird abgelehnt.
|
||||
3. **Notizen sind ein eigenes Modell, nicht `Activity`.** Die Activity-Timeline ist
|
||||
flach und hat kein Leser-Gate; eine „Nur ich"-Notiz würde dort leaken. Beim Anlegen
|
||||
wird weiterhin ein Activity-Eintrag geschrieben — **ohne** den Notiztext.
|
||||
|
||||
**Rest-Delta (Arbeitsliste, nicht stillschweigend weggelassen):**
|
||||
|
||||
- S05-Feldtypen **Prozent, Datum + Uhrzeit, Person/Team, Adresse, Link** fehlen. Sie
|
||||
bräuchten eine Erweiterung des modulübergreifenden `CustomFieldDatentyp`-Enums
|
||||
(P6 CRM) samt Renderern und Validatoren — bewusst nicht blind mitgebaut, weil sonst
|
||||
Typen entstehen, die speichern aber nie korrekt anzeigen.
|
||||
- **S02 KWP-Integrationsblock** (Projektnummer/Abteilung/Sachbearbeiter/Auftragsstatus)
|
||||
ist read-only Sync-Bestand aus `kwp.prisma` und noch nicht an den Screen angebunden.
|
||||
- Die **12 Bestands-Screens** (S00/S01/S01a/S03/S03a/S04/S06/S07/S07-D/S07a/M01/M03)
|
||||
sind funktional integriert, aber noch nicht 1:1 gegen den neuen Subframe-Stand
|
||||
nachgezogen.
|
||||
- **Demo-Seed** für die neuen Zustände (Übergabe-Kandidaten, Notiz-Sichtbarkeiten,
|
||||
Feldgruppen) und die **visuelle Browser-Abnahme** stehen aus.
|
||||
- Aus dem Vorgänger-Nachzug weiter offen: Kontextmenü-Undo, Start-Datum +
|
||||
`flagVariant` auf der Karte, Deep-Link zum Anlege-Dialog.
|
||||
|
||||
**Proof (2026-07-28).** `pnpm exec prisma validate` grün · `verify:migrations-parity`
|
||||
grün (3 Migrationen, Replay gegen leere DB) · `verify:tenant-policy-contract` grün
|
||||
(376/376) · `typecheck-web` ohne Fehler · `eslint --max-warnings=0` auf allen
|
||||
berührten Pfaden grün · `i18n-check` + Diacritics grün · 157 Tests in
|
||||
`screens/projects` + `view-models/projects` grün.
|
||||
|
||||
**%-Stand R-P8a:** unverändert 13/13 DoD = 100 % (dieser Nachzug erweitert den
|
||||
Screen-Bestand, er ändert die R-P8a-DoD nicht). Der `design-nachzug`-Tag bleibt
|
||||
**offen** — siehe Rest-Delta oben.
|
||||
|
||||
### 2026-07-29 — Bestands-Screens auf Davids Baseline neu gebaut (Fortsetzung, Branch `feat/wf-p8-subframe-baseline`, PR #286)
|
||||
|
||||
Der zweite Teil des Baseline-Auftrags: die **12 Bestands-Screens**, die am 28.07. noch als
|
||||
Rest-Delta offen standen, sind gegen Davids Stand vom 2026-07-28 **neu** gebaut — nicht
|
||||
angeglichen. R-P8a-Anteil:
|
||||
|
||||
- **S07 Board-Verwaltung + S04 Board-Einstellungen — Aufteilung.** David schneidet die
|
||||
frühere Akkordeon-Seite in zwei Screens: `S07` ist eine **Board-Tabelle**
|
||||
(`/admin/pipelines`, eine Zeile je Board mit Typ/Spalten/Projekte/Zugriff/Status, Suche +
|
||||
3 Facetten, Zeilenmenü, Fußzeile), `S04` sind die **Board-Einstellungen je Board**
|
||||
(neue Route `/admin/pipelines/:pipelineId`, Spaltentabelle mit Drag-Reihenfolge und
|
||||
Inline-Feldern, Detailfelder-Promo nach S05, M04-Nachfolge-Board, Zugriffsregeln).
|
||||
Beide Routen teilen sich `pipelineAdminAction.server`, damit der Schreibpfad nicht in
|
||||
zwei auseinanderlaufende Kopien zerfällt. Das S00-Zahnrad zeigt jetzt auf die echte
|
||||
S04-Route statt auf einen Hash-Anker.
|
||||
- **S07-D / S07a** Dialog- und Fehlerzustände des Anlege-Dialogs, **S06** Verlustgründe,
|
||||
**M01** Verloren-Dialog, **M03** Karten-Kontextmenü — alle auf Davids aktuellem Export.
|
||||
- **S00** war bereits am 28.07. fertig; die Zahnrad-/Facetten-Deltas stehen dort.
|
||||
|
||||
**Bewusste Deltas (nicht stillschweigend weggelassen):** `SettingsPage` und
|
||||
`Table.Cell variant="align-right"` fehlen im lokalen Kit; die Spalten-Status-Auswahl behält
|
||||
die drei echten `stageKind`-Werte statt der Freitext-Status des Exports (Kanban, M01 und die
|
||||
Gewinn-/Verlust-Zahlen lesen genau dieses Enum); Farbe, Gewinn-%, Zugriff und Nachfolge-Board
|
||||
bleiben, obwohl der Export sie weglässt, weil kein anderer Screen sie konfiguriert; die
|
||||
Zugriffsspalte meldet die **Form** der Einschränkung, keinen Teamnamen (`PipelineAccess` hält
|
||||
Rollen-/Gruppen-/User-IDs); der Board-Status leitet sich aus der bestehenden
|
||||
gewonnen/verloren-Invariante ab, statt ein zweites Flag einzuführen, das ihr widersprechen
|
||||
könnte.
|
||||
|
||||
**Proof:** Commits `eb663b702` (S00) · `c76023386` (M01) · `e08c4b064` (M03) · `8f3c27b0a`
|
||||
(S06) · `5b7be1026` (S04) · `2c372d942` (S07) · `fa66fcbe9` (S04-404 über den i18n-Katalog) ·
|
||||
`7c46b6d4b` (Intent-Tests am neuen Ort). Volle lokale Gates am Ende der Strecke: `pnpm
|
||||
typecheck` 0 · `pnpm lint` 0 Warnungen · `pnpm test` 7876 Tests grün · `verify:ui-visual`
|
||||
130 passed / 0 failed · `verify:hardcoded-strings` Exit 0. Browser-Abnahme lokal erfolgt
|
||||
(S00 inkl. Zahnrad-Deep-Link, S05-Rendering) — dabei zwei echte Layout-Bugs gefunden und
|
||||
behoben, dokumentiert im Interim-UI-Playbook §„`~/ui`-Felder in einer umbrechenden Flex-Zeile".
|
||||
|
||||
**%-Stand R-P8a:** unverändert **13/13 DoD = 100 %**. Der `design-nachzug`-Tag ist damit
|
||||
**bis auf zwei benannte Punkte abgetragen** und bleibt formal offen für: (1) Demo-Seed für
|
||||
die neuen Zustände (Übergabe-Kandidaten, Notiz-Sichtbarkeiten, Feldgruppen), (2) Re-Baseline
|
||||
der Interim-Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik (DoD 21) und die
|
||||
visuelle Abnahme auf Staging nach Merge. Der Rest des Delta-Katalogs vom 28.07. bleibt
|
||||
unverändert offen (S05-Feldtypen, S02-KWP-Block — beide ohne Datenmodell).
|
||||
|
||||
**2026-07-30 — S02 Detailansicht, Stufe B (Datenmodell), KWP-Block und S05-Feldtypen
|
||||
(Akeshan, Fortsetzung PR #286):** Der letzte große Rest des Baseline-Nachzugs ist gebaut.
|
||||
|
||||
**S02 ist jetzt Davids Screen.** Kopf mit Board-Chip, ID-Pille samt Kopieraktion und
|
||||
„Speichern“; sechs Feldgruppen (Kontakte und Adressdaten als echte Accordions, die vier
|
||||
anderen divider-geführt); schwebende Schnellaktionsleiste; 340px-Seitenleiste. Der Status ist
|
||||
kein Header-Select mehr, sondern das erste Feld der Grunddaten. Neu verdrahtet: Projektleiter
|
||||
(`Projekt.projektleiterId` existierte, stand aber in keinem VM), „Zuständige Personen“ und
|
||||
„Monteure“ als Mehrfachauswahl über `ProjektMitglied` (jede Auswahl schreibt sofort — es gibt
|
||||
keinen Draft, der eine halbe Mitgliederliste halten könnte), Kontakte als Firmen- und
|
||||
Ansprechpartner-Karten über `Kontakt.kontaktTyp` mit Link ins CRM, und die drei Adress-Slots,
|
||||
die vorher **nie gelesen oder geschrieben** wurden. Die beiden optionalen Slots liegen hinter
|
||||
Schaltern, und der Schalter **ist** der FK: ausschalten löst den Slot und entfernt die
|
||||
`Adresse`-Zeile, solange kein Kontakt noch auf sie zeigt.
|
||||
|
||||
**Stufe B (Datenmodell).** Neues `ProjektAdressDetail` (ein Zeile je Projekt und Slot) für die
|
||||
Adress-Zusätze — bewusst **nicht** als Spalten an `Adresse`: das ist eine geteilte CRM-Entität,
|
||||
ein „Zahlungsziel“ dort würde in jede Kontaktadresse lecken. **Modulübergreifend** in
|
||||
`crm.prisma` (gehört zu `R-P6`/Raffael, dort vermerkt): `Kontakt` bekommt Website, USt-IdNr.,
|
||||
Handelsregister, Kundennummer, Kunde-seit, Branche, Mitarbeiterzahl, Position und
|
||||
Erreichbarkeit; `KontaktTelefon` bekommt einen `typ` (haupt/durchwahl/mobil/fax) statt zweier
|
||||
weiterer Skalare an `Kontakt`, weil ein Kontakt mehrere Durchwahlen haben kann. „Letzter
|
||||
Kontakt“ wird aus der Activity-Timeline **abgeleitet**, nicht gespeichert — eine Spalte wäre
|
||||
eine zweite Wahrheit, die beim ersten vergessenen Schreiber auseinanderläuft. S02 rendert die
|
||||
Kontakt-Stammdaten **read-only** und verlinkt zum Pflegen nach P6.
|
||||
|
||||
**KWP-Block gebaut, read-only.** Projektnummer, Auftragsstatus und letzter Abgleich eines
|
||||
gebundenen Projekts, gelesen aus dem bestehenden `AppEntityBinding`-Snapshot — kein
|
||||
Schema-Change nötig, der Link existierte schon. Zwei Deltas: der Export zeichnet die Felder als
|
||||
Eingaben, aber KWP ist ein Inbound-Mirror ohne Schreibpfad (editierbare Felder würden Eingaben
|
||||
still verwerfen); und **Abteilungsnummer/Sachbearbeiter kommen im KWP-Vertrag überhaupt nicht
|
||||
vor** — Spiegel-Spalten dafür könnte kein Importer füllen, das ist eine Frage an David/VR-P32.
|
||||
|
||||
**S05 Feldtyp + Options-Editor.** Der Feldtyp ist ein echter Selector über alle 12 Enum-Werte
|
||||
statt Lesetext, Auswahloptionen haben einen Editor mit Reihenfolge, Bezeichnung, Farbe und
|
||||
Hinzufügen/Entfernen. `CustomFieldDefinition.optionen` war opakes JSON ohne Leser; die Form ist
|
||||
jetzt einmal in `parseCustomFieldOptions`/`serializeCustomFieldOptions` festgelegt und liest
|
||||
Alt-Zeilen weiter. „Mehrfachauswahl“ ist **kein** zweites Flag, sondern schaltet zwischen
|
||||
`select` und `multiselect`. **Umtypisieren wird abgelehnt, sobald Werte gespeichert sind**
|
||||
(Klartext-Fehler statt ein Datum still als Zahl zu lesen); `select` ↔ `multiselect` bleibt
|
||||
erlaubt, beide halten Optionswerte.
|
||||
|
||||
**Proof:** Commits `1cfe33fb2` (Feldgruppen) · `7a9fad50e` (Projektleiter + Mitglieder) ·
|
||||
`c3679d6f2` (Kontakte-Accordion) · `48e82433f` (Adress-Slots) · `2bf2cdb92` (Seitenleiste) ·
|
||||
`148183e0b` (Visual-Re-Baseline) · `a3817e2e4` (Feldbreite) · `f00358844` (Adress-Zusätze) ·
|
||||
`79d5d3d19` (crm.prisma) · `3f5ffb756` (KWP read-only) · `147ba10de` (Letzter Kontakt) ·
|
||||
`c048b06e0` (Migration + Zählwerte) · `e223fec9e` (S05). Volle lokale Gates: `pnpm typecheck`
|
||||
0 · `pnpm lint` 0 Warnungen · `pnpm test` **7916 Tests grün** · `verify:ui-visual` 130 passed /
|
||||
0 failed · `verify:i18n`, `verify:hardcoded-strings`, `verify:tenant-policy-contract` (377/377),
|
||||
`verify:cross-cutting-models` (377/377 · 230/230), `verify:prisma-baseline` alle Exit 0.
|
||||
`prisma migrate deploy` gegen eine **frisch erzeugte leere DB** replayt alle fünf
|
||||
Branch-Migrationen; die neue Tabelle kommt mit FORCE RLS und ihren vier Policies heraus
|
||||
(`infra/LESSONS.md §9`). Browser-Abnahme lokal erfolgt: Monteur zuweisen (Chip aus dem Loader,
|
||||
Activity-Eintrag), Adresse samt Zufahrt speichern und nach Reload persistent, Projektleiter über
|
||||
den Header, Kontakt-Stammdaten auf der Karte, S05 mit Reihenfolge/Farbe/Mehrfachauswahl gegen
|
||||
ein Feld im Alt-Format und der Retype-Schutz mit seiner Meldung. Dabei ein echter optischer
|
||||
Fehler gefunden und behoben (die Beschreibung sprengte als einziges Feld die Feldspalte).
|
||||
|
||||
**%-Stand R-P8a:** unverändert **13/13 DoD = 100 %**. Der `design-nachzug`-Tag bleibt offen für
|
||||
genau noch drei Punkte, alle außerhalb der Ticket-DoD: (1) Demo-Seed für die neuen Zustände,
|
||||
(2) Re-Baseline der Visual-Baseline auf die Subframe-Optik + visuelle Abnahme auf Staging nach
|
||||
Merge, (3) die fünf S05-Feldtypen Prozent/Datum+Uhrzeit/Person-Team/Adresse/Link, die das
|
||||
modulübergreifende `CustomFieldDatentyp`-Enum samt Renderern brauchen. Der frühere Punkt
|
||||
„S02-KWP-Block ohne Anbindung“ ist damit **erledigt** (read-only gebaut); neu notiert:
|
||||
Abteilungsnummer/Sachbearbeiter fehlen im KWP-Inbound-Vertrag und „Firma/Kontakt suchen oder
|
||||
neu anlegen“ hat auf der Detail-Route keinen Intent.
|
||||
|
||||
## Umsetzungs-Notiz 2026-07-30 (Nachmittag) — Rest-Delta zu Davids Export abgetragen
|
||||
|
||||
Der vom User beauftragte Durchgang „alles nachbauen, wie David es hat; was technisch nicht geht,
|
||||
bleibt weg und wird gemeldet". Neun Slices, jeder einzeln committed, live gegen die lokale Instanz
|
||||
abgenommen.
|
||||
|
||||
**Zwei echte Fehler in der eigenen Merge-Migration** (CI-rot, `7b488c762`): der FK von
|
||||
`ProjektAdressDetail` auf `Projekt` scheiterte unter `FORCE ROW LEVEL SECURITY` — Postgres
|
||||
validiert den Constraint mit einem internen Join über `Projekt` und verweigert ihn auch dem
|
||||
Tabellen-Owner (42501 → P3018 in der Shadow-DB); eine leere referenzierende Tabelle hilft nicht.
|
||||
Der FK liegt jetzt im gleichen `NO FORCE`/`FORCE`-Fenster wie der `Pipeline`-Block. **Der lokale
|
||||
Replay war grün, weil diese Verbindung Superuser ist.** Zweitens hatte der M03-Commit
|
||||
`Projekt.redoStageId`/`redoLostReasonId` per `db push` angelegt und nie in die Migration gefaltet
|
||||
(AD-21). Beide Gates, die das finden — `verify:migrations-parity` und `verify:rls-live` — gehören
|
||||
bei Schema-Änderungen in die Pre-Push-Runde und stehen jetzt in `docs/AGENT-CHECKLIST.md`.
|
||||
|
||||
**Demo-Seed (`d37448656`, `0fb9a026c`):** das Flaggschiff-Projekt trägt Quelle, Promotion,
|
||||
Beschreibung, Start/Deadline, eigene Kontaktdaten, Projektleiter, Mitglieder in beiden Rollen und
|
||||
alle drei Adress-Slots samt Zusätzen; Kontakte die Stufe-B-Stammdaten (nach Typ getrennt) und
|
||||
typisierte Zweitnummern; die Vertriebs-Pipeline drei Feldgruppen, neun Feld-Konfigurationen und
|
||||
drei Custom-Field-Definitionen, davon eine **absichtlich im Alt-Format** `{select:[…]}`; dazu drei
|
||||
Notizen (eine je Sichtbarkeit), drei Termine (einer je Typ), das Nachfolge-Board für M04 und
|
||||
Stage-Wechsel für „Hängt N T" und den Verlauf. Nebenbei ein bestehender Idempotenz-Fehler behoben:
|
||||
der Seed brach auf jedem Tenant ab, dessen Automation-Steps schon mit cuid existierten.
|
||||
|
||||
**Suchfeld-Optik (`5dd35fd09`):** Davids borderlose Suche trug bei uns Rahmen, weiße Füllung und
|
||||
8px/12px Innenabstand. Ursache ist nicht die Komponente, sondern `@tailwindcss/forms`, das jede
|
||||
nackte `<input>` stylt; `TextInput`/`SearchInput`/`NumberInput`/`InputOtp` neutralisieren das
|
||||
längst, `FilterBar`/`DropdownMenuSelect`/`DropdownMenuMultiSelect`/`Combobox` wurden ohne diesen
|
||||
Reset synchronisiert. Alle vier tragen ihn jetzt. Die Leiste selbst war korrekt
|
||||
(surface-neutral-secondary auf surface-neutral-primary — Davids Verhältnis, im Browser gemessen).
|
||||
|
||||
**S02-Felder (`6af02813d`, `190e0f8c0`):** Notizen auf Firmenkarte, Ansprechpartner-Karte und allen
|
||||
drei Adress-Slots; „E-Mail für Rechnungen"; Telefon und Ansprechpartner vor Ort am Bauherr-Slot;
|
||||
Durchwahl/Mobil/Fax als eigene Zeilen (dafür wird `KontaktTelefon.typ` endlich gelesen — die Spalte
|
||||
lag seit Stufe B ungenutzt im Schema); Adresszeile auf der Firmenkarte.
|
||||
|
||||
**Projekt-Tags (`5f4262879`, `20b6929d1`):** die Notiz „kein Tag-Modell" war falsch — `crm.prisma`
|
||||
hat längst ein tenantweites `Tag` plus polymorphes `TagAssignment`, dessen Kommentar
|
||||
`entityType = "projekt"` ausdrücklich nennt. Kein neues Schema, keine Migration: Karten-Chips,
|
||||
S03-Spalte und Facette lesen über denselben Batch wie die übrigen Begleitdaten, der Filter löst
|
||||
Tag → Projekt-IDs auf und läuft durch `projectListWhere`, also teilen Board, Liste und CSV eine
|
||||
Definition. Parameter `tags`.
|
||||
|
||||
**S05-Feldtypen (`be952d174`):** alle fünf ergänzt. Die alte Begründung („braucht erst Renderer und
|
||||
Validatoren") hielt nicht: für die anderen zwölf gibt es die auch nicht, jeder Wert ist heute ein
|
||||
String im Textfeld. Enum-Werte per `ALTER TYPE ADD VALUE` in der Branch-Migration.
|
||||
|
||||
**Kontakt hinzufügen (`9f834d00e`):** Davids drei Wege. Die Suche ist eine eigene Loader-only-
|
||||
JSON-Ressource pro Projekt (der Detail-Loader baut das ganze Projekt zusammen — pro Tastendruck
|
||||
neu wäre absurd), liest über `crm.read_own` und bricht die vorige Anfrage ab. Angelegt wird über
|
||||
den CRM-Service, damit ein Projekt kein zweiter Geburtsort für Kontakte wird; das Verknüpfen ist
|
||||
idempotent auf (Projekt, Kontakt).
|
||||
|
||||
**Seitenleiste (`ebc0f2081`):** alle sechs Bereiche tragen Inhalt statt eines Hinweissatzes —
|
||||
Verlauf, nächste Termine, offene Aufgaben, sichtbare Notizen, neueste Timeline-Einträge. Read-only
|
||||
bleibt Absicht: die Editoren liegen im Operations-Bereich derselben Route. Termine und Aufgaben
|
||||
werden dafür **selbst** gelesen, weil das P9-Operations-VM einen Zuständigen als rohe User-ID
|
||||
ausgibt (`principalLabel` gibt `userId || groupId` zurück) — brauchbar neben einem Picker, unbrauchbar
|
||||
in einer Rail-Zeile. **Neuer Fund: der Operations-Bereich selbst zeigt damit heute rohe IDs.**
|
||||
|
||||
**Rest-Deltas geschlossen (`48de62c35`):** Kundentyp mit allen vier Optionen (Organisation =
|
||||
Obermenge, Unternehmen = gewerbliche Teilmenge gmbh/kg — das korrigiert auch die alte Abbildung
|
||||
„Organisation, die keine öffentliche Einrichtung ist", was einen Verein einschloss); Zeitraum als
|
||||
Mehrfachauswahl mit Vereinigung der Bereiche und einem Chip je Periode; Davids Spalten-Kebab mit
|
||||
Einklappen (das Kit konnte `collapsed` längst, niemand nutzte es) und Board-Einstellungen;
|
||||
S05-Live-Vorschau zeigt die konfigurierte Schablone statt eines leeren Platzhalters.
|
||||
|
||||
**Proof:** Commits `7b488c762` · `d37448656` · `0fb9a026c` · `5dd35fd09` · `6af02813d` ·
|
||||
`190e0f8c0` · `5f4262879` · `20b6929d1` · `be952d174` · `f79e8d940` · `9f834d00e` · `ebc0f2081` ·
|
||||
`48de62c35` · `f13c9dccf`. Volle lokale Gates: `pnpm typecheck` 0 · `pnpm lint` 0 Warnungen ·
|
||||
`pnpm test` **7940 Tests grün** · `verify:ui-visual` 130 passed / 0 failed · `verify:i18n`,
|
||||
`verify:hardcoded-strings`, `verify:tenant-policy-contract` (377/377), `verify:cross-cutting-models`,
|
||||
`verify:migrations-parity` („No difference detected"), `verify:rls-live` („PASS non-superuser
|
||||
migration"), `verify:prisma-baseline-equivalence` alle Exit 0. Browser-Abnahme lokal je Slice
|
||||
erfolgt (Suchfeld gemessen, Adress- und Notizfelder nach Reload persistent, Tag-Filter auf drei
|
||||
Projekte, S05-Retype samt Schutzmeldung, Kontakt suchen/verknüpfen/anlegen, sechs Rail-Bereiche mit
|
||||
aufgelösten Namen, zwei Zeiträume gleichzeitig, Spalte eingeklappt auf 48px). Zum Test angelegte
|
||||
Zeilen wurden wieder entfernt.
|
||||
|
||||
**%-Stand R-P8a:** **13/13 DoD = 100 %**, unverändert. Offen bleibt außerhalb der DoD:
|
||||
(1) visuelle Abnahme auf Staging nach dem Merge, (2) „Rechnungsadresse" auf der Firmenkarte —
|
||||
`Kontakt` hat genau eine Adress-FK, eine zweite nur für eine hier read-only gezeigte Zeile wäre
|
||||
eine Spalte, die niemand pflegen kann (offener Punkt für P6), (3) Abteilungsnummer und
|
||||
Sachbearbeiter fehlen im KWP-Inbound-Vertrag (Frage an David/VR-P32), (4) der Inhalt des
|
||||
Spalten-Kebabs ist meine Wahl und braucht Davids Bestätigung, (5) rohe User-IDs im
|
||||
P9-Operations-Bereich (`principalLabel`), (6) Wert-Rendering pro Feldtyp fehlt für alle 17 Typen,
|
||||
nicht nur für die fünf neuen.
|
||||
|
||||
### 2026-07-31 — Live-Abnahme WF-P8, Chargen 2–7 (Branch `fix/wf-p8-kanban-abnahme-charge1`, Akeshan)
|
||||
|
||||
Fortsetzung der gemeinsamen Abnahme des gemergten Standes gegen Davids Subframe-Projekt
|
||||
`f023064a5ca0` und die Wireframe-Docs. Charge 1 (S01-Kopf, Spalten, Einklappen) steht in
|
||||
`R-P8b.md`. Reine Screen-/Kit-Schicht plus die unten genannten Backend-Nachzüge; Pipeline-Engine,
|
||||
Stage-Move-Pfad, Forecast und Worker unberührt.
|
||||
|
||||
**S02 Detailansicht** — voller Neubau nach Export: zwei Spalten mit fester Seitenleiste, Grunddaten
|
||||
mit Euro an den Geldfeldern, Badge-Felder ohne eigenen Rahmen, Personenfelder als Multiselect,
|
||||
Kontakte- und Adress-Kacheln, Schnellaktionsleiste scrollend statt umbrechend, KWP-Kachel und ein
|
||||
einklappbares Pipeline-Panel am Fensterrand mit eigenem Datei-Upload.
|
||||
|
||||
**S03 Liste · S04 Board-Einstellungen · S05 Detailfelder · S06 Verlust-Gründe · S07 Board-Verwaltung**
|
||||
— je gegen den aktuellen Export neu gebaut (Kopfzeilen, Filterleisten, Tabellenspalten mit Icons,
|
||||
Sortierung archivierter Zeilen ans Ende, Dialoge ohne die grauen Bänder). S05 bekam dabei einen
|
||||
echten Fund: die Systemfelder hatten **gar kein Label** und listeten rohe Spaltenschlüssel; das VM
|
||||
trägt jetzt einen i18n-Key je Systemfeld.
|
||||
|
||||
**S01a/S03a Empty States** — leeres Board zeigt die Meldung **über** den Spalten, die Liste zeigt
|
||||
bei null Projekten nur die Meldung und gar keine Tabelle.
|
||||
|
||||
**M01 Verloren-Dialog** — auf Exportmaß (448px), Grund-Auswahl und Notiz gleich breit.
|
||||
|
||||
**Drag & Drop repariert** — die Karte war nur über einen unsichtbaren 97×24-Streifen greifbar; jetzt
|
||||
ist die ganze Kachel die Ziehfläche, die gezogene Karte hängt am Zeiger und der Cursor ist für die
|
||||
Dauer des Ziehens die greifende Faust. Der Platzhalter einer leeren Spalte ist ausgenommen.
|
||||
Nebenbefund behoben: ein KWP-gebundenes Projekt quittierte den Zug mit einer **500-Seite**
|
||||
(`KwpProjectDomainError` lief ungefangen durch `projectActionErrorResponse`) — jetzt Klartext-
|
||||
Meldung plus Rücksprung der Karte.
|
||||
|
||||
**M04/M04a–c Pipeline-Übergabe** — die vier Seiten sind vier Tab-Zustände eines Dialogs; jede Art
|
||||
zeichnet jetzt ihre eigene Zeile (Notiz mit Text und „Datum · Autor", Datei mit „Rolle · Größe ·
|
||||
Datum" und Typ-Badge, Aufgabe mit Status/Fälligkeit/Priorität/Zuständigem, Termin mit Datumskachel).
|
||||
Dafür trägt das VM die Detailfelder je Art, der Service liefert sie aus vorhandenen Spalten.
|
||||
**Auslöser nachgezogen:** D-P8 sagt `S01 → M04`, gebaut war der Trigger nur auf S02 — der
|
||||
Stage-Wechsel gibt die Nutzlast jetzt zurück und das Board öffnet den Dialog selbst
|
||||
(`loadHandoverVM` teilen sich beide Einstiege, neuer Board-Intent `handoverProject`).
|
||||
|
||||
**M05 Modal Bestandsfeld** — nach Export: Untertitel nennt die Zielgruppe, Bestandsfelder als Zeilen
|
||||
mit ihrem Typ, Auswahl hervorgehoben und unten bestätigt (zweiter Klick nimmt die Wahl zurück).
|
||||
|
||||
**S02-A/N/T/F Schnellaktionsmodale** — alle vier auf 448px, ein Feld je Zeile, Exportreihenfolge,
|
||||
Upload als Ablagefläche mit Durchsuchen-Knopf. Fund dabei: Selects und Textfelder liefen gegen die
|
||||
320px-Deckel des Kits und standen schmaler als der Rest des Dialogs.
|
||||
|
||||
**Auf Wunsch entfernt (2026-07-31):** der Block „Übergabe an Nachfolge-Board" unten in den
|
||||
Board-Einstellungen (S04) — der Export zeigt ihn dort nicht. **Konsequenz, bewusst getragen:** damit
|
||||
setzt heute kein Screen mehr `Pipeline.nachfolgePipelineId`, und ohne dieses Feld löst M04 nirgends
|
||||
aus. Der Schreibpfad in `updatePipeline` bleibt unverändert und nimmt das Feld weiter an; die
|
||||
Eingabestelle braucht ein neues Zuhause. Ebenfalls auf Wunsch aus S07 entfernt: die Links auf
|
||||
Abnahmeformulare und Projektvorlagen — beide Routen sind seither nur noch per URL erreichbar
|
||||
(offener Punkt, siehe `projectService.test.ts`).
|
||||
|
||||
**Bewusst nicht gebaut:** Davids Chip-Feld „Eingeladene Personen" im Termin-Dialog — `ProjektTermin`
|
||||
hält genau einen Zuständigen und kennt keine Eingeladenen; die Chips wären ein Bedienelement, das
|
||||
nichts speichert.
|
||||
|
||||
**Proof:** 43 Commits auf dem Branch, u. a. `7d65c36b9` (S02-Modale) · `20cb8dbab` (M05 + S04) ·
|
||||
`7f1d9b560` (M04 auf dem Board) · `b70efcbb2` (M04 nach Subframe) · `f7018f042` (Drag & Drop) ·
|
||||
`0adf5620e` (Empty States) · `677cb739c` (S07) · `ca73870f5` (S06) · `a9e76e81b` (S05) ·
|
||||
`028fd10d7` (S04) · `e0b099c1b` (S03). Volle lokale Gates nach Rebase auf `origin/main`:
|
||||
`pnpm typecheck` 0 · `pnpm lint` 0 Warnungen · `pnpm test` grün · `verify:i18n`,
|
||||
`verify:source-health`, `verify:ci-baseline` je Exit 0. Browser-Abnahme jedes Punkts lokal auf
|
||||
`app.localhost:3001` mit Demo-Daten; die Übergabe wurde einmal vollständig ausgeführt (Projekt in
|
||||
die Auftrags-Pipeline, 9 Positionen im Paket) und anschließend samt Stage-Wechsel, Aktivitäts-
|
||||
Eintrag und Hilfsverknüpfungen wieder zurückgesetzt.
|
||||
|
||||
**%-Stand:** R-P8a **13/13 DoD = 100 %**, R-P8b **10/10 = 100 %** — beide unverändert, dies ist ein
|
||||
Abnahme-Nachzug an der Optik. Offen bleibt außerhalb der DoD zusätzlich zu den oben gelisteten
|
||||
Punkten: (7) Nachfolge-Board hat keine Eingabestelle mehr, (8) Abnahmeformulare und Projektvorlagen
|
||||
sind von nirgends verlinkt, (9) Re-Baseline der Visual-Baseline auf die neue Subframe-Optik,
|
||||
(10) visuelle Abnahme auf Staging nach dem Merge.
|
||||
Reference in new issue
Block a user