feat: add return to service workflow

backend/app/repairs/models.py

@@ -28,8 +28,13 @@ RepairStatus = Literal[
     "COMPLETED",
     "CANCELLED",
 ]
-RepairEventType = Literal["REPAIR_STARTED", "INITIAL_NOTE"]
+RepairEventType = Literal[
+    "REPAIR_STARTED",
+    "INITIAL_NOTE",
+    "REPAIR_COMPLETED",
+]
 RepairEligibleLifecycle = Literal["active", "spare"]
+RepairPostLifecycle = Literal["active", "spare"]
 RepairMinerLifecycle = Literal["active", "spare", "retired", "in_repair"]
 
 
@@ -41,6 +46,13 @@ class BeginRepairRequest(BaseModel):
     notes: str | None = Field(default=None, max_length=4000)
 
 
+class RepairCompleteRequest(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    target_lifecycle: RepairPostLifecycle
+    completion_summary: str | None = Field(default=None, max_length=4000)
+
+
 class RepairStartedPayload(BaseModel):
     reason: RepairReason
     from_lifecycle: RepairEligibleLifecycle
@@ -51,6 +63,13 @@ class InitialRepairNotePayload(BaseModel):
     note: str = Field(min_length=1, max_length=4000)
 
 
+class RepairCompletedPayload(BaseModel):
+    previous_miner_lifecycle: Literal["in_repair"] = "in_repair"
+    resulting_miner_lifecycle: RepairPostLifecycle
+    pre_repair_lifecycle: RepairEligibleLifecycle | None = None
+    completion_summary: str | None = Field(default=None, max_length=4000)
+
+
 class BeginRepairResult(BaseModel):
     repair_id: UUID
     miner_id: UUID