优化

scripts/admin-test-env-modules/finance-reconciliation-full-contract.test.mjs

@@ -15,7 +15,8 @@ test('Finance AP consumes only published fin_fee_source rows and never substitut
   assert.match(source, /!isUnboundContainerCost\(source\.raw\) \|\| hasContainerAllocations/)
 })
 const financePermissions = [
-  'platform:finance:customer-account:list', 'platform:finance:customer-statement:list',
+  'platform:finance:customer-account:list', 'platform:finance:customer-arap:list',
+  'platform:finance:fee-source:review', 'platform:finance:customer-statement:list',
   'platform:finance:reconciliation:create', 'platform:finance:reconciliation:review',
   'platform:finance:reconciliation:issue', 'platform:finance:reconciliation:adjust',
   'platform:finance:reconciliation:void', 'platform:finance:settlement-ar:create',
@@ -58,12 +59,13 @@ function fakeContext(withFixture = true, permissions = financePermissions, denyF
   const calls = []
   const steps = []
   const coverageGaps = []
+  const reviewedSourceIds = new Set()
 
   function responseForStatement(statement) { return structuredClone(statement) }
   function applyAction(statement, body) {
     const status = { SUBMIT: 'PENDING_REVIEW', APPROVE: 'APPROVED', REJECT: 'REJECTED',
       ISSUE: 'ISSUED', ADJUST: 'ISSUED', VOID: 'VOIDED', REOPEN: 'DRAFT' }[body.action]
-    statement.revisions.push({ action: `RECONCILIATION_${body.action}` })
+    statement.revisions.push({ action: body.action })
     statement.status = status
     statement.version += 1
     if (body.action === 'ADJUST') {
@@ -112,6 +114,20 @@ function fakeContext(withFixture = true, permissions = financePermissions, denyF
             reviewStatus: 'APPROVED', sourceStatus: 'AVAILABLE' }
         }))
       }
+      const feeSourceDetailMatch = requestPath.match(/\/fee-sources\/(\d+)$/)
+      if (method === 'GET' && feeSourceDetailMatch) {
+        const localId = feeSourceDetailMatch[1]
+        return ok({ feeSourceId: localId, reviewStatus: reviewedSourceIds.has(localId) ? 'APPROVED' : 'PENDING',
+          sourceStatus: 'AVAILABLE', statementGenerated: false, operationVersion: reviewedSourceIds.has(localId) ? 1 : 0 })
+      }
+      const feeSourceReviewMatch = requestPath.match(/\/fee-sources\/(\d+)\/review$/)
+      if (method === 'POST' && feeSourceReviewMatch) {
+        reviewedSourceIds.add(feeSourceReviewMatch[1])
+        const reviewed = { feeSourceId: feeSourceReviewMatch[1], reviewStatus: 'APPROVED',
+          sourceStatus: 'AVAILABLE', statementGenerated: false, operationVersion: 1 }
+        if (idem) idempotency.set(idem, reviewed)
+        return ok(reviewed)
+      }
       if (method === 'POST' && requestPath.endsWith('/statements')) {
         if (body.currency !== 'CNY') return { http: 200, body: { code: 'FIN_400' } }
         if (String(body.customerId) !== '11') return { http: 200, body: { code: 'FIN_404' } }

scripts/admin-test-env-modules/finance-reconciliation-full.mjs

@@ -6,6 +6,8 @@ const STATEMENT_LIST_PERMISSION = 'platform:finance:customer-statement:list'
 const LEGACY_STATEMENT_VIEW_PERMISSION = 'platform:finance:bill:view'
 const REQUIRED_PERMISSIONS = [
   'platform:finance:customer-account:list',
+  'platform:finance:customer-arap:list',
+  'platform:finance:fee-source:review',
   STATEMENT_LIST_PERMISSION,
   'platform:finance:reconciliation:create',
   'platform:finance:reconciliation:review',
@@ -116,6 +118,31 @@ function finish(context, start) {
     failed: steps.filter((step) => !step.passed).length,
   })
 }
