AP1.9a: Arbeitsmodi-Shell mit Scope, Objekt-Routen und Legacy-Redirects.
Deploy Development / deploy (push) Successful in 47s
Test Suite / pytest-backend (push) Failing after 1m46s
Test Suite / k6 /api/health Baseline (push) Has been skipped
Test Suite / playwright-smoke (push) Has been skipped
Test Suite / lint-backend (push) Successful in 2s
Test Suite / compose-smoke (push) Has been skipped
Deploy Development / deploy (push) Successful in 47s
Test Suite / pytest-backend (push) Failing after 1m46s
Test Suite / k6 /api/health Baseline (push) Has been skipped
Test Suite / playwright-smoke (push) Has been skipped
Test Suite / lint-backend (push) Successful in 2s
Test Suite / compose-smoke (push) Has been skipped
Ersetzt die Vorhaben-Tab-Navigation durch Cockpit/Ausführen/Planen/Kontrolle/Team, Deep Links für APs/Projekte/Gates und Programm-Scope im Header. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
33831a8c2c
commit
e42edd86fa
54 files changed
+2489
-150
No files matched your search
@@ -0,0 +1,146 @@
|
||||
# ADP — AP1.9 PM Work Modes & Frontend IA Reset v0.1
|
||||
|
||||
**Status:** vorgeschlagen (PO-Freigabe ausstehend)
|
||||
**Stand:** 2026-07-08
|
||||
**Autor:** Product/Architektur (Cursor-Session, PM-Feedback)
|
||||
**UI-Konzept:** `docs/product/Kairo_PM_Frontend_UI_Concept_v0.1.md`
|
||||
**Auslöser:** Frontend strukturiert nach Objekten (Vorhaben-Tabs), nicht nach Programmmanager-Arbeitslogik
|
||||
|
||||
---
|
||||
|
||||
## Problem
|
||||
|
||||
Nach AP1.2c–AP1.6 existiert ein IA-Skeleton (Workspace, Initiative-Übersicht, Unterseiten), aber:
|
||||
|
||||
1. **Alle Arbeitsflächen hängen unter `/initiatives/:id/...`** — Querschnitt (alle Tasks, alle Blocker, Next Step portfolio-weit) fehlt als eigene Fläche.
|
||||
2. Tab **Ausführung** vermischt Struktur (Projects), Ist (Actions), Blocker — widerspricht Plan/Ist-Trennung und PM-Use-Cases.
|
||||
3. **Workspace** ist Widget-Sammlung ohne klaren Modus „Cockpit“.
|
||||
4. Weitere UI-Patches auf Unterseiten **verstärken** das Anti-Pattern (Vision §7, Canonical OM §8.1).
|
||||
|
||||
Ohne Entscheidung wird jede weitere Feature-Arbeit (Tasks, KI, Portfolio-Prio) erneut „irgendwo unter Vorhaben“ landen.
|
||||
|
||||
---
|
||||
|
||||
## Betroffene Regeln
|
||||
|
||||
| Dokument | Regel |
|
||||
|----------|--------|
|
||||
| Vision v0.2 §7 | Drei Ebenen: Workspace → Initiative-Übersicht → Unterseiten |
|
||||
| Vision v0.2 §7.1–7.2 | Workspace = Querschnitt; Initiative-Übersicht = Steuerung im Alltag |
|
||||
| Canonical OM §8.1–8.4 | Übersicht entscheidet; getrennte Hauptflächen Plan / Ausführung / Eingang / Journey |
|
||||
| ADP PO Product Layering | Gates ≠ operativer Plan; Ausführung = Ist-Kern |
|
||||
| Principle Gate / Sprint0 | Kein weiteres InitiativeDetail-Omnibus |
|
||||
|
||||
**Erweiterung (dieses ADP):** Vision-Ebenen bleiben fachlich; **Präsentation** wird um **App-weite Arbeitsmodi** ergänzt. Unterseiten-Inhalte **migrieren in Modi + Scope**, nicht in tiefere Verschachtelung.
|
||||
|
||||
---
|
||||
|
||||
## Optionen
|
||||
|
||||
| Option | Kurzbeschreibung | Pro | Contra |
|
||||
|--------|------------------|-----|--------|
|
||||
| **A** | Status quo + weiter patchen | Kein Migrationsaufwand | PM-Use-Cases bleiben unbedienbar; KI ohne Einstieg |
|
||||
| **B** | Nur Widgets auf Workspace erweitern | Schnell | Kein Plan/Kontrolle-Modus; Vorhaben-Tabs bleiben |
|
||||
| **C** | **Fünf App-Modi + Scope-Selector** (UI Concept v0.1) | Entspricht PM-Logik; Querschnitt; Agent-ready | Einmaliger IA-Umbau; Redirects nötig |
|
||||
|
||||
---
|
||||
|
||||
## Entscheidung (Empfehlung: Option C)
|
||||
|
||||
### 1. App-Hauptnavigation = Arbeitsmodi
|
||||
|
||||
| Modus | Route | Ersetzt / absorbiert |
|
||||
|-------|-------|----------------------|
|
||||
| Cockpit | `/cockpit` | `/workspace`, Portfolio-Widgets |
|
||||
| Ausführen | `/work/*` | `/my-actions`, Tab Ausführung (Ist-Teil) |
|
||||
| Planen | `/plan/*` | Tabs Plan, Eingang, Project-Struktur |
|
||||
| Kontrolle | `/control/*` | Initiative-Steuerung, Journey, Plan-Ist-Aggregate |
|
||||
| Team | `/team` | Workload (neu) |
|
||||
|
||||
**Objekt-Routen (first-class, parallel zur Modus-Nav):** `/actions/:id`, `/projects/:id`, `/gates/:id`, `/tasks/:id` (AP1.5d). Beim Öffnen: Scope und aktiver Modus aus Objektdaten ableiten; Redirects von legacy nested URLs.
|
||||
|
||||
Vorhaben-Katalog: `/initiatives` — **Scope setzen**, nicht primärer Arbeitscontainer.
|
||||
|
||||
### 2. Scope-Selector (global)
|
||||
|
||||
- Portfolio | Initiative | optional Project
|
||||
- URL: `?initiative=&project=` (Query) — **Scope Lock** bis ADP v0.2
|
||||
- React Context: `ProgramScopeProvider` in `AppLayout`
|
||||
|
||||
### 3. InitiativeSubNav — deprecate
|
||||
|
||||
- Tabs `Steuerung | Zielzustände | Ausführung | Eingang | Nachvollziehbarkeit` werden **entfernt** (nach AP1.9a Redirects)
|
||||
- Inhalt wandert in Modi (siehe UI Concept §11)
|
||||
|
||||
### 4. Harte Guardrails (Scope Lock)
|
||||
|
||||
| Verboten | Erlaubt |
|
||||
|----------|---------|
|
||||
| Neue Sektionen auf `InitiativeExecutionPage` | Hotfix bis AP1.9a |
|
||||
| Inline-CRUD auf Modus-Übersichten | Detail-Route / Modal |
|
||||
| Dritte parallele Navigationshierarchie | Scope + Modus nur |
|
||||
| Project-Lifecycle / Steering pro Project | ADP Recursive Containers |
|
||||
|
||||
### 5. Implementierungspakete
|
||||
|
||||
```text
|
||||
AP1.9a Shell, Routen, Scope, Redirects, Platzhalter-Screens
|
||||
AP1.9b Cockpit + Work/Heute (AP-Querschnitt)
|
||||
AP1.9c Control (Snapshot, Journey, Plan-Ist)
|
||||
AP1.9d Plan (Structure, Gates, Inbox)
|
||||
AP1.9e Team (Workload)
|
||||
```
|
||||
|
||||
AP1.5d (Tasks) **füllt** `/work` — ändert IA nicht.
|
||||
AP1.8 (Portfolio-Prio) **erweitert** `/cockpit`.
|
||||
AP1.7 (Agent API) **mappt** auf Modus-Endpunkte.
|
||||
|
||||
---
|
||||
|
||||
## Risiko
|
||||
|
||||
| Risiko | Mitigation |
|
||||
|--------|------------|
|
||||
| Große Migration / gebrochene Bookmarks | Redirect-Tabelle, 6 Monate |
|
||||
| Doppelpflege alt/neu | Freeze auf alten Tabs ab AP1.9a Start |
|
||||
| Scope in URL vs. State | Ein Provider, Tests für Deep-Links |
|
||||
| Überengineering Mobile | 9a nur Desktop+Mobile Nav-Parität; Detail polish later |
|
||||
|
||||
---
|
||||
|
||||
## Rückbaubarkeit
|
||||
|
||||
- Modi-Routen isoliert unter `frontend/src/modes/` (neu)
|
||||
- Alte Initiative-Routen als Redirect-Layer bis Entfernung
|
||||
- Scope-Provider optional abschaltbar für Tests
|
||||
- ADP v0.2 kann Modus-Namen anpassen ohne OM-Änderung
|
||||
|
||||
---
|
||||
|
||||
## Auswirkung auf Roadmap
|
||||
|
||||
| Paket | Änderung |
|
||||
|-------|----------|
|
||||
| AP1.5d | Bleibt; liefert Task-Daten für `/work` |
|
||||
| AP1.4c Gate-UI | Gehört in `/plan/gates`, nicht Initiative-Tab |
|
||||
| AP1.8 | Cockpit-Feature |
|
||||
| AP1.7 | Nach AP1.9b+c (Leseschnittstellen stabil) |
|
||||
|
||||
**Nächstes Code-Paket nach PO-Freigabe:** AP1.9a (Shell) — **nicht** weiter AP1.5e-UI.
|
||||
|
||||
---
|
||||
|
||||
## PO-Freigabe
|
||||
|
||||
- [ ] Option C angenommen
|
||||
- [ ] UI Concept v0.1 bestätigt
|
||||
- [ ] AP1.9a–e Reihenfolge OK
|
||||
- [ ] InitiativeSubNav-Abschaffung OK
|
||||
|
||||
---
|
||||
|
||||
## Referenzen
|
||||
|
||||
- `docs/product/Kairo_PM_Frontend_UI_Concept_v0.1.md`
|
||||
- `docs/product/Kairo_Corrected_MVP_Roadmap_v0.2.md` (Abschnitt AP1.9)
|
||||
- `docs/product/Kairo_Implementation_Truth_Table_v0.1.md`
|
||||
@@ -52,7 +52,24 @@ Siehe `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`.
|
||||
|
||||
Siehe `ADP_Recursive_Containers_and_Execution_Granularity_v0.1.md`.
|
||||
|
||||
**Reihenfolge:** AP1.5c → AP1.6 → AP1.5d
|
||||
**Reihenfolge:** AP1.5c → AP1.6 → **AP1.9 (PM Work Modes IA)** → AP1.5d
|
||||
|
||||
---
|
||||
|
||||
## 1.3 PO-Entscheidung 2026-07-08 — PM Work Modes (Frontend IA)
|
||||
|
||||
**Auslöser:** Programmmanager-Feedback — Vorhaben-Unterseiten decken Arbeitslogik nicht ab; Querschnitt fehlt.
|
||||
|
||||
| Entscheidung | |
|
||||
|--------------|--|
|
||||
| App-Navigation = **Arbeitsmodi** (Cockpit, Ausführen, Planen, Kontrolle, Team) | vorgeschlagen |
|
||||
| Scope = Filter (Portfolio / Vorhaben / Projekt), nicht Navigationstiefe | vorgeschlagen |
|
||||
| Initiative-Tabs (`InitiativeSubNav`) abschaffen | vorgeschlagen, mit Redirects |
|
||||
| Kein weiteres UI-Patching auf Ausführungs-Tab | Scope Lock ab AP1.9a |
|
||||
|
||||
Siehe `Kairo_PM_Frontend_UI_Concept_v0.1.md`, `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`.
|
||||
|
||||
**Reihenfolge Code:** AP1.9a (Shell) → 9b–9e (Modus-Inhalte); AP1.5d parallel nach 9b wo sinnvoll.
|
||||
|
||||
---
|
||||
|
||||
@@ -69,8 +86,9 @@ Phase F Gate-Backend AP1.4 + AP1.4b ✓ (Backend); UI minimal
|
||||
Phase G Ist-Hierarchie AP1.5 ✓
|
||||
Phase G2 Rekursive Container AP1.5c–5d ✓ 5c / → 5d nach AP1.6
|
||||
Phase H Plan/Ist-Verknüpfung AP1.6 ✓
|
||||
Phase H2 Rekursive Tasks AP1.5d ← **NÄCHSTES CODE**
|
||||
Phase I Gate-Graph AP1.4d–4e nach AP1.6
|
||||
Phase H2 PM Work Modes IA AP1.9 ← **NÄCHSTES CODE** (PO 2026-07-08)
|
||||
Phase H3 Rekursive Tasks AP1.5d nach AP1.9b
|
||||
Phase I Gate-Graph AP1.4d–4e nach AP1.9d
|
||||
Phase J Portfolio & Kontext AP1.8 geplant
|
||||
Phase K Agent Interface AP1.7 geplant (unverändert)
|
||||
Phase L Validation AP0.10d (laufend PO) parallel
|
||||
@@ -94,6 +112,8 @@ Phase L Validation AP0.10d (laufend PO) parallel
|
||||
| AP1.4b | 0.13.1-ap1.4b | Gate-Checkliste Backend + Detail-Route |
|
||||
| AP1.5c | 0.14.1-ap1.5c | Rekursive Projects |
|
||||
| AP1.6 | 0.15.0-ap1.6 | Plan/Ist, Journey, Gate-Beiträge |
|
||||
| AP1.5e | 0.15.1-ap1.5e | Projekt-Detail, Lifecycle-Chip (Übergang — ersetzt durch AP1.9) |
|
||||
| DOC PM UI | 2026-07-08 | PM Frontend UI Concept v0.1, ADP AP1.9 |
|
||||
| DOC PO | 2026-07-06 | ADP Product Layering & IA-Reset |
|
||||
| DOC Container | 2026-07-06 | ADP Recursive Containers & Execution Granularity |
|
||||
|
||||
@@ -156,6 +176,26 @@ Backlog/Action/Project/Task → RoadmapItem; Decision-Spur; Journey-Timeline.
|
||||
|
||||
---
|
||||
|
||||
### AP1.9 — PM Work Modes & Frontend IA Reset ← **NÄCHSTES CODE**
|
||||
|
||||
**Ziel:** App-weite Arbeitsmodi statt Vorhaben-Tab-Omnibus; Querschnitt für PM-Use-Cases.
|
||||
|
||||
| Teil | Scope |
|
||||
|------|--------|
|
||||
| **9a** | App-Shell, Routen `/cockpit`, `/work`, `/plan`, `/control`, `/team`, Scope-Provider, Redirects |
|
||||
| **9b** | Cockpit + Ausführen/Heute (AP-Querschnitt) |
|
||||
| **9c** | Kontrolle: Snapshot, Journey, Plan-Ist-Aggregate |
|
||||
| **9d** | Planen: Struktur, Gates, Inbox (Migration von Initiative-Tabs) |
|
||||
| **9e** | Team: Workload, Zuweisungsübersicht |
|
||||
|
||||
**ADP:** `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`
|
||||
**UI Concept:** `Kairo_PM_Frontend_UI_Concept_v0.1.md`
|
||||
**Version-Ziel:** `0.16.0-ap1.9a` (Shell), dann inkrementell
|
||||
|
||||
**Explizit nicht:** Weitere Features unter `InitiativeExecutionPage` / `InitiativeSubNav`.
|
||||
|
||||
---
|
||||
|
||||
### AP1.5d — Rekursive Tasks & Roll-up
|
||||
|
||||
**Ziel:** Task-Baum (`parent_task_id`); Mensch UI max. ~3 Ebenen; Agent tiefer.
|
||||
@@ -169,8 +209,8 @@ Backlog/Action/Project/Task → RoadmapItem; Decision-Spur; Journey-Timeline.
|
||||
| **Kein** nested Action (Default) |
|
||||
|
||||
**ADP:** `ADP_Recursive_Containers_and_Execution_Granularity_v0.1.md`
|
||||
**Nach AP1.6**
|
||||
**Version:** `0.15.1-ap1.5d`
|
||||
**Nach AP1.9b** (Tasks füllen `/work`, IA bleibt)
|
||||
**Version:** `0.16.x-ap1.5d`
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,444 @@
|
||||
# Kairo — PM Frontend UI Concept v0.1
|
||||
|
||||
**Status:** PO-Arbeitsentwurf (Entscheidung ausstehend)
|
||||
**Stand:** 2026-07-08
|
||||
**Auslöser:** Programmmanager-Feedback — Objekt-Hierarchie ohne Arbeitslogik; Vorhaben-Unterseiten als Sackgasse
|
||||
**Bezug:** Vision v0.2 §7, Canonical OM v0.2 §8, `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`
|
||||
**Ersetzt als UI-Leitbild:** Ad-hoc-Layout unter `InitiativeExecutionPage` / Tab-Omnibus
|
||||
|
||||
---
|
||||
|
||||
## 1. Problem in einem Satz
|
||||
|
||||
Kairo hat **Objekte** (Vorhaben, Projekt, Arbeitspaket) und **Tabs**, aber keine **Arbeitsmodi** — deshalb findet ein Programmmanager weder Querschnitt noch Planung noch Kontrolle, und KI/Agenten haben keinen kanonischen Einstieg.
|
||||
|
||||
---
|
||||
|
||||
## 2. Leitprinzipien (verbindlich für UI)
|
||||
|
||||
| # | Prinzip | Konsequenz |
|
||||
|---|---------|------------|
|
||||
| P1 | **Modi für Überblick, Objekte direkt** | Modi beantworten Querschnittsfragen; **bekannte** APs/Projekte/Gates sind per **Deep Link** sofort erreichbar — ohne vorher Modus wählen. |
|
||||
| P2 | **Scope ist Filter, kein Gefängnis** | Portfolio, ein Vorhaben oder ein Projekt sind **Filter** auf dieselben Modi — nicht separate Welten. |
|
||||
| P3 | **Querschnitt auf Top-Level** | „Alle meine Tasks“, „Was klemmt?“, „Nächster Schritt?“ leben **global**, nicht unter `/initiatives/:id/...`. |
|
||||
| P4 | **Übersicht entscheidet, Detail pflegt** | Modi zeigen Steuerungsantworten; Anlage/Bearbeitung nur auf **Objekt-Detail-Routen** oder Modal — nie als dauerhafte Inline-CRUD-Wand. |
|
||||
| P5 | **Plan ≠ Ausführung ≠ Kontrolle** | Drei kognitive Tätigkeiten — drei Flächen. Nicht in einem Tab stapeln. |
|
||||
| P6 | **Methodenneutral** | Gates optional; flache Vorhaben ohne Roadmap müssen in jedem Modus sinnvoll leer oder reduziert sein (`generic_operating`). |
|
||||
| P7 | **Gleiche Logik für Mensch und Agent** | Jeder Modus mappt auf lesbare/schriftbare API-Oberflächen (`steering/`, Workspace Data Layer). |
|
||||
| P8 | **Stabile Objekt-URLs** | `/actions/:id`, `/projects/:id` usw. sind bookmarkbar; Scope und Modus werden aus dem Objekt **abgeleitet**, nicht manuell vorher gesetzt. |
|
||||
|
||||
---
|
||||
|
||||
## 3. Navigationsmodell — drei Ebenen
|
||||
|
||||
```text
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ EBENE 1 — MODUS (Sidebar): Querschnitt & Arbeitsintention │
|
||||
│ Cockpit │ Ausführen │ Planen │ Kontrolle │ Team │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
+
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ EBENE 2 — SCOPE (Header): Filter auf Modus-Inhalte │
|
||||
│ Portfolio > Vorhaben X > [ optional Projekt Y ] │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
+
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ EBENE 3 — OBJEKTFokus (Route): Konkretes Ding bearbeiten │
|
||||
│ /actions/:id /projects/:id /gates/:id … │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Modus allein reicht nicht** — du springst oft **direkt** auf ein Arbeitspaket oder Projekt (Link, Lesezeichen, Next-Action-Klick, Agent).
|
||||
**Modus allein reicht auch nicht ohne Querschnitt** — „Was ist heute dran über alles?“ braucht `/work/heute` ohne vorher ein Vorhaben zu öffnen.
|
||||
|
||||
| Ebene | Wann | Beispiel |
|
||||
|-------|------|----------|
|
||||
| **Modus** | Ich weiß noch nicht *welches* Objekt, aber *welche Aufgabe* | „Heute“, „Was klemmt?“, „Planen“ |
|
||||
| **Scope** | Ich will alles in einem Vorhaben/Projekt sehen | Filter auf Queue, Kontrolle, Plan |
|
||||
| **Objekt** | Ich kenne die ID / den Namen | AP „API-Auth“, Projekt „Phase 2“ |
|
||||
|
||||
**Regel:** Objekt-Route hat **Vorrang**. Beim Öffnen von `/actions/:id` setzt die App automatisch Scope (Initiative, ggf. Project) und markiert den passenden Modus in der Sidebar — du musst nicht „erst Ausführen klicken“.
|
||||
|
||||
Wechsel des Modus **behält** Scope, solange sinnvoll. Wechsel des Objekts **aktualisiert** Scope aus den Objektdaten.
|
||||
|
||||
---
|
||||
|
||||
## 4. Die fünf Arbeitsmodi (Product Language)
|
||||
|
||||
### 4.1 Cockpit — *Wo stehe ich im Portfolio?*
|
||||
|
||||
**Leitfrage:** Welches Vorhaben braucht Aufmerksamkeit — und was ist programmweit als Nächstes dran?
|
||||
|
||||
| Inhalt | Quelle (heute / geplant) |
|
||||
|--------|---------------------------|
|
||||
| Portfolio-Kacheln mit Lifecycle, Signal, Prio | `InitiativePortfolioWidget`, AP1.8 Prio |
|
||||
| Attention / Showstopper quer | `AttentionWidget`, Snapshot-Signale |
|
||||
| Next Action (Portfolio-Scope) | `NextActionWidget` scope=portfolio |
|
||||
| Kurz-KPIs (offen, blockiert, Gates at risk) | `WorkspaceSummaryWidget` |
|
||||
|
||||
**Nicht hier:** Gate-CRUD, Projektbaum, Sprint-Planung im Detail.
|
||||
|
||||
**Route:** `/cockpit` (Alias `/workspace` → Redirect)
|
||||
|
||||
---
|
||||
|
||||
### 4.2 Ausführen — *Was mache ich jetzt konkret?*
|
||||
|
||||
**Leitfrage:** Welche committete Arbeit (Arbeitspaket / Task) ist dran — **über alle Vorhaben und Projekte**?
|
||||
|
||||
| Inhalt | Beschreibung |
|
||||
|--------|--------------|
|
||||
| **Heute** | Mir zugewiesen, überfällig zuerst, Next-Action-Ranking |
|
||||
| **Meine Queue** | Alle offenen Tasks/APs (filterbar) |
|
||||
| **Nach Vorhaben / Projekt** | Gruppierung optional — kein Navigationszwang |
|
||||
| Detail-Drill | Link zu AP-/Task-Detail |
|
||||
|
||||
**Nicht hier:** Programmstruktur anlegen, Gates definieren, Portfolio-Priorität setzen.
|
||||
|
||||
**Route:** `/work` (+ Unterrouten `/work/today`, `/work/mine`, `/work/queue`)
|
||||
|
||||
**Abhängigkeit:** Task-Querschnitt braucht AP1.5d; MVP von 4.2 startet mit **Arbeitspaketen**, Tasks folgen ohne IA-Wechsel.
|
||||
|
||||
---
|
||||
|
||||
### 4.3 Planen — *Wie soll das Programm aufgebaut sein?*
|
||||
|
||||
**Leitfrage:** Struktur, Gates, Eingang — was ist geplant, noch nicht committet?
|
||||
|
||||
| Zone | Inhalt |
|
||||
|------|--------|
|
||||
| **Struktur** | Project-Baum (Container), optional flach |
|
||||
| **Zielzustände** | Gates / RoadmapItems, Kriterien, Abhängigkeiten |
|
||||
| **Eingang** | Backlog, Triage, Convert-to-Action |
|
||||
|
||||
Planen ist **scope-pflichtig auf mindestens ein Vorhaben** (Struktur hängt an Initiative). Portfolio-Scope zeigt **Planungs-Inbox**: „Vorhaben ohne Struktur“, „Gates ohne Kriterien“ — Einstieg, nicht Vollplanung.
|
||||
|
||||
**Nicht hier:** Tagesausführung, Blocker-Status aller APs, Team-Workload.
|
||||
|
||||
**Route:** `/plan` (+ `/plan/structure`, `/plan/gates`, `/plan/inbox`)
|
||||
|
||||
**Migration:** Heutige Tabs `plan`, `inbox` und Projektbaum aus `execution` **wandern hierher**.
|
||||
|
||||
---
|
||||
|
||||
### 4.4 Kontrolle — *Erreichen wir die Ziele? Was blockiert den Fortschritt?*
|
||||
|
||||
**Leitfrage:** Plan vs. Ist, Zielerreichung, Risiken, kritischer Pfad, Showstopper.
|
||||
|
||||
| Zone | Inhalt |
|
||||
|------|--------|
|
||||
| **Programm-Status** | Lifecycle, Snapshot, Signale (pro Scope) |
|
||||
| **Plan vs. Ist** | Gate-Beiträge, offene Kriterien, Journey |
|
||||
| **Roadblocker** | Blockierte APs, offene Blocker, Gates at risk |
|
||||
| **Kritischer Pfad** | Gate-Graph + Ist-Blocker (AP1.4d+, progressive) |
|
||||
|
||||
**Nicht hier:** Neue APs anlegen, Backlog triagieren.
|
||||
|
||||
**Route:** `/control` (+ `/control/status`, `/control/plan-ist`, `/control/journey`)
|
||||
|
||||
**Migration:** Teile von Initiative-Übersicht + Journey + Gate-Detail-Contributions.
|
||||
|
||||
---
|
||||
|
||||
### 4.5 Team — *Wer arbeitet an was?*
|
||||
|
||||
**Leitfrage:** Zuweisungen, Kapazität, Delegation.
|
||||
|
||||
| Inhalt | Quelle |
|
||||
|--------|--------|
|
||||
| Actor-Workload | `GET /api/workspace/actors/workload` |
|
||||
| Offene Zuweisungen ohne Fortschritt | Snapshot / Assignments |
|
||||
| Delegation (später) | Bulk-Zuweisung, Umhängen |
|
||||
|
||||
**Route:** `/team`
|
||||
|
||||
---
|
||||
|
||||
## 5. Vorhaben-Katalog — nicht der Arbeitsort
|
||||
|
||||
`/initiatives` wird **Katalog & Scope-Auswahl**, kein Omnibus:
|
||||
|
||||
- Liste / Suche aller Vorhaben
|
||||
- Anlegen neues Vorhaben
|
||||
- Klick setzt **Scope-Filter** und springt in sinnvollen Default-Modus (Cockpit scoped oder Kontrolle scoped) — **nicht** in verschachtelte Tab-Welt
|
||||
|
||||
**Abschaffen (Ziel):** Vorhaben als „App-in-App“ mit fünf Tabs, in denen alles passiert.
|
||||
|
||||
**Legacy-Redirects:** Alte URLs `/initiatives/:id/plan` → `/plan/gates?initiative=:id` etc. (siehe ADP AP1.9).
|
||||
|
||||
---
|
||||
|
||||
## 6. Direkte Objektnavigation (Deep Links)
|
||||
|
||||
### 6.1 Stabile Objekt-Routen (first-class)
|
||||
|
||||
Diese URLs funktionieren **ohne** vorherigen Modus- oder Scope-Schritt. Sie sind sharebar, bookmarkbar, Agent-Ziele.
|
||||
|
||||
| Objekt | Route (Ziel) | Modus (Sidebar) | Scope (auto) |
|
||||
|--------|--------------|-----------------|--------------|
|
||||
| **Arbeitspaket** | `/actions/:actionId` | Ausführen | Initiative + Project aus AP |
|
||||
| **Task** (AP1.5d) | `/tasks/:taskId` | Ausführen | über Action → Initiative |
|
||||
| **Projekt** | `/projects/:projectId` | Planen | Initiative + Project |
|
||||
| **Gate** | `/gates/:gateId` | Planen (Detail) / Kontrolle (Ist) | Initiative |
|
||||
| **Vorhaben** | `/initiatives/:id` | Kontrolle (Status-Home scoped) | Initiative |
|
||||
| **Backlog-Item** | `/backlog/:id` | Planen → Inbox | Initiative |
|
||||
|
||||
**Bestehende Route** `/initiatives/:id/actions/:actionId` → Redirect auf `/actions/:actionId` (kanonische URL).
|
||||
|
||||
API-IDs sind global im Tenant — Pfad **ohne** `/initiatives/:id/...`-Präfix ist gewollt (kürzer, agentenfreundlich).
|
||||
|
||||
### 6.2 Verhalten beim Direktsprung
|
||||
|
||||
```text
|
||||
Nutzer öffnet /actions/abc-123
|
||||
│
|
||||
▼
|
||||
GET /api/actions/abc-123
|
||||
│
|
||||
├── Scope: initiative_id, project_id gesetzt
|
||||
├── Sidebar: „Ausführen“ aktiv
|
||||
├── Breadcrumb: Ausführen › {Vorhaben} › {AP-Titel}
|
||||
└── Inhalt: AP-Detail (wie heute ActionDetailPage)
|
||||
```
|
||||
|
||||
**Zurück-Navigation:** „Zur Queue“ → `/work/mine?initiative=` (Scope bleibt), nicht in Tab-Hölle.
|
||||
|
||||
### 6.3 Schnellzugriff (App-Chrome)
|
||||
|
||||
Neben Modus-Nav braucht es **Sprung-Hilfen** — unabhängig vom Modus:
|
||||
|
||||
| Element | Funktion | Phase |
|
||||
|---------|----------|-------|
|
||||
| **Springen zu…** (Suche) | Titel/ID: AP, Projekt, Gate, Vorhaben | AP1.9a minimal (Liste), 9f Volltext |
|
||||
| **Zuletzt geöffnet** | 5–10 Objekte | AP1.9a |
|
||||
| **Angepinnt** (optional) | PM pinnt laufende APs/Projekte | AP1.9b+ |
|
||||
| Links aus Widgets | Next Action, Attention, Queue → Objekt-Route | AP1.9b |
|
||||
|
||||
```text
|
||||
┌──────────┬──────────────────────────────────────────────────┐
|
||||
│ … │ [ 🔍 Springen zu… ] Scope: Portfolio ▼ │
|
||||
│ Cockpit ├──────────────────────────────────────────────────┤
|
||||
```
|
||||
|
||||
Command Palette (⌘K) ist **optional später** — MVP: Suchfeld mit Typ-Ahead über offene APs/Projekte/Vorhaben.
|
||||
|
||||
### 6.4 Zwei Wege zum gleichen AP (beide gültig)
|
||||
|
||||
| Weg | Nutzen |
|
||||
|-----|--------|
|
||||
| **Querschnitt** | `/work/heute` → Liste → Klick | „Was ist überall dran?“ |
|
||||
| **Direkt** | `/actions/:id` oder Suche | „Ich weiß schon, welches AP“ |
|
||||
|
||||
Das ist kein Widerspruch zu Modus-Nav — **Modi listen auf, Objekt-Routen fokussieren**.
|
||||
|
||||
---
|
||||
|
||||
## 7. Scope-Selector (globale Komponente)
|
||||
|
||||
Im **App-Chrome** (Sidebar-Header / Mobile-Header), in allen Modi sichtbar:
|
||||
|
||||
```text
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ Scope: [ Portfolio ▼ ] > [ optional ] │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
| Scope | Filterwirkung |
|
||||
|-------|----------------|
|
||||
| **Portfolio** | Alle Initiativen im Tenant |
|
||||
| **Vorhaben** | Eine Initiative (+ implizit deren Projekte/APs) |
|
||||
| **Projekt** | Subtree eines Blatt-/Container-Projects |
|
||||
|
||||
Scope wird in URL codiert: Query `?initiative=&project=` auf Modus-Listen; **Objekt-Routen** brauchen keinen Query (Scope aus Objekt). Bei Wechsel Scope → Modus-Liste aktualisieren; bei Objekt-Route Scope read-only anzeigen (änderbar über Scope-Dropdown → navigiert zur scoped Modus-Liste).
|
||||
|
||||
---
|
||||
|
||||
## 8. Routen-Zielbild (v0.1)
|
||||
|
||||
```text
|
||||
── Modus-Listen (Querschnitt / scoped) ──
|
||||
/cockpit Portfolio-Cockpit
|
||||
/cockpit?initiative=:id Programm-Cockpit (scoped)
|
||||
|
||||
/work Ausführen — Default: Heute
|
||||
/work/mine Meine Queue (APs → später Tasks)
|
||||
/work/today Heute (überfällig, Next Action)
|
||||
/work?initiative=:id Queue scoped
|
||||
|
||||
/plan/structure?initiative=:id Project-Baum
|
||||
/plan/gates?initiative=:id Zielzustände
|
||||
/plan/inbox?initiative=:id Backlog / Triage
|
||||
|
||||
/control/status?initiative=:id Lifecycle, Snapshot
|
||||
/control/plan-ist?initiative=:id Gate-Beiträge
|
||||
/control/journey?initiative=:id Timeline
|
||||
|
||||
/team Workload & Zuweisungen
|
||||
|
||||
/initiatives Katalog
|
||||
/initiatives/new Anlage
|
||||
|
||||
── Objekt-Routen (Direktsprung, Scope auto) ──
|
||||
/actions/:actionId Arbeitspaket-Detail ★
|
||||
/tasks/:taskId Task-Detail (AP1.5d)
|
||||
/projects/:projectId Projekt-Detail ★
|
||||
/gates/:gateId Gate-Detail
|
||||
/backlog/:backlogId Backlog-Detail
|
||||
/initiatives/:id Vorhaben-Status (Kontrolle scoped)
|
||||
|
||||
── Legacy-Redirects ──
|
||||
/initiatives/:id/actions/:aid → /actions/:aid
|
||||
/initiatives/:id/execution/projects/:pid → /projects/:pid
|
||||
/initiatives/:id/plan/items/:gid → /gates/:gid
|
||||
```
|
||||
|
||||
★ = häufigste Direktsprünge für PM im Alltag.
|
||||
|
||||
**Objekt-Details** sind **keine Unterseiten eines Vorhabens** — sie sind tenant-globale Routen mit automatischem Kontext.
|
||||
|
||||
---
|
||||
|
||||
## 9. Screen-Matrix (PM Use Cases → Modus)
|
||||
|
||||
| PM Use Case | Primärer Modus | Sekundär |
|
||||
|-------------|----------------|----------|
|
||||
| Programm/Vorhaben strukturieren | **Planen** → Struktur | Planen → Gates |
|
||||
| Meilensteine / Gates planen | **Planen** → Gates | Kontrolle (Ist-Beitrag lesen) |
|
||||
| Roadmap / Abhängigkeiten | **Planen** → Gates | AP1.4d Graph |
|
||||
| Sprint / nächste APs planen | **Planen** → Inbox + Struktur | Ausführen (Queue) |
|
||||
| Konkrete nächste Schritte tun | **Ausführen** | Cockpit (Next Action) |
|
||||
| Status innerhalb AP | **Ausführen** → Detail | — |
|
||||
| Gesamtfortschritt / Zielerreichung | **Kontrolle** | Cockpit |
|
||||
| Risiken / Showstopper | **Kontrolle** + Cockpit Attention | — |
|
||||
| Kritischer Pfad | **Kontrolle** (später Graph) | — |
|
||||
| Wer arbeitet an was | **Team** | Ausführen (Filter Actor) |
|
||||
| Nächsten besten Schritt | **Cockpit** + **Ausführen/Heute** | Steering API |
|
||||
| Beauftragung / Delegation | **Team** | AP-Detail |
|
||||
| Direkt zu AP / Projekt springen | **Objekt-Route** `/actions/:id`, `/projects/:id` | Suche, Zuletzt |
|
||||
| Alle Tasks quer (alle Projekte) | **Ausführen** → Queue | AP1.5d Tasks |
|
||||
|
||||
---
|
||||
|
||||
## 10. Layout-Anatomie (Wireframe)
|
||||
|
||||
### 10.1 App-Shell (Desktop)
|
||||
|
||||
```text
|
||||
┌──────────┬──────────────────────────────────────────────────┐
|
||||
│ Kairo │ [ Springen zu… ] Scope: Portfolio ▼ │
|
||||
│ ├──────────────────────────────────────────────────┤
|
||||
│ Cockpit │ MODUS- oder OBJEKT-INHALT │
|
||||
│ Ausführen│ (Liste/Übersicht ODER AP/Projekt-Detail) │
|
||||
│ Planen │ │
|
||||
│ Kontrolle│ Breadcrumb: Ausführen › Vorhaben › AP-Titel │
|
||||
│ Team │ │
|
||||
│──────────│ Zuletzt: AP Auth · Projekt Phase 2 · … │
|
||||
│ Vorhaben │ │
|
||||
│ User │ │
|
||||
└──────────┴──────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 10.2 Mobile
|
||||
|
||||
- Bottom-Nav: **Cockpit | Ausführen | Planen | Mehr** (Kontrolle + Team unter „Mehr“)
|
||||
- Scope-Selector im Header
|
||||
|
||||
### 10.3 Anti-Pattern (ab AP1.9 verboten)
|
||||
|
||||
```text
|
||||
✗ InitiativeExecutionPage = Projektbaum + AP-Hub + Blocker + Inline-Forms
|
||||
✗ Tab „Ausführung“ als Müllhalde für Planung und Ist
|
||||
✗ Querschnitt nur als kleines Widget ohne eigene Fläche
|
||||
✗ AP-Detail nur unter /initiatives/:id/actions/:id erreichbar (kein /actions/:id)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. Daten & API — Modus-Map (keine Parallel-Logik)
|
||||
|
||||
| Modus | Read Models / APIs |
|
||||
|-------|---------------------|
|
||||
| Cockpit | `workspace/*`, `attention`, `next-actions`, Initiative-Liste |
|
||||
| Ausführen | `workspace/actions/*`, `actions/me/open`, Tasks (AP1.5d) |
|
||||
| Planen | `projects`, `roadmap/*`, `backlog/*` |
|
||||
| Kontrolle | `steering-snapshot`, `journey`, `plan-ist` contributions |
|
||||
| Team | `actors`, `workspace/actors/workload`, Assignments |
|
||||
|
||||
Alles weiter über `TenantContext` + Capabilities — Modus ist **pure IA**, keine neue Domäne.
|
||||
|
||||
---
|
||||
|
||||
## 12. Migrationsplan — vom Ist zum Zielbild
|
||||
|
||||
| Heute | Ziel | Phase |
|
||||
|-------|------|-------|
|
||||
| `/workspace` Widget-Grid | `/cockpit` strukturierte Flächen | 9b |
|
||||
| `/my-actions` | `/work/mine` | 9b |
|
||||
| `/initiatives/:id` Steuerung | `/control/status?initiative=` | 9c |
|
||||
| Tab Plan | `/plan/gates?initiative=` | 9d |
|
||||
| Tab Eingang | `/plan/inbox?initiative=` | 9d |
|
||||
| Tab Ausführung (Stack) | `/work?initiative=` + AP-Detail | 9c |
|
||||
| Tab Journey | `/control/journey?initiative=` | 9c |
|
||||
| Projekt-Detail unter execution | `/projects/:projectId` | 9d |
|
||||
| AP-Detail nested unter initiative | `/actions/:actionId` (kanonisch) | 9a |
|
||||
| `InitiativeSubNav` Tabs | **Entfernen** — Modus-Nav global | 9a |
|
||||
|
||||
Redirects mindestens **6 Monate** oder bis PO schließt.
|
||||
|
||||
---
|
||||
|
||||
## 13. Umsetzungspakete (Roadmap)
|
||||
|
||||
| Paket | Ergebnis | Nutzen für PM |
|
||||
|-------|----------|----------------|
|
||||
| **AP1.9a** | App-Shell, Modi-Routen, **Objekt-Routen**, Scope-Provider, Springen-zu (minimal), Redirects | Navigation + Direktsprung |
|
||||
| **AP1.9b** | Cockpit + Ausführen/Heute (AP-Querschnitt) | Täglicher Einstieg |
|
||||
| **AP1.9c** | Kontrolle (Snapshot, Journey, Plan-Ist) | Status & Zielerreichung |
|
||||
| **AP1.9d** | Planen (Struktur, Gates, Inbox) | Planung ausgelagert |
|
||||
| **AP1.9e** | Team + Delegation-Grundlagen | Wer macht was |
|
||||
| **AP1.5d** | Tasks in Ausführen-Queue | Feingranulare Querschnittsliste |
|
||||
| **AP1.8** | Portfolio-Priorität im Cockpit | Welches Vorhaben zuerst |
|
||||
|
||||
**Kein weiteres AP1.5x-UI-Patch** auf `InitiativeExecutionPage` außer Hotfixes bis AP1.9a live ist.
|
||||
|
||||
---
|
||||
|
||||
## 14. MVP-Nutzbarkeit (neu formuliert)
|
||||
|
||||
Kairos Frontend ist **für Programmmanager nutzbar**, wenn:
|
||||
|
||||
1. **Ausführen/Heute** in ≤30s die nächste Arbeit **portfolio-weit** zeigt
|
||||
2. **Cockpit** in ≤30s zeigt, welches Vorhaben Aufmerksamkeit braucht
|
||||
3. **Planen** und **Ausführen** ohne gemeinsame Seite erreichbar sind
|
||||
4. **Kontrolle** Plan vs. Ist und Blocker **ohne CRUD-Listen** aggregiert
|
||||
5. Scope-Wechsel von Portfolio → Vorhaben **ohne Modus-Wechsel** funktioniert
|
||||
6. Agent-API kann dieselben aggregierten Read Models ansprechen (Vorbereitung AP1.7)
|
||||
7. **Direktsprung** auf AP/Projekt per URL oder Suche — Scope korrekt gesetzt
|
||||
|
||||
---
|
||||
|
||||
## 15. Offene PO-Entscheide (vor AP1.9a Code)
|
||||
|
||||
| # | Frage | Empfehlung |
|
||||
|---|-------|------------|
|
||||
| 1 | URL-Scope: Query vs. Pfad | Query `?initiative=` + Context |
|
||||
| 2 | Default nach Vorhaben-Klick | Cockpit scoped |
|
||||
| 3 | `/workspace` Redirect | Ja → `/cockpit` |
|
||||
| 4 | Tab-InitiativeSubNav entfernen | Ja, mit Redirects |
|
||||
| 5 | Planen ohne Scope | Inbox leer + CTA „Vorhaben wählen“ |
|
||||
| 6 | Kanonische AP-URL | `/actions/:id` (Redirect von nested) |
|
||||
| 7 | Kanonische Projekt-URL | `/projects/:id` |
|
||||
|
||||
---
|
||||
|
||||
## 16. Referenzen
|
||||
|
||||
- `Kairo_Vision_and_Product_Direction_v0.2.md` §7
|
||||
- `Kairo_Canonical_Operating_Model_v0.2.md` §8
|
||||
- `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`
|
||||
- `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md` (Scope Lock)
|
||||
- `Kairo_Implementation_Truth_Table_v0.1.md` (wird mit AP1.9 aktualisiert)
|
||||
|
||||
---
|
||||
|
||||
*Dieses Dokument ist das führende UI-Zielbild ab 2026-07-08 bis PO-Freigabe oder v0.2. Implementierung ohne Alignment hier → Principle Gate.*
|
||||
Reference in new issue
Block a user