71 lines
3.2 KiB
Markdown
71 lines
3.2 KiB
Markdown
|
# 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
|