@chenchaolong/plugin-trade-compliance-workbench 1.0.19 → 1.0.21

package/dist/lib/workbench.service.js

@@ -24,6 +24,7 @@ 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;
@@ -34,6 +35,12 @@ 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'];
@@ -219,7 +226,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const pendingRows = await this.pendingControlledCatalogRows(scope, claim.batch, input.rows);
                 if (!pendingRows.length)
                     return this.completeControlledCatalogPostProcessing(scope, claim.batch);
-                const localizedRows = await this.localizeControlledCatalogRows(pendingRows);
+                const localizedRows = await this.localizeControlledCatalogRows(pendingRows, scope.organizationId);
                 const appended = await this.appendCompletedControlledCatalog(scope, { ...input, rows: pendingRows }, localizedRows, claim.batch.id);
                 return this.completeControlledCatalogPostProcessing(scope, appended);
             }
@@ -231,7 +238,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             try {
                 let result;
                 try {
-                    const localizedRows = await this.localizeControlledCatalogRows(input.rows, claim.deadline, heartbeat.signal);
+                    const localizedRows = await this.localizeControlledCatalogRows(input.rows, scope.organizationId, claim.deadline, heartbeat.signal);
                     heartbeat.assertOwned();
                     result = await this.persistControlledCatalog(scope, input, localizedRows, claim.claimId);
                 }
@@ -462,7 +469,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         batch.riskRecalculatedAt = result.riskRecalculatedAt ?? new Date();
         return batch;
     }
-    async localizeControlledCatalogRows(rows, deadline = Date.now() + CONTROLLED_CATALOG_TRANSLATION_TIMEOUT_MS, ownerSignal) {
+    async localizeControlledCatalogRows(rows, organizationId, deadline = Date.now() + CONTROLLED_CATALOG_TRANSLATION_TIMEOUT_MS, ownerSignal) {
         const localized = new Array(rows.length);
         const controller = new AbortController();
         const abortFromOwner = () => controller.abort(ownerSignal?.reason);
@@ -476,7 +483,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             while (nextIndex < rows.length) {
                 const index = nextIndex;
                 nextIndex += 1;
-                localized[index] = await this.localizeControlledCatalogRow(rows[index], deadline, controller.signal);
+                localized[index] = await this.localizeControlledCatalogRow(rows[index], organizationId, deadline, controller.signal);
             }
         };
         try {
@@ -488,7 +495,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             ownerSignal?.removeEventListener('abort', abortFromOwner);
         }
     }
-    async localizeControlledCatalogRow(row, deadline, signal) {
+    async localizeControlledCatalogRow(row, organizationId, deadline, signal) {
         const originalProductName = String(row.originalProductName ?? '').trim() || null;
         const originalControlDescription = String(row.originalControlDescription ?? '').trim() || null;
         let productName = String(row.productName ?? '').trim();
@@ -501,13 +508,13 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         if (!productName) {
             if (!originalProductName)
                 return { productName: '', controlDescription, originalProductName, originalControlDescription, translationSource, error: '商品名称为空' };
-            productName = await this.translateCatalogValue(originalProductName, deadline, signal) ?? '';
+            productName = await this.translateCatalogValue(originalProductName, organizationId, deadline, signal) ?? '';
             if (!productName)
                 return { productName: '', controlDescription, originalProductName, originalControlDescription, translationSource, error: '商品名称翻译失败' };
             serviceTranslated = true;
         }
         if (!controlDescription && originalControlDescription) {
-            controlDescription = await this.translateCatalogValue(originalControlDescription, deadline, signal);
+            controlDescription = await this.translateCatalogValue(originalControlDescription, organizationId, deadline, signal);
             if (!controlDescription)
                 return { productName, controlDescription: null, originalProductName, originalControlDescription, translationSource, error: '管控说明翻译失败' };
             serviceTranslated = true;
@@ -518,11 +525,11 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             translationSource = 'SERVICE_TRANSLATED';
         return { productName, controlDescription, originalProductName, originalControlDescription, translationSource };
     }
-    async translateCatalogValue(value, deadline, signal) {
+    async translateCatalogValue(value, organizationId, deadline, signal) {
         const remaining = deadline - Date.now();
         if (!this.translation || remaining <= 0 || signal.aborted)
             return null;
-        const translated = Promise.resolve(this.translation.toChinese(value, { signal, deadline }))
+        const translated = Promise.resolve(this.translation.toChinese(value, { signal, deadline, organizationId }))
             .then(result => String(result ?? '').trim() || null, () => null);
         let onAbort;
         try {
@@ -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 };
         });
@@ -752,7 +761,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         const controlledRows = input.candidates.flatMap(candidate => candidate.kind === 'CONTROLLED'
             ? candidateToControlledRows(candidate)
             : []);
-        const localizedRows = controlledRows.length ? await this.localizeControlledCatalogRows(controlledRows) : [];
+        const localizedRows = controlledRows.length ? await this.localizeControlledCatalogRows(controlledRows, scope.organizationId) : [];
         return this.dataSource.transaction(async (manager) => {
             const taskRepo = manager.getRepository(ImportTask);
             const task = await required(taskRepo.findOne({
@@ -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, scope.organizationId);
                 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);
         });
     }
@@ -3108,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);
             });
@@ -3549,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',
@@ -3559,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,
@@ -3577,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,
@@ -3584,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) {