9.2 KiB
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_visibilityNEU (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
- ✅ Entitätenmodell festgesetzt (ENTITY-MODEL.md, 6 offene Fragen entschieden)
- ✅ Kohärenz-Prüfung (KOHAERENZ-FINDINGS.md) + R-REFIT (REQUIREMENTS/ROADMAP/PHASE-SOURCES nachgezogen)
- ✅ 154 Ticket-Docs
.planning/ticket-docs/(alle Tickets, Dev + Screen + Spuren) - ✅ committed + gepusht (aeae678b)
- ✅ 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.
- Phase 1 (
MASTER-REIHENFOLGE (beschlossen 16.06.)
- Entitätenmodell festsetzen (gemeinsam) — Grundlage für P6–P9-Docs.
- Kohärenz-Prüfung Tickets ↔ Phasen ↔ Milestones.
- 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. - commit + push (git-Links live machen).
- Plane: neue Tickets anlegen/umbauen + Doc als 1. granularen Link.
- 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-IDAK-P1c→R-P1c. - Infra bleibt Akeshan:
AK-INFRA1/AK-INFRA2sind 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-P1cblocked-byR-P1a,R-P1b;R-P2ablocked-byR-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
mainliegt.
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-RESTAUFLÖSEN → D-P13 (KI, Brief P13) · D-P20 (Billing/Onboarding/Branding, Brief P20) · D-P21 (DSGVO/Launch + Feedback-Widget, Brief P21). Telefonie-Screen → inD-CHAT-Umfeld (P15), Signatur-Screen → inD-FORM/D-BOOK-Umfeld (P16).
v2 — neu anzulegen / umzubauen:
VD-1AUFLÖSEN → VD-P23 (Postfach-Inbox, Brief P23) · VD-P24 (Abo-Baukasten-UI + Onboarding-Wizard, Brief P24)VD-5AUFLÖ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-3erheben 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.svgnachziehen (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-P8hö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.