@chenchaolong/plugin-trade-compliance-workbench 1.0.18 → 1.0.20

package/dist/lib/workbench.service.js

@@ -24,16 +24,23 @@ import { TranslationProvider } from './adapters/translation.provider.js';
 import { parseBankAccountType, parseExchangeRateInput, parseExpectedRevision, validateBankSettingsInput, validateProfitSettingsInput, validatePurchaseLineDiscriminators, validateTaxRates } from './runtime-validation.js';
 import { publicCustomerContractReanalysisDto, publicImportTaskDto } from './public-dto.js';
 import { classifyCandidate } from './catalog-import/confidence.js';
+import { catalogTerminalOutcome } from './catalog-import/outcome.js';
 const DEFAULT_IMPORT_ISSUE_EXPORT_MAX_ROWS = 50_000;
 const HARD_IMPORT_ISSUE_EXPORT_MAX_ROWS = 100_000;
 const CUSTOMER_REANALYSIS_TIMEOUT_MS = 20 * 60 * 1000;
-const ANALYTICS_EXPORT_MAX_ROWS = 100_000;
+const DEFAULT_ANALYTICS_EXPORT_MAX_ROWS = 100_000;
 const CONTROLLED_CATALOG_TRANSLATION_CONCURRENCY = 4;
 const CONTROLLED_CATALOG_TRANSLATION_TIMEOUT_MS = 60_000;
 const CONTROLLED_CATALOG_PROCESSING_CLAIM_LEASE_MS = 90_000;
 const CONTROLLED_CATALOG_PROCESSING_HEARTBEAT_MS = 30_000;
 const CONTROLLED_CATALOG_PROCESSING_CLAIM_INITIAL_POLL_MS = 250;
 const CONTROLLED_CATALOG_PROCESSING_CLAIM_MAX_POLL_MS = 1_000;
+const SKIPPED_REASON_MESSAGES = {
+    SECTION_OR_NOTE_SKIPPED: '章节或说明行已跳过',
+    INVALID_HS_CODE: 'HS 编码格式无效',
+    EMPTY_PRODUCT_DESCRIPTION: '商品描述为空',
+    STRUCTURAL_MAPPING_AMBIGUOUS: '表格列结构无法可靠判断'
+};
 const RUNNING_IMPORT_TASK_STATUSES = ['EXTRACTING', 'AI_PARSING', 'VALIDATING', 'PERSISTING'];
 const RECOVERABLE_IMPORT_TASK_STATUSES = ['QUEUED', 'EXTRACTING', 'AI_PARSING', 'VALIDATING', 'PERSISTING'];
 const RECOVERABLE_REANALYSIS_STATUSES = ['PENDING', 'RUNNING'];
@@ -716,7 +723,8 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const batch = await batchRepo.save(batchRepo.create({
                     ...auditScope(scope), catalogType, sourceFileId: task.sourceFileId, sourceFileName: task.sourceFileName,
                     importMode: input.replaceBatchId ? 'REPLACE_BATCH' : 'APPEND', replacedBatchId: input.replaceBatchId ?? null,
-                    totalCount: 0, successCount: 0, duplicateCount: 0, invalidCount: 0,
+                    totalCount: 0, successCount: 0, duplicateCount: 0, invalidCount: 0, skippedCount: 0,
+                    inferenceMetadata: input.inferenceMetadata ?? null,
                     importTaskId: task.id, riskRecalculatedAt: null
                 }));
                 batchId = batch.id;
@@ -736,14 +744,15 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const batch = await batchRepo.save(batchRepo.create({
                     ...auditScope(scope), sourceFileId: task.sourceFileId, sourceFileName: task.sourceFileName,
                     importMode: input.replaceBatchId ? 'REPLACE_BATCH' : 'APPEND', replacedBatchId: input.replaceBatchId ?? null,
-                    totalCount: 0, successCount: 0, duplicateCount: 0, invalidCount: 0, importTaskId: task.id
+                    totalCount: 0, successCount: 0, duplicateCount: 0, invalidCount: 0, skippedCount: 0,
+                    inferenceMetadata: input.inferenceMetadata ?? null, importTaskId: task.id
                 }));
                 batchId = batch.id;
             }
             task.status = 'PERSISTING';
             task.resultEntityId = batchId;
             task.completedAt = null;
-            task.progress = initialFastCatalogProgress(input.totalCandidates);
+            task.progress = initialFastCatalogProgress(input.totalCandidates, input.inferenceMetadata);
             await taskRepo.save(task);
             return { committedCursor: 0, batchId };
         });
