YARA-850

src/expert-claim/dto/claim-detail-v2.dto.ts

@@ -93,6 +93,11 @@ export class ClaimDetailV2ResponseDto {
       type: 'object',
       properties: {
         index: { type: 'number' },
+        partId: {
+          type: 'string',
+          description:
+            'Send this in PUT reply/submit parts[] — stable id (`id:{catalogId}` or `{side}|{name}`)',
+        },
         id: { type: 'number', nullable: true },
         name: { type: 'string' },
         side: { type: 'string' },
@@ -104,6 +109,7 @@ export class ClaimDetailV2ResponseDto {
   })
   damagedParts?: Array<{
     index: number;
+    partId: string;
     id?: number | null;
     name: string;
     side: string;

src/expert-claim/dto/expert-claim-v2.dto.ts

@@ -7,59 +7,12 @@ import {
   IsOptional,
   ValidateNested,
   IsEnum,
-  IsInt,
 } from 'class-validator';
 import { Type } from 'class-transformer';
 import { ClaimRequiredDocumentType } from 'src/Types&Enums/claim-request-management/required-document-type.enum';
 import { DamagedPartItem } from 'src/claim-request-management/dto/capture-requirements-v2.dto';
 import { DaghiOption } from 'src/Types&Enums/claim-request-management/daghi-option.enum';
 
-/**
- * Damage line part reference — same unified shape as `damage.selectedParts` / catalog rows.
- * Send either `{ name, side, label_fa?, id?, catalogKey? }` or legacy `{ part, side }`
- * (e.g. part `backFender`, side `left`); the API persists canonical `{ id, name, side, label_fa, catalogKey? }`.
- */
-export class ExpertReplyCarPartDamageV2Dto {
-  @ApiPropertyOptional({ description: 'Catalog id when known' })
-  @IsOptional()
-  @IsInt()
-  id?: number;
-
-  @ApiPropertyOptional({
-    description: 'Side-agnostic catalog segment, e.g. backfender',
-    example: 'backfender',
-  })
-  @IsOptional()
-  @IsString()
-  name?: string;
-
-  @ApiPropertyOptional({ example: 'left' })
-  @IsOptional()
-  @IsString()
-  side?: string;
-
-  @ApiPropertyOptional({
-    description:
-      'Farsi label; optional when server can resolve from catalog + vehicle.carType',
-  })
-  @IsOptional()
-  @IsString()
-  label_fa?: string;
-
-  @ApiPropertyOptional({ example: 'left_backfender' })
-  @IsOptional()
-  @IsString()
-  catalogKey?: string;
-
-  @ApiPropertyOptional({
-    description: 'Legacy expert UI: camelCase segment with `side`, e.g. backFender',
-    example: 'backFender',
-  })
-  @IsOptional()
-  @IsString()
-  part?: string;
-}
-
 /** Same shape as V1 {@link PartsList} `daghi` (damage expert reply). */
 export class DaghiDetailsV2Dto {
   @ApiProperty({
@@ -86,16 +39,15 @@ export class DaghiDetailsV2Dto {
 }
 
 export class PartPricingV2Dto {
-  @ApiProperty({ example: 'part-001' })
+  @ApiProperty({
+    example: '12',
+    description:
+      'Stable part id from GET claim detail `damagedParts[].partId` or `selectedParts` identity (`id:{catalogId}` or `{side}|{name}`). Required.',
+  })
   @IsString()
   @IsNotEmpty()
   partId: string;
 
-  @ApiProperty({ type: ExpertReplyCarPartDamageV2Dto })
-  @ValidateNested()
-  @Type(() => ExpertReplyCarPartDamageV2Dto)
-  carPartDamage: ExpertReplyCarPartDamageV2Dto;
-
   @ApiProperty({ example: 'Minor' })
   @IsString()
   typeOfDamage: string;
@@ -135,7 +87,7 @@ export class SubmitExpertReplyV2Dto {
   @ApiProperty({
     type: [PartPricingV2Dto],
     description:
-      "Each part: manual pricing and `daghi`; set `factorNeeded` only where a repair factor upload is required from the owner.",
+      "One line per damaged part (`partId` from claim detail `damagedParts[]`), plus pricing, `daghi`, and `factorNeeded`.",
   })
   @IsArray()
   @ValidateNested({ each: true })

src/expert-claim/expert-claim.service.ts

@@ -84,6 +84,7 @@ import {
   normalizeDamageSelectedParts,
   partIdentityKey,
   partIdentityKeyFromCarPartDamage,
+  resolveSelectedPartByPartId,
 } from "src/helpers/outer-damage-parts";
 import { ClaimVehicleTypeV2 } from "src/static/outer-car-parts-catalog";
 import { snapshotFromDamageExpert } from "src/helpers/expert-profile-snapshot";
@@ -2698,13 +2699,29 @@ export class ExpertClaimService {
     const processedParts = daghiNormalized.map((p) => {
       let carPartDamage: Record<string, unknown>;
       try {
+        const selected = resolveSelectedPartByPartId(
+          p.partId,
+          ownerSelectedParts,
+        );
+        if (!selected) {
+          throw new BadRequestException(
+            `Unknown partId "${p.partId}". Use partId from claim detail damagedParts (after editing parts on the claim).`,
+          );
+        }
         carPartDamage = normalizeCarPartDamageForExpertReply(
-          p.carPartDamage as unknown,
+          {
+            id: selected.id,
+            name: selected.name,
+            side: selected.side,
+            label_fa: selected.label_fa,
+            ...(selected.catalogKey ? { catalogKey: selected.catalogKey } : {}),
+          },
           carTypeSubmit,
         );
       } catch (err) {
+        if (err instanceof BadRequestException) throw err;
         throw new BadRequestException(
-          `Invalid carPartDamage for part ${p.partId}: ${
+          `Invalid part ${p.partId}: ${
             err instanceof Error ? err.message : String(err)
           }`,
         );
@@ -2713,7 +2730,7 @@ export class ExpertClaimService {
       const identityKey = partIdentityKeyFromCarPartDamage(carPartDamage);
       if (!identityKey) {
         throw new BadRequestException(
-          `Invalid carPartDamage for part ${p.partId}: cannot derive a stable identity (need a catalog id or both name and side).`,
+          `Invalid part ${p.partId}: cannot derive a stable identity (need a catalog id or both name and side).`,
         );
       }
 
@@ -3537,6 +3554,7 @@ export class ExpertClaimService {
       ) as { url?: string; path?: string } | undefined;
       return {
         index,
+        partId: partIdentityKey(sp),
         id: sp.id,
         name: sp.name,
         side: sp.side,

src/expert-claim/expert-claim.v2.controller.ts

@@ -132,7 +132,7 @@ export class ExpertClaimV2Controller {
   @ApiOperation({
     summary: "Submit expert damage assessment reply",
     description:
-      "**Preconditions:** claim locked by this expert (`EXPERT_REVIEWING`). **Unlocks** the claim. Each part needs `daghi` (V1 rules) and may set `factorNeeded` (repair factor file required from owner) or priced lines only. **Cap:** sum of line `totalPayment` values ≤ 53,000,000 (same limit as factor-validation totals across priced + factor lines). Clears any prior `evaluation.ownerInsurerApproval` / `ownerPricedPartsApproval`.\n\n" +
+      "**Preconditions:** claim locked by this expert (`EXPERT_REVIEWING`). **Unlocks** the claim. Each `parts[]` line needs `partId` (from GET claim detail `damagedParts[].partId`), plus pricing, `daghi`, and optional `factorNeeded`. **Cap:** sum of line `totalPayment` values ≤ 53,000,000 (same limit as factor-validation totals across priced + factor lines). Clears any prior `evaluation.ownerInsurerApproval` / `ownerPricedPartsApproval`.\n\n" +
       "**Frontend routing by `ClaimCaseStatus` (`status`):**\n" +
       "- **All parts `factorNeeded`:** `OWNER_REPAIR_FACTOR_UPLOAD_PENDING`, `claimStatus=NEEDS_REVISION`, `workflow.currentStep=OWNER_UPLOAD_FACTOR_DOCUMENTS`, `workflow.nextStep=EXPERT_COST_EVALUATION` → owner uploads all factors; then `status` becomes **`EXPERT_VALIDATING_REPAIR_FACTORS`**, `claimStatus=UNDER_REVIEW`, `currentStep=EXPERT_COST_EVALUATION` for expert **validate-factors**.\n" +
       "- **Mixed (some priced, some factorNeeded):** `INSURER_REVIEW_MIXED_FACTORS_PENDING`, `claimStatus=NEEDS_REVISION`, `currentStep=INSURER_REVIEW`, `nextStep=OWNER_UPLOAD_FACTOR_DOCUMENTS` → owner must call **owner-insurer-approval/sign** first (priced-line acceptance); `currentStep` then moves to `OWNER_UPLOAD_FACTOR_DOCUMENTS` (same case `status` until factors are done).\n" +