优化

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

@@ -323,20 +323,25 @@ export async function run(context) {
     finish(context, start)
     return
   }
+  fixture.root.reconciliationPrerequisite = null
   const permissionResponse = await context.request('GET', '/api/platform/v1/iam/authorization/permissions')
   const permissions = context.apiSuccess(MODULE, '查询当前账号 Finance 有效权限', permissionResponse, '', OPTIONS)
   const granted = new Set(list(permissions).map(String))
   if (granted.has(LEGACY_STATEMENT_VIEW_PERMISSION)) {
+    fixture.root.reconciliationPrerequisite = { ready: false, category: 'permission-prerequisite',
+      required: [STATEMENT_LIST_PERMISSION], legacy: [LEGACY_STATEMENT_VIEW_PERMISSION] }
     blocker(context, '客户对账单旧 view 权限兼容阻断',
-      `检测到旧权限=${LEGACY_STATEMENT_VIEW_PERMISSION}；列表和详情只能以正式权限=${STATEMENT_LIST_PERMISSION} 验收，旧 view 不得作为通过依据`,
+      `检测到旧权限=${LEGACY_STATEMENT_VIEW_PERMISSION}；列表和详情只能以正式权限=${STATEMENT_LIST_PERMISSION} 验收，旧 view 不得作为通过依据；需由 IAM 角色初始化为验收账号授予 ${STATEMENT_LIST_PERMISSION} 并移除旧资源，Finance 脚本不兼容旧权限`,
       'legacy-customer-statement-view-permission', permissionResponse)
     finish(context, start)
     return
   }
   const missingPermissions = REQUIRED_PERMISSIONS.filter((permission) => !granted.has(permission))
   if (missingPermissions.length > 0) {
+    fixture.root.reconciliationPrerequisite = { ready: false, category: 'permission-prerequisite',
+      required: missingPermissions, legacy: [] }
     blocker(context, 'Finance 写权限门禁',
-      `缺少权限=${missingPermissions.join(',')}; 对账接口将返回 A0403，禁止继续写入`,
+      `缺少正式权限资源=${missingPermissions.join(',')}; 需由 IAM 角色初始化授予验收账号；对账接口将返回 A0403，禁止继续写入`,
       'missing-finance-write-permissions', permissionResponse)
     finish(context, start)
     return
@@ -353,6 +358,8 @@ export async function run(context) {
   const invalid = fixture.sources.filter((source) => !source.feeSourceId || !source.customerId
     || !source.businessDate || !source.waybillId || source.marker !== context.marker)
   if (invalid.length > 0) {
+    fixture.root.reconciliationPrerequisite = { ready: false, category: 'finance-source-prerequisite',
+      invalidSourceCount: invalid.length }
     blocker(context, 'Fixture 来源契约完整',
       `存在 ${invalid.length} 条来源缺少 feeSourceId/customerId/businessDate/运单标识/marker`,
       'invalid-finance-fixture-contract')
@@ -364,6 +371,8 @@ export async function run(context) {
     && source.direction === 'RECEIVABLE' && source.currency === 'CNY')
   const businessDates = new Set(receivables.map((source) => source.businessDate))
   if (receivables.length < 4 || businessDates.size < 2) {
+    fixture.root.reconciliationPrerequisite = { ready: false, category: 'finance-source-prerequisite',
+      receivableCount: receivables.length, businessDateCount: businessDates.size }
     blocker(context, '三张 AR 与日期范围 Fixture 门禁',
       `至少需要同客户 4 条 CNY 应收来源且跨 2 个真实 businessDate；actual sources=${receivables.length}, dates=${businessDates.size}`,
       'insufficient-receivable-date-fixture')