@@ -771,23 +780,29 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const batchRepo = manager.getRepository(ControlledCatalogBatch);
                 const batch = await required(batchRepo.findOne({ where: { ...activeScope(scope), id: task.resultEntityId } }), '管控目录批次不存在');
                 await this.appendControlledCatalogRows(manager, scope, batch, controlledRows, localizedRows);
+                await this.appendCatalogSkippedSources(manager.getRepository(ControlledCatalogImportIssue), scope, batch, input.skipped);
                 await batchRepo.save(batch);
                 task.progress.successCount = batch.successCount;
                 task.progress.duplicateCount = batch.duplicateCount;
                 task.progress.invalidCount = batch.invalidCount;
+                task.progress.skippedCount = batch.skippedCount;
             }
             else {
                 const batch = await this.appendFastSanctionCandidates(manager, scope, task.resultEntityId, input.candidates);
+                await this.appendCatalogSkippedSources(manager.getRepository(SanctionCatalogImportIssue), scope, batch, input.skipped);
+                await manager.getRepository(SanctionCatalogBatch).save(batch);
                 task.progress.successCount = batch.successCount;
                 task.progress.duplicateCount = batch.duplicateCount;
                 task.progress.invalidCount = batch.invalidCount;
+                task.progress.skippedCount = batch.skippedCount;
             }
+            let insertedReviewCount = 0;
             if (input.reviewBlocks.length) {
                 const reviewRepo = manager.getRepository(CatalogReviewBlock);
                 for (const block of input.reviewBlocks) {
                     const existing = await reviewRepo.findOne({ where: {
                             ...activeScope(scope), importTaskId: task.id, ordinal: block.ordinal,
-                            sourceLocation: block.sourceLocation, status: 'PENDING'
+                            sourceLocation: block.sourceLocation
                         } });
                     if (existing)
                         continue;
@@ -798,11 +813,12 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                         payload: block.payload, reasons: block.reasons,
                         leaseToken: null, leaseExpiresAt: null, resolvedAt: null
                     }));
+                    insertedReviewCount += 1;
                 }
             }
             task.progress.committedCursor = input.endCursor;
             task.progress.processedCount = input.endCursor + input.reviewBlocks.length + input.skipped.length;
-            task.progress.reviewPendingCount += input.reviewBlocks.length;
+            task.progress.reviewPendingCount += insertedReviewCount;
             task.progress.currentBatch = input.endCursor === 0 ? 0 : Math.ceil(input.endCursor / 100);
             task.progress.progressVersion += 1;
             task.progress.lastProgressAt = new Date().toISOString();
@@ -820,18 +836,42 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             if (!current.progress || current.progress.mode !== 'FAST_PIPELINE') {
                 throw new DomainError(DomainErrorCodes.INVALID_INPUT, '快速目录导入进度不存在');
             }
-            current.status = current.progress.reviewPendingCount > 0 ? 'AWAITING_REVIEW' : 'SUCCEEDED';
-            current.progress.stage = current.progress.reviewPendingCount > 0 ? 'REVIEWING' : 'SUCCEEDED';
-            current.progress.observerStatus = current.progress.reviewPendingCount > 0 ? 'PENDING' : 'COMPLETED';
+            if (current.progress.reviewPendingCount > 0) {
+                current.status = 'AWAITING_REVIEW';
+                current.progress.stage = 'REVIEWING';
+                current.progress.observerStatus = 'PENDING';
+                current.completedAt = null;
+            }
+            else {
+                const counts = await this.catalogBatchCounts(manager, scope, current);
+                const outcome = catalogTerminalOutcome(counts);
+                current.progress.successCount = counts.successCount;
+                current.progress.duplicateCount = counts.duplicateCount;
+                current.progress.invalidCount = counts.invalidCount;
+                current.progress.skippedCount = counts.skippedCount;
+                current.progress.outcome = outcome.outcome;
+                if (outcome.status === 'FAILED') {
+                    await this.applyImportTaskFailure(manager, scope, current, 'FAILED', outcome.errorCode, outcome.errorMessage);
+                }
+                else {
+                    current.status = 'SUCCEEDED';
+                    current.progress.stage = 'SUCCEEDED';
+                    current.progress.observerStatus = 'COMPLETED';
+                    current.errorCode = null;
+                    current.errorMessage = null;
+                    current.completedAt = new Date();
+                }
+            }
             current.progress.progressVersion += 1;
             current.progress.lastProgressAt = new Date().toISOString();
-            current.completedAt = new Date();
             return repo.save(current);
         });
