Changes before error encountered

Co-authored-by: Kenearos <86194771+Kenearos@users.noreply.github.com>
This commit is contained in:
copilot-swe-agent[bot] 2026-03-12 15:00:09 +00:00
parent 3be3cb73b6
commit d4cfb34423
17 changed files with 1128 additions and 0 deletions

View file

@ -0,0 +1,72 @@
# Story 2.6: FastAPI-Run-Endpunkte implementieren
<!-- 🏃 Prepared by BMAD SM Skill — Agent: Bob (Scrum Master) -->
<!-- Skill Command: /bmad-agent-bmm-sm → [CS] Context Story -->
Status: done
## Story
Als **API-Nutzer**,
möchte ich **`POST /api/councils/run` und `GET /api/councils/run/{run_id}`**,
so dass ich **einen Council-Run starten und sein Ergebnis abrufen kann**.
## Acceptance Criteria
1. `POST /api/councils/run``202 Accepted` mit `run_id`, asynchroner Hintergrundausführung
2. `GET /api/councils/run/{run_id}``status`, `final_draft` bei abgeschlossenem Run
3. Unbekannte `run_id``404 Not Found`
4. Leeres `input_topic` → Validierungsfehler (422)
5. `GET /api/health``{"status": "ok", "service": "CouncilOS API"}`
6. FastAPI-App registriert alle Router unter `/api`-Prefix
## Tasks / Subtasks
- [x] Task 1: `api/routes.py` mit Run-Endpunkten (AC: 14)
- [x] Subtask 1.1: `CouncilRunRequest` Pydantic-Modell
- [x] Subtask 1.2: `POST /councils/run` mit `BackgroundTasks`
- [x] Subtask 1.3: `GET /councils/run/{run_id}` mit `run_store.get()`
- [x] Subtask 1.4: `GET /health` (AC: 5)
- [x] Task 2: `api/run_store.py` In-Memory-Run-Store (AC: 2, 3)
- [x] Task 3: `main.py` FastAPI-Entrypoint (AC: 6)
- [x] Subtask 3.1: Router-Registrierung mit `/api` Prefix
- [x] Subtask 3.2: CORS-Middleware
- [x] Task 4: Unit-Tests für alle Endpunkte (AC: 15)
## Dev Notes
- `BackgroundTasks.add_task()` für nicht-blockierende LangGraph-Ausführung
- `run_store.create(run_id, input_topic)` → status: "pending"
- Test-Setup: `AsyncClient(app=app)` via `httpx` ohne echten LangGraph-Lauf
### Project Structure Notes
- `backend/api/routes.py`
- `backend/api/run_store.py`
- `backend/main.py`
- `backend/tests/test_api.py`
### References
- [Source: _bmad-output/planning-artifacts/architecture.md#REST-Endpunkte]
- [Source: _bmad-output/planning-artifacts/architecture.md#ADR-002]
## Dev Agent Record
### Agent Model Used
Amelia (💻 BMAD Dev Agent)
### Completion Notes List
- `run_store` ist ein einfaches `dict` mit Thread-Safe-Operationen (GIL ausreichend für MVP).
- `BackgroundTasks` erlaubt sofortige `202`-Antwort ohne auf LangGraph zu warten.
- CORS: `allow_origins=["*"]` für lokale Entwicklung; in Produktion einschränken.
### File List
- `backend/api/__init__.py`
- `backend/api/routes.py`
- `backend/api/run_store.py`
- `backend/main.py`
- `backend/tests/test_api.py`