Kairo-Jinkendo/docs/sprints/Sprint0_AP0_1_Project_Setup_Assignment_v0.1.md

# Jinkendo Kairo
## Sprint 0 – AP0.1 Projektgrundlage v0.1

Status: erster ausführbarer Coding-Auftrag  
Stand: 2026-07-04

---

## 1. Auftrag

Erstelle die technische Projektgrundlage für Jinkendo Kairo.

AP0.1 baut noch keine fachliche Kairo-Domäne.

Ziel ist ein lauffähiges, testbares, migrationsfähiges Grundgerüst.

---

## 2. Verbindliche Leitplanken

Vor Umsetzung lesen:

- `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
- `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
- `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
- `CLAUDE.md`
- `.cursor/rules/kairo-architecture.mdc`

---

## 3. Scope AP0.1

Erstelle:

```text
backend/
frontend/ optional minimal
infra/
scripts/
tests/
```

Mindestumfang:

- Backend-Skeleton
- FastAPI-App oder begründete Alternative
- Health Endpoint
- PostgreSQL-Anbindung
- Docker Compose lokal
- Migrationsverzeichnis
- Migration Runner
- `schema_migrations` Tracking
- erste Migration `001_init_core.sql`
- Testbasis
- README-Abschnitt „Local Development“

---

## 4. Nicht-Scope AP0.1

Nicht implementieren:

- Tenant/User/Actor-Fachlogik über minimale Schema-Vorbereitung hinaus
- vollständige Auth
- Prompt Engine
- Feature Registry
- Capability Registry
- Vorhaben
- Projekte
- Maßnahmen
- Backlog
- MCP
- Billing
- UI-Komplexität

---

## 5. Migrationsanforderungen

Migrationen liegen unter:

```text
backend/migrations/
```

Namensschema:

```text
001_init_core.sql
002_*.sql
003_*.sql
```

Pflicht:

- `schema_migrations` Tracking
- lexikographische Ausführung
- bereits ausgeführte Migrationen überspringen
- Fehler blockiert App-Start oder Setup-Command
- keine ad-hoc DDL in Routern

---

## 6. Health Endpoint

Mindestendpoint:

```text
GET /api/health
```

Antwortbeispiel:

```json
{
  "status": "ok",
  "app": "jinkendo-kairo",
  "db": "ok"
}
```

---

## 7. Tests

Mindestens:

- App importierbar
- Health Endpoint antwortet
- Migration Runner erkennt Migrationen
- Migration Runner trägt ausgeführte Migration ein
- wiederholter Migration Run ist idempotent

---

## 8. Akzeptanzkriterien

AP0.1 ist abgeschlossen, wenn:

- Projekt lokal startbar ist.
- Datenbank lokal startbar ist.
- Migrationen laufen.
- Health Endpoint funktioniert.
- Tests laufen.
- README beschreibt Setup.
- Keine fachliche Sprint-1-Logik wurde vorgezogen.
- Offene technische Entscheidungen sind dokumentiert.

---

## 9. Erwarteter Abschlussbericht

Der Coding-Agent liefert am Ende:

```markdown
## Umgesetzt

## Tests

## Lokaler Start

## Offene Fragen

## Abweichungen von der Spezifikation

## Empfehlung für AP0.2
```