-        if (task.documentType === 'CONTROLLED_CATALOG')
-            await this.recalculateProductRisks(scope, 'CATALOG_CHANGED', task.resultEntityId ?? undefined);
-        else
-            await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
+        if (task.status === 'SUCCEEDED' && (task.progress?.successCount ?? 0) > 0) {
+            if (task.documentType === 'CONTROLLED_CATALOG')
+                await this.recalculateProductRisks(scope, 'CATALOG_CHANGED', task.resultEntityId ?? undefined);
+            else
+                await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
+        }
         return task;
     }
     async waitImportProgress(scope, taskId, afterProgressVersion = 0, waitMs = 10_000) {
@@ -914,12 +954,14 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 throw new DomainError(DomainErrorCodes.INVALID_INPUT, '复核块租约无效或已过期');
             }
             const acceptedCandidates = [];
+            const rejectedBlocks = [];
             let resolved = 0;
             let rejected = 0;
             for (const item of items) {
                 const block = blocks.find(value => value.id === item.blockId);
                 if (item.decision === 'REJECT') {
                     block.status = 'REJECTED';
+                    rejectedBlocks.push(block);
                     rejected += 1;
                 }
                 else {
@@ -942,12 +984,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const batchRepo = manager.getRepository(ControlledCatalogBatch);
                 const batch = await required(batchRepo.findOne({ where: { ...activeScope(scope), id: task.resultEntityId } }), '管控目录批次不存在');
                 const rows = acceptedCandidates.flatMap(candidateToControlledRows);
-                const localized = rows.map(row => ({
-                    productName: String(row.productName ?? '').trim(),
-                    controlDescription: optionalString(row.controlDescription),
-                    originalProductName: null, originalControlDescription: null,
-                    translationSource: row.translationSource ?? null
-                }));
+                const localized = await this.localizeControlledCatalogRows(rows);
                 await this.appendControlledCatalogRows(manager, scope, batch, rows, localized);
                 await batchRepo.save(batch);
                 task.progress.successCount = batch.successCount;
@@ -960,6 +997,13 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 task.progress.duplicateCount = batch.duplicateCount;
                 task.progress.invalidCount = batch.invalidCount;
             }
+            const rejectedBatch = await this.appendRejectedCatalogReviews(manager, scope, task, rejectedBlocks);
+            if (rejectedBatch) {
+                task.progress.successCount = rejectedBatch.successCount;
+                task.progress.duplicateCount = rejectedBatch.duplicateCount;
+                task.progress.invalidCount = rejectedBatch.invalidCount;
+                task.progress.skippedCount = rejectedBatch.skippedCount;
+            }
             await reviewRepo.save(blocks);
             task.progress.reviewResolvedCount += resolved;
             task.progress.reviewRejectedCount += rejected;
@@ -967,10 +1011,24 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             task.progress.progressVersion += 1;
             task.progress.lastProgressAt = new Date().toISOString();
             if (task.progress.reviewPendingCount === 0) {
-                task.status = 'SUCCEEDED';
-                task.progress.stage = 'SUCCEEDED';
-                task.progress.observerStatus = 'COMPLETED';
-                task.completedAt = new Date();
+                const counts = await this.catalogBatchCounts(manager, scope, task);
+                const outcome = catalogTerminalOutcome(counts);
+                task.progress.successCount = counts.successCount;
+                task.progress.duplicateCount = counts.duplicateCount;
+                task.progress.invalidCount = counts.invalidCount;
+                task.progress.skippedCount = counts.skippedCount;
+                task.progress.outcome = outcome.outcome;
+                if (outcome.status === 'FAILED') {
+                    await this.applyImportTaskFailure(manager, scope, task, 'FAILED', outcome.errorCode, outcome.errorMessage);
+                }
+                else {
+                    task.status = 'SUCCEEDED';
+                    task.progress.stage = 'SUCCEEDED';
+                    task.progress.observerStatus = 'COMPLETED';
+                    task.errorCode = null;
+                    task.errorMessage = null;
+                    task.completedAt = new Date();
+                }
             }
             else {
                 task.status = 'AWAITING_REVIEW';
@@ -1039,6 +1097,148 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         }
         return batchRepo.save(batch);
     }
