feat: add return to service workflow

backend/app/repairs/router.py

@@ -9,6 +9,7 @@ from app.identity import require_permission
 from app.repairs.dependencies import get_repair_service
 from app.repairs.exceptions import (
     RepairActorRequired,
+    RepairCompletionActorRequired,
     RepairConflict,
     RepairMinerNotFound,
     RepairNotFound,
@@ -16,6 +17,7 @@ from app.repairs.exceptions import (
 from app.repairs.models import (
     BeginRepairRequest,
     BeginRepairResponse,
+    RepairCompleteRequest,
     RepairDetailResponse,
     RepairTimelineResponse,
 )
@@ -25,6 +27,7 @@ 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")
+require_repair_complete = require_permission("repairs.complete")
 
 RepairServiceDependency = Annotated[
     RepairService,
@@ -32,6 +35,7 @@ RepairServiceDependency = Annotated[
 ]
 RepairCreateUser = Annotated[dict, Depends(require_repair_create)]
 RepairReadUser = Annotated[dict, Depends(require_repair_read)]
+RepairCompleteUser = Annotated[dict, Depends(require_repair_complete)]
 
 
 @router.post(
@@ -68,6 +72,46 @@ def begin_repair(
     return BeginRepairResponse(data=repair)
 
 
+@router.post(
+    "/{repair_id}/complete",
+    response_model=RepairDetailResponse,
+)
+def complete_repair(
+    repair_id: UUID,
+    request: RepairCompleteRequest,
+    service: RepairServiceDependency,
+    current_user: RepairCompleteUser,
+) -> RepairDetailResponse:
+    try:
+        repair = service.complete_repair(
+            repair_id,
+            request,
+            actor_user_id=UUID(str(current_user["id"])),
+        )
+    except RepairNotFound as exc:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Repair not found",
+        ) from exc
+    except RepairMinerNotFound as exc:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail="Repair miner no longer exists",
+        ) from exc
+    except RepairConflict as exc:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=str(exc),
+        ) from exc
+    except RepairCompletionActorRequired as exc:
+        raise HTTPException(
+            status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
+            detail=str(exc),
+        ) from exc
+
+    return RepairDetailResponse(data=repair)
+
+
 @router.get(
     "/{repair_id}",
     response_model=RepairDetailResponse,