Lars/Kairo-Jinkendo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
Kairo-Jinkendo/docs/sprints/Sprint0_AP0_1_Project_Setup_Assignment_v0.1.md
Lars 1ce20d8bdb
Some checks failed
Test Suite / playwright-tests (push) Waiting to run
Details
Deploy Development / deploy (push) Failing after 0s
Details
Test Suite / pytest-backend (push) Failing after 5m1s
Details
Test Suite / lint-backend (push) Failing after 0s
Details
Test Suite / build-frontend (push) Successful in 0s
Details
Test Suite / k6 /api/health Baseline (push) Has been cancelled
Details
Sprint-0-Spezifikationen ergaenzen, AP0.1-Setup-Luecken schliessen (Health, CI, ADR-Vorlage). 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-04 19:08:55 +02:00

2.5 KiB
Raw Permalink Blame History

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:

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:

backend/migrations/

Namensschema:

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:

GET /api/health

Antwortbeispiel:

{
  "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:

## Umgesetzt

## Tests

## Lokaler Start

## Offene Fragen

## Abweichungen von der Spezifikation

## Empfehlung für AP0.2