Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/plane-sync/KOHAERENZ-FINDINGS.md
T

109 lines
14 KiB
Markdown
Raw 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.
# Kohärenz-Audit HiveGrid 2.0 — Findings
**Erstellt:** 2026-06-16 · **Modus:** read-only · **Quellen:** PHASE-SOURCES.md, ROADMAP.md, ROADMAP-V2.md, ENTITY-MODEL.md, SCOPE-V1-CUTS.md, REQUIREMENTS.md, plane-snapshot.json (135 Tickets)
**Maßstab:** AD-20 (projekt-zentrisch) · KWP komplett v2 · Mobile PWA-only v1+v2 · v1 DE-only · Pipeline-Rechte (PipelineFieldVisibility) komplex schon v1.
**Befund in einem Satz:** Struktur (Phasen↔Tickets, Milestone-Integrität, Scope-Cuts KWP/PWA/DE) ist überwiegend kohärent. Die kritische Inkohärenz-Wolke liegt am **noch nicht vollzogenen Pivot-Re-Fit (R-REFIT offen)**: ROADMAP/REQUIREMENTS/PHASE-SOURCES für P6–P9 beschreiben durchgehend noch das alte Deal/Auftrag-Entity-Modell, während ENTITY-MODEL.md (16.06. LOCKED) und die Plane-Tickets bereits projekt-zentrisch sind.
---
## Achse A — Ticket ↔ Phasen-Abdeckung
**Gesamtbild: kohärent.** Jede v1-Phase P1–P21 (außer P10/P18 = v2) hat ≥1 Dev-Ticket (R-*/AK-*); jede v2-Phase P22–P34 hat ≥1 VR-*/VA-*. Kein Phasen-Loch, kein Dev-Ticket ohne Phase.
| Befund | Schwere | Beleg | Inkohärenz | Empf. Fix |
|---|---|---|---|---|
| A-1 | klein | plane-snapshot: P10 (KWP) + P18 (Portal) ohne R-*/AK-* | KORREKT — beide sind deferred; nur zur Bestätigung gelistet, kein Finding | — |
| A-2 | klein | VR-P28a + VA-P28b teilen sich P28; VR-P32a/b/c → P32 | Mehrere Tickets je Phase = gewollter Split. Kein Problem, nur dokumentieren, dass Phase↔Ticket 1:n ist | — |
**Zahl Achse A: 0 echte Findings** (alle 21 v1- und 13 v2-Phasen abgedeckt; alle 135 Tickets einer Phase/Spur zuordenbar).
---
## Achse B — Pivot-Reste (Deal/Sales-Pipeline/Verkaufsfall/Auftragspipeline als Eigen-Entität)
Maßstab AD-20: „Deal"/„Auftrag" = Pipeline-TYPEN, keine eigenen Entitäten; ein `Projekt`-Kern; Lead→Projekt.
| Befund | Schwere | Beleg | Inkohärenz | Empf. Fix |
|---|---|---|---|---|
| B-1 | kritisch | REQUIREMENTS.md:33 `REQ-sales-datenmodell`; :41 `REQ-projekt-datenmodell` | Definieren `Deal`, `LostReason`, `ProjectPipeline`, `Project`, `AcceptanceProtocol`, `ProjectTemplate` als getrennte Entitäten — widerspricht „ein Projekt-Kern". ENTITY-MODEL.md kennt nur `Projekt`/`Pipeline`/`PipelineStage`/`AbnahmeProtokoll` | REQ-Texte gegen ENTITY-MODEL.md neu fassen (R-REFIT-DoD „REQUIREMENTS P6–9 nachgezogen") |
| B-2 | kritisch | REQUIREMENTS.md:35 `REQ-sales-deal-lifecycle`: „…Won-Handoff zu M4…" | „Won-Handoff" ist im Pivot explizit gestrichen (ENTITY-MODEL.md:53 „kein Won-Handoff, das Projekt wechselt nur die Pipeline") | Req auf „Pipeline-Wechsel statt Won-Handoff" umschreiben |
| B-3 | kritisch | REQUIREMENTS.md:15 `REQ-crm-lead-promotion` + Traceability :304 | Req „Lead-zu-Contact-Promotions-Modal, 4 Optionen" ist laut REQUIREMENTS.md:6 + ENTITY-MODEL.md:53 **entfallen** (Lead→Projekt, kein Modal), steht aber noch als aktive `- [ ]`-Zeile UND in der Traceability-Tabelle (P6) | Req entfernen/ersetzen durch `REQ-lead-projekt-konvertierung`; Traceability-Zeile löschen → senkt v1-Req-Zahl |
| B-4 | mittel | ROADMAP.md:146 (P6 SC#4): „…Lead kann per Promotions-Modal (Auto-Email-Match, 4 Optionen) transaktional zum Contact werden" | Identischer Pivot-Widerspruch im Success-Criterion; Ticket R-P6-DoD sagt dagegen korrekt „Lead→Projekt (AD-20)" — ROADMAP hinkt dem Ticket hinterher | SC#4 auf Lead→Projekt umschreiben |
| B-5 | mittel | PHASE-SOURCES.md:53 „## Phase 8: **Sales-Pipeline**"; :58 „## Phase 9: **Auftrags-/Projektpipeline**" | Phasen-Namen-Drift: PHASE-SOURCES nennt P8/P9 noch nach altem Modell. ROADMAP.md:168/185 trägt bereits „→ Projekt & Pipelines (Teil 1/2)". Inkonsistenz zwischen den beiden Steuerdateien | PHASE-SOURCES-Header an ROADMAP angleichen („Projekt & Pipelines Teil 1/2") |
| B-6 | mittel | PHASE-SOURCES.md:54 Spec-Ref „M03-sales-pipeline.md"; :59 „M04-auftragspipeline.md" + Milestone-Namen :55/:60 (`M060-verkaufsfall-crud`, `M065-auftragspipeline-konfiguration`) | Milestone-/Spec-Bezeichner tragen noch die alte getrennte Deal/Auftrag-Welt. Laut Pivot-Note PHASE-SOURCES.md:12 sollen P6–9-Maps „neu geschnitten" werden — noch nicht erfolgt | Beim R-REFIT die Milestone-Maps konsolidieren bzw. Namen als historisch markieren |
| B-7 | mittel | ROADMAP.md:171 (P8 Goal) + :194 (P9 SC#1) | P8-Goal „führt Deals durch mehrere SHK-Pipelines"; P9-SC#1 „ProjectPipeline, Project … entstehen aus dem Sales-Won-Handoff" — beide noch alt-modelliert trotz Pivot-Note direkt darüber (:169/:186) | Goal/SC unter den Pivot-Notes nachziehen |
| B-8 | klein | REQUIREMENTS.md:6 kündigt `REQ-rechnung-sub-entity (NEU, E3)` an | Der einzige echte v1-Scope-Zuwachs des Pivots (Rechnung-Sub-Entity) ist **nirgends als Requirement angelegt** (nicht in Req-Liste, nicht in Traceability) — obwohl R-P9a-DoD „Rechnung = neues Sub-Entity v1" baut | `REQ-rechnung-sub-entity` als v1-Req + Traceability-Zeile (P9) ergänzen |
| B-9 | klein | REQUIREMENTS.md:12/:17/:152 etc. „Contact, Company"; ENTITY-MODEL.md:26 erklärt Mapping | Begriffe Contact/Company statt Kontakt(-Oberbegriff)/Organisation. ENTITY-MODEL.md erklärt dies als zulässiges Alias — daher nur kosmetisch, aber beim Re-Fit zu vereinheitlichen | Beim R-REFIT Terminologie angleichen (Kontakt/Organisation) |
**Zahl Achse B: 9 Findings** (3 kritisch, 4 mittel, 2 klein). Gemeinsame Wurzel: **R-REFIT (W1-Ticket) noch offen** — die Single-Source ENTITY-MODEL.md ist gelockt, die abgeleiteten Steuerdokumente sind nicht nachgezogen.
---
## Achse C — Scope-Cut-Konsistenz (KWP-v2 / PWA-only / DE-only / v1-v2-Zuordnung)
| Befund | Schwere | Beleg | Inkohärenz | Empf. Fix |
|---|---|---|---|---|
| C-1 | mittel | EXT-04 (Ticket) description: „➡️ blocks: **v2-P10** (KWP-Integration)"; auch N-KWP blockt EXT-04 → „v2-P10" | KWP ist in ROADMAP/ROADMAP-V2 jetzt **Phase 32** (ex-P10). „v2-P10" ist die interne ROADMAP-V2-Spur-Nummer (dort heißt KWP „v2-P5"!). Drei verschiedene Nummern für dieselbe Sache (P10 / P32 / v2-P5) → Verwechslungsgefahr | EXT-04/N-KWP-Beschreibung auf „P32 (= ROADMAP-V2 v2-P5)" vereinheitlichen |
| C-2 | mittel | ROADMAP-V2.md durchgängig „v2-P1…v2-P11" vs. ROADMAP.md „Phase 22…34" | Zwei parallele v2-Nummernkreise (ROADMAP-V2 1–11 vs. ROADMAP 22–34). Tickets nutzen 22–34. Mapping nur implizit. KWP = v2-P5 (ROADMAP-V2) = P32 (ROADMAP) = ex-P10 | Eine Mapping-Tabelle „v2-Px ↔ Phase 22–34 ↔ ex-Pn" an den Kopf von ROADMAP-V2 setzen |
| C-3 | klein | PHASE-SOURCES.md:241 Ownership-Register-Zeile „**P10 KWP** … v2-P10 integriert sich rückwirkend" | Nutzt ebenfalls „v2-P10" (=P32). Konsistent mit der falschen Nummer aus C-1, aber drift gegen ROADMAP-V2-„v2-P5" | Bei C-1/C-2-Fix mitziehen |
| C-4 | klein | SCOPE-V1-CUTS.md:56 (#7) „Telefonie bleibt KOMPLETT v1 (M105–M109 inkl. AirCall … **HalloPetra**)"; :87 „Telefonie voll (inkl. HalloPetra)" | Widerspruch INNERHALB von SCOPE-V1-CUTS: #10 (:73) und FINALER SCHNITT verschieben HalloPetra (M105) → v2; #7/#87 behaupten noch HalloPetra v1. ROADMAP/PHASE-SOURCES haben M105→v2 korrekt | #7- und :87-Klammer „inkl. HalloPetra" als überholt markieren (von #10 ersetzt) |
| C-5 | klein | SCOPE-V1-CUTS.md:12/:16 (#1) Expo-Text vs. #14 (:177) PWA-only | #1 sagt „v2-App mit Expo"; #14 nimmt das zurück (PWA-only). #1 ist mit Durchstreichung + Verweis auf #14 annotiert → noch konsistent lesbar, aber der Cut-Log enthält zwei gegensätzliche Aussagen ohne Top-Level-Hinweis | OK (annotiert); optional Kopf-Notiz „Tech-Teil von #1 durch #14 überholt" |
| C-6 | klein | ROADMAP.md:407 (P24 Risiko): „Apple Guideline 3.1.3(c) ist der Grund, warum Self-Service v2 ist" | Widerspricht #14 (PWA-only, kein App-Store) und ROADMAP-V2.md:86, das genau diesen Grund explizit als überholt erklärt („nicht mehr wegen Apple-Store-Auflagen"). ROADMAP.md (v1-Datei) ist hier stale | P24-Risiko-Zeile auf „Grund = konkrete Preise (EXT-14), nicht Apple" angleichen |
| C-7 | klein | PWA/DE-only sonst | PWA-only (AD-17) und DE-only (M029→v2) sind in ROADMAP, PHASE-SOURCES, REQUIREMENTS, ENTITY-MODEL durchgängig konsistent — KEIN Finding, positiv vermerkt | — |
**Zahl Achse C: 6 Findings** (0 kritisch, 2 mittel, 4 klein). KWP-v2 inhaltlich überall korrekt; die Reste sind Nummern-/Begründungs-Drift, kein Scope-Widerspruch.
---
## Achse D — Milestone-Integrität (Behauptung „176, jeder genau einer Phase")
**Maschinen-Check (Skript über PHASE-SOURCES.md):**
- Distinct M001–M176 referenziert: **176/176** ✓
- Explizit einer Phase zugeordnete Milestones: **176** ✓
- Doppelt zugeordnete Milestones: **0** ✓
- Milestones ohne Phasen-Zuordnung: **0** ✓
- Summe v1 133 + v2 43 = **176** ✓ (PHASE-SOURCES.md:218/:226 deckungsgleich)
| Befund | Schwere | Beleg | Inkohärenz | Empf. Fix |
|---|---|---|---|---|
| D-1 | mittel | PHASE-SOURCES.md:55 `M064-pipeline-reporting-**kwp-sync**`; :60 `M066-auftrag-crud-**kwp-archiv**`, `M069-abnahme-workflow` (KWP-Archiv-Anteil) — alle in v1-Phasen P8/P9 | Maßstab: KWP-Anteile in v1-Milestones müssen Extension-Points-only/v2 sein. Das ist in :61 als Note geregelt („KWP-Archiv-Anteile von M066/M069 ruhen bis v2-P10") — aber die Milestone-NAMEN tragen KWP weiter, was beim Plan-Lauf KWP-Bau triggern könnte | Beim R-REFIT/Plan-Phase die KWP-Tokens aus den v1-Milestone-Namen entfernen oder Note an die Namens-Zeile heften |
| D-2 | klein | PHASE-SOURCES.md:8 „verifizierte Summe: 176 Milestones … 36 Modul-Specs"; vs. ROADMAP-V2.md:212 „aus 18 Modul-Specs" | Unterschiedliche Spec-Zahlen (36 vs. 18) — 18 = nur v2-relevante Teilmenge, nicht falsch, aber ohne Erklärung verwirrend | Klarstellen „18 v2-relevante von 36 Specs" |
| D-3 | klein | ROADMAP.md:581/:584/:585/:586 Changelog: 109 → 94 → 93 → 90 Reqs; SCOPE-V1-CUTS.md:81/:89/:98 „147 / 160 / 165 MS" | Historische Zwischenstände im selben File; der finale Stand (133 MS / 90 Reqs, ROADMAP.md:586) ist eindeutig. Frühere Zahlen sind als „Revidiert"-Historie markiert → kein echter Widerspruch, nur Lese-Stolperfalle | Optional: „(historisch, siehe finalen Stand)" an die Bilanz-Zeilen #10/#FINAL in SCOPE-V1-CUTS |
| D-4 | klein | SCOPE-V1-CUTS.md:173 (#13) „MS/Reqs-Bilanz: noch nicht final neu gezählt" | Der Pivot (Rechnung +1 Req, Lead-Promotion −1 Req, Deal+Project-Milestone-Konsolidierung) ist in der 176/90-Zählung **nicht** nachgeführt — die „176"-Summe ist die Vor-Pivot-Zahl. Konsistent gezählt, aber gegen den gelockten Pivot veraltet | Nach R-REFIT MS/Req-Summe neu ziehen (B-3 −1, B-8 +1) |
**Zahl Achse D: 4 Findings** (0 kritisch, 1 mittel, 3 klein). **Summe-Check-Zahl: 176 ✓ (133 v1 + 43 v2), 0 doppelt, 0 verwaist.** Die Integrität der Maschinen-Buchhaltung steht; offen ist nur die Pivot-Nachzählung (D-4) und KWP in v1-Namen (D-1).
---
## Achse E — Ticket-Inhalt vs. Phase/Modell
| Befund | Schwere | Beleg | Inkohärenz | Empf. Fix |
|---|---|---|---|---|
| E-1 | mittel | Ticket **R-P8a** name: „P8 Pipeline-Engine + **Deal-CRUD** + Auto-Verkaufsfall"; DoD „Pipeline/Stage/**Deal** + HiveNumberSeq" | Ticket-Titel/DoD nennen „Deal-CRUD"/„Deal" als Entität — im Pivot ist Deal nur ein Pipeline-Typ des Projekt-Kerns. Inkonsistent mit R-P8a-Doku-Ref ENTITY-MODEL.md (Projekt-Kern) und mit R-P9a-DoD, das es richtig macht („kein Won-Objekt") | DoD auf „Projekt-CRUD in Sales-Pipeline-Sicht" umformulieren |
| E-2 | mittel | Tickets R-P8a/R-P8b Doku-Ref: nur `M03-sales-pipeline.md` + ENTITY-MODEL; R-P9a/b: `M04-auftragspipeline.md` | Tickets referenzieren weiter die ungeschnittenen alt-modellierten Specs (M03/M04). Bis R-REFIT die Specs nachzieht, liest der Coding-Agent widersprüchliche Quellen (Spec = Deal/Auftrag-getrennt, ENTITY-MODEL = Projekt-Kern) | R-REFIT muss M03/M04-Spec-Deltas erzeugen ODER Tickets auf ENTITY-MODEL als Vorrang-Quelle festnageln |
| E-3 | mittel | Ticket **R-P8a** DoD enthält **kein PipelineFieldVisibility / Field-Level-Rechte**; R-P8b-DoD: nur „Field-Level-Permissions (Volumen)" | Maßstab #5: Pipeline-Rechte komplex schon v1 — neue Tabelle `PipelineFieldVisibility` (ENTITY-MODEL.md:136, Entsch. 16.06.). Kein Ticket nennt PipelineFieldVisibility/PipelineFieldConfig/PipelineAccess explizit; R-P8a baut „Pipeline-Engine" ohne die drei Rechte-Tabellen im DoD | DoD von R-P8a um PipelineFieldConfig/-Access/-Visibility ergänzen (sonst v1-Pflicht-Feature ungeticktet) |
| E-4 | klein | Ticket **R-P9a** DoD: „Sub-Areas: Termine/Rechnungen/Checklisten/Tasks/Doku" + „Rechnung = neues Sub-Entity v1" | KORREKT projekt-zentrisch (Gegenprobe bestanden) — bestätigt, dass die Tickets dem Modell näher sind als ROADMAP/REQUIREMENTS. Kein Finding, positiv | — |
| E-5 | klein | Ticket **EXT-04** DoD ok, aber „blocks: v2-P10" (siehe C-1) | Nummern-Drift (dort behandelt) | siehe C-1 |
| E-6 | klein | Ticket **R-REFIT** DoD: „REQUIREMENTS P6–9 nachgezogen / SCREEN-MAP §2–4 / PHASE-SOURCES P6–9 re-mapped" | Bestätigt: alle Achse-B-Findings sind durch dieses **eine offene W1-Ticket** abgedeckt. R-REFIT blockt R-P6/R-P7/R-P9a → solange offen, sind B-1…B-9 + E-1…E-3 erwartbar | R-REFIT priorisiert abschließen (es ist der Single-Point-of-Fix für die Pivot-Reste) |
**Zahl Achse E: 6 Findings** (0 kritisch, 3 mittel, 3 klein). Tickets sind **moderner** als die Prosa-Docs (gut), aber R-P8a trägt „Deal-CRUD" und keinem Ticket-DoD steht das v1-Pflicht-Feature PipelineFieldVisibility.
---
## Gesamt-Bilanz
| Achse | Findings | kritisch | mittel | klein |
|---|---|---|---|---|
| A Ticket↔Phase | 0 | 0 | 0 | 0 |
| B Pivot-Reste | 9 | 3 | 4 | 2 |
| C Scope-Cuts | 6 | 0 | 2 | 4 |
| D Milestone-Integrität | 4 | 0 | 1 | 3 |
| E Ticket-Inhalt | 6 | 0 | 3 | 3 |
| **Summe** | **25** | **3** | **10** | **12** |
**Milestone-Summe-Check: 176 ✓** (133 v1 + 43 v2; 0 doppelt zugeordnet, 0 verwaist, M001–M176 vollständig).
**Single-Point-of-Fix:** Das offene W1-Ticket **R-REFIT** (ER-Modell-Re-Fit P6–P9) adressiert direkt B-1…B-9 und E-1…E-3. Es abzuschließen löst alle 3 kritischen + die Mehrzahl der mittleren Findings. Restliche Findings (C-1/C-2 Nummern-Drift, C-4/C-6 stale Begründungen, D-1 KWP in v1-Namen, D-4 Pivot-Nachzählung) sind unabhängige Kleinfixes.