+    async appendCatalogSkippedSources(repository, scope, batch, skippedSources) {
+        for (const skipped of skippedSources) {
+            const parsedPayload = { skipReason: skipped.reason, sourceLocation: skipped.sourceLocation };
+            const existing = await repository.findOne({ where: {
+                    ...activeScope(scope), batchId: batch.id, issueType: 'INVALID', parsedPayload
+                } });
+            if (existing)
+                continue;
+            batch.totalCount += 1;
+            batch.invalidCount += 1;
+            batch.skippedCount += 1;
+            await repository.save(repository.create({
+                ...createdScope(scope), batchId: batch.id, issueType: 'INVALID', sourceSequence: batch.totalCount,
+                sourceLocation: skipped.sourceLocation || null, sourceContent: skipped.sourceContent || null,
+                parsedPayload, message: SKIPPED_REASON_MESSAGES[skipped.reason] ?? '无法入库的来源行已跳过'
+            }));
+        }
+    }
+    async appendRejectedCatalogReviews(manager, scope, task, blocks) {
+        if (blocks.length === 0 || !task.resultEntityId)
+            return null;
+        const controlled = task.documentType === 'CONTROLLED_CATALOG';
+        const batchRepo = controlled
+            ? manager.getRepository(ControlledCatalogBatch)
+            : manager.getRepository(SanctionCatalogBatch);
+        const issueRepo = controlled
+            ? manager.getRepository(ControlledCatalogImportIssue)
+            : manager.getRepository(SanctionCatalogImportIssue);
+        const batch = await required(batchRepo.findOne({ where: {
+                ...activeScope(scope), id: task.resultEntityId
+            } }), controlled ? '管控目录批次不存在' : '制裁目录批次不存在');
+        for (const block of blocks) {
+            const parsedPayload = { reviewBlockId: block.id, reviewDecision: 'REJECT' };
+            const existing = await issueRepo.findOne({ where: {
+                    ...activeScope(scope), batchId: batch.id, issueType: 'INVALID', parsedPayload
+                } });
+            if (existing)
+                continue;
+            batch.totalCount += 1;
+            batch.invalidCount += 1;
+            batch.skippedCount += 1;
+            await issueRepo.save(issueRepo.create({
+                ...createdScope(scope), batchId: batch.id, issueType: 'INVALID', sourceSequence: batch.totalCount,
+                sourceLocation: block.sourceLocation, sourceContent: block.sourceContent,
+                parsedPayload, message: '审核未通过，来源行已跳过'
+            }));
+        }
+        return batchRepo.save(batch);
+    }
+    async catalogBatchCounts(manager, scope, task) {
+        if (!task.resultEntityId)
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '目录导入批次不存在');
+        const batch = task.documentType === 'CONTROLLED_CATALOG'
+            ? await required(manager.getRepository(ControlledCatalogBatch).findOne({
+                where: { ...activeScope(scope), id: task.resultEntityId }
+            }), '管控目录批次不存在')
+            : await required(manager.getRepository(SanctionCatalogBatch).findOne({
+                where: { ...activeScope(scope), id: task.resultEntityId }
+            }), '制裁目录批次不存在');
+        return {
+            successCount: batch.successCount,
+            duplicateCount: batch.duplicateCount,
+            invalidCount: batch.invalidCount,
+            skippedCount: batch.skippedCount ?? 0
+        };
+    }
+    async rollbackFailedCatalogReplacement(manager, scope, task) {
+        if (!task.resultEntityId || (task.documentType !== 'CONTROLLED_CATALOG' && task.documentType !== 'SANCTION_CATALOG'))
+            return;
+        const now = new Date();
+        if (task.documentType === 'CONTROLLED_CATALOG') {
+            const batchRepo = manager.getRepository(ControlledCatalogBatch);
+            const recordRepo = manager.getRepository(ControlledGoodsRecord);
+            const current = await batchRepo.findOne({ where: { ...activeScope(scope), id: task.resultEntityId } });
+            if (!current?.replacedBatchId)
+                return;
+            const replaced = await batchRepo.findOne({ where: { ...activeScope(scope), id: current.replacedBatchId } });
+            if (!replaced || replaced.deleteOperation !== 'CATALOG_REPLACE')
+                return;
+            current.deletedAt = now;
+            current.deletedById = scope.userId ?? null;
+            current.deleteOperation = 'IMPORT_FAILED';
+            current.updatedById = scope.userId ?? null;
+            await batchRepo.save(current);
+            await recordRepo.update({
+                ...activeScope(scope), batchId: current.id, deletedAt: IsNull()
+            }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'IMPORT_FAILED', updatedById: scope.userId ?? null });
+            replaced.deletedAt = null;
+            replaced.deletedById = null;
+            replaced.deleteOperation = null;
+            replaced.updatedById = scope.userId ?? null;
+            await batchRepo.save(replaced);
+            await recordRepo.update({
+                ...activeScope(scope), batchId: replaced.id, deleteOperation: 'CATALOG_REPLACE'
+            }, { deletedAt: null, deletedById: null, deleteOperation: null, updatedById: scope.userId ?? null });
+            return;
+        }
+        const batchRepo = manager.getRepository(SanctionCatalogBatch);
+        const recordRepo = manager.getRepository(SanctionedCompanyRecord);
+        const aliasRepo = manager.getRepository(SanctionedCompanyAlias);
+        const current = await batchRepo.findOne({ where: { ...activeScope(scope), id: task.resultEntityId } });
+        if (!current?.replacedBatchId)
+            return;
+        const replaced = await batchRepo.findOne({ where: { ...activeScope(scope), id: current.replacedBatchId } });
+        if (!replaced || replaced.deleteOperation !== 'SANCTION_CATALOG_REPLACE')
+            return;
+        current.deletedAt = now;
+        current.deletedById = scope.userId ?? null;
+        current.deleteOperation = 'IMPORT_FAILED';
+        current.updatedById = scope.userId ?? null;
+        await batchRepo.save(current);
+        const failedRecords = await recordRepo.find({
+            where: { ...activeScope(scope), batchId: current.id, deletedAt: IsNull() }, select: { id: true }
+        });
+        if (failedRecords.length > 0) {
+            await aliasRepo.update({
+                ...activeScope(scope), sanctionedCompanyId: In(failedRecords.map(record => record.id)), deletedAt: IsNull()
+            }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'IMPORT_FAILED', updatedById: scope.userId ?? null });
+        }
+        await recordRepo.update({
+            ...activeScope(scope), batchId: current.id, deletedAt: IsNull()
+        }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'IMPORT_FAILED', updatedById: scope.userId ?? null });
+        replaced.deletedAt = null;
+        replaced.deletedById = null;
+        replaced.deleteOperation = null;
+        replaced.updatedById = scope.userId ?? null;
+        await batchRepo.save(replaced);
+        await recordRepo.update({
+            ...activeScope(scope), batchId: replaced.id, deleteOperation: 'SANCTION_CATALOG_REPLACE'
+        }, { deletedAt: null, deletedById: null, deleteOperation: null, updatedById: scope.userId ?? null });
+    }
+    async applyImportTaskFailure(manager, scope, task, status, errorCode, errorMessage, completedAt = new Date()) {
+        task.status = status;
+        task.errorCode = errorCode;
+        task.errorMessage = errorMessage;
+        task.completedAt = completedAt;
+        if (task.progress?.mode === 'FAST_PIPELINE') {
+            task.progress.stage = 'FAILED';
+            task.progress.observerStatus = 'FAILED';
+            await this.rollbackFailedCatalogReplacement(manager, scope, task);
+        }
+    }
     async createImportTask(scope, input) {
         const repo = this.dataSource.getRepository(ImportTask);
         const targetAssistantId = requiredId(input.targetAssistantId, '目标智能体标识');
@@ -1075,10 +1275,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             if (!task)
                 return null;
             if (!task.targetAssistantId) {
-                task.status = 'FAILED';
-                task.errorCode = 'TARGET_ASSISTANT_MISSING';
-                task.errorMessage = '历史解析任务缺少目标智能体，无法自动恢复';
-                task.completedAt = new Date();
+                await this.applyImportTaskFailure(manager, scope, task, 'FAILED', 'TARGET_ASSISTANT_MISSING', '历史解析任务缺少目标智能体，无法自动恢复');
                 await repo.save(task);
                 return null;
             }
@@ -1102,10 +1299,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             if (!task)
                 return null;
             if (!task.targetAssistantId) {
-                task.status = 'FAILED';
-                task.errorCode = 'TARGET_ASSISTANT_MISSING';
-                task.errorMessage = '历史解析任务缺少目标智能体，无法自动恢复';
-                task.completedAt = new Date();
+                await this.applyImportTaskFailure(manager, scope, task, 'FAILED', 'TARGET_ASSISTANT_MISSING', '历史解析任务缺少目标智能体，无法自动恢复');
                 await repo.save(task);
                 return null;
             }
@@ -1181,10 +1375,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             const task = await repo.findOne({ where: { ...activeScope(snapshot), id: snapshot.id }, lock: { mode: 'pessimistic_write' } });
             if (!task || task.targetAssistantId || !RECOVERABLE_IMPORT_TASK_STATUSES.includes(task.status))
                 return;
-            task.status = 'FAILED';
-            task.errorCode = 'TARGET_ASSISTANT_MISSING';
-            task.errorMessage = '历史解析任务缺少目标智能体，无法自动恢复';
-            task.completedAt = new Date();
+            await this.applyImportTaskFailure(manager, snapshot, task, 'FAILED', 'TARGET_ASSISTANT_MISSING', '历史解析任务缺少目标智能体，无法自动恢复');
             await repo.save(task);
         });
     }
