Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,106 @@
# 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.