@chenchaolong/plugin-trade-compliance-workbench 1.0.11 → 1.0.12

package/dist/lib/workbench.service.js

@@ -1,7 +1,7 @@
 import { __decorate, __metadata, __param } from "tslib";
 import { Injectable, Optional } from '@nestjs/common';
 import { InjectDataSource } from '@nestjs/typeorm';
-import { Brackets, DataSource, In, IsNull, Not } from 'typeorm';
+import { Brackets, DataSource, In, IsNull, LessThanOrEqual, Not } from 'typeorm';
 import { Decimal } from 'decimal.js';
 import ExcelJS from 'exceljs';
 import { createWriteStream } from 'node:fs';
@@ -10,7 +10,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { finished } from 'node:stream/promises';
 import { randomUUID } from 'node:crypto';
-import { BankAccountSettings, CompanySanctionMatch, CompanySettings, ControlledCatalogBatch, ControlledCatalogImportIssue, ControlledGoodsRecord, Customer, CustomerContract, CustomerContractAnalysisRun, CustomerContractClause, CustomerContractClauseAnalysis, DerivedSalesOrderManualData, GeneratedSalesFile, ImportTask, ManagedAsset, MonthlySafeExchangeRate, ProductComplianceMatch, ProfitRuleSettings, PurchaseOrder, PurchaseOrderLine, SanctionCatalogBatch, SanctionCatalogImportIssue, SanctionedCompanyRecord, SettingsHistory, Supplier } from './entities/index.js';
+import { BankAccountSettings, CatalogReviewBlock, CompanySanctionMatch, CompanySettings, ControlledCatalogBatch, ControlledCatalogImportIssue, ControlledGoodsRecord, Customer, CustomerContract, CustomerContractAnalysisRun, CustomerContractClause, CustomerContractClauseAnalysis, DerivedSalesOrderManualData, GeneratedSalesFile, ImportTask, ManagedAsset, MonthlySafeExchangeRate, ProductComplianceMatch, ProfitRuleSettings, PurchaseOrder, PurchaseOrderLine, SanctionCatalogBatch, SanctionCatalogImportIssue, SanctionedCompanyAlias, SanctionedCompanyRecord, SettingsHistory, Supplier } from './entities/index.js';
 import { CatalogTypes, ClauseTypes, CustomerProfitRateStatuses, DomainError, DomainErrorCodes, RefundValidationMethods, SalesPaymentStatuses, SanctionHitStatuses } from './types.js';
 import { deriveSalesLine, assertReceivedAmount } from './domain/finance.js';
 import { parseCustomerContractNo, parsePurchaseContractNo } from './domain/contract-number.js';
@@ -23,6 +23,7 @@ import { TradeComplianceFileStorage } from './adapters/file-storage.js';
 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';
 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;
@@ -442,7 +443,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 await issueRepo.save(issueRepo.create({ ...createdScope(scope), batchId: batch.id, issueType: 'DUPLICATE', sourceSequence: batch.totalCount, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null, parsedPayload: row, message: '目录中已存在相同商品名称和海关编码' }));
                 continue;
             }
-            await recordRepo.save(recordRepo.create({ ...auditScope(scope), batchId: batch.id, sourceType: 'FILE_IMPORT', catalogType: batch.catalogType, productName, normalizedProductName: productName, hsCode: row.hsCode ?? null, normalizedHsCode, controlDescription: localized.controlDescription, originalProductName: localized.originalProductName, originalControlDescription: localized.originalControlDescription, translationSource: localized.translationSource, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null }));
+            await recordRepo.save(recordRepo.create({ ...auditScope(scope), batchId: batch.id, sourceType: 'FILE_IMPORT', catalogType: batch.catalogType, productName, normalizedProductName: productName, hsCode: row.hsCode ?? null, normalizedHsCode, controlDescription: localized.controlDescription, originalProductName: localized.originalProductName, originalControlDescription: localized.originalControlDescription, translationSource: localized.translationSource, controlCode: row.controlCode ?? null, sourceSection: row.sourceSection ?? null, sourceOrdinal: row.sourceOrdinal ?? null, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null }));
             batch.successCount += 1;
             batch.riskRecalculatedAt = null;
         }