@@ -1213,10 +1404,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 return task;
             if (task.claimAttemptToken !== attemptToken)
                 return task;
-            task.status = 'TIMED_OUT';
-            task.errorCode = 'AI_PARSING_TIMEOUT';
-            task.errorMessage = '解析任务超过 20 分钟未完成';
-            task.completedAt = new Date();
+            await this.applyImportTaskFailure(manager, scope, task, 'TIMED_OUT', 'AI_PARSING_TIMEOUT', '解析任务超过 20 分钟未完成');
             return repo.save(task);
         });
     }
@@ -1328,10 +1516,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 return task;
             if (task.status === 'FAILED' || task.status === 'TIMED_OUT')
                 return task;
-            task.status = 'FAILED';
-            task.errorCode = 'AGENT_HANDOFF_RESULT_MISSING';
-            task.errorMessage = '智能体已结束，但解析工具未保存业务结果';
-            task.completedAt = new Date();
+            await this.applyImportTaskFailure(manager, scope, task, 'FAILED', 'AGENT_HANDOFF_RESULT_MISSING', '智能体已结束，但解析工具未保存业务结果');
             return repo.save(task);
         });
     }
@@ -1355,17 +1540,11 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             if (input.kind === 'complete' &&
                 task.status !== 'AWAITING_REVIEW' && task.status !== 'SUCCEEDED' &&
                 task.status !== 'FAILED' && task.status !== 'TIMED_OUT') {
-                task.status = 'FAILED';
-                task.errorCode = 'AGENT_HANDOFF_RESULT_MISSING';
-                task.errorMessage = '智能体已结束，但解析工具未保存业务结果';
-                task.completedAt = new Date();
+                await this.applyImportTaskFailure(manager, scope, task, 'FAILED', 'AGENT_HANDOFF_RESULT_MISSING', '智能体已结束，但解析工具未保存业务结果');
             }
             else if (input.kind === 'error' &&
                 !TERMINAL_IMPORT_TASK_STATUSES.includes(task.status)) {
-                task.status = 'FAILED';
-                task.errorCode = requiredId(input.errorCode, '错误代码');
-                task.errorMessage = requiredId(input.errorMessage, '错误信息');
-                task.completedAt = new Date();
+                await this.applyImportTaskFailure(manager, scope, task, 'FAILED', requiredId(input.errorCode, '错误代码'), requiredId(input.errorMessage, '错误信息'));
             }
             await repo.save(task);
             return { accepted: true, sequence: input.sequence };
