YARA-951

src/common/dto/expert-file-assign-result.dto.ts

@@ -0,0 +1,38 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+
+export type ExpertFileAssignStatus =
+  | "assigned"
+  | "already_assigned_to_you"
+  | "locked"
+  | "unavailable";
+
+export class ExpertFileAssignResultDto {
+  @ApiProperty({ example: true })
+  success: boolean;
+
+  @ApiProperty({
+    enum: ["assigned", "already_assigned_to_you", "locked", "unavailable"],
+    example: "assigned",
+  })
+  status: ExpertFileAssignStatus;
+
+  @ApiPropertyOptional({
+    example: "You already started processing this request",
+  })
+  message?: string;
+
+  @ApiPropertyOptional({
+    description: "When the expert was assigned (ISO 8601).",
+    example: "2026-05-24T12:00:00.000Z",
+  })
+  assignedAt?: string;
+
+  @ApiPropertyOptional({
+    description: "Present when status is locked (another expert).",
+  })
+  lockedBy?: {
+    actorId: string;
+    actorName?: string;
+    lockedAt?: string;
+  };
+}