@chenchaolong/plugin-trade-compliance-workbench 0.1.74 → 1.0.1

package/dist/lib/workbench.service.js

@@ -0,0 +1,755 @@
+import { __decorate, __metadata, __param } from "tslib";
+import { Injectable } from '@nestjs/common';
+import { InjectDataSource } from '@nestjs/typeorm';
+import { Brackets, DataSource, In, IsNull } from 'typeorm';
+import { Decimal } from 'decimal.js';
+import { BankAccountSettings, CompanySanctionMatch, CompanySettings, ControlledCatalogBatch, ControlledCatalogImportIssue, ControlledGoodsRecord, Customer, CustomerContract, CustomerContractAnalysisRun, CustomerContractClause, CustomerContractClauseAnalysis, DerivedSalesOrderManualData, GeneratedSalesFile, ImportTask, MonthlySafeExchangeRate, ProductComplianceMatch, ProfitRuleSettings, PurchaseOrder, PurchaseOrderLine, RiskNoticeSettings, SanctionCatalogBatch, SanctionCatalogImportIssue, SanctionedCompanyRecord, SettingsHistory, Supplier } from './entities/index.js';
+import { ClauseTypes, DomainError, DomainErrorCodes } from './types.js';
+import { deriveSalesLine, assertReceivedAmount } from './domain/finance.js';
+import { parseCustomerContractNo, parsePurchaseContractNo } from './domain/contract-number.js';
+import { isProductNameMatch, normalizeExactName, normalizeForProductMatch, normalizeHsCode, normalizeSanctionSource } from './domain/normalization.js';
+import { importTaskTimedOut, nextSettingsRevision, normalizeOptionalDecimalInput } from './domain/workflow.js';
+import { renderImportIssuesWorkbook } from './domain/import-issues.js';
+import { DEFAULT_BANKS, DEFAULT_COMPANY, DEFAULT_PROFIT_RULE } from './domain/default-settings.js';
+const DEFAULT_RISK_NOTICE = '<h3>操作前请确认</h3><ul><li><strong>删除、目录覆盖和合同审核</strong>会影响当前业务数据，请核对对象后再操作。</li><li>采购合同和客户合同重复时不会覆盖，必须先删除旧记录再重新上传。</li><li>销售文件生成前请确认利润率、换汇成本和银行信息。</li></ul><h3>推荐业务顺序</h3><p>维护风险目录，上传采购合同和客户合同，完成审核后处理销售合规与销售文件。</p>';
+let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+    }
+    async bootstrapSettings(scope) {
+        const riskRepo = this.dataSource.getRepository(RiskNoticeSettings);
+        let risk = await riskRepo.findOne({ where: activeScope(scope) });
+        if (!risk)
+            risk = await riskRepo.save(riskRepo.create({ ...auditScope(scope), content: DEFAULT_RISK_NOTICE, revision: 1 }));
+        const profitRepo = this.dataSource.getRepository(ProfitRuleSettings);
+        let profit = await profitRepo.findOne({ where: activeScope(scope) });
+        if (!profit)
+            profit = await profitRepo.save(profitRepo.create({ ...auditScope(scope), ...DEFAULT_PROFIT_RULE, revision: 1 }));
+        const companyRepo = this.dataSource.getRepository(CompanySettings);
+        let company = await companyRepo.findOne({ where: activeScope(scope) });
+        if (!company)
+            company = await companyRepo.save(companyRepo.create({ ...auditScope(scope), ...DEFAULT_COMPANY, revision: 1 }));
+        const bankRepo = this.dataSource.getRepository(BankAccountSettings);
+        const banks = [];
+        for (const defaults of DEFAULT_BANKS) {
+            let bank = await bankRepo.findOne({ where: { ...activeScope(scope), bankType: defaults.bankType } });
+            if (!bank)
+                bank = await bankRepo.save(bankRepo.create({ ...auditScope(scope), ...defaults, revision: 1 }));
+            banks.push(bank);
+        }
+        return { risk, profit, company, banks };
+    }
+    async dashboard(scope) {
+        const [{ risk }, controlledRiskCount, sanctionRiskCount, unlinkedPurchaseCount, unlinkedCustomerCount] = await Promise.all([
+            this.bootstrapSettings(scope),
+            this.dataSource.getRepository(ProductComplianceMatch).count({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
+            this.dataSource.getRepository(CompanySanctionMatch).count({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
+            this.countUnlinkedPurchases(scope),
+            this.countUnlinkedCustomers(scope)
+        ]);
+        return { riskNotice: risk, controlledRiskCount, sanctionRiskCount, unlinkedPurchaseCount, unlinkedCustomerCount };
+    }
+    async listControlledGoods(scope, query = {}) {
+        return this.pagedQuery(ControlledGoodsRecord, scope, query, ['productName', 'hsCode', 'controlDescription'], {
+            catalogType: query.parameters?.catalogType,
+            sourceFileName: query.parameters?.sourceFileName
+        });
+    }
+    async listImportTasks(scope, query = {}) {
+        await this.expireStaleImportTasks(scope);
+        return this.pagedQuery(ImportTask, scope, query, ['sourceFileName', 'documentType', 'status', 'errorMessage'], { documentType: query.parameters?.documentType, status: query.parameters?.status });
+    }
+    async listControlledBatches(scope, query = {}) { return this.pagedQuery(ControlledCatalogBatch, scope, query, ['sourceFileName'], { catalogType: query.parameters?.catalogType }); }
+    async listSanctionBatches(scope, query = {}) { return this.pagedQuery(SanctionCatalogBatch, scope, query, ['sourceFileName']); }
+    async saveControlledGoods(scope, input) {
+        const repo = this.dataSource.getRepository(ControlledGoodsRecord);
+        const productName = input.productName.trim();
+        const normalizedProductName = productName.trim();
+        const normalizedHsCode = String(input.hsCode ?? '').replace(/\s/g, '');
+        const duplicate = await repo.findOne({ where: { ...activeScope(scope), catalogType: input.catalogType, normalizedProductName, normalizedHsCode, deletedAt: IsNull() } });
+        if (duplicate)
+            throw new DomainError(DomainErrorCodes.DUPLICATE_CATALOG_RECORD, '相同目录类型、商品名称和海关编码的记录已存在', { id: duplicate.id });
+        return repo.save(repo.create({ ...auditScope(scope), sourceType: input.sourceType ?? 'MANUAL_ENTRY', catalogType: input.catalogType, productName, normalizedProductName, hsCode: input.hsCode ?? null, normalizedHsCode, controlDescription: input.controlDescription ?? null, sourceLocation: input.sourceLocation ?? null, sourceContent: input.sourceContent ?? null }));
+    }
+    async updateControlledGoods(scope, id, input) {
+        const repo = this.dataSource.getRepository(ControlledGoodsRecord);
+        const item = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '管控商品不存在');
+        Object.assign(item, pick(input, ['catalogType', 'productName', 'hsCode', 'controlDescription']));
+        item.normalizedProductName = item.productName.trim();
+        item.normalizedHsCode = String(item.hsCode ?? '').replace(/\s/g, '');
+        item.updatedById = scope.userId ?? null;
+        const saved = await repo.save(item);
+        await this.recalculateProductRisks(scope, 'CATALOG_CHANGED');
+        return saved;
+    }
+    async importControlledCatalog(scope, input) {
+        return this.dataSource.transaction(async (manager) => {
+            const batchRepo = manager.getRepository(ControlledCatalogBatch);
+            const recordRepo = manager.getRepository(ControlledGoodsRecord);
+            const issueRepo = manager.getRepository(ControlledCatalogImportIssue);
+            const taskRepo = manager.getRepository(ImportTask);
+            const task = await required(taskRepo.findOne({ where: { ...activeScope(scope), id: input.importTaskId } }), '解析任务不存在');
+            task.status = 'PERSISTING';
+            await taskRepo.save(task);
+            const now = new Date();
+            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: input.catalogType, sourceFileId: input.sourceFileId, sourceFileName: input.sourceFileName, importMode: input.replaceBatchId ? 'REPLACE_BATCH' : 'APPEND', replacedBatchId: input.replaceBatchId ?? null, totalCount: input.rows.length, successCount: 0, duplicateCount: 0, invalidCount: 0, importTaskId: input.importTaskId }));
+            for (let index = 0; index < input.rows.length; index += 1) {
+                const row = input.rows[index];
+                const productName = String(row.productName ?? '').trim();
+                const normalizedHsCode = String(row.hsCode ?? '').replace(/\s/g, '');
+                if (!productName) {
+                    batch.invalidCount += 1;
+                    await issueRepo.save(issueRepo.create({ ...createdScope(scope), batchId: batch.id, issueType: 'INVALID', sourceSequence: index + 1, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null, parsedPayload: row, message: '商品名称为空' }));
+                    continue;
+                }
+                const duplicate = await recordRepo.findOne({ where: { ...activeScope(scope), catalogType: input.catalogType, normalizedProductName: productName, normalizedHsCode, deletedAt: IsNull() } });
+                if (duplicate) {
+                    batch.duplicateCount += 1;
+                    await issueRepo.save(issueRepo.create({ ...createdScope(scope), batchId: batch.id, issueType: 'DUPLICATE', sourceSequence: index + 1, 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: input.catalogType, productName, normalizedProductName: productName, hsCode: row.hsCode ?? null, normalizedHsCode, controlDescription: row.controlDescription ?? null, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null }));
+                batch.successCount += 1;
+            }
+            await batchRepo.save(batch);
+            task.status = 'SUCCEEDED';
+            task.resultEntityId = batch.id;
+            task.completedAt = new Date();
+            await taskRepo.save(task);
+            return batch;
+        }).then(async (batch) => { await this.recalculateProductRisks(scope, 'CATALOG_CHANGED'); return batch; });
+    }
+    async listSanctionedCompanies(scope, query = {}) {
+        return this.pagedQuery(SanctionedCompanyRecord, scope, query, ['companyName', 'countryOrRegion', 'sanctionListSource', 'sanctionReason'], { sanctionListSource: query.parameters?.sanctionListSource });
+    }
+    async downloadImportIssues(scope, documentType, batchId) {
+        const batchEntity = documentType === 'CONTROLLED_CATALOG' ? ControlledCatalogBatch : SanctionCatalogBatch;
+        const issueEntity = documentType === 'CONTROLLED_CATALOG' ? ControlledCatalogImportIssue : SanctionCatalogImportIssue;
+        const batch = await required(this.dataSource.getRepository(batchEntity).findOne({ where: { ...activeScope(scope), id: batchId } }), '目录导入批次不存在');
+        const issues = await this.dataSource.getRepository(issueEntity).find({ where: { ...activeScope(scope), batchId }, order: { sourceSequence: 'ASC' } });
+        return { fileName: `${batch.sourceFileName}-导入问题明细.xlsx`, buffer: await renderImportIssuesWorkbook(issues) };
+    }
+    async saveSanctionedCompany(scope, input) {
+        const repo = this.dataSource.getRepository(SanctionedCompanyRecord);
+        const companyName = input.companyName.trim();
+        const normalizedCompanyName = normalizeExactName(companyName);
+        const normalizedSanctionListSource = normalizeSanctionSource(input.sanctionListSource);
+        const duplicate = await repo.findOne({ where: { ...activeScope(scope), normalizedCompanyName, normalizedSanctionListSource, deletedAt: IsNull() } });
+        if (duplicate)
+            throw new DomainError(DomainErrorCodes.DUPLICATE_CATALOG_RECORD, '相同公司名称和制裁名单来源的记录已存在', { id: duplicate.id });
+        const saved = await repo.save(repo.create({ ...auditScope(scope), sourceType: input.sourceType ?? 'MANUAL_ENTRY', companyName, normalizedCompanyName, countryOrRegion: input.countryOrRegion ?? null, sanctionListSource: input.sanctionListSource ?? null, normalizedSanctionListSource, sanctionReason: input.sanctionReason ?? null, effectiveDate: input.effectiveDate ?? null, remarks: input.remarks ?? null, sourceLocation: input.sourceLocation ?? null, sourceContent: input.sourceContent ?? null }));
+        await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
+        return saved;
+    }
+    async updateSanctionedCompany(scope, id, input) {
+        const repo = this.dataSource.getRepository(SanctionedCompanyRecord);
+        const item = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '制裁公司不存在');
+        Object.assign(item, pick(input, ['companyName', 'countryOrRegion', 'sanctionListSource', 'sanctionReason', 'effectiveDate', 'remarks']));
+        item.normalizedCompanyName = normalizeExactName(item.companyName);
+        item.normalizedSanctionListSource = normalizeSanctionSource(item.sanctionListSource);
+        item.updatedById = scope.userId ?? null;
+        const saved = await repo.save(item);
+        await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
+        return saved;
+    }
+    async importSanctionCatalog(scope, input) {
+        const batch = await this.dataSource.transaction(async (manager) => {
+            const batchRepo = manager.getRepository(SanctionCatalogBatch);
+            const recordRepo = manager.getRepository(SanctionedCompanyRecord);
+            const issueRepo = manager.getRepository(SanctionCatalogImportIssue);
+            const taskRepo = manager.getRepository(ImportTask);
+            const task = await required(taskRepo.findOne({ where: { ...activeScope(scope), id: input.importTaskId } }), '解析任务不存在');
+            task.status = 'PERSISTING';
+            await taskRepo.save(task);
+            const now = new Date();
+            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 result = await batchRepo.save(batchRepo.create({ ...auditScope(scope), sourceFileId: input.sourceFileId, sourceFileName: input.sourceFileName, importMode: input.replaceBatchId ? 'REPLACE_BATCH' : 'APPEND', replacedBatchId: input.replaceBatchId ?? null, totalCount: input.rows.length, successCount: 0, duplicateCount: 0, invalidCount: 0, importTaskId: input.importTaskId }));
+            for (let index = 0; index < input.rows.length; index += 1) {
+                const row = input.rows[index];
+                const companyName = String(row.companyName ?? '').trim();
+                if (!companyName) {
+                    result.invalidCount += 1;
+                    await issueRepo.save(issueRepo.create({ ...createdScope(scope), batchId: result.id, issueType: 'INVALID', sourceSequence: index + 1, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null, parsedPayload: row, message: '公司名称为空' }));
+                    continue;
+                }
+                const normalizedCompanyName = normalizeExactName(companyName);
+                const normalizedSanctionListSource = normalizeSanctionSource(row.sanctionListSource);
+                const duplicate = await recordRepo.findOne({ where: { ...activeScope(scope), normalizedCompanyName, normalizedSanctionListSource, deletedAt: IsNull() } });
+                if (duplicate) {
+                    result.duplicateCount += 1;
+                    await issueRepo.save(issueRepo.create({ ...createdScope(scope), batchId: result.id, issueType: 'DUPLICATE', sourceSequence: index + 1, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null, parsedPayload: row, message: '制裁目录中已存在相同公司和名单来源' }));
+                    continue;
+                }
+                await recordRepo.save(recordRepo.create({ ...auditScope(scope), batchId: result.id, sourceType: 'FILE_IMPORT', companyName, normalizedCompanyName, countryOrRegion: row.countryOrRegion ?? null, sanctionListSource: row.sanctionListSource ?? null, normalizedSanctionListSource, sanctionReason: row.sanctionReason ?? null, effectiveDate: row.effectiveDate ?? null, remarks: row.remarks ?? null, sourceLocation: row.sourceLocation ?? null, sourceContent: row.sourceContent ?? null }));
+                result.successCount += 1;
+            }
+            const saved = await batchRepo.save(result);
+            task.status = 'SUCCEEDED';
+            task.resultEntityId = saved.id;
+            task.completedAt = new Date();
+            await taskRepo.save(task);
+            return saved;
+        });
+        await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
+        return batch;
+    }
+    async createImportTask(scope, input) {
+        const repo = this.dataSource.getRepository(ImportTask);
+        return repo.save(repo.create({ ...createdScope(scope), ...input, status: input.status ?? 'QUEUED', queuedAt: new Date(), createdById: scope.userId ?? null }));
+    }
+    async updateImportTaskDraft(scope, id, payload, version = 'v1') {
+        const repo = this.dataSource.getRepository(ImportTask);
+        const task = await required(repo.findOne({ where: { ...activeScope(scope), id } }), '解析任务不存在');
+        task.resultPayload = payload;
+        task.resultPayloadVersion = version;
+        task.status = 'AWAITING_REVIEW';
+        task.completedAt = new Date();
+        return repo.save(task);
+    }
+    async markImportTaskParsing(scope, id) {
+        const repo = this.dataSource.getRepository(ImportTask);
+        const task = await required(repo.findOne({ where: { ...activeScope(scope), id } }), '解析任务不存在');
+        task.status = 'AI_PARSING';
+        task.startedAt ??= new Date();
+        task.completedAt = null;
+        return repo.save(task);
+    }
+    async savePurchaseDraft(scope, importTaskId, draft) {
+        const order = await this.dataSource.transaction(async (manager) => {
+            const orderRepo = manager.getRepository(PurchaseOrder);
+            const normalizedContractNo = parsePurchaseContractNo(draft.order.contractNo).normalized;
+            const duplicate = await orderRepo.findOne({ where: { ...activeScope(scope), normalizedContractNo, deletedAt: IsNull() } });
+            if (duplicate)
+                throw new DomainError(DomainErrorCodes.DUPLICATE_CONTRACT, '采购合同已存在，如需重新上传请先删除旧记录', { id: duplicate.id, contractNo: draft.order.contractNo });
+            const supplier = await this.upsertSupplier(manager, scope, draft.supplier);
+            const task = await required(manager.getRepository(ImportTask).findOne({ where: { ...activeScope(scope), id: importTaskId } }), '解析任务不存在');
+            task.status = 'PERSISTING';
+            await manager.getRepository(ImportTask).save(task);
+            const entity = await orderRepo.save(orderRepo.create({ ...auditScope(scope), supplierId: supplier.id, contractNo: draft.order.contractNo.trim(), normalizedContractNo, orderDate: draft.order.orderDate ?? null, contractAmountCny: draft.order.contractAmountCny, paidAmountCny: draft.order.paidAmountCny ?? '0', refundedAmountCny: draft.order.refundedAmountCny ?? '0', sourceFileId: task.sourceFileId, sourceFileName: task.sourceFileName, importTaskId: task.id, amountMismatchConfirmedAt: draft.order.amountMismatchConfirmedAt ?? null, amountMismatchConfirmedById: draft.order.amountMismatchConfirmedById ?? null }));
+            const lineRepo = manager.getRepository(PurchaseOrderLine);
+            for (let index = 0; index < draft.lines.length; index += 1) {
+                const line = draft.lines[index];
+                if (new Decimal(line.quantity).lte(0))
+                    throw new DomainError(DomainErrorCodes.INVALID_INPUT, '采购商品数量必须大于 0', { lineNumber: index + 1 });
+                await lineRepo.save(lineRepo.create({ ...auditScope(scope), purchaseOrderId: entity.id, lineNumber: line.lineNumber ?? index + 1, sourceType: line.sourceType ?? 'CONTRACT_EXTRACTED', productName: line.productName.trim(), normalizedProductName: normalizeForProductMatch(line.productName), englishName: line.englishName ?? null, englishNameSource: line.englishNameSource ?? null, productDescription: line.productDescription ?? null, modelSpecification: line.modelSpecification ?? null, unit: line.unit ?? null, quantity: line.quantity, unitPriceTaxIncluded: line.unitPriceTaxIncluded, lineAmountTaxIncluded: line.lineAmountTaxIncluded, vatRate: line.vatRate ?? null, vatRateSource: line.vatRateSource ?? null, hsCode: line.hsCode ?? null, hsCodeStatus: line.hsCodeStatus ?? 'UNCONFIRMED', hsCodeSource: line.hsCodeSource ?? null, hsCodeReferenceSnapshotId: line.hsCodeReferenceSnapshotId ?? null, refundRate: line.refundRate ?? null, refundRateSource: line.refundRateSource ?? null, refundPolicyReference: line.refundPolicyReference ?? null, refundPolicyDate: line.refundPolicyDate ?? null, refundValidationMethod: line.refundValidationMethod ?? null, refundConfirmedAt: line.refundConfirmedAt ?? null, refundConfirmedById: line.refundConfirmedById ?? null, amountMismatchConfirmedAt: line.amountMismatchConfirmedAt ?? null, amountMismatchConfirmedById: line.amountMismatchConfirmedById ?? null, sourceLocation: line.sourceLocation ?? null, sourceContent: line.sourceContent ?? null }));
+            }
+            task.status = 'SUCCEEDED';
+            task.resultEntityId = entity.id;
+            task.reviewSavedAt = new Date();
+            task.completedAt = new Date();
+            await manager.getRepository(ImportTask).save(task);
+            return entity;
+        });
+        await this.recalculateProductRisks(scope, 'SOURCE_CHANGED');
+        await this.recalculateCompanyRisks(scope, 'SOURCE_CHANGED');
+        return order;
+    }
+    async listSuppliers(scope, query = {}) { return this.pagedQuery(Supplier, scope, query, ['code', 'name', 'shortName', 'contactName', 'businessProducts']); }
+    async listPurchaseOrders(scope, supplierId, query = {}) { return this.pagedQuery(PurchaseOrder, scope, query, ['contractNo', 'sourceFileName'], { supplierId }); }
+    async listPurchaseLines(scope, purchaseOrderId, query = {}) { return this.pagedQuery(PurchaseOrderLine, scope, query, ['productName', 'productDescription', 'modelSpecification', 'hsCode'], { purchaseOrderId }); }
+    async updateSupplier(scope, id, input) {
+        const repo = this.dataSource.getRepository(Supplier);
+        const item = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '供应商不存在');
+        Object.assign(item, pick(input, ['code', 'name', 'shortName', 'address', 'contactName', 'phone', 'wechat', 'email', 'taxNumber', 'paymentAccount', 'bankName', 'taxpayerRating', 'website', 'businessProducts']));
+        item.normalizedName = normalizeExactName(item.name);
+        item.updatedById = scope.userId ?? null;
+        const saved = await repo.save(item);
+        await this.recalculateCompanyRisks(scope, 'SOURCE_CHANGED');
+        return saved;
+    }
+    async updatePurchaseOrder(scope, id, input) {
+        const repo = this.dataSource.getRepository(PurchaseOrder);
+        const item = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '采购订单不存在');
+        Object.assign(item, pick(input, ['orderDate', 'contractAmountCny', 'paidAmountCny', 'refundedAmountCny']));
+        if (new Decimal(item.paidAmountCny).gt(item.contractAmountCny))
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '已付款不能超过采购订单总额');
+        item.updatedById = scope.userId ?? null;
+        return repo.save(item);
+    }
+    async updatePurchaseLine(scope, id, input) {
+        const repo = this.dataSource.getRepository(PurchaseOrderLine);
+        const item = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '采购商品不存在');
+        Object.assign(item, pick(input, ['productName', 'englishName', 'englishNameSource', 'productDescription', 'modelSpecification', 'unit', 'quantity', 'unitPriceTaxIncluded', 'lineAmountTaxIncluded', 'vatRate', 'vatRateSource', 'hsCode', 'hsCodeStatus', 'hsCodeSource', 'refundRate', 'refundRateSource', 'refundPolicyReference', 'refundPolicyDate', 'refundValidationMethod']));
+        if (new Decimal(item.quantity).lte(0))
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '采购商品数量必须大于 0');
+        await this.assertPurchaseOrderReceiptsRemainValid(scope, item.purchaseOrderId, item);
+        item.normalizedProductName = normalizeForProductMatch(item.productName);
+        item.updatedById = scope.userId ?? null;
+        const saved = await repo.save(item);
+        await this.recalculateProductRisks(scope, 'SOURCE_CHANGED');
+        return saved;
+    }
+    async addPurchaseLine(scope, purchaseOrderId, input) {
+        const repo = this.dataSource.getRepository(PurchaseOrderLine);
+        const count = await repo.count({ where: { ...activeScope(scope), purchaseOrderId, deletedAt: IsNull() } });
+        const saved = await repo.save(repo.create({ ...auditScope(scope), purchaseOrderId, lineNumber: count + 1, sourceType: 'MANUAL_ENTRY', productName: input.productName.trim(), normalizedProductName: normalizeForProductMatch(input.productName), englishName: input.englishName ?? null, englishNameSource: input.englishNameSource ?? null, productDescription: input.productDescription ?? null, modelSpecification: input.modelSpecification ?? null, unit: input.unit ?? null, quantity: input.quantity, unitPriceTaxIncluded: input.unitPriceTaxIncluded, lineAmountTaxIncluded: input.lineAmountTaxIncluded, vatRate: input.vatRate ?? null, vatRateSource: input.vatRateSource ?? 'MANUAL', hsCode: input.hsCode ?? null, hsCodeStatus: input.hsCodeStatus ?? 'UNCONFIRMED', hsCodeSource: input.hsCodeSource ?? null, hsCodeReferenceSnapshotId: null, refundRate: input.refundRate ?? null, refundRateSource: input.refundRateSource ?? null, refundPolicyReference: input.refundPolicyReference ?? null, refundPolicyDate: input.refundPolicyDate ?? null, refundValidationMethod: input.refundValidationMethod ?? null, refundConfirmedAt: null, refundConfirmedById: null, amountMismatchConfirmedAt: null, amountMismatchConfirmedById: null, sourceLocation: null, sourceContent: null }));
+        await this.recalculateProductRisks(scope, 'SOURCE_CHANGED');
+        return saved;
+    }
+    async saveCustomerContractDraft(scope, importTaskId, draft) {
+        const contract = await this.dataSource.transaction(async (manager) => {
+            const parsed = parseCustomerContractNo(draft.contract.contractNo);
+            const contractRepo = manager.getRepository(CustomerContract);
+            const duplicate = await contractRepo.findOne({ where: { ...activeScope(scope), normalizedContractNo: parsed.normalized, deletedAt: IsNull() } });
+            if (duplicate)
+                throw new DomainError(DomainErrorCodes.DUPLICATE_CONTRACT, '客户合同已存在，如需重新上传请先删除旧记录', { id: duplicate.id, contractNo: draft.contract.contractNo });
+            const customer = await this.upsertCustomer(manager, scope, draft.customer);
+            const task = await required(manager.getRepository(ImportTask).findOne({ where: { ...activeScope(scope), id: importTaskId } }), '解析任务不存在');
+            task.status = 'PERSISTING';
+            await manager.getRepository(ImportTask).save(task);
+            const overallRiskLevel = maxRisk(draft.analyses?.map(item => item.riskLevel) ?? []);
+            const entity = await contractRepo.save(contractRepo.create({ ...auditScope(scope), customerId: customer.id, contractNo: draft.contract.contractNo.trim(), normalizedContractNo: parsed.normalized, contractAmountReviewCny: draft.contract.contractAmountReviewCny ?? null, signedAt: draft.contract.signedAt ?? null, overallRiskLevel, latestAnalysisRunId: null, sourceFileId: task.sourceFileId, sourceFileName: task.sourceFileName, importTaskId: task.id }));
+            const clauseRepo = manager.getRepository(CustomerContractClause);
+            const analysisRun = await manager.getRepository(CustomerContractAnalysisRun).save(manager.getRepository(CustomerContractAnalysisRun).create({ ...createdScope(scope), customerContractId: entity.id, importTaskId: task.id, analysisType: 'INITIAL', status: 'SUCCEEDED', promptVersion: 'CUSTOMER_CLAUSE_V1', modelName: null, startedAt: new Date(), completedAt: new Date(), createdById: scope.userId ?? null }));
+            for (const type of ClauseTypes) {
+                const item = draft.clauses.find(clause => clause.clauseType === type);
+                const clause = await clauseRepo.save(clauseRepo.create({ ...auditScope(scope), customerContractId: entity.id, clauseType: type, extractionStatus: item?.extractionStatus ?? (item?.sourceText ? 'FOUND' : 'NOT_FOUND'), sourceText: item?.sourceText ?? null, reviewedText: item?.reviewedText ?? item?.sourceText ?? null, sourceLocation: item?.sourceLocation ?? null, sourceContent: item?.sourceContent ?? null }));
+                const analysis = draft.analyses?.find(value => value.clauseType === type);
+                if (analysis)
+                    await manager.getRepository(CustomerContractClauseAnalysis).save(manager.getRepository(CustomerContractClauseAnalysis).create({ ...createdScope(scope), analysisRunId: analysisRun.id, customerContractClauseId: clause.id, clauseType: type, analyzedTextSnapshot: clause.reviewedText, riskLevel: analysis.riskLevel, riskMessageZh: analysis.riskMessageZh, suggestionZh: analysis.suggestionZh }));
+            }
+            entity.latestAnalysisRunId = analysisRun.id;
+            await contractRepo.save(entity);
+            task.status = 'SUCCEEDED';
+            task.resultEntityId = entity.id;
+            task.reviewSavedAt = new Date();
+            task.completedAt = new Date();
+            await manager.getRepository(ImportTask).save(task);
+            return entity;
+        });
+        await this.recalculateCompanyRisks(scope, 'SOURCE_CHANGED');
+        return contract;
+    }
+    async listCustomers(scope, query = {}) { return this.pagedQuery(Customer, scope, query, ['code', 'name', 'shortName', 'country', 'contactName']); }
+    async listCustomerContracts(scope, query = {}) { return this.pagedQuery(CustomerContract, scope, query, ['contractNo', 'sourceFileName'], { customerId: query.parameters?.customerId }); }
+    async getCustomerContractReview(scope, id) {
+        const contract = await required(this.dataSource.getRepository(CustomerContract).findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '客户合同不存在');
+        const [customer, clauses, runs] = await Promise.all([
+            this.dataSource.getRepository(Customer).findOne({ where: { ...activeScope(scope), id: contract.customerId, deletedAt: IsNull() } }),
+            this.dataSource.getRepository(CustomerContractClause).find({ where: { ...activeScope(scope), customerContractId: id, deletedAt: IsNull() } }),
+            this.dataSource.getRepository(CustomerContractAnalysisRun).find({ where: { ...activeScope(scope), customerContractId: id }, order: { createdAt: 'DESC' } })
+        ]);
+        const analyses = runs.length ? await this.dataSource.getRepository(CustomerContractClauseAnalysis).find({ where: { ...activeScope(scope), analysisRunId: runs[0].id } }) : [];
+        return { contract, customer, clauses, analyses, latestRun: runs[0] ?? null };
+    }
+    async updateCustomerContractReview(scope, id, input) {
+        const saved = await this.dataSource.transaction(async (manager) => {
+            const contractRepo = manager.getRepository(CustomerContract);
+            const contract = await required(contractRepo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '客户合同不存在');
+            const customerRepo = manager.getRepository(Customer);
+            const customer = await required(customerRepo.findOne({ where: { ...activeScope(scope), id: contract.customerId, deletedAt: IsNull() } }), '客户不存在');
+            if (input.customer) {
+                Object.assign(customer, pick(input.customer, ['code', 'name', 'shortName', 'country', 'address', 'contactName', 'phone', 'wechat', 'email', 'taxNumber', 'paymentAccount', 'bankName', 'taxpayerRating', 'website', 'businessProducts']));
+                customer.normalizedName = normalizeExactName(customer.name);
+                customer.updatedById = scope.userId ?? null;
+                await customerRepo.save(customer);
+            }
+            if (input.contract) {
+                Object.assign(contract, pick(input.contract, ['contractAmountReviewCny', 'signedAt']));
+                contract.updatedById = scope.userId ?? null;
+                await contractRepo.save(contract);
+            }
+            const clauseRepo = manager.getRepository(CustomerContractClause);
+            for (const update of input.clauses ?? []) {
+                const clause = await required(clauseRepo.findOne({ where: { ...activeScope(scope), id: update.id, customerContractId: id, deletedAt: IsNull() } }), '客户合同条款不存在');
+                clause.reviewedText = String(update.reviewedText ?? '').trim() || null;
+                clause.extractionStatus = clause.reviewedText ? 'FOUND' : 'NOT_FOUND';
+                clause.updatedById = scope.userId ?? null;
+                await clauseRepo.save(clause);
+            }
+            return { contract, customer };
+        });
+        await this.recalculateCompanyRisks(scope, 'SOURCE_CHANGED');
+        return saved;
+    }
+    async listDerivedSalesOrders(scope, customerId) {
+        const customerRepo = this.dataSource.getRepository(Customer);
+        const contractRepo = this.dataSource.getRepository(CustomerContract);
+        const purchaseRepo = this.dataSource.getRepository(PurchaseOrder);
+        const lineRepo = this.dataSource.getRepository(PurchaseOrderLine);
+        const manualRepo = this.dataSource.getRepository(DerivedSalesOrderManualData);
+        const customers = await customerRepo.find({ where: { ...activeScope(scope), ...(customerId ? { id: customerId } : {}), deletedAt: IsNull() } });
+        const customerMap = new Map(customers.map(customer => [customer.id, customer]));
+        const contracts = await contractRepo.find({ where: { ...activeScope(scope), ...(customerId ? { customerId } : {}), deletedAt: IsNull() } });
+        const purchases = await purchaseRepo.find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        const results = [];
+        for (const contract of contracts) {
+            const customer = customerMap.get(contract.customerId) ?? await customerRepo.findOne({ where: { ...activeScope(scope), id: contract.customerId, deletedAt: IsNull() } });
+            if (!customer)
+                continue;
+            const baseCode = parseCustomerContractNo(contract.contractNo).baseCode;
+            for (const purchase of purchases.filter(item => parsePurchaseContractNo(item.contractNo).baseCode === baseCode)) {
+                const manual = await manualRepo.findOne({ where: { ...activeScope(scope), customerContractId: contract.id, purchaseOrderId: purchase.id, deletedAt: IsNull() } });
+                const effectiveRate = manual?.pricingProfitRateOverride ?? customer.defaultPricingProfitRate;
+                if (effectiveRate == null)
+                    continue;
+                const source = manual?.pricingProfitRateOverride != null ? 'ORDER_OVERRIDE' : 'CUSTOMER_DEFAULT';
+                const lines = await lineRepo.find({ where: { ...activeScope(scope), purchaseOrderId: purchase.id, deletedAt: IsNull() }, order: { lineNumber: 'ASC' } });
+                const riskRows = lines.length ? await this.dataSource.getRepository(ProductComplianceMatch).find({ where: { ...activeScope(scope), purchaseOrderLineId: In(lines.map(line => line.id)), deletedAt: IsNull() } }) : [];
+                const derivedLines = lines.map(line => {
+                    const pricing = deriveSalesLine({ purchaseUnitPriceCny: line.unitPriceTaxIncluded, quantity: line.quantity }, effectiveRate);
+                    return { purchaseOrderLineId: line.id, productName: line.productName, englishName: line.englishName, productDescription: line.productDescription, modelSpecification: line.modelSpecification, unit: line.unit, quantity: line.quantity, hsCode: line.hsCode, ...pricing, complianceMatches: riskRows.filter(match => match.purchaseOrderLineId === line.id).map(match => ({ controlledGoodsId: match.controlledGoodsId, catalogType: match.catalogType, matchMethod: match.matchMethod, similarityScore: match.similarityScore })) };
+                });
+                const amount = derivedLines.reduce((sum, line) => sum.plus(line.salesLineAmountCny), new Decimal(0));
+                const received = new Decimal(manual?.receivedAmountCny ?? 0);
+                results.push({ customerContractId: contract.id, purchaseOrderId: purchase.id, customerId: customer.id, salesOrderNo: parsePurchaseContractNo(purchase.contractNo).salesOrderNo, customerContractNo: contract.contractNo, purchaseContractNo: purchase.contractNo, orderDate: purchase.orderDate, currencyCode: 'CNY', pricingProfitRateSource: source, effectivePricingProfitRate: effectiveRate, orderAmountCny: amount.toFixed(0), receivedAmountCny: received.toFixed(2), unreceivedAmountCny: Decimal.max(amount.minus(received), 0).toFixed(2), lines: derivedLines });
+            }
+        }
+        return results;
+    }
+    async saveCustomerProfitRate(scope, customerId, rate) {
+        const repo = this.dataSource.getRepository(Customer);
+        const customer = await required(repo.findOne({ where: { ...activeScope(scope), id: customerId, deletedAt: IsNull() } }), '客户不存在');
+        if (new Decimal(rate).isNegative())
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '客户默认利润率不能小于 0');
+        await this.assertExistingReceiptsRemainValid(scope, customerId, rate);
+        customer.defaultPricingProfitRate = rate;
+        customer.updatedById = scope.userId ?? null;
+        return repo.save(customer);
+    }
+    async updateCustomer(scope, id, input) {
+        const repo = this.dataSource.getRepository(Customer);
+        const item = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '客户不存在');
+        Object.assign(item, pick(input, ['code', 'name', 'shortName', 'country', 'address', 'contactName', 'phone', 'wechat', 'email', 'taxNumber', 'paymentAccount', 'bankName', 'taxpayerRating', 'website', 'businessProducts']));
+        item.normalizedName = normalizeExactName(item.name);
+        item.updatedById = scope.userId ?? null;
+        const saved = await repo.save(item);
+        await this.recalculateCompanyRisks(scope, 'SOURCE_CHANGED');
+        return saved;
+    }
+    async saveDerivedManualData(scope, customerContractId, purchaseOrderId, input) {
+        const repo = this.dataSource.getRepository(DerivedSalesOrderManualData);
+        let row = await repo.findOne({ where: { ...activeScope(scope), customerContractId, purchaseOrderId, deletedAt: IsNull() } });
+        if (!row)
+            row = repo.create({ ...auditScope(scope), customerContractId, purchaseOrderId, pricingProfitRateOverride: null, receivedAmountCny: '0' });
+        const override = input.pricingProfitRateOverride === undefined ? row.pricingProfitRateOverride : normalizeOptionalDecimalInput(input.pricingProfitRateOverride);
+        if (override != null && new Decimal(override).isNegative())
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '订单利润率不能小于 0');
+        row.pricingProfitRateOverride = override;
+        const derived = await this.deriveSingleOrder(scope, customerContractId, purchaseOrderId, row.pricingProfitRateOverride);
+        const received = input.receivedAmountCny ?? row.receivedAmountCny;
+        assertReceivedAmount(derived.orderAmountCny, received);
+        row.receivedAmountCny = received;
+        row.updatedById = scope.userId ?? null;
+        return repo.save(row);
+    }
+    async softDelete(scope, entityType, id) {
+        const map = { controlledGoods: ControlledGoodsRecord, sanctionedCompany: SanctionedCompanyRecord, supplier: Supplier, purchaseOrder: PurchaseOrder, purchaseLine: PurchaseOrderLine, customer: Customer, customerContract: CustomerContract, generatedFile: GeneratedSalesFile, exchangeRate: MonthlySafeExchangeRate };
+        const entity = map[entityType];
+        if (!entity)
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '不支持的删除类型', { entityType });
+        if (entity === Customer) {
+            const count = await this.dataSource.getRepository(CustomerContract).count({ where: { ...activeScope(scope), customerId: id, deletedAt: IsNull() } });
+            if (count)
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '客户存在有效合同，不能删除', { contractCount: count });
+        }
+        if (entity === Supplier) {
+            const count = await this.dataSource.getRepository(PurchaseOrder).count({ where: { ...activeScope(scope), supplierId: id, deletedAt: IsNull() } });
+            if (count)
+                throw new DomainError(DomainErrorCodes.INVALID_INPUT, '供应商存在有效采购订单，不能删除', { orderCount: count });
+        }
+        const repo = this.dataSource.getRepository(entity);
+        const row = await required(repo.findOne({ where: { ...activeScope(scope), id, deletedAt: IsNull() } }), '记录不存在');
+        if (entity === PurchaseOrderLine)
+            await this.assertPurchaseOrderReceiptsRemainValid(scope, row.purchaseOrderId, undefined, row.id);
+        row.deletedAt = new Date();
+        row.deletedById = scope.userId ?? null;
+        row.deleteOperation = 'USER_DELETE';
+        row.updatedById = scope.userId ?? null;
+        await repo.save(row);
+        if (entity === PurchaseOrder)
+            await this.cascadePurchaseOrder(scope, id);
+        if (entity === CustomerContract)
+            await this.cascadeCustomerContract(scope, id);
+        if (entity === PurchaseOrderLine) {
+            await this.dataSource.getRepository(ProductComplianceMatch).update({ ...activeScope(scope), purchaseOrderLineId: id, deletedAt: IsNull() }, { deletedAt: new Date(), invalidationReason: 'SOURCE_CHANGED' });
+        }
+        if (entity === ControlledGoodsRecord)
+            await this.recalculateProductRisks(scope, 'CATALOG_CHANGED');
+        if (entity === SanctionedCompanyRecord)
+            await this.recalculateCompanyRisks(scope, 'CATALOG_CHANGED');
+        return row;
+    }
+    async listGeneratedFiles(scope, query = {}) { return this.pagedQuery(GeneratedSalesFile, scope, query, ['salesOrderNoSnapshot', 'documentNo', 'fileName'], { customerContractId: query.parameters?.customerContractId, purchaseOrderId: query.parameters?.purchaseOrderId, fileType: query.parameters?.fileType }); }
+    async settings(scope) {
+        const [{ risk, profit }, company, banks, rates] = await Promise.all([
+            this.bootstrapSettings(scope),
+            this.dataSource.getRepository(CompanySettings).findOne({ where: activeScope(scope) }),
+            this.dataSource.getRepository(BankAccountSettings).find({ where: activeScope(scope), order: { bankType: 'ASC' } }),
+            this.dataSource.getRepository(MonthlySafeExchangeRate).find({ where: { ...activeScope(scope), deletedAt: IsNull() }, order: { year: 'DESC', month: 'DESC' } })
+        ]);
+        return { risk, company, banks, profit, rates };
+    }
+    async saveSettings(scope, type, input) {
+        const entityMap = { risk: RiskNoticeSettings, company: CompanySettings, bank: BankAccountSettings, profit: ProfitRuleSettings, rate: MonthlySafeExchangeRate };
+        const entity = entityMap[type];
+        const repo = this.dataSource.getRepository(entity);
+        const where = { ...activeScope(scope) };
+        if (type === 'bank')
+            where.bankType = input.bankType;
+        if (type === 'rate') {
+            where.year = input.year;
+            where.month = input.month;
+            where.currencyCode = 'USD';
+            where.deletedAt = IsNull();
+        }
+        let row = await repo.findOne({ where });
+        const before = row ? { ...row } : null;
+        if (!row)
+            row = repo.create({ ...auditScope(scope), ...(type === 'rate' ? { currencyCode: 'USD' } : {}) });
+        const allowed = { risk: ['content'], company: ['logoFileId', 'companyNameZh', 'companyNameEn', 'unifiedSocialCreditCode', 'addressZh', 'addressEn', 'phone', 'email'], bank: ['bankType', 'beneficiary', 'bankName', 'bankAddress', 'cnapsCode', 'accountNo', 'swiftCode'], profit: ['status', 'ruleVersion', 'minimumOrderProfitRate', 'exchangeCostMinimum', 'exchangeCostMaximum'], rate: ['year', 'month', 'usdToCnyRate', 'sourceReference'] };
+        Object.assign(row, pick(input, allowed[type]));
+        row.updatedById = scope.userId ?? null;
+        row.revision = nextSettingsRevision(before?.revision);
+        const saved = await repo.save(row);
+        await this.dataSource.getRepository(SettingsHistory).save(this.dataSource.getRepository(SettingsHistory).create({ ...activeScope(scope), settingsType: type.toUpperCase(), settingsId: saved.id, operationType: 'EDIT', snapshotVersion: 'v1', beforeRevision: before?.revision ?? 0, afterRevision: saved.revision ?? 1, beforeSnapshot: before, afterSnapshot: saved, operatedById: scope.userId ?? null }));
+        return saved;
+    }
+    async analytics(scope, filters = {}) {
+        const purchases = await this.dataSource.getRepository(PurchaseOrder).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        const suppliers = await this.dataSource.getRepository(Supplier).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        const lines = await this.dataSource.getRepository(PurchaseOrderLine).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        const derived = await this.listDerivedSalesOrders(scope);
+        const supplierMap = new Map(suppliers.map(item => [item.id, item.name]));
+        const search = String(filters.search ?? '').trim().toLocaleLowerCase();
+        const dateFrom = String(filters.orderDateFrom ?? '').trim();
+        const dateTo = String(filters.orderDateTo ?? '').trim();
+        const unpaidOnly = filters.unpaidOnly === true || filters.unpaidOnly === 'true';
+        const unreceivedOnly = filters.unreceivedOnly === true || filters.unreceivedOnly === 'true';
+        const purchaseRows = purchases.map(order => ({ ...order, supplierName: supplierMap.get(order.supplierId) ?? '', unpaidAmountCny: Decimal.max(new Decimal(order.contractAmountCny).minus(order.paidAmountCny), 0).toFixed(2), unrefundedAmountCny: this.unrefundedAmount(order, lines.filter(line => line.purchaseOrderId === order.id)) })).filter(row => {
+            const orderLines = lines.filter(line => line.purchaseOrderId === row.id);
+            const text = [row.contractNo, row.supplierName, ...orderLines.flatMap(line => [line.productName, line.hsCode])].filter(Boolean).join(' ').toLocaleLowerCase();
+            return (!search || text.includes(search)) && (!dateFrom || String(row.orderDate ?? '') >= dateFrom) && (!dateTo || String(row.orderDate ?? '') <= dateTo) && (!unpaidOnly || new Decimal(row.unpaidAmountCny).gt(0));
+        });
+        const customerNames = new Map((await this.dataSource.getRepository(Customer).find({ where: { ...activeScope(scope), deletedAt: IsNull() } })).map(item => [item.id, item.name]));
+        const salesRows = derived.filter(row => {
+            const text = [row.salesOrderNo, row.purchaseContractNo, row.customerContractNo, customerNames.get(row.customerId), ...row.lines.flatMap(line => [line.productName, line.hsCode])].filter(Boolean).join(' ').toLocaleLowerCase();
+            return (!search || text.includes(search)) && (!dateFrom || String(row.orderDate ?? '') >= dateFrom) && (!dateTo || String(row.orderDate ?? '') <= dateTo) && (!unreceivedOnly || new Decimal(row.unreceivedAmountCny).gt(0));
+        });
+        const purchaseIds = new Set(purchaseRows.map(row => row.id));
+        const filteredLines = lines.filter(line => purchaseIds.has(line.purchaseOrderId));
+        const currentYear = new Date().getFullYear();
+        return {
+            purchase: summarizeRows(purchaseRows, 'contractAmountCny', 'paidAmountCny', 'unpaidAmountCny'),
+            sales: summarizeRows(salesRows, 'orderAmountCny', 'receivedAmountCny', 'unreceivedAmountCny'),
+            annualPurchaseCount: purchaseRows.filter(row => row.orderDate?.startsWith(String(currentYear))).length,
+            annualSalesCount: salesRows.filter(row => row.orderDate?.startsWith(String(currentYear))).length,
+            purchaseTop5: topProducts(filteredLines, 'lineAmountTaxIncluded'),
+            salesTop5: topDerivedProducts(salesRows),
+            filters
+        };
+    }
+    async recalculateProductRisks(scope, reason) {
+        const matchRepo = this.dataSource.getRepository(ProductComplianceMatch);
+        const now = new Date();
+        await matchRepo.update({ ...activeScope(scope), deletedAt: IsNull() }, { deletedAt: now, invalidationReason: reason });
+        const [lines, goods] = await Promise.all([
+            this.dataSource.getRepository(PurchaseOrderLine).find({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
+            this.dataSource.getRepository(ControlledGoodsRecord).find({ where: { ...activeScope(scope), deletedAt: IsNull() } })
+        ]);
+        for (const line of lines) {
+            const lineHs = normalizeHsCode(line.hsCode);
+            const hsMatches = lineHs ? goods.filter(item => item.normalizedHsCode && item.normalizedHsCode === lineHs) : [];
+            const candidates = hsMatches.length ? hsMatches : goods.filter(item => isProductNameMatch(line.productName, item.productName));
+            for (const item of candidates) {
+                const contains = normalizeForProductMatch(line.productName).includes(normalizeForProductMatch(item.productName)) || normalizeForProductMatch(item.productName).includes(normalizeForProductMatch(line.productName));
+                await matchRepo.save(matchRepo.create({ ...createdScope(scope), purchaseOrderLineId: line.id, controlledGoodsId: item.id, catalogType: item.catalogType, matchMethod: hsMatches.length ? 'HS_CODE_EXACT' : contains ? 'NAME_CONTAINS' : 'NAME_DICE', similarityScore: null, matchingRuleVersion: 'PRODUCT_MATCH_V1', matchingThreshold: '0.65', matchedAt: now, deletedAt: null, invalidationReason: null }));
+            }
+            line.complianceCheckedAt = now;
+            await this.dataSource.getRepository(PurchaseOrderLine).save(line);
+        }
+        return { scanned: lines.length, matches: await matchRepo.count({ where: { ...activeScope(scope), deletedAt: IsNull() } }) };
+    }
+    async recalculateCompanyRisks(scope, reason) {
+        const repo = this.dataSource.getRepository(CompanySanctionMatch);
+        const now = new Date();
+        await repo.update({ ...activeScope(scope), deletedAt: IsNull() }, { deletedAt: now, invalidationReason: reason });
+        const [suppliers, customers, sanctions] = await Promise.all([
+            this.dataSource.getRepository(Supplier).find({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
+            this.dataSource.getRepository(Customer).find({ where: { ...activeScope(scope), deletedAt: IsNull() } }),
+            this.dataSource.getRepository(SanctionedCompanyRecord).find({ where: { ...activeScope(scope), deletedAt: IsNull() } })
+        ]);
+        for (const supplier of suppliers) {
+            for (const item of sanctions.filter(row => row.normalizedCompanyName === 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 }));
+            supplier.complianceCheckedAt = now;
+            await this.dataSource.getRepository(Supplier).save(supplier);
+        }
+        for (const customer of customers) {
+            for (const item of sanctions.filter(row => row.normalizedCompanyName === 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 }));
+            customer.complianceCheckedAt = now;
+            await this.dataSource.getRepository(Customer).save(customer);
+        }
+        return { scanned: suppliers.length + customers.length, matches: await repo.count({ where: { ...activeScope(scope), deletedAt: IsNull() } }) };
+    }
+    async pagedQuery(entity, scope, query, searchFields, exactFilters = {}) {
+        const page = Math.max(1, Number(query.page ?? 1));
+        const pageSize = Math.min(200, Math.max(1, Number(query.pageSize ?? 20)));
+        const qb = this.dataSource.getRepository(entity).createQueryBuilder('row').where('row.tenantId = :tenantId AND row.organizationId = :organizationId', activeScope(scope));
+        if (this.dataSource.getMetadata(entity).findColumnWithPropertyName('deletedAt'))
+            qb.andWhere('row.deletedAt IS NULL');
+        const search = String(query.search ?? '').trim();
+        if (search)
+            qb.andWhere(new Brackets(inner => searchFields.forEach((field, index) => index ? inner.orWhere(`CAST(row.${field} AS TEXT) ILIKE :search`) : inner.where(`CAST(row.${field} AS TEXT) ILIKE :search`))), { search: `%${search}%` });
+        for (const [key, value] of Object.entries(exactFilters))
+            if (value !== undefined && value !== null && value !== '')
+                qb.andWhere(`row.${key} = :filter_${key}`, { [`filter_${key}`]: value });
+        const [items, total] = await qb.orderBy('row.createdAt', 'DESC').skip((page - 1) * pageSize).take(pageSize).getManyAndCount();
+        return { items, total, page, pageSize };
+    }
+    async upsertSupplier(manager, scope, input) {
+        const repo = manager.getRepository(Supplier);
+        const normalizedName = normalizeExactName(input.name);
+        let item = await repo.findOne({ where: { ...activeScope(scope), normalizedName, deletedAt: IsNull() } });
+        if (!item)
+            item = repo.create({ ...auditScope(scope), name: input.name.trim(), normalizedName });
+        const manualCode = item.code;
+        Object.assign(item, pick(input, ['name', 'shortName', 'address', 'contactName', 'phone', 'wechat', 'email', 'taxNumber', 'paymentAccount', 'bankName', 'taxpayerRating', 'website', 'businessProducts']));
+        item.normalizedName = normalizedName;
+        item.code = manualCode ?? input.code ?? null;
+        item.updatedById = scope.userId ?? null;
+        return repo.save(item);
+    }
+    async upsertCustomer(manager, scope, input) {
+        const repo = manager.getRepository(Customer);
+        const normalizedName = normalizeExactName(input.name);
+        let item = await repo.findOne({ where: { ...activeScope(scope), normalizedName, deletedAt: IsNull() } });
+        if (!item)
+            item = repo.create({ ...auditScope(scope), name: input.name.trim(), normalizedName });
+        const manualCode = item.code;
+        const profitRate = item.defaultPricingProfitRate;
+        Object.assign(item, pick(input, ['name', 'shortName', 'country', 'address', 'contactName', 'phone', 'wechat', 'email', 'taxNumber', 'paymentAccount', 'bankName', 'taxpayerRating', 'website', 'businessProducts']));
+        item.normalizedName = normalizedName;
+        item.code = manualCode ?? input.code ?? null;
+        item.defaultPricingProfitRate = profitRate ?? input.defaultPricingProfitRate ?? null;
+        item.updatedById = scope.userId ?? null;
+        return repo.save(item);
+    }
+    async deriveSingleOrder(scope, customerContractId, purchaseOrderId, override) {
+        const contract = await required(this.dataSource.getRepository(CustomerContract).findOne({ where: { ...activeScope(scope), id: customerContractId, deletedAt: IsNull() } }), '客户合同不存在');
+        const customer = await required(this.dataSource.getRepository(Customer).findOne({ where: { ...activeScope(scope), id: contract.customerId, deletedAt: IsNull() } }), '客户不存在');
+        const purchase = await required(this.dataSource.getRepository(PurchaseOrder).findOne({ where: { ...activeScope(scope), id: purchaseOrderId, deletedAt: IsNull() } }), '采购订单不存在');
+        const rate = override ?? customer.defaultPricingProfitRate;
+        if (rate == null)
+            throw new DomainError(DomainErrorCodes.CUSTOMER_PROFIT_RATE_REQUIRED, '客户默认利润率未维护');
+        const lines = await this.dataSource.getRepository(PurchaseOrderLine).find({ where: { ...activeScope(scope), purchaseOrderId, deletedAt: IsNull() } });
+        const amount = lines.reduce((sum, line) => sum.plus(deriveSalesLine({ purchaseUnitPriceCny: line.unitPriceTaxIncluded, quantity: line.quantity }, rate).salesLineAmountCny), new Decimal(0));
+        return { contract, customer, purchase, rate, orderAmountCny: amount.toFixed(0) };
+    }
+    async assertExistingReceiptsRemainValid(scope, customerId, fallbackRate) {
+        const contracts = await this.dataSource.getRepository(CustomerContract).find({ where: { ...activeScope(scope), customerId, deletedAt: IsNull() } });
+        const manuals = contracts.length ? await this.dataSource.getRepository(DerivedSalesOrderManualData).find({ where: { ...activeScope(scope), customerContractId: In(contracts.map(item => item.id)), deletedAt: IsNull() } }) : [];
+        for (const row of manuals.filter(item => item.pricingProfitRateOverride == null)) {
+            const derived = await this.deriveSingleOrder(scope, row.customerContractId, row.purchaseOrderId, fallbackRate);
+            assertReceivedAmount(derived.orderAmountCny, row.receivedAmountCny);
+        }
+    }
+    async assertPurchaseOrderReceiptsRemainValid(scope, purchaseOrderId, changedLine, deletedLineId) {
+        const purchase = await required(this.dataSource.getRepository(PurchaseOrder).findOne({ where: { ...activeScope(scope), id: purchaseOrderId, deletedAt: IsNull() } }), '采购订单不存在');
+        const sourceLines = await this.dataSource.getRepository(PurchaseOrderLine).find({ where: { ...activeScope(scope), purchaseOrderId, deletedAt: IsNull() } });
+        const lines = sourceLines.filter(line => line.id !== deletedLineId).map(line => changedLine?.id === line.id ? changedLine : line);
+        const baseCode = parsePurchaseContractNo(purchase.contractNo).baseCode;
+        const contracts = await this.dataSource.getRepository(CustomerContract).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        for (const contract of contracts.filter(item => parseCustomerContractNo(item.contractNo).baseCode === baseCode)) {
+            const [customer, manual] = await Promise.all([
+                this.dataSource.getRepository(Customer).findOne({ where: { ...activeScope(scope), id: contract.customerId, deletedAt: IsNull() } }),
+                this.dataSource.getRepository(DerivedSalesOrderManualData).findOne({ where: { ...activeScope(scope), customerContractId: contract.id, purchaseOrderId, deletedAt: IsNull() } })
+            ]);
+            if (!customer || !manual || new Decimal(manual.receivedAmountCny).eq(0))
+                continue;
+            const rate = manual.pricingProfitRateOverride ?? customer.defaultPricingProfitRate;
+            if (rate == null)
+                continue;
+            const total = lines.reduce((sum, line) => sum.plus(deriveSalesLine({ purchaseUnitPriceCny: line.unitPriceTaxIncluded, quantity: line.quantity }, rate).salesLineAmountCny), new Decimal(0));
+            assertReceivedAmount(total, manual.receivedAmountCny);
+        }
+    }
+    async cascadePurchaseOrder(scope, purchaseOrderId) {
+        const now = new Date();
+        const lineRepo = this.dataSource.getRepository(PurchaseOrderLine);
+        const lines = await lineRepo.find({ where: { ...activeScope(scope), purchaseOrderId, deletedAt: IsNull() } });
+        if (lines.length) {
+            await lineRepo.update({ ...activeScope(scope), purchaseOrderId, deletedAt: IsNull() }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'SOURCE_CASCADE' });
+            await this.dataSource.getRepository(ProductComplianceMatch).update({ ...activeScope(scope), purchaseOrderLineId: In(lines.map(line => line.id)), deletedAt: IsNull() }, { deletedAt: now, invalidationReason: 'SOURCE_CHANGED' });
+        }
+        await this.dataSource.getRepository(DerivedSalesOrderManualData).update({ ...activeScope(scope), purchaseOrderId, deletedAt: IsNull() }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'SOURCE_CASCADE' });
+    }
+    async cascadeCustomerContract(scope, customerContractId) {
+        const now = new Date();
+        await Promise.all([
+            this.dataSource.getRepository(CustomerContractClause).update({ ...activeScope(scope), customerContractId, deletedAt: IsNull() }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'SOURCE_CASCADE' }),
+            this.dataSource.getRepository(DerivedSalesOrderManualData).update({ ...activeScope(scope), customerContractId, deletedAt: IsNull() }, { deletedAt: now, deletedById: scope.userId ?? null, deleteOperation: 'SOURCE_CASCADE' })
+        ]);
+    }
+    async expireStaleImportTasks(scope) {
+        const repo = this.dataSource.getRepository(ImportTask);
+        const tasks = await repo.find({ where: { ...activeScope(scope), status: In(['QUEUED', 'EXTRACTING', 'AI_PARSING', 'VALIDATING', 'PERSISTING']) } });
+        const now = new Date();
+        for (const task of tasks) {
+            const startedAt = task.startedAt ?? task.queuedAt ?? task.createdAt;
+            if (!startedAt || !importTaskTimedOut(startedAt, now))
+                continue;
+            task.status = 'TIMED_OUT';
+            task.errorCode = DomainErrorCodes.IMPORT_TIMED_OUT;
+            task.errorMessage = '文件解析超过 20 分钟，请重新上传';
+            task.completedAt = now;
+            task.machineElapsedMs = now.getTime() - startedAt.getTime();
+            await repo.save(task);
+        }
+    }
+    async countUnlinkedPurchases(scope) {
+        const contracts = await this.dataSource.getRepository(CustomerContract).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        const bases = new Set(contracts.map(item => parseCustomerContractNo(item.contractNo).baseCode));
+        const orders = await this.dataSource.getRepository(PurchaseOrder).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        return orders.filter(item => !bases.has(parsePurchaseContractNo(item.contractNo).baseCode)).length;
+    }
+    async countUnlinkedCustomers(scope) {
+        const purchases = await this.dataSource.getRepository(PurchaseOrder).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        const bases = new Set(purchases.map(item => parsePurchaseContractNo(item.contractNo).baseCode));
+        const contracts = await this.dataSource.getRepository(CustomerContract).find({ where: { ...activeScope(scope), deletedAt: IsNull() } });
+        return contracts.filter(item => !bases.has(parseCustomerContractNo(item.contractNo).baseCode)).length;
+    }
+    unrefundedAmount(order, lines) {
+        const expected = lines.reduce((sum, line) => line.refundRate ? sum.plus(new Decimal(line.lineAmountTaxIncluded).div(new Decimal(line.vatRate ?? 0).add(1)).mul(line.refundRate)) : sum, new Decimal(0));
+        return Decimal.max(expected.minus(order.refundedAmountCny), 0).toFixed(2);
+    }
+};
+TradeComplianceWorkbenchService = __decorate([
+    Injectable(),
+    __param(0, InjectDataSource()),
+    __metadata("design:paramtypes", [DataSource])
+], TradeComplianceWorkbenchService);
+export { TradeComplianceWorkbenchService };
+function activeScope(scope) { return { tenantId: scope.tenantId, organizationId: scope.organizationId }; }
+function createdScope(scope) { return { ...activeScope(scope), createdById: scope.userId ?? null }; }
+function auditScope(scope) { return { ...createdScope(scope), updatedById: scope.userId ?? null, deletedAt: null, deletedById: null, deleteOperation: null }; }
+async function required(promise, message) { const value = await promise; if (!value)
+    throw new DomainError(DomainErrorCodes.NOT_FOUND, message); return value; }
+function pick(input, keys) { return Object.fromEntries(keys.filter(key => key in input).map(key => [key, input[key]])); }
+function maxRisk(levels) { return levels.includes('HIGH') ? 'HIGH' : levels.includes('MEDIUM') ? 'MEDIUM' : levels.includes('LOW') ? 'LOW' : null; }
+function summarizeRows(rows, totalKey, paidKey, unpaidKey) { return { count: rows.length, totalCny: sum(rows, totalKey), paidCny: sum(rows, paidKey), unpaidCny: sum(rows, unpaidKey), rows }; }
+function sum(rows, key) { return rows.reduce((value, row) => value.plus(row[key] ?? 0), new Decimal(0)).toFixed(2); }
+function topProducts(lines, amountKey) { const map = new Map(); for (const line of lines)
+    map.set(line.productName, (map.get(line.productName) ?? new Decimal(0)).plus(String(line[amountKey] ?? 0))); return [...map].sort((a, b) => b[1].cmp(a[1])).slice(0, 5).map(([name, amountCny]) => ({ name, amountCny: amountCny.toFixed(2) })); }
+function topDerivedProducts(orders) { const map = new Map(); for (const order of orders)
+    for (const line of order.lines)
+        map.set(line.productName, (map.get(line.productName) ?? new Decimal(0)).plus(line.salesLineAmountCny)); return [...map].sort((a, b) => b[1].cmp(a[1])).slice(0, 5).map(([name, amountCny]) => ({ name, amountCny: amountCny.toFixed(2) })); }
+//# sourceMappingURL=workbench.service.js.map