@@ -1377,10 +1556,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             const task = await required(repo.findOne({ where: { ...activeScope(scope), id }, lock: { mode: 'pessimistic_write' } }), '解析任务不存在');
             if (TERMINAL_IMPORT_TASK_STATUSES.includes(task.status))
                 return task;
-            task.status = 'FAILED';
-            task.errorCode = failure.errorCode;
-            task.errorMessage = failure.errorMessage;
-            task.completedAt = new Date();
+            await this.applyImportTaskFailure(manager, scope, task, 'FAILED', failure.errorCode, failure.errorMessage);
             return repo.save(task);
         });
     }
@@ -1397,10 +1573,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 return task;
             if (!snapshotMissingRecoveryMetadataStillMissing(snapshot, task))
                 return task;
-            task.status = 'FAILED';
-            task.errorCode = failure.errorCode;
-            task.errorMessage = failure.errorMessage;
-            task.completedAt = new Date();
+            await this.applyImportTaskFailure(manager, scope, task, 'FAILED', failure.errorCode, failure.errorMessage);
             return repo.save(task);
         });
     }
@@ -2470,10 +2643,33 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                         .orWhere("COALESCE(row.generationSnapshot #>> '{request,fileNumber}', '') ILIKE :generatedFileName")), { generatedFileName: `%${String(fileName).trim()}%` });
                 }
                 if (hasQueryValue(customerName))
