优化

2026-08-21 10:38:28 +08:00
parent 361e6be3be
commit d5e9ba6d4c
21 changed files with 1705 additions and 15 deletions
@@ -0,0 +1,375 @@
+const MODULE = 'phase4-overseas-master-data'
+const DOMESTIC_BASE = '/api/platform/v1/warehouse-admin'
+const OVERSEAS_BASE = '/api/platform/v1/last-leg/master-data'
+const BLOCKER = { scenario: 'phase4-overseas-master-data-lifecycle', deploymentBlocker: true }
+
+const success = (response) => response?.http === 200 && String(response?.body?.code) === '200'
+const data = (response) => success(response) ? response.body.data : null
+const recordVersion = (value) => Number.isInteger(Number(value)) && Number(value) >= 0
+const asId = (value) => value == null ? '' : String(value)
+
+function requireData(context, name, response) {
+  const value = context.apiSuccess(MODULE, name, response, '', BLOCKER)
+  if (value == null) throw new Error(`${name}失败，生命周期无法继续`)
+  return value
+}
+
+function assertBinaryCsv(context, name, response) {
+  context.assert(MODULE, name, response,
+    response?.http === 200
+      && String(response.contentType || '').toLowerCase().startsWith('text/csv')
+      && response.bytes instanceof Uint8Array && response.bytes.length > 0,
+    `HTTP=${response?.http ?? 0}, contentType=${response?.contentType || 'missing'}, bytes=${response?.bytes?.length || 0}`,
+    BLOCKER)
+}
+
+async function safeCleanup(context, name, action) {
+  try {
+    await action()
+  } catch (error) {
+    context.assert(MODULE, `${name} finally停用`, null, false,
+      error instanceof Error ? error.message : String(error), BLOCKER)
+  }
+}
+
+function warehousePayload(marker, edited = false) {
+  const suffix = marker.replace(/[^A-Za-z0-9]/g, '').slice(-20).toUpperCase()
+  return {
+    tenantId: 0,
+    warehouseCode: `P4-${suffix}`.slice(0, 50),
+    warehouseName: edited ? `${marker} 合作仓-已编辑` : `${marker} 合作仓`,
+    warehouseType: 'OVERSEAS_PARTNER',
+    countryCode: 'US',
+    timezone: 'UTC-8',
+    contactName: 'Phase4 QA',
+    contactPhone: '+1-213-555-0199',
+    contactEmail: null,
+    status: 'ACTIVE',
+    remark: edited ? `${marker} lifecycle edited` : `${marker} lifecycle`,
+    address: {
+      addressType: 'WAREHOUSE', countryCode: 'US', stateProvince: 'California',
+      city: 'Los Angeles', district: 'Commerce', postalCode: '90040',
+      addressLine1: edited ? '402 Phase Four Test Avenue' : '401 Phase Four Test Avenue',
+      addressLine2: null, latitude: null, longitude: null,
+    },
+    capabilities: [{
+      capabilityCode: 'STORAGE', capabilityName: 'Storage', enabled: true,
+      cutoffTime: null, description: `${marker} acceptance capability`,
+    }],
+  }
+}
+
+async function createAndVerifyPartnerWarehouse(context, resource) {
+  const initial = warehousePayload(context.marker)
+  const createResponse = await context.request('POST', DOMESTIC_BASE, initial)
+  const createdId = asId(requireData(context, '新增OVERSEAS_PARTNER合作仓', createResponse))
+  if (!createdId) throw new Error('合作仓创建响应未返回ID')
+  resource.partnerWarehouse = { id: createdId, code: initial.warehouseCode, finalStatus: 'ACTIVE' }
+
+  const detailPath = `${DOMESTIC_BASE}/${encodeURIComponent(createdId)}?tenantId=0`
+  const detailResponse = await context.request('GET', detailPath)
+  const detail = requireData(context, '查询合作仓详情', detailResponse)
+  context.assert(MODULE, '合作仓真实类型与marker', detailResponse,
+    detail?.warehouse?.warehouseType === 'OVERSEAS_PARTNER'
+      && detail.warehouse.warehouseCode === initial.warehouseCode,
+    `id=${createdId}, type=${detail?.warehouse?.warehouseType || 'missing'}, code=${detail?.warehouse?.warehouseCode || 'missing'}`,
+    BLOCKER)
+
+  const edited = warehousePayload(context.marker, true)
+  const editResponse = await context.request('PUT', detailPath, edited)
+  context.apiSuccess(MODULE, '编辑合作仓（当前契约无version）', editResponse, 'warehouse SaveRequest 无乐观锁字段', BLOCKER)
+  const afterResponse = await context.request('GET', detailPath)
+  const after = requireData(context, '编辑后查询合作仓详情', afterResponse)
+  context.assert(MODULE, '合作仓编辑持久化', afterResponse,
+    after?.warehouse?.warehouseName === edited.warehouseName
+      && after?.warehouse?.remark === edited.remark
+      && after?.warehouse?.warehouseType === 'OVERSEAS_PARTNER',
+    `name=${after?.warehouse?.warehouseName || 'missing'}, type=${after?.warehouse?.warehouseType || 'missing'}`,
+    BLOCKER)
+}
+
+function quoteCreatePayload(context, warehouseId) {
+  return {
+    name: `${context.marker} 海外报价`, warehouseId,
+    providerName: `${context.marker} Provider`, currency: 'USD',
+    effectiveStart: '2098-01-01', effectiveEnd: '2098-12-31',
+    versionCode: `${context.marker}-V1`.slice(0, 64),
+    warehouseFees: [{ item: 'Storage QA', billingUnit: 'PALLET', unitPrice: 1.25, minimumCharge: 2.5, remark: context.marker }],
+    transitPrices: [{ fbaWarehouseCode: 'ONT8', deliveryMethod: 'TRUCK', estimatedMiles: 12.5, price: 18.75, minimumCharge: 20, remark: context.marker }],
+    remark: `${context.marker} lifecycle`,
+  }
+}
+
+function quoteUpdatePayload(created, context, version) {
+  return {
+    recordVersion: version, name: `${context.marker} 海外报价-已编辑`,
+    providerName: created.providerName, currency: created.currency,
+    effectiveStart: created.effectiveStart, effectiveEnd: created.effectiveEnd,
+    warehouseFees: [{ item: 'Storage QA Edited', billingUnit: 'PALLET', unitPrice: 1.5, minimumCharge: 3, remark: `${context.marker} edited` }],
+    transitPrices: created.transitPrices,
+    remark: `${context.marker} lifecycle edited`,
+  }
+}
+
+async function quoteLifecycle(context, resource) {
+  const optionsResponse = await context.requestOverseas('GET', `${OVERSEAS_BASE}/overseas-quotes/warehouse-options`)
+  const options = requireData(context, '查询海外报价合作仓候选', optionsResponse)
+  context.assert(MODULE, '报价候选只来自海外正式接口', optionsResponse,
+    Array.isArray(options) && options.every((item) => asId(item.warehouseId)
+      && item.warehouseCode && item.warehouseName && item.countryCode),
+    `count=${Array.isArray(options) ? options.length : 'invalid'}`, BLOCKER)
+  if (Array.isArray(options) && options.length === 0) {
+    resource.quote = {
+      skipped: true,
+      reason: 'warehouse-options-empty-cache',
+      finalStatus: null,
+    }
+    context.addCoverageGap(MODULE, BLOCKER.scenario, '海外报价完整写生命周期',
+      'warehouse-options 返回空数组；已创建的 OVERSEAS_PARTNER 可能尚未穿透服务端30分钟空缓存。本轮跳过报价且不猜测 warehouseId，继续验收汇率与车辆。',
+      'deployment-prerequisite', {
+        marker: context.marker,
+        partnerWarehouseId: resource.partnerWarehouse?.id || null,
+        http: optionsResponse?.http ?? null,
+        code: optionsResponse?.body?.code ?? null,
+        requestId: optionsResponse?.requestId ?? null,
+        traceId: optionsResponse?.traceId ?? null,
+      })
+    return false
+  }
+  const createdOption = options.find((item) => asId(item.warehouseId) === resource.partnerWarehouse?.id)
+  const option = createdOption || options[0]
+  if (!option) throw new Error('海外报价接口未返回可用合作仓候选')
+
+  const payload = quoteCreatePayload(context, asId(option.warehouseId))
+  const createResponse = await context.requestOverseas('POST', `${OVERSEAS_BASE}/overseas-quotes`, payload)
+  let detail = requireData(context, '新增海外报价', createResponse)
+  const id = asId(detail?.summary?.id)
+  if (!id || !recordVersion(detail?.summary?.recordVersion)) throw new Error('报价创建响应缺少字符串ID或recordVersion')
+  resource.quote = { id, warehouseId: payload.warehouseId, recordVersion: Number(detail.summary.recordVersion), finalStatus: detail.summary.status }
+  const path = `${OVERSEAS_BASE}/overseas-quotes/${encodeURIComponent(id)}`
+
+  const detailResponse = await context.requestOverseas('GET', path)
+  detail = requireData(context, '查询海外报价详情', detailResponse)
+  context.assert(MODULE, '报价详情长ID、费用和版本', detailResponse,
+    asId(detail?.summary?.id) === id && recordVersion(detail?.summary?.recordVersion)
+      && Array.isArray(detail?.warehouseFees) && detail.warehouseFees.length > 0,
+    `id=${asId(detail?.summary?.id) || 'missing'}, version=${detail?.summary?.recordVersion ?? 'missing'}`, BLOCKER)
+
+  const staleVersion = Number(detail.summary.recordVersion)
+  const updatePayload = quoteUpdatePayload({ ...payload, transitPrices: payload.transitPrices }, context, staleVersion)
+  const updateResponse = await context.requestOverseas('PUT', path, updatePayload)
+  detail = requireData(context, '编辑海外报价', updateResponse)
+  resource.quote.recordVersion = Number(detail.summary.recordVersion)
+  context.assert(MODULE, '报价编辑版本递增', updateResponse,
+    detail.summary.name === updatePayload.name && resource.quote.recordVersion === staleVersion + 1,
+    `before=${staleVersion}, after=${resource.quote.recordVersion}`, BLOCKER)
+
+  const conflictResponse = await context.requestOverseas('PUT', path, { ...updatePayload, name: `${context.marker} stale` })
+  context.expectConflict(MODULE, '报价旧recordVersion编辑冲突', conflictResponse, BLOCKER.scenario)
+  const afterConflictResponse = await context.requestOverseas('GET', path)
+  detail = requireData(context, '报价冲突后重新查询', afterConflictResponse)
+  context.assert(MODULE, '报价冲突未覆盖新值', afterConflictResponse,
+    detail.summary.name === updatePayload.name && Number(detail.summary.recordVersion) === resource.quote.recordVersion,
+    `name=${detail.summary.name}, version=${detail.summary.recordVersion}`, BLOCKER)
+
+  const activateResponse = await context.requestOverseas('PATCH', `${path}/status`, {
+    status: 'ACTIVE', recordVersion: resource.quote.recordVersion,
+  })
+  detail = requireData(context, '启用海外报价', activateResponse)
+  resource.quote.recordVersion = Number(detail.summary.recordVersion)
+  resource.quote.finalStatus = detail.summary.status
+  context.assert(MODULE, '报价状态切换为ACTIVE', activateResponse,
+    detail.summary.status === 'ACTIVE', `status=${detail.summary.status}`, BLOCKER)
+
+  const csv = await context.requestOverseasBinary('GET', `${OVERSEAS_BASE}/overseas-quotes/export?keyword=${encodeURIComponent(context.marker)}`)
+  assertBinaryCsv(context, '导出海外报价CSV', csv)
+  return true
+}
+
+async function chooseSafeExchangeMonth(context) {
+  const digits = context.marker.replace(/\D/g, '')
+  const seed = Number(digits.slice(-4) || '0')
+  for (let offset = 0; offset < 24; offset += 1) {
+    const serial = ((seed + offset) % 120)
+    const month = `${2090 + Math.floor(serial / 12)}-${String((serial % 12) + 1).padStart(2, '0')}`
+    const path = `${OVERSEAS_BASE}/exchange-rates?page=1&size=20&monthFrom=${month}&monthTo=${month}`
+    const response = await context.requestOverseas('GET', path)
+    const page = requireData(context, `探测安全汇率月份${month}`, response)
+    if (Array.isArray(page?.records) && page.records.length === 0 && Number(page.total) === 0) return month
+  }
+  throw new Error('2090-2099安全月份池均已占用，拒绝覆盖既有汇率')
+}
+
+async function exchangeLifecycle(context, resource) {
+  const month = await chooseSafeExchangeMonth(context)
+  const createPayload = { month, usdToCnyAverage: 7.123456, remark: `${context.marker} safe marker month` }
+  const createResponse = await context.requestOverseas('POST', `${OVERSEAS_BASE}/exchange-rates`, createPayload)
+  let rate = requireData(context, '新增安全marker月汇率', createResponse)
+  resource.exchangeRate = { month, recordVersion: Number(rate.recordVersion), finalStatus: rate.status }
+  const path = `${OVERSEAS_BASE}/exchange-rates/${encodeURIComponent(month)}`
+
+  const detailResponse = await context.requestOverseas('GET', path)
+  rate = requireData(context, '查询marker月汇率详情', detailResponse)
+  context.assert(MODULE, '汇率详情月份、decimal与版本', detailResponse,
+    rate.month === month && Number(rate.usdToCnyAverage) > 0 && recordVersion(rate.recordVersion),
+    `month=${rate.month}, rate=${rate.usdToCnyAverage}, version=${rate.recordVersion}`, BLOCKER)
+
+  const staleVersion = Number(rate.recordVersion)
+  const updatePayload = { recordVersion: staleVersion, usdToCnyAverage: 7.234567, remark: `${context.marker} overwritten once` }
+  const updateResponse = await context.requestOverseas('PUT', path, updatePayload)
+  rate = requireData(context, '覆盖维护marker月汇率', updateResponse)
+  resource.exchangeRate.recordVersion = Number(rate.recordVersion)
+  context.assert(MODULE, '汇率覆盖版本递增', updateResponse,
+    Number(rate.usdToCnyAverage) === updatePayload.usdToCnyAverage
+      && resource.exchangeRate.recordVersion === staleVersion + 1,
+    `before=${staleVersion}, after=${resource.exchangeRate.recordVersion}`, BLOCKER)
+
+  const conflictResponse = await context.requestOverseas('PUT', path, { ...updatePayload, usdToCnyAverage: 7.345678 })
+  context.expectConflict(MODULE, '汇率旧recordVersion覆盖冲突', conflictResponse, BLOCKER.scenario)
+  const afterConflictResponse = await context.requestOverseas('GET', path)
+  rate = requireData(context, '汇率冲突后重新查询', afterConflictResponse)
+  context.assert(MODULE, '汇率冲突未覆盖新值', afterConflictResponse,
+    Number(rate.usdToCnyAverage) === updatePayload.usdToCnyAverage
+      && Number(rate.recordVersion) === resource.exchangeRate.recordVersion,
+    `rate=${rate.usdToCnyAverage}, version=${rate.recordVersion}`, BLOCKER)
+
+  const statusResponse = await context.requestOverseas('PATCH', `${path}/status`, {
+    status: 'INACTIVE', recordVersion: resource.exchangeRate.recordVersion,
+    remark: `${context.marker} lifecycle complete`,
+  })
+  rate = requireData(context, '停用marker月汇率', statusResponse)
+  resource.exchangeRate.recordVersion = Number(rate.recordVersion)
+  resource.exchangeRate.finalStatus = rate.status
+  context.assert(MODULE, '汇率状态切换为INACTIVE', statusResponse,
+    rate.status === 'INACTIVE', `status=${rate.status}`, BLOCKER)
+
+  const csv = await context.requestOverseasBinary('GET',
+    `${OVERSEAS_BASE}/exchange-rates/export?monthFrom=${month}&monthTo=${month}`)
+  assertBinaryCsv(context, '导出marker月汇率CSV', csv)
+}
+
+function vehiclePayload(context, edited = false) {
+  const suffix = context.marker.replace(/[^A-Za-z0-9]/g, '').slice(-18).toUpperCase()
+  return {
+    plateNumber: `QA-${suffix}`.slice(0, 64),
+    model: edited ? 'Phase4 QA Truck Edited' : 'Phase4 QA Truck',
+    fuelConsumptionPer100Km: edited ? 18.75 : 18.5,
+    mileageKm: edited ? 101 : 100,
+    driverOrDispatchCompany: `${context.marker} Carrier`, phone: '+1-213-555-0188',
+    region: 'OVERSEAS', ownership: 'OWNED',
+    ...(edited ? {} : { status: 'IN_SERVICE' }),
+    remark: edited ? `${context.marker} lifecycle edited` : `${context.marker} lifecycle`,
+  }
+}
+
+async function vehicleLifecycle(context, resource) {
+  const createPayload = vehiclePayload(context)
+  const createResponse = await context.requestOverseas('POST', `${OVERSEAS_BASE}/vehicles`, createPayload)
+  let vehicle = requireData(context, '新增marker车辆', createResponse)
+  const id = asId(vehicle.id)
+  if (!id || !recordVersion(vehicle.recordVersion)) throw new Error('车辆创建响应缺少字符串ID或recordVersion')
+  resource.vehicle = { id, plateNumber: createPayload.plateNumber, recordVersion: Number(vehicle.recordVersion), finalStatus: vehicle.status }
+  const path = `${OVERSEAS_BASE}/vehicles/${encodeURIComponent(id)}`
+
+  const detailResponse = await context.requestOverseas('GET', path)
+  vehicle = requireData(context, '查询marker车辆详情', detailResponse)
+  context.assert(MODULE, '车辆详情长ID、五态字段与版本', detailResponse,
+    asId(vehicle.id) === id && ['IN_SERVICE', 'DISPATCHED', 'MAINTENANCE', 'INACTIVE', 'RETURNED'].includes(vehicle.status)
+      && recordVersion(vehicle.recordVersion),
+    `id=${asId(vehicle.id)}, status=${vehicle.status}, version=${vehicle.recordVersion}`, BLOCKER)
+
+  const staleVersion = Number(vehicle.recordVersion)
+  const updatePayload = { recordVersion: staleVersion, ...vehiclePayload(context, true) }
+  const updateResponse = await context.requestOverseas('PUT', path, updatePayload)
+  vehicle = requireData(context, '编辑marker车辆', updateResponse)
+  const updatedVersion = Number(vehicle.recordVersion)
+  const updatedMileage = Number(vehicle.mileageKm)
+  resource.vehicle.recordVersion = updatedVersion
+  context.assert(MODULE, '车辆编辑版本递增', updateResponse,
+    vehicle.model === updatePayload.model && updatedMileage === Number(updatePayload.mileageKm)
+      && updatedVersion === Number(staleVersion) + 1,
+    `before=${staleVersion}, after=${updatedVersion}, mileage=${updatedMileage}`, BLOCKER)
+
+  const conflictResponse = await context.requestOverseas('PUT', path, { ...updatePayload, model: 'stale overwrite' })
+  context.expectConflict(MODULE, '车辆旧recordVersion编辑冲突', conflictResponse, BLOCKER.scenario)
+  const afterConflictResponse = await context.requestOverseas('GET', path)
+  vehicle = requireData(context, '车辆冲突后重新查询', afterConflictResponse)
+  context.assert(MODULE, '车辆冲突未覆盖新值', afterConflictResponse,
+    vehicle.model === updatePayload.model && Number(vehicle.recordVersion) === resource.vehicle.recordVersion,
+    `model=${vehicle.model}, version=${vehicle.recordVersion}`, BLOCKER)
+
+  const statusResponse = await context.requestOverseas('PATCH', `${path}/status`, {
+    status: 'MAINTENANCE', recordVersion: resource.vehicle.recordVersion,
+  })
+  vehicle = requireData(context, '车辆切换安全维护状态', statusResponse)
+  resource.vehicle.recordVersion = Number(vehicle.recordVersion)
+  resource.vehicle.finalStatus = vehicle.status
+  context.assert(MODULE, '车辆状态切换为MAINTENANCE', statusResponse,
+    vehicle.status === 'MAINTENANCE', `status=${vehicle.status}`, BLOCKER)
+
+  const csv = await context.requestOverseasBinary('GET', `${OVERSEAS_BASE}/vehicles/export?keyword=${encodeURIComponent(createPayload.plateNumber)}`)
+  assertBinaryCsv(context, '导出marker车辆CSV', csv)
+}
+
+async function cleanupPartnerWarehouse(context, resource) {
+  if (!resource.partnerWarehouse?.id) return
+  const response = await context.request('PATCH',
+    `${DOMESTIC_BASE}/${encodeURIComponent(resource.partnerWarehouse.id)}/status?tenantId=0&status=INACTIVE`)
+  context.apiSuccess(MODULE, '合作仓finally停用', response, `id=${resource.partnerWarehouse.id}`, BLOCKER)
+  if (success(response)) resource.partnerWarehouse.finalStatus = 'INACTIVE'
+}
+
+async function cleanupVersioned(context, resource, key, path, extract) {
+  const current = resource[key]
+  if (!current) return
+  const detailResponse = await context.requestOverseas('GET', path)
+  const detail = data(detailResponse)
+  const value = extract(detail)
+  if (!success(detailResponse) || !value || !recordVersion(value.recordVersion)) {
+    context.assert(MODULE, `${key} finally查询当前版本`, detailResponse, false,
+      `HTTP=${detailResponse?.http ?? 0}, code=${detailResponse?.body?.code || 'missing'}`, BLOCKER)
+    return
+  }
+  current.recordVersion = Number(value.recordVersion)
+  current.finalStatus = value.status
+  if (value.status === 'INACTIVE') return
+  const response = await context.requestOverseas('PATCH', `${path}/status`, {
+    status: 'INACTIVE', recordVersion: current.recordVersion,
+    ...(key === 'exchangeRate' ? { remark: `${context.marker} finally cleanup` } : {}),
+  })
+  const stopped = data(response)
+  const normalized = extract(stopped)
+  context.apiSuccess(MODULE, `${key} finally停用`, response, `path=${path}`, BLOCKER)
+  if (normalized) {
+    current.recordVersion = Number(normalized.recordVersion)
+    current.finalStatus = normalized.status
+  }
+}
+
+export async function run(context) {
+  const resource = { marker: context.marker }
+  context.createdResources.phase4OverseasMasterData = resource
+  try {
+    await createAndVerifyPartnerWarehouse(context, resource)
+    await quoteLifecycle(context, resource)
+    await exchangeLifecycle(context, resource)
+    await vehicleLifecycle(context, resource)
+  } finally {
+    await safeCleanup(context, '海外报价', async () => {
+      if (!resource.quote?.id) return
+      const path = `${OVERSEAS_BASE}/overseas-quotes/${encodeURIComponent(resource.quote.id)}`
+      await cleanupVersioned(context, resource, 'quote', path, (value) => value?.summary)
+    })
+    await safeCleanup(context, '月度汇率', async () => {
+      if (!resource.exchangeRate?.month) return
+      const path = `${OVERSEAS_BASE}/exchange-rates/${encodeURIComponent(resource.exchangeRate.month)}`
+      await cleanupVersioned(context, resource, 'exchangeRate', path, (value) => value)
+    })
+    await safeCleanup(context, '车辆', async () => {
+      if (!resource.vehicle?.id) return
+      const path = `${OVERSEAS_BASE}/vehicles/${encodeURIComponent(resource.vehicle.id)}`
+      await cleanupVersioned(context, resource, 'vehicle', path, (value) => value)
+    })
+    await safeCleanup(context, '合作仓', () => cleanupPartnerWarehouse(context, resource))
+  }
+}