init

app/api/routes_instructions.py

@@ -0,0 +1,72 @@
+"""
+app/api/routes_instructions.py
+HTTP endpoints for instruction CRUD.
+"""
+
+from __future__ import annotations
+
+import logging
+
+from fastapi import APIRouter, HTTPException, Query
+from fastapi.responses import Response
+
+from app.models import (
+    CreateInstructionRequest,
+    InstructionCreateResponse,
+    InstructionListResponse,
+    UpdateInstructionRequest,
+)
+from app.services import event_service, instruction_service
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/api/instructions", tags=["instructions"])
+
+
+@router.get("", response_model=InstructionListResponse)
+def list_instructions(
+    status: str = Query(default="all", pattern="^(pending|consumed|all)$")
+):
+    items = instruction_service.list_instructions(status_filter=status)
+    return InstructionListResponse(items=items)
+
+
+@router.post("", response_model=InstructionCreateResponse, status_code=201)
+def create_instruction(body: CreateInstructionRequest):
+    item = instruction_service.create_instruction(body.content)
+    event_service.broadcast(
+        "instruction.created",
+        {"item": item.model_dump(mode="json")},
+    )
+    return InstructionCreateResponse(item=item)
+
+
+@router.patch("/{instruction_id}", response_model=InstructionCreateResponse)
+def update_instruction(instruction_id: str, body: UpdateInstructionRequest):
+    try:
+        item = instruction_service.update_instruction(instruction_id, body.content)
+    except KeyError:
+        raise HTTPException(status_code=404, detail="Instruction not found")
+    except PermissionError as exc:
+        raise HTTPException(status_code=409, detail=str(exc))
+
+    event_service.broadcast(
+        "instruction.updated",
+        {"item": item.model_dump(mode="json")},
+    )
+    return InstructionCreateResponse(item=item)
+
+
+@router.delete("/{instruction_id}", status_code=204)
+def delete_instruction(instruction_id: str):
+    try:
+        instruction_service.delete_instruction(instruction_id)
+    except KeyError:
+        raise HTTPException(status_code=404, detail="Instruction not found")
+    except PermissionError as exc:
+        raise HTTPException(status_code=409, detail=str(exc))
+
+    event_service.broadcast("instruction.deleted", {"id": instruction_id})
+    return Response(status_code=204)
+
+