Files

107 lines
9.2 KiB
Markdown
Raw Permalink 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.
# Phasen-Review — Changeset (Durchgang ab 16.06.)
Beschlossene Änderungen aus dem gemeinsamen Phasen-Durchgang (Raffael + Claude).
Werden **gebündelt** angewendet: Doku-Edits direkt, Plane-Writes via `scrub_plane.py`-Muster (dry-run zuerst).
Status je Eintrag: **OFFEN** bis angewendet → dann **DONE**.
## ✅ DOKU-NACHZÜGE 16.06. (nach Plane-Operation)
- **entity-model.dbml**: `pipeline_field_visibility` NEU (Field-Level-Rechte) · `projekt_externes_feld` → [v2] · Header + SVG-Regenerier-Hinweis.
- **entity-model.svg**: ⚠ NICHT auto-regenerierbar (dbdiagram.io-Export) — manuell neu exportieren (Hinweis im dbml-Header).
- **ENTITY-MODELL-ERKLAERUNG.md + .pdf**: KWP-Felder → „ab Version 2", Pipeline-Rechte „voll ausgebaut" (Field-Level je Rolle); PDF neu gerendert.
- **SCREEN-MAP.md §2–4 + _bmad-output/specs/M01–M04**: projekt-zentrisch nachgezogen (Pivot-Hinweis-Blöcke + inline-Entschärfung; tiefere pre-pivot-Stellen bewusst belassen, durch Blöcke abgedeckt). Damit ist der R-REFIT-Pivot in ALLEN Steuerdocs vollzogen.
- **Kohärenz-Findings**: C-5 (Cut-#1-Header), D-2 (18-von-36-Specs in ROADMAP-V2) gefixt; D-3 durch Chronologie ausreichend.
- **D-P2 nachgelegt** (war im Anlege-Skript übersehen) → Plane-Ticket + start_date + DAYPLAN.
- **Vollständigkeits-Check**: 154 aktive Board-Tickets ↔ 154 Doc-Dateien, ALLE mit Doc-Link in Description, 0 Lücken; 3 Cancelled ohne Doc (korrekt).
---
## ✅ ABGESCHLOSSEN 16.06. — alle Schritte ausgeführt
1. ✅ Entitätenmodell festgesetzt (ENTITY-MODEL.md, 6 offene Fragen entschieden)
2. ✅ Kohärenz-Prüfung (KOHAERENZ-FINDINGS.md) + R-REFIT (REQUIREMENTS/ROADMAP/PHASE-SOURCES nachgezogen)
3. ✅ 154 Ticket-Docs `.planning/ticket-docs/` (alle Tickets, Dev + Screen + Spuren)
4. ✅ committed + gepusht (aeae678b)
5. ✅ **Plane inkrementell** (LIVE, idempotent, Backup `plane-backup-review.json`):
- Phase 1 (`link_ticketdocs.py`): 128 Tickets → granularer Ticket-Doc-Link
- Phase 2 (`create_and_fix.py`): 21 neue Screen-Tickets (D-P3/4/5/7/8/9/12/13/14/15/16/20/21 + VD-P22/23/24/25/28/30/31/32) + Cycle + Modul David + Assignee
- Phase 3: VD-2/3/4 → VD-P26/27/29 (rename) · D-REST/VD-1/VD-5 → Cancelled (aufgelöst) · AK-P1c → R-P1c (Owner Raffael) · R-P8a Deal→Projekt · EXT-04 KWP-Nr · R-REFIT → Done
- Phase 4 (`set_startdates.py` + `gen_dayplan.py`): start_date für 21 neue + SPRINT-DAYPLAN.md regeneriert (151 aktive Tickets, gen_dayplan filtert jetzt Cancelled)
- **Board: 156 Issues** (135 + 21 neu), davon 151 Sprint-aktiv + 3 Cancelled + 2 v3-Backlog.
---
## MASTER-REIHENFOLGE (beschlossen 16.06.)
1. **Entitätenmodell festsetzen** (gemeinsam) — Grundlage für P6–P9-Docs.
2. **Kohärenz-Prüfung** Tickets ↔ Phasen ↔ Milestones.
3. **Alle Ticket-Docs schreiben** — pro Ticket eine self-contained Datei `.planning/ticket-docs/<TICKET-ID>.md`. **Scope: ALLE Tickets (David-Screen + Dev R-/AK-)**. Inhalt je Datei: Was wir bauen · Benötigte Screens · Features · UI-Elemente · Abhängigkeiten/Parallelität · Davids Delta · Dev-Nachzug. Quelle = die 32 Phasen-Briefs (auf Tickets aufgeteilt). Generierung via parallele Agenten.
4. **commit + push** (git-Links live machen).
5. **Plane:** neue Tickets anlegen/umbauen + Doc als 1. granularen Link.
6. Danach: weitere Themen.
---
## P1 — Fundament & Walking-Skeleton · beschlossen 16.06. · Status: OFFEN
**Entscheidung:** P1 macht **nur Raffael** (löst Engstelle Problem #1 — keine kollidierenden Branches am frischen Fundament).
- **Ticket:** `AK-P1c` (Hot-Swap + Walking-Skeleton + PWA) → Assignee Akeshan → **Raffael**, Working-ID `AK-P1c` → **`R-P1c`**.
- **Infra bleibt Akeshan:** `AK-INFRA1` / `AK-INFRA2` sind reines Ops (Coolify/DNS/TLS/PG-Redis) — kein App-Code-Konflikt, laufen echt parallel. Bleiben bei Akeshan.
- **Doku:** SPRINT-4W.md §3 W1 („Alle 3 / P1 in 3 Strängen" → „Raffael P1 solo; Akeshan Infra parallel") · SPRINT-DAYPLAN.md (Ticket-Move `AK-P1c`→`R-P1c`, Raffael) · designer-briefs/P01 Owner-Dev.
- **Dependency:** `R-P1c` blocked-by `R-P1a`,`R-P1b`; `R-P2a` blocked-by `R-P1c`.
- **Konsequenz (Risiko):** Raffaels W1-Pfad +1 Ticket → P2 rutscht ggf. ~1 Tag nach hinten. Akeshan W1 = Infra solide, dann **P4 starten, sobald P1-Fundament auf `main`** liegt.
---
## QUER: David braucht für JEDE Phase mit Screens ein eigenes Screen-Ticket · beschlossen 16.06. · Status: OFFEN
**Entscheidung:** Jede Phase mit Screens bekommt ein dediziertes David-Screen-Ticket, das auf den (bereits existierenden) fokussierten Phasen-Brief verlinkt — kein „aus Archetypen ableiten" mehr, keine Sammel-Bündel. Umfang: **v1 + v2 komplett**. Anwenden: **gebündelt am Durchgang-Ende**.
**v1 — neu anzulegen / umzubauen:**
- **D-P2** → Brief P02 (Auth, 11 Screens; Header sieht „D-P2 fällig So 21.06." bereits vor)
- **D-P3** → Brief P03 (Audit-Viewer, Notif-Center + Settings, Sprache DE)
- **D-P4** → Brief P04 (chunked-Upload-UI, HEIC-Vorschau, Task-Liste, EntityLink-Anhang)
- **D-P5** → Brief P05 (App-Katalog, Connection-/OAuth-Screens, Settings A6)
- **D-P7** → Brief P07 (Lead-Inbox-Triage — USP-Screen)
- **`D-REST` AUFLÖSEN** → **D-P13** (KI, Brief P13) · **D-P20** (Billing/Onboarding/Branding, Brief P20) · **D-P21** (DSGVO/Launch + Feedback-Widget, Brief P21). Telefonie-Screen → in `D-CHAT`-Umfeld (P15), Signatur-Screen → in `D-FORM`/`D-BOOK`-Umfeld (P16).
**v2 — neu anzulegen / umzubauen:**
- **`VD-1` AUFLÖSEN** → **VD-P23** (Postfach-Inbox, Brief P23) · **VD-P24** (Abo-Baukasten-UI + Onboarding-Wizard, Brief P24)
- **`VD-5` AUFLÖSEN** → **VD-P22** (Public-API-Keys, Brief P22) · **VD-P28** (Admin-Tiefe, Brief P28) · **VD-P32** (KWP-Setup, Brief P32)
- **VD-P25** neu → Brief P25 (KI-Tiefe/RAG — Scope aus Brief prüfen, ggf. minimal)
- **VD-P30** neu → Brief P30 (Dashboard-Deluxe: Custom-Widgets, Export)
- **VD-P31** prüfen → Brief P31 (DSGVO-Vollausbau — falls Screens; sonst Dev-Doku)
- P33/P34 (HalloPetra/HR-Drittanbieter): **kein Ticket jetzt** — Spec noch offen (`VEXT-2`/`VEXT-3` erheben sie erst).
- **Bleiben ohne Phasen-Brief (ok):** `D-WEB`, `D-POLISH`, `VD-6` (Polish/Website, keine Feature-Phase).
**Anwenden-Schritte (gebündelt):** (1) Tickets in Plane anlegen/umbenennen + Assignee David + Cycle/Fenster + Brief als 1. Doku-Link (granular). (2) Briefe ggf. Owner-Zeile bestätigen. (3) `gen_dayplan.py` neu laufen → SPRINT-DAYPLAN.md. (4) SPRINT-4W.md Designer-Track-Hinweis.
**Caveat:** David ~17 → ~25 v1-Tickets — Kapazität/Timeline bei Designer-Reihenfolge prüfen.
---
## P4 / Prisma — schema.prisma-Konflikt: GELÖST via ADR · beschlossen 16.06. · Status: DONE (Doku geschrieben)
Befund: Schema ist schon ein Ordner (`prisma/schema/`, 29 Dateien, Prisma 7.8.0) — Datei-Konflikt entschärft. Rest = `core/accounts`-Hotspot + Migrations-Reihenfolge.
**Bereits angewendet (keine Plane-Aktion):** AD-21 in `docs/ARCHITECTURE-DECISIONS.md` + neuer Abschnitt „Prisma-Schema & Migrationen" in `AGENTS.md` (damit Coding-Agent es liest). Drei Regeln: Modul=eigene .prisma · Feature-Branch `db push`, Migration erst beim Merge · CI `prisma validate`+`migrate status`.
---
## Entitätenmodell — offene Fragen entschieden, Modell festgesetzt · 16.06. · Status: ENTITY-MODEL.md DONE, Folge-Docs OFFEN
**Entscheidungen (in ENTITY-MODEL.md eingetragen):** Pipeline-Rechte komplex (NEU `PipelineFieldVisibility`) · HiveNumberSeq Row-Lock lückenlos · is_demo_data quer · kontakt_status Kontakt/Kunde/Bestandskunde · Label **„Organisation"** · **KWP-Felder/`ProjektExternesFeld` komplett v1 raus → v2**.
**Folge-Anpassungen noch OFFEN (beim Doc-Schreiben/Nachziehen):**
- `entity-model.dbml` + `entity-model.svg` nachziehen (ProjektExternesFeld → v2, neue Tabelle PipelineFieldVisibility). PDF-Erklärung neu rendern.
- **P09-Doku/Brief:** „ProjektExterneFelder (KWP) v1 Anzeige" **streichen** (→ v2). Screen-Zahl P09 entsprechend −0/−1 prüfen.
- **P08-Doku/Brief:** Pipeline-Rechte = **komplex** (Field-Level-Visibility je Rolle) — Aufwand in `R-P8` höher, im Dev-Ticket vermerken.
- ROADMAP.md P9 (KWP-Feld-Halter-Erwähnung) + SCOPE-V1-CUTS.md (Mini-Cut „KWP-Feld-Halter raus aus v1") nachziehen.
---
## Kohärenz-Prüfung + R-REFIT · 16.06. · Status: R-REFIT DONE (verifiziert)
Audit: `.planning/plane-sync/KOHAERENZ-FINDINGS.md` (25 Findings, 3 kritisch). Struktur sauber (Phasen↔Tickets lückenlos, 176 Milestones ✓). Wurzel = R-REFIT offen.
**R-REFIT ausgeführt + verifiziert (16.06.):** REQUIREMENTS.md (Modul 3+4 projekt-zentrisch, REQ-crm-lead-promotion→REQ-lead-projekt-konvertierung, REQ-rechnung-sub-entity NEU, PipelineFieldVisibility verankert) · ROADMAP.md (P6 SC#4, P8-Goal, P9-SC) · PHASE-SOURCES.md (P8/P9-Header „Projekt & Pipelines", KWP-Tokens entschärft, KWP-Nummer vereinheitlicht) · ROADMAP-V2.md (v2-Px↔Phase-Mapping-Tabelle) · SCOPE-V1-CUTS.md (HalloPetra-Widerspruch, MS/Req neu gezählt = 90/176). Traceability = 90 ✓.
**Noch OFFEN (klein, beim Ticket-Doc/Plane-Schritt):** Ticket `R-P8a` Titel/DoD „Deal-CRUD"→Projekt-CRUD + PipelineFieldVisibility (E-1/E-3) · `EXT-04` blocks-Nummer (C-1) · `R-REFIT`-Ticket auf done · SCREEN-MAP §2–4 + M01–M04-Spec-Deltas (`_bmad-output`) noch pre-pivot.