feat: add repair timeline read APIs

backend/app/repairs/router.py

@@ -11,19 +11,27 @@ from app.repairs.exceptions import (
     RepairActorRequired,
     RepairConflict,
     RepairMinerNotFound,
+    RepairNotFound,
+)
+from app.repairs.models import (
+    BeginRepairRequest,
+    BeginRepairResponse,
+    RepairDetailResponse,
+    RepairTimelineResponse,
 )
-from app.repairs.models import BeginRepairRequest, BeginRepairResponse
 from app.repairs.service import RepairService
 
 
 router = APIRouter(prefix="/api/repairs", tags=["repairs"])
 require_repair_create = require_permission("repairs.create")
+require_repair_read = require_permission("repairs.read")
 
 RepairServiceDependency = Annotated[
     RepairService,
     Depends(get_repair_service),
 ]
 RepairCreateUser = Annotated[dict, Depends(require_repair_create)]
+RepairReadUser = Annotated[dict, Depends(require_repair_read)]
 
 
 @router.post(
@@ -58,3 +66,43 @@ def begin_repair(
         ) from exc
 
     return BeginRepairResponse(data=repair)
+
+
+@router.get(
+    "/{repair_id}",
+    response_model=RepairDetailResponse,
+)
+def get_repair(
+    repair_id: UUID,
+    service: RepairServiceDependency,
+    current_user: RepairReadUser,
+) -> RepairDetailResponse:
+    del current_user
+    try:
+        repair = service.get_repair(repair_id)
+    except RepairNotFound as exc:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Repair not found",
+        ) from exc
+    return RepairDetailResponse(data=repair)
+
+
+@router.get(
+    "/{repair_id}/events",
+    response_model=RepairTimelineResponse,
+)
+def get_repair_events(
+    repair_id: UUID,
+    service: RepairServiceDependency,
+    current_user: RepairReadUser,
+) -> RepairTimelineResponse:
+    del current_user
+    try:
+        timeline = service.get_repair_timeline(repair_id)
+    except RepairNotFound as exc:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Repair not found",
+        ) from exc
+    return RepairTimelineResponse(data=timeline)