-                    qb.andWhere("COALESCE(row.generationSnapshot #>> '{customer,name}', '') ILIKE :generatedFileCustomerName", { generatedFileCustomerName: `%${String(customerName).trim()}%` });
-            }
-        });
-        return { ...page, items: page.items.map(item => ({ ...item, customerName: generatedFileCustomerName(item.generationSnapshot) })) };
+                    qb.andWhere(`(
+            COALESCE(row.generationSnapshot #>> '{customer,name}', '') ILIKE :generatedFileCustomerName
+            OR EXISTS (
+              SELECT 1
+              FROM plugin_trade_compliance_customer_contract legacy_contract_filter
+              INNER JOIN plugin_trade_compliance_customer legacy_customer_filter
+                ON legacy_customer_filter.id = legacy_contract_filter."customerId"
+               AND legacy_customer_filter."tenantId" = legacy_contract_filter."tenantId"
+               AND legacy_customer_filter."organizationId" = legacy_contract_filter."organizationId"
+               AND legacy_customer_filter."deletedAt" IS NULL
+              WHERE legacy_contract_filter.id = row."customerContractId"
+                AND legacy_contract_filter."tenantId" = row."tenantId"
+                AND legacy_contract_filter."organizationId" = row."organizationId"
+                AND legacy_contract_filter."deletedAt" IS NULL
+                AND legacy_customer_filter.name ILIKE :generatedFileCustomerName
+            )
+          )`, { generatedFileCustomerName: `%${String(customerName).trim()}%` });
+            }
+        });
+        const snapshotNames = new Map(page.items.map(item => [item.id, generatedFileCustomerName(item.generationSnapshot)]));
+        const fallbackContractIds = [...new Set(page.items.filter(item => !snapshotNames.get(item.id)).map(item => item.customerContractId).filter((id) => Boolean(id)))];
+        const contracts = fallbackContractIds.length ? await this.dataSource.getRepository(CustomerContract).find({ where: { ...activeScope(scope), id: In(fallbackContractIds), deletedAt: IsNull() } }) : [];
+        const customerIds = [...new Set(contracts.map(contract => contract.customerId).filter((id) => Boolean(id)))];
+        const customers = customerIds.length ? await this.dataSource.getRepository(Customer).find({ where: { ...activeScope(scope), id: In(customerIds), deletedAt: IsNull() } }) : [];
+        const contractCustomerIds = new Map(contracts.map(contract => [contract.id, contract.customerId]));
+        const customerNames = new Map(customers.map(customer => [customer.id, customer.name]));
+        return { ...page, items: page.items.map(item => ({ ...item, customerName: snapshotNames.get(item.id) ?? customerNames.get(contractCustomerIds.get(item.customerContractId) ?? '') ?? null })) };
     }
     async listMonthlyRates(scope, query = {}) {
         const page = Math.max(1, Math.trunc(Number(query.page)) || 1);
@@ -2695,8 +2891,9 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         const statement = analyticsAggregationStatement(scope, query, currentYear, 'PAGE');
         const rawRows = await source.query(statement.sql, statement.parameters);
         const total = Number(rawRows[0]?.total ?? rawRows.length);
-        if (total > ANALYTICS_EXPORT_MAX_ROWS)
-            throw new DomainError(DomainErrorCodes.INVALID_INPUT, `分析分组最多支持 ${ANALYTICS_EXPORT_MAX_ROWS} 条`, { total });
+        const maxRows = analyticsExportMaxRows();
+        if (total > maxRows)
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, `分析分组最多支持 ${maxRows} 条`, { total });
         const pageCount = Math.max(1, Math.ceil(total / query.pageSize));
         const page = Math.min(query.page, pageCount);
         const pageStart = (page - 1) * query.pageSize + 1;
@@ -2724,11 +2921,12 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 sheet.getRow(1).font = { bold: true };
                 sheet.getRow(1).commit();
                 const statement = analyticsAggregationStatement(scope, query, shanghaiCurrentYear(), 'EXPORT');