@@ -681,6 +682,363 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
         return batch;
     }
+    async beginFastCatalogImport(scope, input) {
+        return this.dataSource.transaction(async (manager) => {
+            const taskRepo = manager.getRepository(ImportTask);
+            const task = await required(taskRepo.findOne({
+                where: { ...activeScope(scope), id: input.taskId },
+                lock: { mode: 'pessimistic_write' }
+            }), '解析任务不存在');
+            if (task.documentType !== 'CONTROLLED_CATALOG' && task.documentType !== 'SANCTION_CATALOG') {
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '仅目录任务支持快速入库');
+            }
+            if (task.progress?.mode === 'FAST_PIPELINE' && task.resultEntityId) {
+                return { committedCursor: task.progress.committedCursor, batchId: task.resultEntityId };
+            }
+            assertImportTaskResultWritable(task);
+            const now = new Date();
+            let batchId;
+            if (task.documentType === 'CONTROLLED_CATALOG') {
+                const catalogType = input.catalogType;
+                if (!catalogType)
+                    throw new DomainError(DomainErrorCodes.INVALID_INPUT, '管控目录缺少目录类型');
+                const batchRepo = manager.getRepository(ControlledCatalogBatch);
+                const recordRepo = manager.getRepository(ControlledGoodsRecord);
+                if (input.replaceBatchId) {
+                    const old = await required(batchRepo.findOne({ where: { ...activeScope(scope), id: input.replaceBatchId, deletedAt: IsNull() } }), '被覆盖目录批次不存在');
+                    old.deletedAt = now;
+                    old.deletedById = scope.userId ?? null;
+                    old.deleteOperation = 'CATALOG_REPLACE';
+                    old.updatedById = scope.userId ?? null;
+                    await batchRepo.save(old);
+                    await recordRepo.update({ ...activeScope(scope), batchId: old.id, deletedAt: IsNull() }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'CATALOG_REPLACE' });
+                }
+                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,
+                    importTaskId: task.id, riskRecalculatedAt: null
+                }));
+                batchId = batch.id;
+            }
+            else {
+                const batchRepo = manager.getRepository(SanctionCatalogBatch);
+                const recordRepo = manager.getRepository(SanctionedCompanyRecord);
+                if (input.replaceBatchId) {
+                    const old = await required(batchRepo.findOne({ where: { ...activeScope(scope), id: input.replaceBatchId, deletedAt: IsNull() } }), '被覆盖制裁目录批次不存在');
+                    old.deletedAt = now;
+                    old.deletedById = scope.userId ?? null;
+                    old.deleteOperation = 'SANCTION_CATALOG_REPLACE';
+                    old.updatedById = scope.userId ?? null;
+                    await batchRepo.save(old);
+                    await recordRepo.update({ ...activeScope(scope), batchId: old.id, deletedAt: IsNull() }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'SANCTION_CATALOG_REPLACE' });
+                }
+                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
+                }));
+                batchId = batch.id;
+            }
+            task.status = 'PERSISTING';
+            task.resultEntityId = batchId;
+            task.completedAt = null;
+            task.progress = initialFastCatalogProgress(input.totalCandidates);
+            await taskRepo.save(task);
+            return { committedCursor: 0, batchId };
+        });
+    }
+    async appendFastCatalogBatch(scope, input) {
+        const controlledRows = input.candidates.flatMap(candidate => candidate.kind === 'CONTROLLED'
+            ? candidateToControlledRows(candidate)
+            : []);
+        const localizedRows = controlledRows.length ? await this.localizeControlledCatalogRows(controlledRows) : [];
+        return this.dataSource.transaction(async (manager) => {
+            const taskRepo = manager.getRepository(ImportTask);
+            const task = await required(taskRepo.findOne({
+                where: { ...activeScope(scope), id: input.taskId },
+                lock: { mode: 'pessimistic_write' }
+            }), '解析任务不存在');
+            if (!task.progress || task.progress.mode !== 'FAST_PIPELINE' || !task.resultEntityId) {
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '快速目录导入尚未初始化');
+            }
+            if (task.progress.committedCursor >= input.endCursor && input.endCursor > input.startCursor)
+                return task.progress;
+            if (task.progress.committedCursor !== input.startCursor) {
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '快速目录导入游标不一致');
+            }
+            if (task.documentType === 'CONTROLLED_CATALOG') {
+                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 batchRepo.save(batch);
+                task.progress.successCount = batch.successCount;
+                task.progress.duplicateCount = batch.duplicateCount;
+                task.progress.invalidCount = batch.invalidCount;
+            }
+            else {
+                const batch = await this.appendFastSanctionCandidates(manager, scope, task.resultEntityId, input.candidates);
+                task.progress.successCount = batch.successCount;
+                task.progress.duplicateCount = batch.duplicateCount;
+                task.progress.invalidCount = batch.invalidCount;
+            }
+            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'
+                        } });
+                    if (existing)
+                        continue;
+                    await reviewRepo.save(reviewRepo.create({
+                        ...createdScope(scope), importTaskId: task.id, documentType: task.documentType,
+                        confidence: block.confidence, status: 'PENDING', ordinal: block.ordinal,
+                        sourceLocation: block.sourceLocation || null, sourceContent: block.sourceContent || null,
+                        payload: block.payload, reasons: block.reasons,
+                        leaseToken: null, leaseExpiresAt: null, resolvedAt: null
+                    }));
+                }
+            }
+            task.progress.committedCursor = input.endCursor;
+            task.progress.processedCount = input.endCursor + input.reviewBlocks.length + input.skipped.length;
+            task.progress.reviewPendingCount += input.reviewBlocks.length;
+            task.progress.currentBatch = input.endCursor === 0 ? 0 : Math.ceil(input.endCursor / 100);
+            task.progress.progressVersion += 1;
+            task.progress.lastProgressAt = new Date().toISOString();
+            task.progress.stage = input.reviewBlocks.length ? 'REVIEWING' : 'SAVING';
+            await taskRepo.save(task);
+            return task.progress;
+        });
+    }
+    async finalizeFastCatalogImport(scope, taskId) {
+        const task = await this.dataSource.transaction(async (manager) => {
+            const repo = manager.getRepository(ImportTask);
+            const current = await required(repo.findOne({
+                where: { ...activeScope(scope), id: taskId }, lock: { mode: 'pessimistic_write' }
+            }), '解析任务不存在');
+            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';
+            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');
+        return task;
+    }
+    async waitImportProgress(scope, taskId, afterProgressVersion = 0, waitMs = 10_000) {
+        const deadline = Date.now() + Math.max(0, Math.min(waitMs, 10_000));
+        while (true) {
+            const task = await required(this.dataSource.getRepository(ImportTask).findOne({
+                where: { ...activeScope(scope), id: taskId }
+            }), '解析任务不存在');
+            const version = task.progress?.progressVersion ?? 0;
+            if (version > afterProgressVersion || TERMINAL_IMPORT_TASK_STATUSES.includes(task.status)) {
+                return { task: publicImportTaskDto(task) };
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return { task: publicImportTaskDto(task) };
+            await new Promise(resolve => setTimeout(resolve, Math.min(250, remaining)));
+        }
+    }
+    async nextCatalogReviewBatch(scope, taskId, requestedLimit = 20) {
+        const limit = Math.max(1, Math.min(requestedLimit, 20));
+        return this.dataSource.transaction(async (manager) => {
+            const task = await required(manager.getRepository(ImportTask).findOne({
+                where: { ...activeScope(scope), id: taskId }, lock: { mode: 'pessimistic_write' }
+            }), '解析任务不存在');
+            if (task.documentType !== 'CONTROLLED_CATALOG' && task.documentType !== 'SANCTION_CATALOG') {
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '仅目录任务包含复核块');
+            }
+            const repo = manager.getRepository(CatalogReviewBlock);
+            await repo.update({
+                ...activeScope(scope), importTaskId: taskId, status: 'LEASED', leaseExpiresAt: LessThanOrEqual(new Date())
+            }, { status: 'PENDING', leaseToken: null, leaseExpiresAt: null });
+            const blocks = await repo.createQueryBuilder('block')
+                .setLock('pessimistic_write')
+                .setOnLocked('skip_locked')
+                .where('block."tenantId" = :tenantId AND block."organizationId" = :organizationId AND block."importTaskId" = :taskId AND block.status = :status', {
+                ...activeScope(scope), taskId, status: 'PENDING'
+            })
+                .orderBy('block.ordinal', 'ASC')
+                .addOrderBy('block.id', 'ASC')
+                .limit(limit)
+                .getMany();
+            if (blocks.length === 0)
+                return { leaseToken: null, items: [] };
+            const leaseToken = randomUUID();
+            const leaseExpiresAt = new Date(Date.now() + 5 * 60_000);
+            for (const block of blocks) {
+                block.status = 'LEASED';
+                block.leaseToken = leaseToken;
+                block.leaseExpiresAt = leaseExpiresAt;
+            }
+            await repo.save(blocks);
+            return {
+                leaseToken,
+                leaseExpiresAt: leaseExpiresAt.toISOString(),
+                items: blocks.map(block => ({
+                    blockId: block.id, ordinal: block.ordinal, confidence: block.confidence,
+                    sourceLocation: block.sourceLocation, sourceContent: block.sourceContent,
+                    payload: block.payload, reasons: block.reasons
+                }))
+            };
+        });
+    }
+    async submitCatalogReviewBatch(scope, taskId, leaseToken, items) {
+        if (!leaseToken.trim() || items.length === 0 || items.length > 20) {
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '复核提交参数无效');
+        }
+        return this.dataSource.transaction(async (manager) => {
+            const taskRepo = manager.getRepository(ImportTask);
+            const task = await required(taskRepo.findOne({
+                where: { ...activeScope(scope), id: taskId }, lock: { mode: 'pessimistic_write' }
+            }), '解析任务不存在');
+            if (!task.progress || !task.resultEntityId)
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '目录复核任务状态无效');
+            const reviewRepo = manager.getRepository(CatalogReviewBlock);
+            const blocks = await reviewRepo.find({ where: {
+                    ...activeScope(scope), importTaskId: taskId, id: In(items.map(item => item.blockId)),
+                    status: 'LEASED', leaseToken
+                } });
+            if (blocks.length !== items.length || blocks.some(block => !block.leaseExpiresAt || block.leaseExpiresAt.getTime() <= Date.now())) {
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '复核块租约无效或已过期');
+            }
+            const acceptedCandidates = [];
+            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';
+                    rejected += 1;
+                }
+                else {
+                    const payload = item.payload ?? block.payload;
+                    const candidate = reviewCandidate(task.documentType, block, payload);
+                    const decision = classifyCandidate(candidate);
+                    if (decision.confidence === 'LOW') {
+                        throw new DomainError(DomainErrorCodes.INVALID_INPUT, `复核结果未通过代码校验：${decision.reasons.join(',')}`);
+                    }
+                    acceptedCandidates.push(candidate);
+                    block.payload = payload;
+                    block.status = 'RESOLVED';
+                    resolved += 1;
+                }
+                block.resolvedAt = new Date();
+                block.leaseToken = null;
+                block.leaseExpiresAt = null;
+            }
+            if (task.documentType === 'CONTROLLED_CATALOG' && acceptedCandidates.length) {
+                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
+                }));
+                await this.appendControlledCatalogRows(manager, scope, batch, rows, localized);
+                await batchRepo.save(batch);
+                task.progress.successCount = batch.successCount;
+                task.progress.duplicateCount = batch.duplicateCount;
+                task.progress.invalidCount = batch.invalidCount;
+            }
+            if (task.documentType === 'SANCTION_CATALOG' && acceptedCandidates.length) {
+                const batch = await this.appendFastSanctionCandidates(manager, scope, task.resultEntityId, acceptedCandidates);
+                task.progress.successCount = batch.successCount;
+                task.progress.duplicateCount = batch.duplicateCount;
+                task.progress.invalidCount = batch.invalidCount;
+            }
+            await reviewRepo.save(blocks);
+            task.progress.reviewResolvedCount += resolved;
+            task.progress.reviewRejectedCount += rejected;
+            task.progress.reviewPendingCount = Math.max(0, task.progress.reviewPendingCount - resolved - rejected);
+            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();
+            }
+            else {
+                task.status = 'AWAITING_REVIEW';
+                task.progress.stage = 'REVIEWING';
+            }
+            await taskRepo.save(task);
+            return { resolved, rejected, remaining: task.progress.reviewPendingCount, task: publicImportTaskDto(task) };
+        });
+    }
+    async setImportObserverConversation(scope, taskId, conversationId) {
+        const normalizedConversationId = requiredId(conversationId, '观察会话标识');
+        return this.dataSource.transaction(async (manager) => {
+            const repo = manager.getRepository(ImportTask);
+            const task = await required(repo.findOne({
+                where: { ...activeScope(scope), id: taskId }, lock: { mode: 'pessimistic_write' }
+            }), '解析任务不存在');
+            if (task.observerConversationId && task.observerConversationId !== normalizedConversationId) {
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '观察会话标识不一致');
+            }
+            task.observerConversationId = normalizedConversationId;
+            if (task.progress)
+                task.progress.observerStatus = 'ACTIVE';
+            return repo.save(task);
+        });
+    }
+    async appendFastSanctionCandidates(manager, scope, batchId, candidates) {
+        const batchRepo = manager.getRepository(SanctionCatalogBatch);
+        const recordRepo = manager.getRepository(SanctionedCompanyRecord);
+        const aliasRepo = manager.getRepository(SanctionedCompanyAlias);
+        const issueRepo = manager.getRepository(SanctionCatalogImportIssue);
+        const batch = await required(batchRepo.findOne({ where: { ...activeScope(scope), id: batchId } }), '制裁目录批次不存在');
+        for (const candidate of candidates.filter(value => value.kind === 'SANCTION')) {
+            const companyName = String(candidate.values.companyName ?? '').trim();
+            const sourceLocation = candidate.evidence[0]?.sourceLocation ?? null;
+            const sourceContent = candidate.evidence[0]?.sourceContent ?? null;
+            if (!companyName)
+                continue;
+            const normalizedCompanyName = normalizeExactName(companyName);
+            const sanctionListSource = optionalString(candidate.values.sanctionListSource);
+            const normalizedSanctionListSource = normalizeSanctionSource(sanctionListSource);
+            const duplicate = await recordRepo.findOne({ where: { ...activeScope(scope), normalizedCompanyName, normalizedSanctionListSource, deletedAt: IsNull() } });
+            batch.totalCount += 1;
+            if (duplicate) {
+                batch.duplicateCount += 1;
+                await issueRepo.save(issueRepo.create({
+                    ...createdScope(scope), batchId: batch.id, issueType: 'DUPLICATE', sourceSequence: batch.totalCount,
+                    sourceLocation, sourceContent, parsedPayload: candidate.values,
+                    message: '制裁目录中已存在相同公司和名单来源'
+                }));
+                continue;
+            }
+            const record = await recordRepo.save(recordRepo.create({
+                ...auditScope(scope), batchId: batch.id, sourceType: 'FILE_IMPORT', companyName, normalizedCompanyName,
+                countryOrRegion: optionalString(candidate.values.countryOrRegion), sanctionListSource,
+                normalizedSanctionListSource, sanctionReason: optionalString(candidate.values.sanctionReason),
+                effectiveDate: optionalString(candidate.values.effectiveDate), remarks: optionalString(candidate.values.remarks),
+                sourceLocation, sourceContent
+            }));
+            for (const alias of candidateAliases(candidate)) {
+                await aliasRepo.save(aliasRepo.create({
+                    ...auditScope(scope), sanctionedCompanyId: record.id, alias: alias.alias,
+                    normalizedAlias: normalizeExactName(alias.alias), aliasType: alias.aliasType, sourceLocation
+                }));
+            }
+            batch.successCount += 1;
+        }
+        return batchRepo.save(batch);
+    }
     async createImportTask(scope, input) {
         const repo = this.dataSource.getRepository(ImportTask);
         const targetAssistantId = requiredId(input.targetAssistantId, '目标智能体标识');
@@ -692,6 +1050,17 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             order: { queuedAt: 'ASC', id: 'ASC' }
         });
     }
