refactor(A1): Progression-Lanes aus Graph statt Strang=Project
Deploy Development / deploy (push) Successful in 53s
Test Suite / pytest-backend (push) Successful in 4m52s
Test Suite / lint-backend (push) Successful in 3s
Test Suite / compose-smoke (push) Has been skipped
Test Suite / k6 /api/health Baseline (push) Successful in 18s
Test Suite / playwright-smoke (push) Successful in 31s
Deploy Development / deploy (push) Successful in 53s
Test Suite / pytest-backend (push) Successful in 4m52s
Test Suite / lint-backend (push) Successful in 3s
Test Suite / compose-smoke (push) Has been skipped
Test Suite / k6 /api/health Baseline (push) Successful in 18s
Test Suite / playwright-smoke (push) Successful in 31s
Ersetzt strand_project_id/Stream-Projects in der A1-Steuerung durch graph-abgeleitete Lanes (requires-Ketten + Join). Recurring bindet nur noch am Gate; Re-Abnahme-Docs und ADP dokumentieren die Korrektur. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
88a03a65f2
commit
17add13d9d
12 files changed
+396
-125
No files matched your search
@@ -0,0 +1,70 @@
|
||||
# ADP — A1 Progression: Graph-abgeleitete Lanes statt Strang=Project
|
||||
|
||||
**Status:** PO/Architektur-Korrektur (2026-07-28)
|
||||
**Stand:** 2026-07-28
|
||||
**Auslöser:** AP2.1 — Strang=Project und `strand_project_id` vermischen Dimension A (Zielzustands-Graph) mit Dimension B (Project-Struktur)
|
||||
**Bezug:** `ADP_Execution_Plan_and_Work_Package_Dependencies_v0.1.md`, `SPEC_A1_Progression_Model_PO_Lock_v0.1.md`, `SPEC_D_maturity_progression_v0.1.md`
|
||||
|
||||
---
|
||||
|
||||
## Entscheidung
|
||||
|
||||
**A1 Multi-Gate-Progression braucht kein Project pro parallelem Pfad.**
|
||||
|
||||
| Thema | Lock |
|
||||
|-------|------|
|
||||
| **Ziel-Horizont (A)** | Gates + `requires`-Graph + Join — modelliert **Zielzustände**, nicht Pfade |
|
||||
| **Ist / Übungen** | `RecurringElement.roadmap_item_id` → aktives Gate — **eine** Bindung |
|
||||
| **Parallele aktive Gates** | Erlaubt; Horizon-Regel „max. 1 aktiv pro Lane“ aus **Graph-Topologie** ableiten |
|
||||
| **Lane** | Interner, nicht persistierter Schlüssel (`compute_progression_lanes`) — kein Nutzerobjekt |
|
||||
| **Project** | **Nicht** Träger paralleler Progression in A1; optional nur für echte Struktur-Hierarchie (ADP Dimension B) |
|
||||
| **`strand_project_id`** | **Deprecated** für Steuerlogik; Spalte bleibt nullable (Migration 032), wird nicht mehr gelesen |
|
||||
| **`recurring.project_id` für A1** | **Nicht** setzen / nicht auswerten für Ready-Menge |
|
||||
|
||||
---
|
||||
|
||||
## Begründung
|
||||
|
||||
1. **ADP-Leitentscheidung:** Gate-Designer = Zielzustände; Pfad-/Container-Semantik gehört nicht in dieselbe Pflichtmodellierung.
|
||||
2. **Nutzerbild:** Mehrere aktive Gates, Routinen am Gate, Join wertet Kanten aus — kein Pfad-Navigator nötig.
|
||||
3. **Archetyp-Isolation:** Project=Strang hätte andere Archetypen (A2, B1) semantisch verunreinigt.
|
||||
4. **Kein Doppelmodell:** Kanten im Designer genügen; kein Strang-Dropdown, keine Stream-Projects für A1-Kernbild.
|
||||
|
||||
---
|
||||
|
||||
## Lane-Algorithmus (MVP)
|
||||
|
||||
Aus `requires`-Kanten zwischen Work-Gates und Joins:
|
||||
|
||||
- Sequenzielle Work-Gates teilen eine Lane (Vorgänger-Kette).
|
||||
- Parallele Quellen (kein Work-Gate-Vorgänger) → getrennte Lanes.
|
||||
- Erstes Gate nach Join (`requires` Join) → neue Lane (`post-join:{gate_id}`).
|
||||
|
||||
Horizon: Beim Aktivieren eines Gates werden andere `active`/`at_risk` Gates **derselben Lane** auf `planned` gesetzt.
|
||||
|
||||
---
|
||||
|
||||
## Implementierung
|
||||
|
||||
| Modul | Änderung |
|
||||
|-------|----------|
|
||||
| `backend/services/progression_graph.py` | `compute_progression_lanes`, `enforce_single_active_work_gate_per_lane` |
|
||||
| `backend/services/maturity_practice.py` | Pause/Seed nur über `roadmap_item_id` + Lane |
|
||||
| `backend/services/archetype_starter_kit.py` | Demo ohne Stream-Projects / `strand_project_id` |
|
||||
| `frontend/.../WorkTodayPracticePanel.jsx` | Gruppierung nach Gate-Titel |
|
||||
|
||||
Steuerung bleibt in **`maturity_progression`** — nicht im generischen `roadmap_engine`.
|
||||
|
||||
---
|
||||
|
||||
## Spec-Nachzug
|
||||
|
||||
`SPEC_A1_Progression_Model_PO_Lock_v0.1.md` §1/§4: „Strang = Project“ → **ersetzt durch** „parallele Lanes = graph-abgeleitete Requires-Ketten“. Project-Spiegel `project.maturity_journey` optional für Struktur-IA, nicht für Horizon.
|
||||
|
||||
---
|
||||
|
||||
## Nicht in Scope
|
||||
|
||||
- Spalten-Drop in Migration ( später, wenn keine Legacy-Daten )
|
||||
- Join If/Else (Stufe B)
|
||||
- Blueprint / Starter-Kit als Produktweg
|
||||
@@ -1,8 +1,8 @@
|
||||
# AP2.1 — MVP Validation Report
|
||||
## v0.3 (Stufe A)
|
||||
|
||||
**Status:** Entwurf — vom Product Owner auszufüllen
|
||||
**Stand:** 2026-07-28
|
||||
**Status:** Entwurf — Re-Abnahme A1 Progression ausstehend (2026-08-02)
|
||||
**Stand:** 2026-08-02 (§3.5 Progressions-Re-Abnahme ergänzt)
|
||||
**Bezug:** `Kairo_MVP_Definition_v0.3.md` §5–8
|
||||
**Assignment:** `Sprint1_AP2_1_MVP_Validation_Assignment_v0.1.md`
|
||||
**Findings (Architektur-Review):** `Sprint1_AP2_1_Validation_Findings_Register_v0.1.md`
|
||||
@@ -106,6 +106,79 @@ Produkt (PO): **A1 No-Go** — Cadence-Plumbing reicht nicht; Nutzerbild = **par
|
||||
|
||||
**Lücken / UX-Schmerz:** PO No-Go — Register F-A1-02…10; Minimum Slice §6.1 vor Re-Test. Kein Architektur-Neudesign — fehlender A1-Kern (CadenceInstance, Today=Übung, Gate-Fortschritt, IA).
|
||||
|
||||
### 3.5 Re-Abnahme A1 — Progressionsmodell (PO-Lock, ohne Starter-Kit)
|
||||
|
||||
**Zweck:** PO-Kernbild prüfen gemäß [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../product/archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md) §7 — **≥2 parallele Gates + 1 Join + Activity Sets + Today**, manuell modelliert (kein Spagat-Starter-Kit). Horizon/Lanes: [`ADP_A1_Progression_Graph_Derived_Lanes_v0.1.md`](../architecture/ADP_A1_Progression_Graph_Derived_Lanes_v0.1.md).
|
||||
|
||||
**Vorbedingungen**
|
||||
|
||||
| # | Check | erledigt |
|
||||
|---|--------|----------|
|
||||
| V1 | Deploy `develop` grün (pytest inkl. `test_a1_progression_join.py`) | ☐ |
|
||||
| V2 | Health: `GET https://dev.kairo.jinkendo.de/api/health` | ☐ |
|
||||
| V3 | PO-Entscheid: **kein Starter-Kit** — Anlage mit `"apply_starter_kit": false` (API) oder Spagat-Stufen nach Anlage löschen | ☐ |
|
||||
|
||||
**Referenz-Graph (MVP, 2 parallele Pfade — reicht für Go):**
|
||||
|
||||
```text
|
||||
[Dehnung — Einstieg] ──requires──▶ [Join: Mawashi …] ◀──requires── [Hüftrotation — Einstieg]
|
||||
│
|
||||
┌───────────────────┴───────────────────┐
|
||||
▼ ▼
|
||||
[Dehnung — nach Join] [Hüftrotation — nach Join]
|
||||
```
|
||||
|
||||
Alle Kanten: **Voraussetzung** (`requires`). Kein Parallelgruppe/Blockiert nötig. **Keine** Stream-Projects / `strand_project_id` nötig — parallele Pfade ergeben sich aus dem Graph.
|
||||
|
||||
---
|
||||
|
||||
**9 Smoke-Schritte**
|
||||
|
||||
| # | Schritt | Route / Aktion | Erwartung | ✓/✗ | Notiz |
|
||||
|---|---------|----------------|-----------|-----|-------|
|
||||
| **1** | Vorhaben anlegen | API `POST /api/initiatives` mit `archetype_key: initiative.maturity_journey`, **`apply_starter_kit: false`** | Archetyp A1, Methode `maturity_progression`, **keine** Spagat-Stufen | | |
|
||||
| **2** | Operating Context | `GET …/initiatives/{id}/operating-context` oder Kontrolle | `maturity_stage`, `recurring_rhythm`; Default-Route Kontrolle | | |
|
||||
| **3** | Gates + Join im Designer | Plan → Zielzustände → **Designer** | 5 Knoten: 4× `Reifegrad-Stufe` + 1× **Join/Schaltknoten**; D1+H1 **active**, Rest **planned** | | |
|
||||
| **4** | Kanten ziehen | Designer, Kantentyp **Voraussetzung** | Join→D1, Join→H1, D2→Join, H2→Join (4 Kanten) | | |
|
||||
| **5** | Activity Sets | Gate-Detail je Work-Gate: Recurring/Übung anlegen oder Kriterium + Übung | D1 und H1 je ≥1 Übung; Join **ohne** Checkliste/Verify-Button | | |
|
||||
| **6** | Today (Start) | `/work/today` (Initiative-Scope) | Übungen von **beiden** aktiven Gates; **keine** flache AP-Wand; Join **nicht** in Today | | |
|
||||
| **7** | Verify Pfad 1 | Gate D1: Evidence + **Verify** | D1 `reached`; Join wartet auf H1; **kein** auto-next auf D2; Today nur noch H1-Übungen | | |
|
||||
| **8** | Join schaltet | Gate H1: Evidence + **Verify** | Join `reached` (automatisch); D2 + H2 **active**; neue Übungen in Today | | |
|
||||
| **9** | Leitfrage + Kontrolle | Kontrolle `/control/status` + Stopuhr | Join-Warteliste zeigte offene Eingänge (Schritt 7); Leitfrage in **≤2 Min** beantwortbar: *Welche Übung heute, welcher Join wartet?* | | |
|
||||
|
||||
**Technische Referenz (Automatisierung):** `backend/tests/test_a1_progression_join.py`
|
||||
|
||||
---
|
||||
|
||||
**Go-Kriterien A1 Progression (alle nötig für Go)**
|
||||
|
||||
| # | Kriterium | ja/nein | Notiz |
|
||||
|---|-----------|---------|-------|
|
||||
| G1 | Multi-Gate: 2 aktive Work-Gates parallel (Schritt 6) | | |
|
||||
| G2 | Join: Warteliste/Kontrolle zeigt pending inputs (Schritt 7) | | |
|
||||
| G3 | Join schaltet Ausgänge gemeinsam (Schritt 8) | | |
|
||||
| G4 | Today = Übungen am Gate, nicht AP-Liste (Schritt 6, 9) | | |
|
||||
| G5 | Leitfrage ≤2 Min (Schritt 9) | | |
|
||||
| G6 | Kein Anti-Pattern: flache Rhythmus-Liste als Hauptbild | | |
|
||||
|
||||
**Zwischenurteil Re-Abnahme:** ☐ Go · ☐ Bedingt · ☐ No-Go
|
||||
|
||||
| Feld | Wert |
|
||||
|------|------|
|
||||
| **Initiative-ID / Titel** | |
|
||||
| **Deploy / Commit** | `develop` @ |
|
||||
| **Testdatum Re-Abnahme** | |
|
||||
|
||||
**Leitfrage-Antwort (PO, ≤2 Min):**
|
||||
|
||||
**Nächster Schritt:**
|
||||
**Warum:**
|
||||
**Stopuhr (Min):**
|
||||
|
||||
**Bei Go:** §3 Zwischenurteil auf Go setzen; Findings Register F-A1-02…10 einzeln abhaken; Truth Table MVP-Abnahfe A1 aktualisieren.
|
||||
|
||||
**Bei No-Go:** neue Finding-IDs im Register; keine Stufe-A-Sign-off.
|
||||
|
||||
---
|
||||
|
||||
## 4. Szenario A2 — Neue Küche (Linear)
|
||||
|
||||
@@ -216,12 +216,12 @@ Alternanz, volle Metric-Engine, Activity-Set-Automation → **nach** Slice 1–4
|
||||
|
||||
Kernentscheide:
|
||||
|
||||
- **Multi-Strang** (Projects) + **Gate-Graph** + **Join-Gates**
|
||||
- **Parallele Gates** + **Gate-Graph** + **Join-Gates** (Lanes graph-abgeleitet — ADP A1 Lanes v0.1)
|
||||
- **Horizon:** mehrere aktive Gates (nicht eine Stufe initiative-weit)
|
||||
- **Übung** = `RecurringElement` am Gate + Strang; Rhythmus = Feld
|
||||
- **A1 Go MVP:** ≥2 Stränge + 1 Join + Gate-Activity-Set + Today — nicht nur Spagat-Demo
|
||||
- **Übung** = `RecurringElement` am Gate (`roadmap_item_id`); Rhythmus = Feld
|
||||
- **A1 Go MVP:** ≥2 parallele Gates + 1 Join + Gate-Activity-Set + Today — nicht nur Spagat-Demo
|
||||
|
||||
**Validation A1:** pausiert bis `AP-A1-PM-4` (Plan Struktur + Gate-Detail). A2/B2b-Smoke **parallel** möglich.
|
||||
**Validation A1:** Re-Abnahme gemäß [`Sprint1_AP2_1_MVP_Validation_Report_v0.3.md`](Sprint1_AP2_1_MVP_Validation_Report_v0.3.md) **§3.5** (Progressionsmodell, ohne Starter-Kit). A2/B2b-Smoke **parallel** möglich.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user