Fixed workflow step

src/request-management/expert-initiated-blame-v3.mirror.controller.ts

@@ -325,7 +325,13 @@ export class ExpertInitiatedBlameV3MirrorController {
 
   @Get("capture-requirements/:claimRequestId")
   @ApiParam({ name: "claimRequestId" })
-  @ApiOperation({ summary: "List required claim documents" })
+  @ApiOperation({
+    summary: "Capture requirements (step-aware for V3)",
+    description:
+      "Initial documents phase: only pre-capture docs (no chassis/engine/metal plate). " +
+      "CAPTURE_PART_DAMAGES: damaged parts + angles via capture-part, then chassis/engine/metal plate via upload-document. " +
+      "Use `captureSequencePhase` and `captureSequenceHint` to drive the UI.",
+  })
   async getCaptureRequirements(
     @Param("claimRequestId") claimRequestId: string,
     @CurrentUser() expert: any,
@@ -353,7 +359,12 @@ export class ExpertInitiatedBlameV3MirrorController {
       }),
     }),
   )
-  @ApiOperation({ summary: "Upload one required claim document" })
+  @ApiOperation({
+    summary: "Upload one required claim document",
+    description:
+      "Initial phase (UPLOAD_REQUIRED_DOCUMENTS): licenses and car cards only. " +
+      "Capture phase (CAPTURE_PART_DAMAGES, after parts + angles): chassis, engine, metal plate only.",
+  })
   async uploadDocument(
     @Param("claimRequestId") claimRequestId: string,
     @Body() body: UploadRequiredDocumentV2Dto,