Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/plane-sync/KOHAERENZ-FINDINGS.md
T

14 KiB
Raw Blame History

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.