AP2.2a: Archetyp-Starter-Kits und MVP Execution Plan v0.2.
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Successful in 2m40s
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 13s
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Successful in 2m40s
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 13s
Referenz-Vorhaben A1/A2/B2b/B2a per UI anlegbar mit gefuehrter Starter-Struktur; Dogfooding-Seed deprecated. Plan-Korrektur: Execution Plan v0.2 statt Seed-Spiegel als Prioritaet. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
a097a82e17
commit
2b0d5dd3d9
18 files changed
+1050
-87
No files matched your search
@@ -0,0 +1,152 @@
|
||||
# AP2.2a — Archetyp-geführte Anlage & Starter-Kits
|
||||
## Implementierungsauftrag v0.1
|
||||
|
||||
**Status:** freigegeben — **nächstes Code-Paket**
|
||||
**Stand:** 2026-07-12
|
||||
**PO-Basis:** `Kairo_MVP_Execution_Plan_v0.2.md` §5, `Kairo_MVP_Definition_v0.3.md` §5–7, `ADP_Archetype_and_Method_Catalog_v0.2.md` §3
|
||||
**Vorgänger:** AP2.0b (Registry), AP1.10c (Profil-Modal), AP2.0c (Kontrolle)
|
||||
**Nachfolger:** AP2.2b–e (End-to-End pro Archetyp), AP1.9d (Default-UI)
|
||||
|
||||
---
|
||||
|
||||
## 1. Ziel
|
||||
|
||||
Ein Nutzer legt ein **Referenz-Vorhaben** an — **ohne Seed, ohne CRUD-Wand** — und erhält:
|
||||
|
||||
1. **Archetyp** mit Default-Methode und verständlichem Label
|
||||
2. Optional **Ausprägung** (`method_profile_key`: Kumite, Buch, Kairo-Dev)
|
||||
3. **Starter-Kit**: minimale Plan-/Ist-Struktur passend zum Archetyp
|
||||
4. **Guidance**: ein Satz Steuerungshinweis + Link zum nächsten sinnvollen Schritt
|
||||
|
||||
**Leitfrage-Test:** Nach Anlage in ≤3 Minuten in Kontrolle erkennbar: *Was ist der Typ dieses Vorhabens — und was ist als Nächstes dran?*
|
||||
|
||||
**Nicht-Ziel:** Voller Structure Builder, KI, Tenant-Designer.
|
||||
|
||||
---
|
||||
|
||||
## 2. Scope
|
||||
|
||||
### In Scope
|
||||
|
||||
| # | Lieferung |
|
||||
|---|-----------|
|
||||
| 1 | **Anlage-Flow** erweitern: Archetyp zuerst (Pflicht), Ausprägung wenn vorhanden, EFS-Kernfelder |
|
||||
| 2 | **Starter-Kit-Service** (`backend/services/archetype_starter_kit.py`): idempotent nach `create_initiative` |
|
||||
| 3 | Kits für **Stufe A**: A1, A2, B2b (+ optional B2a); B3-Hinweis auf `work_cycle` |
|
||||
| 4 | **API** `GET /api/entity-archetypes/{key}/starter-preview` — was wird angelegt (read-only) |
|
||||
| 5 | **UI**: Vorhaben anlegen — Vorschau „Das legen wir an“ + Guidance nach Create |
|
||||
| 6 | pytest: pro Archetyp Kit-Struktur + Default-Methode |
|
||||
|
||||
### Out of Scope
|
||||
|
||||
- Dogfooding-Seed, Gitea-Webhook, MCP
|
||||
- `chapter` item_type (→ AP2.2f)
|
||||
- AP2.0e Recurring-Stufenwechsel (→ AP2.2c)
|
||||
- Methoden-Default-Ansichten Ausführen-Modus (→ AP1.9d)
|
||||
- Op-API Erweiterung (→ AP1.7b)
|
||||
|
||||
---
|
||||
|
||||
## 3. Starter-Kits (Spezifikation)
|
||||
|
||||
### A1 — `initiative.maturity_journey` / `maturity_progression`
|
||||
|
||||
| Element | Inhalt |
|
||||
|---------|--------|
|
||||
| RoadmapItems | 3× `maturity_stage` (planned → active → planned), sort_order 0,10,20 |
|
||||
| Projects | 1× `project.maturity_journey` „Training“ |
|
||||
| Recurring | 1× RecurringElement „Tägliche Übung“ (weekly, Platzhalter) |
|
||||
| Guidance | „Aktuelle Stufe und heutige Übung steuern deinen nächsten Schritt.“ |
|
||||
| Ausprägung | `maturity.karate_kumite` optional — mehr Stufen in Profil-JSON, Kit bleibt minimal |
|
||||
|
||||
### A2 — `initiative.linear_project` / `sequential_dependency`
|
||||
|
||||
| Element | Inhalt |
|
||||
|---------|--------|
|
||||
| RoadmapItems | 4× `milestone` als Gate-Kette (G1 active, G2–G4 planned), `requires`-Kanten |
|
||||
| Projects | 2×: „Hauptpfad“, „Begleitung“ |
|
||||
| Guidance | „Nächster Schritt am kritischen Pfad — Abhängigkeiten im Plan-Graph.“ |
|
||||
|
||||
### B2b — `initiative.product` / `continuous_product`
|
||||
|
||||
| Element | Inhalt |
|
||||
|---------|--------|
|
||||
| RoadmapItems | 2× `milestone` (Orientierung, nicht Micro-AP-Gates) |
|
||||
| Projects | 2×: „Entwicklung“, „Betrieb“ |
|
||||
| Backlog | 1× BacklogItem „Idee / Issue“ (open) |
|
||||
| Guidance | „Eingang triagieren, dann committete Actions — optional Sprint-Zeitbox (B3).“ |
|
||||
| Ausprägung | `product.kairo_dev` optional |
|
||||
|
||||
### B2a — `initiative.program` / `program_delivery` (minimal)
|
||||
|
||||
| Element | Inhalt |
|
||||
|---------|--------|
|
||||
| RoadmapItems | 3× `milestone` Phasen + Abschluss-Gate (planned/active) |
|
||||
| Guidance | „Programm mit Abschluss — Gate-Horizont in Kontrolle.“ |
|
||||
|
||||
### B3 — Profil-Hinweis (kein eigener Archetyp)
|
||||
|
||||
- Kein separates Kit — bei B2b/B2a: leerer Hinweis „Sprint anlegen unter Plan → Zeitbox“
|
||||
- Optional: 1× `work_cycle` planned „Iteration 1“ **nur wenn** Query-Param `include_work_cycle=true` bei Anlage
|
||||
|
||||
---
|
||||
|
||||
## 4. Technische Umsetzung
|
||||
|
||||
### 4.1 Backend
|
||||
|
||||
```text
|
||||
backend/services/archetype_starter_kit.py
|
||||
get_starter_preview(archetype_key, method_profile_key?) -> StarterPreview
|
||||
apply_starter_kit(tenant_id, initiative_id, archetype_key, ...) -> StarterResult
|
||||
|
||||
backend/routers/entity_archetypes.py (oder initiatives)
|
||||
GET .../starter-preview?archetype_key=&method_profile_key=
|
||||
|
||||
services/initiatives.create_initiative(...)
|
||||
optional: apply_starter_kit wenn apply_starter_kit=true (Default: true für Stufe A)
|
||||
```
|
||||
|
||||
**Regeln:**
|
||||
|
||||
- Idempotent: Re-Apply erzeugt keine Duplikate (Titel-Match wie Seeds)
|
||||
- Tenant-scoped, Audit `initiative.starter_kit_applied`
|
||||
- Keine hardcodierten Rechte — Capabilities wie bei `create_initiative`
|
||||
|
||||
### 4.2 Frontend
|
||||
|
||||
- `InitiativeForm` / Anlage-Modal: Archetyp-Auswahl prominent
|
||||
- Vorschau-Panel aus `starter-preview`
|
||||
- Nach Create: Toast + Link „Zur Kontrolle“ + Guidance-Text aus Snapshot
|
||||
|
||||
### 4.3 Tests
|
||||
|
||||
- `test_ap22a_starter_kit_a1.py` — Stufen + Recurring
|
||||
- `test_ap22a_starter_kit_a2.py` — Gate-Kette + deps
|
||||
- `test_ap22a_starter_kit_b2b.py` — Backlog + Projects
|
||||
- `test_starter_preview_api.py`
|
||||
|
||||
---
|
||||
|
||||
## 5. DoD
|
||||
|
||||
- [ ] Nutzer kann A1, A2, B2b Vorhaben **nur über UI** anlegen mit Starter-Struktur
|
||||
- [ ] Default-Methode aus Archetyp — nicht `generic_operating` bei Stufe A
|
||||
- [ ] Kontrolle zeigt nach Anlage sinnvolle Next Action (bestehende Strategien)
|
||||
- [ ] Starter-Preview API dokumentiert in OpenAPI
|
||||
- [ ] pytest grün
|
||||
- [ ] Keine Abhängigkeit von `seed_004`
|
||||
- [ ] Truth Table + Execution Plan: AP2.2a ✓
|
||||
|
||||
---
|
||||
|
||||
## 6. Akzeptanz (manuell nach Deploy)
|
||||
|
||||
1. Neues Vorhaben „Test Küche“ (A2) → 4 Gates, 2 Projects, Kontrolle mit Next Action
|
||||
2. Neues Vorhaben „Test Spagat“ (A1) → 3 Stufen, 1 Recurring
|
||||
3. Neues Vorhaben „Test Product“ (B2b) → Backlog + Projects
|
||||
4. ≤3 Min Leitfrage beantwortbar
|
||||
|
||||
---
|
||||
|
||||
*Siehe auch: `Kairo_MVP_Execution_Plan_v0.2.md`, `ADP_Archetype_and_Method_Catalog_v0.2.md` §3*
|
||||
Reference in new issue
Block a user