+
+async function approveFixtureSources(context, fixture) {
+  const approved = []
+  for (const source of fixture.sources) {
+    const detailResponse = await context.request('GET', `${BASE}/fee-sources/${encodeURIComponent(source.feeSourceId)}`)
+    let detail = context.apiSuccess(MODULE, '回读本轮 Finance 费用来源审核状态', detailResponse,
+      `feeSourceId=${source.feeSourceId}`, OPTIONS)
+    if (!detail) return false
+    if (detail.reviewStatus === 'PENDING') {
+      const reviewResponse = await write(context, 'POST', `${BASE}/fee-sources/${encodeURIComponent(source.feeSourceId)}/review`, {
+        action: 'APPROVE', reason: context.marker, expectedVersion: Number(detail.operationVersion),
+      }, `fee-source-review-${source.feeSourceId}`)
+      detail = context.apiSuccess(MODULE, '审核本轮 Finance 费用来源', reviewResponse,
+        `feeSourceId=${source.feeSourceId}`, OPTIONS)
+      context.assert(MODULE, '费用来源审核后成为结算候选', reviewResponse,
+        detail?.reviewStatus === 'APPROVED' && detail?.sourceStatus === 'AVAILABLE'
+          && detail?.statementGenerated === false,
+        `feeSourceId=${source.feeSourceId}, reviewStatus=${detail?.reviewStatus ?? 'missing'}, sourceStatus=${detail?.sourceStatus ?? 'missing'}`, OPTIONS)
+    }
+    if (detail?.reviewStatus !== 'APPROVED') return false
+    approved.push(source.feeSourceId)
+  }
+  fixture.root.approvedFinanceFeeSourceIds = approved
+  return approved.length === fixture.sources.length
+}
 function diagnostic(response) {
   return { http: response?.http ?? null,
     code: response?.body?.code == null ? null : String(response.body.code),
@@ -306,8 +333,7 @@ async function issueCompleteChain(context, statement) {
   statement = await act(context, statement, 'ISSUE', 'chain-issue-final')
   const actions = new Set(list(statement?.revisions).map((revision) => revision.action))
   context.assert(MODULE, '完整链保留驳回、重开、调整、作废和再次出账 revision', null,
-    ['RECONCILIATION_REJECT', 'RECONCILIATION_REOPEN', 'RECONCILIATION_ADJUST',
-      'RECONCILIATION_VOID', 'RECONCILIATION_ISSUE'].every((action) => actions.has(action)),
+    ['REJECT', 'REOPEN', 'ADJUST', 'VOID', 'ISSUE'].every((action) => actions.has(action)),
     `actions=${[...actions].join(',')}`, OPTIONS)
   return statement
 }
@@ -445,6 +471,13 @@ export async function run(context) {
   const groups = [cutoffSources, ...(() => {
     return [remainingSources.slice(0, 1), remainingSources.slice(1)]
   })()]
+  if (!await approveFixtureSources(context, fixture)) {
+    blocker(context, '本轮 Finance 费用来源全部审核通过',
+      '费用来源未完成 PENDING -> APPROVED，禁止跳过审核直接生成对账单',
+      'finance-fee-source-review-failed')
+    finish(context, start)
+    return
+  }
   const issuedStatements = []
   for (let index = 0; index < groups.length; index += 1) {
     const created = await createStatement(context, groups[index], `selected-${index + 1}`,

scripts/admin-test-env-modules/orders-approval-convergence-contract.test.mjs

@@ -23,6 +23,12 @@ test('measurable inbound without fulfillment task remains pending', () => {
   }, { http: 200, body: { code: 'A0404' } }, tenantId, orderId), false)
 })
 
+test('approval polling remains pending before the first fulfillment task response', () => {
+  assert.equal(approvedInboundReady({
+    summary: { inboundId: null, mainStatus: 'PENDING_REVIEW' },
+  }, null, tenantId, orderId), false)
+})
+
 test('approval convergence requires matching inbound state, order and customer task identity', () => {
   const detail = { summary: { inboundId: '40001', mainStatus: 'WAIT_MEASURE' } }
   assert.equal(approvedInboundReady(detail, taskResponse, tenantId, orderId), true)

scripts/admin-test-env-modules/orders.mjs

@@ -17,7 +17,7 @@ const ORDER_ESTIMATE_VOLUME_CBM = BOXES.reduce((total, box) =>
 function id(value) { return value == null ? '' : String(value) }
 function records(value) { return Array.isArray(value?.records) ? value.records : [] }
 function pageOk(value) { return Array.isArray(value?.records) && Number.isFinite(Number(value?.total)) }
-function success(response) { return response.http === 200 && String(response.body?.code) === '200' }
+function success(response) { return response?.http === 200 && String(response.body?.code) === '200' }
 function sleep(milliseconds) { return new Promise((resolve) => setTimeout(resolve, milliseconds)) }
 function key(context, operation) { return `${context.marker}-${operation}`.slice(0, 128) }
 export function approvedInboundReady(orderDetail, taskResponse, tenantId, orderId) {

scripts/admin-test-env-modules/phase3-container-loading.mjs

@@ -147,12 +147,20 @@ export async function run(context) {
   const primaryRequirement = { containerType: '40HC', containerKind: 'FCL', capacityCbm: 76, maxWeightKg: 28000 }
   const realContainerNo = `TST-${suffix}-01`.slice(0, 64)
   const wrongContainerNo = `TST-${suffix}-02`.slice(0, 64)
+  const agentResponse = await context.request('GET',
+    '/api/platform/v1/suppliers?tenantId=0&category=BOOKING&status=ACTIVE&page=1&size=20')
+  const agentPage = context.apiSuccess(MODULE, '查询放舱所需 ACTIVE 订舱代理', agentResponse, '', OPTIONS)
+  const bookingAgent = records(agentPage).find((item) => item?.category === 'BOOKING' && item?.status === 'ACTIVE')
+  context.assert(MODULE, '放舱订舱使用真实启用供应商', agentResponse,
+    Boolean(bookingAgent?.id && bookingAgent?.name),
+    `supplierId=${id(bookingAgent?.id) || 'missing'}`, OPTIONS)
+  if (!bookingAgent?.id || !bookingAgent?.name) return
   const bookingDraft = {
     customerId: tenantId, customerName: inbound?.summary?.customerName || `验收客户-${tenantId}`,
     channelCode, warehouseId,
     billOfLadingNo: `BL-${suffix}`.slice(0, 128),
-    shippingCompanyId: null, shippingCompanyName: null,
-    bookingAgentId: null, bookingAgentName: null,
+    shippingCompanyId: id(bookingAgent.id), shippingCompanyName: bookingAgent.name,
+    bookingAgentId: id(bookingAgent.id), bookingAgentName: bookingAgent.name,
     vesselName: `验收船-${suffix}`.slice(0, 128), voyageNo: `V-${suffix}`.slice(0, 64),
     departurePortCode: 'CNSZX', departurePortName: '深圳',
     destinationPortCode: 'USLAX', destinationPortName: '洛杉矶', placeOfDelivery: 'LAX',

scripts/admin-test-env-modules/phase3-producer-chain-contract.test.mjs

@@ -372,10 +372,9 @@ test('container loading enforces channel isolation and stable PDA identity acros
   assert.match(value, /id\(replacedTask\?\.cabinetNo\) === stableIdentity\.cabinetNo/)
   assert.match(value, /afterReplacementSnapshot\?\.snapshotToken === beforeReplacementSnapshot\?\.snapshotToken/)
   assert.match(value, /pdaIdentityStable: true/)
-  assert.match(value, /shippingCompanyId: null, shippingCompanyName: null/)
-  assert.match(value, /bookingAgentId: null, bookingAgentName: null/)
-  assert.doesNotMatch(value, /shippingCompanyName: `验收船公司-/)
-  assert.doesNotMatch(value, /bookingAgentName: `验收代理-/)
+  assert.match(value, /category=BOOKING&status=ACTIVE/)
+  assert.match(value, /shippingCompanyId: id\(bookingAgent\.id\), shippingCompanyName: bookingAgent\.name/)
+  assert.match(value, /bookingAgentId: id\(bookingAgent\.id\), bookingAgentName: bookingAgent\.name/)
   assert.match(value, /const frozenTransport = Object\.fromEntries\(transportFields\.map/)
   assert.match(value, /if \(!frozenTransportMatches\) return/)
   assert.match(value, /expectedVersion: Number\(bookingCreatedDraft\?\.oceanBooking\?\.version\), reason: context\.marker/)