# AP1.2c — IA-Skeleton (Workspace, Initiative-Übersicht, Unterseiten)
## Implementierungsauftrag v0.1

**Status:** bereit zur Umsetzung (nach DOC Welle 2)  
**Stand:** 2026-07-05  
**Vision:** `Kairo_Vision_and_Product_Direction_v0.2.md` §7  
**Recovery:** `Kairo_MVP_Usability_Recovery_Plan_v0.2.md`  
**Vorgänger:** AP1.1b ✓ (Redirect-Ziel)  
**Zielversion:** `0.12.0-ap1.2c` · **kein** Schema-Change

---

## Ziel

**Informationsarchitektur umsetzen** — ohne neues Fachmodell:

- Workspace = Portfolio aller Initiativen  
- Initiative-Übersicht = operative Steuerung (read-heavy)  
- Unterseiten = Pflege (bestehende Sektionen **verschieben**, nicht duplizieren)  
- Next-Action-Widget konfigurierbar auf Workspace **und** Initiative-Übersicht  

---

## Scope Lock

- **Keine** neuen Tabellen  
- **Keine** RoadmapItem / Gate-Logik  
- **Keine** Portfolio-Priorität (AP1.8)  
- **Keine** `/api/operational/` (AP1.7)  
- Steering nur bestehende APIs  

---

## Teil A — Routing (React Router)

Neue Routen:

```text
/                                   Workspace (überarbeiten)
/initiatives/:id                    InitiativeOverviewPage (neu)
/initiatives/:id/plan               InitiativePlanPage (Shell + MilestonesSection verschoben)
/initiatives/:id/execution          InitiativeExecutionPage (ActionsHub)
/initiatives/:id/inbox              InitiativeInboxPage (BacklogSection)
/initiatives/:id/journey            InitiativeJourneyPage (Shell: Decisions/Reviews read)
/actions/:id                        ActionDetailPage (Modal-Alternative: volle Seite)
```

Redirect:

```text
/initiatives/:id/detail  →  /initiatives/:id   (falls alte Links)
```

Alte `InitiativeDetailPage` → deprecate; Inhalt auf neue Pages **verteilen**.

---

## Teil B — Workspace (Portfolio)

### B1 — Initiative-Portfolio-Widget

- Kacheln oder kompakte Liste **aller** Initiativen des Tenants  
- Pro Karte: Titel, Lifecycle-Badge, Method-Label, Kurzsignal (blockiert count, attention)  
- Klick → `/initiatives/:id`  
- Daten: bestehende `listInitiatives` + optional Snapshot-Summary (light endpoint oder parallel fetch — **kein** neues Backend nötig wenn Client parallel 5 Snapshots vermeidet: nur Initiative-Felder + counts aus workspace summary erweitern wenn nötig)

### B2 — Next-Action-Widget (Workspace-Instanz)

- Wiederverwendbare Komponente `NextActionWidget`  
- Props: `scope: 'portfolio' | 'initiative'`, `initiativeId?`, `limit`, `filters`  
- Portfolio: `/api/workspace/next-actions`  
- Initiative: Snapshot `next_actions` oder Initiative-scoped API  

### B3 — Layout-Registry

- Widget konfigurierbar in Workspace-Layout (bestehende View/Widget Registry AP0.6 erweitern — minimal: feste Slots wenn Registry zu schwer)

---

## Teil C — Initiative-Übersicht (read-heavy)

Neue `InitiativeOverviewPage`:

| Block | Quelle | Bearbeitung |
|-------|--------|-------------|
| Breadcrumb + Titel | initiative | — |
| Steering Hero | SteeringSnapshotPanel (read) | Methode wählen ✓ |
| Next-Action-Widget | scope=initiative | — |
| Roadblocker-Zusammenfassung | snapshot counts | Link → execution |
| Meilenstein-Horizont | snapshot | Link → plan |
| Nav-Karten | — | Links zu Unterseiten |

**Keine** Backlog/Blocker/Evidence-Listen inline. **Keine** Create-Formulare.

---

## Teil D — Unterseiten (Pflege verschieben)

| Page | Inhalt (aus InitiativeDetailPage) |
|------|-----------------------------------|
| Plan | `MilestonesSection` (+ später Roadmap) |
| Execution | `InitiativeActionsHub` |
| Inbox | `BacklogSection` |
| Journey | Shell + `DecisionsSection`, `ReviewsSection` read; Recurring optional |

Blockers/Evidence: primär am **ActionDetailPage**; vorhabenweite Blocker in Execution oder Inbox Sub-Sektion.

---

## Teil E — Action Detail

- Route `/actions/:id` oder `/initiatives/:id/actions/:actionId`  
- ActionHubCard-Inhalt + volle Bearbeitung (ActionForm)  
- Verknüpfte Blocker/Evidence/Reviews CRUD  

---

## Teil F — Shared Components

- `NextActionWidget.jsx`  
- `InitiativeNavTabs.jsx` oder Subnav  
- `InitiativePortfolioGrid.jsx`  
- CSS: bestehende steering/action-hub Styles  

---

## Teil G — Tests

- Frontend: Smoke-Routes rendern (vitest optional minimal)  
- Backend: keine Pflicht (kein Schema)  
- Manuell: Navigation Workspace → Initiative → Plan → Execution  

---

## Akzeptanzkriterien

- [ ] Workspace zeigt **alle** Initiativen als Portfolio  
- [ ] Initiative-Übersicht ohne CRUD-Listen (nur Steuerung + Links)  
- [ ] Next-Action-Widget auf Workspace **und** Initiative-Übersicht  
- [ ] Unterseiten erreichbar; Pflege funktioniert dort  
- [ ] Alte Omnibus-URL redirected oder ersetzt  
- [ ] Version `0.12.0-ap1.2c`  
- [ ] Truth Table aktualisiert  

---

## Nicht-Scope

- RoadmapItem  
- Portfolio-Priorität Feld  
- Journey-Timeline visual  
- Agent API  
- operating_phase (→ AP1.2)  

---

## Empfohlene Reihenfolge Implementierung

1. Routing + leere Shell-Pages  
2. InitiativeOverviewPage (Snapshot + Next Action)  
3. Execution/Inbox/Plan (Sektionen verschieben)  
4. Workspace Portfolio  
5. NextActionWidget extrahieren  
6. ActionDetailPage  
7. Redirect + alte Page entfernen  

---

*Parallel empfohlen: AP1.2 (operating_phase entfernen) — kleiner Backend-PR vor oder nach 2c.*