+                const maxRows = analyticsExportMaxRows();
                 let count = 0;
                 await this.withAnalyticsSnapshot(statement, async (raw) => {
                     count += 1;
-                    if (count > ANALYTICS_EXPORT_MAX_ROWS)
-                        throw new DomainError(DomainErrorCodes.INVALID_INPUT, `分析导出最多支持 ${ANALYTICS_EXPORT_MAX_ROWS} 条明细`, { total: count });
+                    if (count > maxRows)
+                        throw new DomainError(DomainErrorCodes.INVALID_INPUT, `分析导出最多支持 ${maxRows} 条明细`, { total: count });
                     const row = analyticsDetailFromRaw(raw, query);
                     sheet.addRow(query.dimension === 'PRODUCT'
                         ? [row.label, row.orderCount, row.productQuantity, row.amountCny]
@@ -3083,10 +3281,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const lockedStartedAt = locked.startedAt ?? locked.queuedAt ?? locked.createdAt;
                 if (!lockedStartedAt || !importTaskTimedOut(lockedStartedAt, now))
                     return;
-                locked.status = 'TIMED_OUT';
-                locked.errorCode = DomainErrorCodes.IMPORT_TIMED_OUT;
-                locked.errorMessage = '文件解析超过 20 分钟，请重新上传';
-                locked.completedAt = now;
+                await this.applyImportTaskFailure(manager, scope, locked, 'TIMED_OUT', DomainErrorCodes.IMPORT_TIMED_OUT, '文件解析超过 20 分钟，请重新上传', now);
                 locked.machineElapsedMs = now.getTime() - lockedStartedAt.getTime();
                 await lockedRepo.save(locked);
             });
@@ -3327,6 +3522,7 @@ function reanalysisClauseInput(value) {
     return { clauseType: clause.clauseType, extractionStatus: clause.extractionStatus, sourceText: optionalText('sourceText'), reviewedText: optionalText('reviewedText'), sourceLocation: optionalText('sourceLocation'), sourceContent: optionalText('sourceContent') };
 }
 function importIssueExportLimit() { const configured = Number(process.env.TRADE_COMPLIANCE_IMPORT_ISSUE_EXPORT_MAX_ROWS); return Math.min(HARD_IMPORT_ISSUE_EXPORT_MAX_ROWS, Number.isFinite(configured) && configured > 0 ? Math.floor(configured) : DEFAULT_IMPORT_ISSUE_EXPORT_MAX_ROWS); }
+function analyticsExportMaxRows() { const configured = Number(process.env.TRADE_COMPLIANCE_ANALYTICS_EXPORT_MAX_ROWS); return Number.isInteger(configured) && configured > 0 ? configured : DEFAULT_ANALYTICS_EXPORT_MAX_ROWS; }
 function hasQueryValue(value) { return value !== undefined && value !== null && String(value).trim() !== ''; }
 function generatedFileCustomerName(snapshot) {
     const customer = snapshot?.customer;
@@ -3523,7 +3719,7 @@ function optionalString(value) {
     const normalized = String(value ?? '').trim();
     return normalized || null;
 }
-function initialFastCatalogProgress(totalCandidates) {
+function initialFastCatalogProgress(totalCandidates, inferenceMetadata) {
     return {
         version: 1,
         mode: 'FAST_PIPELINE',
@@ -3533,6 +3729,8 @@ function initialFastCatalogProgress(totalCandidates) {
         successCount: 0,
         duplicateCount: 0,
         invalidCount: 0,
+        skippedCount: 0,
+        inferenceMetadata,
         currentBatch: 0,
         totalBatches: totalCandidates > 0 ? Math.ceil(totalCandidates / 100) : 0,
         committedCursor: 0,
@@ -3551,6 +3749,7 @@ function candidateToControlledRows(candidate) {
         : [undefined];
     return hsCodes.map(hsCode => ({
         productName: optionalString(candidate.values.productName) ?? undefined,
+        originalProductName: optionalString(candidate.values.originalProductName) ?? undefined,
         hsCode: typeof hsCode === 'string' ? hsCode : undefined,
         controlDescription: optionalString(candidate.values.controlDescription) ?? undefined,
         controlCode: optionalString(candidate.values.controlCode) ?? undefined,
@@ -3558,7 +3757,9 @@ function candidateToControlledRows(candidate) {
         sourceOrdinal: optionalString(candidate.values.sourceOrdinal) ?? String(candidate.ordinal),
         sourceLocation: evidence?.sourceLocation,
         sourceContent: evidence?.sourceContent,
-        translationSource: 'SOURCE_CHINESE'
+        translationSource: candidate.values.translationRequired || (!candidate.values.productName && candidate.values.originalProductName)
+            ? 'AGENT_TRANSLATED'
+            : 'SOURCE_CHINESE'
     }));
 }
 function candidateAliases(candidate) {
@@ -3713,7 +3914,7 @@ function analyticsAggregationStatement(scope, query, currentYear, purpose) {
           FROM sales_orders orders GROUP BY orders."customerId"
         )`;
     }
-    const bounded = `${sourceSql}, bounded AS (SELECT * FROM grouped ORDER BY "amountCny" DESC, key ASC LIMIT ${ANALYTICS_EXPORT_MAX_ROWS + 1})`;
+    const bounded = `${sourceSql}, bounded AS (SELECT * FROM grouped ORDER BY "amountCny" DESC, key ASC LIMIT ${analyticsExportMaxRows() + 1})`;
     if (purpose === 'EXPORT')
         return { sql: `WITH ${bounded} SELECT * FROM bounded ORDER BY "amountCny" DESC, key ASC`, parameters };
     const metricColumns = query.dimension === 'PRODUCT'