+    async findNextFastCatalogImportCandidate(scope) {
+        const tasks = await this.dataSource.getRepository(ImportTask).find({
+            where: {
+                ...activeScope(scope),
+                documentType: In(['CONTROLLED_CATALOG', 'SANCTION_CATALOG']),
+                status: In(['EXTRACTING', 'VALIDATING', 'PERSISTING'])
+            },
+            order: { startedAt: 'ASC', id: 'ASC' }
+        });
+        return tasks.find(task => task.progress?.mode === 'FAST_PIPELINE') ?? null;
+    }
     async claimQueuedImportTaskById(scope, id, claimAttemptToken) {
         const attemptToken = requiredId(claimAttemptToken, '领取尝试标识');
         return this.dataSource.transaction(async (manager) => {
@@ -2453,18 +2822,28 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             const customerRepo = manager.getRepository(Customer);
             const now = new Date();
             await repo.update({ ...activeScope(scope), deletedAt: IsNull() }, { deletedAt: now, invalidationReason: reason });
-            const [suppliers, customers, sanctions] = await Promise.all([
+            const [suppliers, customers, sanctions, aliases] = await Promise.all([
                 supplierRepo.find({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
                 customerRepo.find({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
-                manager.getRepository(SanctionedCompanyRecord).find({ where: { ...activeScope(scope), deletedAt: IsNull() } })
+                manager.getRepository(SanctionedCompanyRecord).find({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
+                manager.getRepository(SanctionedCompanyAlias).find({ where: { ...activeScope(scope), deletedAt: IsNull() } })
             ]);
+            const sanctionsById = new Map(sanctions.map(item => [item.id, item]));
+            const sanctionsByNormalizedName = new Map();
+            for (const item of sanctions)
+                appendMapValue(sanctionsByNormalizedName, item.normalizedCompanyName, item);
+            for (const alias of aliases) {
+                const item = sanctionsById.get(alias.sanctionedCompanyId);
+                if (item)
+                    appendMapValue(sanctionsByNormalizedName, alias.normalizedAlias, item);
+            }
             for (const supplier of suppliers) {
-                for (const item of sanctions.filter(row => row.normalizedCompanyName === supplier.normalizedName))
+                for (const item of sanctionsByNormalizedName.get(supplier.normalizedName) ?? [])
                     await repo.save(repo.create({ ...createdScope(scope), subjectType: 'SUPPLIER', supplierId: supplier.id, customerId: null, sanctionedCompanyId: item.id, matchedNormalizedName: supplier.normalizedName, checkedAt: now, deletedAt: null, invalidationReason: null }));
                 await supplierRepo.update({ ...activeScope(scope), id: supplier.id, deletedAt: IsNull() }, { complianceCheckedAt: now, updatedById: scope.userId ?? null, updatedAt: now });
             }
             for (const customer of customers) {
-                for (const item of sanctions.filter(row => row.normalizedCompanyName === customer.normalizedName))
+                for (const item of sanctionsByNormalizedName.get(customer.normalizedName) ?? [])
                     await repo.save(repo.create({ ...createdScope(scope), subjectType: 'CUSTOMER', supplierId: null, customerId: customer.id, sanctionedCompanyId: item.id, matchedNormalizedName: customer.normalizedName, checkedAt: now, deletedAt: null, invalidationReason: null }));
                 await customerRepo.update({ ...activeScope(scope), id: customer.id, deletedAt: IsNull() }, { complianceCheckStatus: 'CHECKED', complianceCheckedAt: now, updatedById: scope.userId ?? null, updatedAt: now });
             }
@@ -3113,6 +3492,83 @@ function snapshotMissingRecoveryMetadataStillMissing(snapshot, current) {
 }
 function requiredId(value, label) { const id = String(value ?? '').trim(); if (!id)
     throw new DomainError(DomainErrorCodes.INVALID_INPUT, `缺少${label}`); return id; }
+function optionalString(value) {
+    const normalized = String(value ?? '').trim();
+    return normalized || null;
+}
+function initialFastCatalogProgress(totalCandidates) {
+    return {
+        version: 1,
+        mode: 'FAST_PIPELINE',
+        stage: 'SAVING',
+        totalCandidates,
+        processedCount: 0,
+        successCount: 0,
+        duplicateCount: 0,
+        invalidCount: 0,
+        currentBatch: 0,
+        totalBatches: totalCandidates > 0 ? Math.ceil(totalCandidates / 100) : 0,
+        committedCursor: 0,
+        progressVersion: 1,
+        lastProgressAt: new Date().toISOString(),
+        observerStatus: 'PENDING',
+        reviewPendingCount: 0,
+        reviewResolvedCount: 0,
+        reviewRejectedCount: 0
+    };
+}
+function candidateToControlledRows(candidate) {
+    const evidence = candidate.evidence[0];
+    const hsCodes = Array.isArray(candidate.values.hsCodes) && candidate.values.hsCodes.length
+        ? candidate.values.hsCodes
+        : [undefined];
+    return hsCodes.map(hsCode => ({
+        productName: optionalString(candidate.values.productName) ?? undefined,
+        hsCode: typeof hsCode === 'string' ? hsCode : undefined,
+        controlDescription: optionalString(candidate.values.controlDescription) ?? undefined,
+        controlCode: optionalString(candidate.values.controlCode) ?? undefined,
+        sourceSection: optionalString(candidate.values.sourceSection) ?? undefined,
+        sourceOrdinal: optionalString(candidate.values.sourceOrdinal) ?? String(candidate.ordinal),
+        sourceLocation: evidence?.sourceLocation,
+        sourceContent: evidence?.sourceContent,
+        translationSource: 'SOURCE_CHINESE'
+    }));
+}
+function candidateAliases(candidate) {
+    if (!Array.isArray(candidate.values.aliases))
+        return [];
+    return candidate.values.aliases.flatMap(value => {
+        if (!value || typeof value !== 'object')
+            return [];
+        const alias = optionalString(value.alias);
+        const aliasType = value.aliasType;
+        return alias && (aliasType === 'AKA' || aliasType === 'LOCAL_LANGUAGE') ? [{ alias, aliasType }] : [];
+    });
+}
+function reviewCandidate(documentType, block, payload) {
+    const values = { ...payload };
+    if (!Array.isArray(values.hsCodes) && typeof values.hsCode === 'string')
+        values.hsCodes = [values.hsCode];
+    return {
+        kind: documentType === 'CONTROLLED_CATALOG' ? 'CONTROLLED' : 'SANCTION',
+        ordinal: block.ordinal,
+        values,
+        evidence: block.sourceLocation && block.sourceContent
+            ? [{ sourceLocation: block.sourceLocation, sourceContent: block.sourceContent }]
+            : [],
+        signals: ['STRUCTURED_SOURCE', 'HEADER_MAPPED', 'RECORD_START_EXPLICIT', 'COLUMN_LAYOUT_STABLE'],
+        warnings: block.reasons
+    };
+}
+function appendMapValue(map, key, value) {
+    const values = map.get(key);
+    if (values) {
+        if (!values.includes(value))
+            values.push(value);
+    }
+    else
+        map.set(key, [value]);
+}
 function assertCompleteClauseAnalyses(analyses) {
     if (analyses.length !== ClauseTypes.length)
         throw new DomainError(DomainErrorCodes.INVALID_INPUT, '重新分析结果必须完整包含七类关键条款');