# AP0.5 – Abschlussbericht Minimaler Vorhaben- und Maßnahmen-Slice

**Status:** implementiert  
**Stand:** 2026-07-04  
**Version:** `0.5.0-ap0.5` · Schema `006`

---

## 1. Scope und Einordnung

AP0.5 liefert den **ersten fachlich nutzbaren Kairo-Slice**: Ein angemeldeter Actor kann innerhalb eines Tenants Vorhaben und Maßnahmen verwalten, zuweisen und seinen offenen Maßnahmen-Backlog abrufen.

| Anforderung (AP0.5) | Status |
|---------------------|--------|
| Migration `006` (initiatives, actions, action_assignments) | ✓ |
| Tenant-Bezug für alle Objekte | ✓ |
| Owner Actor für Initiative | ✓ |
| Action gehört zu Initiative | ✓ |
| Action → ein oder mehrere Actors (Assignments) | ✓ |
| CRUD-Minimum Initiatives | ✓ |
| CRUD-Minimum Actions | ✓ |
| Endpoint „Meine offenen Maßnahmen“ | ✓ |
| Statusmodell minimal | ✓ |
| Priority minimal | ✓ |
| Capability-Gates (4 neue Capabilities) | ✓ |
| Audit bei Create/Update/Statuswechsel | ✓ |
| Tests (Isolation, CRUD, Assignment, Status) | ✓ |
| README/API-Doku | ✓ |

**Bewusst nicht in AP0.5:** Projects, Milestones, Programs, Reviews, Evidence, Blocker-Objekte, KI/Prompt-Erweiterung, MCP, automatische Priorisierung, komplexe UI, Workflow Engine.

---

## 2. Umgesetzte Dateien

### 2.1 Migration & Schema

| Datei | Zweck |
|-------|--------|
| `backend/migrations/006_initiatives_actions.sql` | Tabellen initiatives, actions, action_assignments |

### 2.2 Services

| Datei | Zweck |
|-------|--------|
| `backend/services/initiatives.py` | Vorhaben-CRUD, Validierung, Audit |
| `backend/services/actions.py` | Maßnahmen-CRUD, Assignments, offene Maßnahmen |

### 2.3 API & Capabilities

| Datei | Zweck |
|-------|--------|
| `backend/routers/initiatives.py` | Initiative-Endpoints + nested Action-Create/List |
| `backend/routers/actions.py` | Action-Endpoints + `/me/open` |
| `backend/rights_registrations/initiative_ops.py` | 4 AP0.5-Capabilities |
| `backend/rights_registrations/__init__.py` | Import initiative_ops |
| `backend/main.py` | Router-Registrierung |
| `backend/version.py` | `0.5.0-ap0.5`, Schema `006` |

### 2.4 Tests & Doku

| Datei | Zweck |
|-------|--------|
| `backend/tests/test_initiatives_actions.py` | CRUD, Isolation, Assignment, Status, Audit |
| `backend/tests/test_migrations.py` | Migration 006 |
| `backend/tests/test_rights_registry.py` | 16 Capabilities |
| `README.md` | API-Doku AP0.5 |
| `frontend/src/App.jsx` | Header AP0.5 |

---

## 3. Neue Migrationen

**`006_initiatives_actions.sql`**

| Tabelle | Zweck |
|---------|--------|
| `initiatives` | Vorhaben (tenant-scoped, owner_actor_id) |
| `actions` | Maßnahmen (gehört zu initiative) |
| `action_assignments` | Actor-Zuweisungen (n:m) |

---

## 4. Datenmodell

```
tenants
    └── initiatives
            id, tenant_id, title, goal, status, priority
            owner_actor_id → actors
        └── actions
                id, tenant_id, initiative_id, title, description
                status, priority
            └── action_assignments
                    id, tenant_id, action_id, actor_id
                    UNIQUE (action_id, actor_id)
```

---

## 5. Endpoints

Siehe `README.md` — Abschnitt AP0.5.

---

## 6. Statusmodell

**Initiative:** `active` · `paused` · `completed` · `archived`

**Action:** `open` · `in_progress` · `blocked` · `done` · `discarded`

**Priorität:** `low` · `normal` · `high`

Offene Maßnahmen: Status ∈ `{open, in_progress, blocked}` und zugewiesen an `ctx.actor_id`.

---

## 7. Assignment-Modell

n:m über `action_assignments`; `PUT /api/actions/{id}/assignments` ersetzt die Liste; Validierung gegen Tenant-Actors.

---

## 8. Capability-Nutzung

`kairo.initiative.read/manage` · `kairo.action.read/manage` — Grants für tenant owner/admin/member.

---

## 9. Tenant-Isolation

Alle Queries tenant-scoped; Cross-Tenant → 404/400; Tests in `test_initiatives_actions.py`.

---

## 10. Tests

11 Tests in `test_initiatives_actions.py` + aktualisierte Registry/Migration-Tests.

Ausführung (Dev-Stack):

```bash
docker compose -f docker-compose.dev-env.yml exec backend python -m pytest tests -ra -vv
```

---

## 11. Empfehlung nächster kleinster Slice

**AP0.6 – Kommentare pro Maßnahme** (`action_comments`, read/manage Capability, minimal Audit) — operativer Mehrwert ohne Projects/Milestones/KI.