72 lines
2.4 KiB
Markdown
72 lines
2.4 KiB
Markdown
# 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: 1–4)
|
||
- [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: 1–5)
|
||
|
||
## 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`
|