Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

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