14 KiB
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.