Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/plane-sync/REVIEW-CHANGESET.md
T

9.2 KiB
Raw Blame History

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.