@chenchaolong/plugin-trade-compliance-workbench 1.0.172 → 1.0.174

package/dist/lib/workbench.service.js

@@ -13,6 +13,7 @@ import { createHash, randomUUID } from 'node:crypto';
 import { BankAccountSettings, CatalogReviewBlock, CompanySanctionMatch, CompanySettings, ControlledCatalogBatch, ControlledCatalogImportIssue, ControlledGoodsRecord, Customer, CustomerContract, CustomerContractAnalysisRun, CustomerContractClause, CustomerContractClauseAnalysis, DerivedSalesOrderManualData, GeneratedSalesFile, HsCodeReferenceSnapshot, ImportTask, ManagedAsset, MonthlySafeExchangeRate, ProductComplianceMatch, ProfitRuleSettings, PurchaseOrder, PurchaseOrderLine, SanctionCatalogBatch, SanctionCatalogImportIssue, SanctionedCompanyAlias, SanctionedCompanyRecord, SettingsHistory, Supplier } from './entities/index.js';
 import { CATALOG_REVIEW_BATCH_LIMIT, CATALOG_REVIEW_LEASE_MS, CATALOG_TRANSLATION_REVIEW_LEASE_MS } from './constants.js';
 import { CatalogTypes, ClauseTypes, CustomerProfitRateStatuses, DomainError, DomainErrorCodes, RefundValidationMethods, RiskLevels, SalesPaymentStatuses, SanctionHitStatuses, StalledCatalogImportDecisions } from './types.js';
+import { resolveSalesLineOrder } from './domain/sales-line-order.js';
 import { deriveSalesLine, assertReceivedAmount, calculateSalesLineFromRate } from './domain/finance.js';
 import { assertYcNumberContractNo, parseCustomerContractNo, parsePurchaseContractNo } from './domain/contract-number.js';
 import { isProductNameMatch, normalizeExactName, normalizeForProductMatch, normalizeHsCode, normalizeSanctionSource } from './domain/normalization.js';
@@ -26,7 +27,7 @@ import { parseBankAccountType, parseExchangeRateInput, parseExpectedRevision, va
 import { publicCustomerContractReanalysisDto, publicImportTaskDto } from './public-dto.js';
 import { classifyCandidate, normalizeCatalogCandidate } from './catalog-import/confidence.js';
 import { catalogTerminalOutcome } from './catalog-import/outcome.js';
-import { analyticsBusinessDetailFromRaw, analyticsDashboardFromRaw, analyticsDashboardStatement, analyticsDetailStatement, analyticsDetailTotalFromRaw, analyticsExportComplianceFromRaw, analyticsExportCustomersFromRaw, analyticsExportFundRisksFromRaw, analyticsExportSalesFileReviewsFromRaw, analyticsExportStatements, analyticsExportSuppliersFromRaw, resolveAnalyticsPeriod } from './analytics-query.js';
+import { analyticsBusinessDetailFromRaw, analyticsDashboardFromRaw, analyticsDashboardStatement, analyticsDetailStatement, analyticsDetailTotalFromRaw, analyticsExportComplianceFromRaw, analyticsExportCustomersFromRaw, analyticsExportFundRisksFromRaw, analyticsExportSalesFileReviewsFromRaw, analyticsExportStatements, analyticsExportSuppliersFromRaw, analyticsSalesLineAmountSql, resolveAnalyticsPeriod } from './analytics-query.js';
 import { analyticsExportMaxRows, renderAnalyticsExportWorkbook } from './analytics-export.js';
 import { formatBeijingDateTime } from './remote-ui/date-time.js';
 import { TradeComplianceSchemaMaintenance } from './schema-maintenance.js';
@@ -2931,7 +2932,68 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                     qb.andWhere("row.complianceCheckStatus = 'UNCHECKED'");
             }
         });
-        return { ...page, items: await this.salesCustomerDtos(scope, page.items) };
+        return { ...page, items: await this.salesCustomerDtos(scope, page.items, true, true) };
+    }
+    /**
+     * 客户级未收款总额（CNY）：派生销售订单（客户合同组）各自 clamp 后汇总，超收不抵扣其他订单欠款。
+     * 口径与销售订单列表、分析看板一致：订单总额 = 人工覆盖值或商品行汇总，未收款 = max(总额 - 已收款, 0)。
+     */
+    async customerUnreceivedAmounts(scope, customerIds) {
+        const map = new Map();
+        const ids = [...new Set(customerIds)].filter(Boolean);
+        if (!ids.length)
+            return map;
+        const parameters = [];
+        const parameter = (value) => { parameters.push(value); return `$${parameters.length}`; };
+        const tenant = parameter(scope.tenantId);
+        const organization = parameter(scope.organizationId);
+        const customerIdsSql = ids.map(id => parameter(id)).join(', ');
+        const lineSalesAmount = analyticsSalesLineAmountSql('line', 'sales_pairs."linePricingOverrides"', 'sales_pairs."effectivePricingProfitRate"');
+        const sql = `WITH sales_pairs AS (
+      SELECT contract."customerId", contract.id AS "customerContractId", purchase.id AS "purchaseOrderId",
+        COALESCE(manual."receivedAmountCny", 0) AS "receivedCny",
+        manual."orderAmountCnyOverride" AS "orderAmountCnyOverride",
+        manual."linePricingOverrides" AS "linePricingOverrides",
+        COALESCE(manual."pricingProfitRateOverride", contract_customer."defaultPricingProfitRate") AS "effectivePricingProfitRate"
+      FROM plugin_trade_compliance_customer_contract contract
+      INNER JOIN plugin_trade_compliance_customer contract_customer ON contract_customer.id = contract."customerId" AND contract_customer."tenantId" = contract."tenantId" AND contract_customer."organizationId" = contract."organizationId" AND contract_customer."deletedAt" IS NULL
+      INNER JOIN plugin_trade_compliance_purchase_order purchase ON purchase."tenantId" = contract."tenantId" AND purchase."organizationId" = contract."organizationId" AND purchase."deletedAt" IS NULL AND ${derivedSalesContractLinkSql('contract', 'purchase')}
+      LEFT JOIN plugin_trade_compliance_derived_sales_manual manual ON manual."customerContractId" = contract.id AND manual."purchaseOrderId" = purchase.id AND manual."tenantId" = contract."tenantId" AND manual."organizationId" = contract."organizationId" AND manual."deletedAt" IS NULL
+      WHERE contract."tenantId" = ${tenant} AND contract."organizationId" = ${organization} AND contract."deletedAt" IS NULL AND contract."customerId" IN (${customerIdsSql})
+    ), sales_line_totals AS (
+      SELECT sales_pairs."customerId", sales_pairs."customerContractId", sales_pairs."purchaseOrderId", sales_pairs."receivedCny",
+        COALESCE(sales_pairs."orderAmountCnyOverride", COALESCE(SUM(${lineSalesAmount}), 0)) AS "salesTotalCny"
+      FROM sales_pairs
+      LEFT JOIN plugin_trade_compliance_purchase_order_line line ON line."purchaseOrderId" = sales_pairs."purchaseOrderId" AND line."tenantId" = ${tenant} AND line."organizationId" = ${organization} AND line."deletedAt" IS NULL
+      GROUP BY sales_pairs."customerId", sales_pairs."customerContractId", sales_pairs."purchaseOrderId", sales_pairs."receivedCny", sales_pairs."orderAmountCnyOverride"
+    ), sales_contract_totals AS (
+      SELECT sales_line_totals."customerId", sales_line_totals."customerContractId",
+        SUM(sales_line_totals."salesTotalCny") AS "salesTotalCny",
+        SUM(sales_line_totals."receivedCny") AS "receivedCny"
+      FROM sales_line_totals
+      GROUP BY sales_line_totals."customerId", sales_line_totals."customerContractId"
+    )
+    SELECT sales_contract_totals."customerId" AS "customerId",
+      SUM(GREATEST(sales_contract_totals."salesTotalCny" - sales_contract_totals."receivedCny", 0))::text AS "unreceivedCny"
+    FROM sales_contract_totals
+    GROUP BY sales_contract_totals."customerId"`;
+        const rows = await this.dataSource.query(sql, parameters);
+        for (const row of rows)
+            if (row?.customerId)
+                map.set(row.customerId, new Decimal(row.unreceivedCny ?? 0).toFixed(2));
+        return map;
+    }
+    async saveCustomerCreditLimit(scope, customerId, limit) {
+        const normalizedLimit = normalizeOptionalDecimalInput(limit);
+        if (normalizedLimit != null && new Decimal(normalizedLimit).isNegative())
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '客户信用额度不能小于 0');
+        return this.dataSource.transaction(async (manager) => {
+            const repo = manager.getRepository(Customer);
+            const customer = await required(repo.findOne({ where: { ...activeScope(scope), id: customerId, deletedAt: IsNull() }, lock: { mode: 'pessimistic_write' } }), '客户不存在');
+            customer.creditLimit = normalizedLimit;
+            customer.updatedById = scope.userId ?? null;
+            return repo.save(customer);
+        });
     }
     async listSalesOrders(scope, customerId, query = {}) {
         assertOptionalEnum(query.parameters?.paymentStatus, SalesPaymentStatuses, '收款状态');
@@ -2954,6 +3016,48 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         const filtered = order.lines.filter(line => fuzzyValue(line.productName, parameters.productName) && fuzzyValue(line.productDescription, parameters.productDescription) && fuzzyValue(line.hsCode, parameters.hsCode) && (!hasQueryValue(parameters.complianceCategory) || line.complianceCategories.includes(parameters.complianceCategory)));
         return { ...pageRows(filtered, query), order };
     }
+    async saveSalesLineOrder(scope, customerContractId, input) {
+        const order = (await this.listDerivedSalesOrders(scope, undefined, [{ customerContractId, purchaseOrderId: '' }])).find(item => item.customerContractId === customerContractId);
+        if (!order)
+            throw new DomainError(DomainErrorCodes.NOT_FOUND, '销售订单不存在');
+        const currentIds = new Set(order.lines.map(line => line.purchaseOrderLineId));
+        const isCompleteList = (value) => Array.isArray(value) && value.length === currentIds.size && new Set(value).size === value.length && value.every(id => typeof id === 'string' && currentIds.has(id));
+        if (!isCompleteList(input.expectedLineIds))
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '商品明细已变化，请关闭排序窗口并刷新后重试');
+        if (input.lineIds !== null && !isCompleteList(input.lineIds))
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '排序必须包含当前订单的全部商品且不能重复');
+        if (typeof input.expectedVersion !== 'number' || !Number.isSafeInteger(input.expectedVersion) || input.expectedVersion < 0 || input.expectedVersion !== order.salesLineOrderVersion)
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '商品顺序已变化，请关闭排序窗口并刷新后重试');
+        const version = input.expectedVersion + 1;
+        // Recheck membership in the same statement as the version CAS: a source edit
+        // committed after derivation must not silently save an obsolete list.
+        const result = await this.dataSource.getRepository(CustomerContract).createQueryBuilder()
+            .update(CustomerContract)
+            .set({ salesLineOrder: input.lineIds, salesLineOrderVersion: version, updatedById: scope.userId ?? null })
+            .where({ ...activeScope(scope), id: customerContractId, deletedAt: IsNull(), salesLineOrderVersion: input.expectedVersion })
+            .andWhere(`ARRAY(
+        SELECT membership_line.id::text
+        FROM plugin_trade_compliance_purchase_order_line membership_line
+        INNER JOIN plugin_trade_compliance_purchase_order membership_purchase
+          ON membership_purchase.id = membership_line."purchaseOrderId"
+          AND membership_purchase."tenantId" = membership_line."tenantId"
+          AND membership_purchase."organizationId" = membership_line."organizationId"
+          AND membership_purchase."deletedAt" IS NULL
+        WHERE membership_line."tenantId" = :membershipTenantId
+          AND membership_line."organizationId" = :membershipOrganizationId
+          AND membership_line."deletedAt" IS NULL
+          AND ${derivedSalesContractLinkSql('plugin_trade_compliance_customer_contract', 'membership_purchase')}
+        ORDER BY membership_line.id::text
+      ) = CAST(:expectedSalesLineIds AS text[])`, {
+            membershipTenantId: scope.tenantId,
+            membershipOrganizationId: scope.organizationId,
+            expectedSalesLineIds: [...input.expectedLineIds].sort()
+        })
+            .execute();
+        if (result.affected !== 1)
+            throw new DomainError(DomainErrorCodes.INVALID_INPUT, '商品明细或顺序已变化，请关闭排序窗口并刷新后重试');
+        return { customerContractId, salesLineOrderVersion: version };
+    }
     async listSalesFileOrders(scope, query = {}) {
         const page = await this.selectDerivedSalesOrderIdentities(scope, undefined, query, true);
         return { ...page, items: await this.salesOrderDtos(scope, await this.listDerivedSalesOrders(scope, undefined, page.items)) };
@@ -3496,6 +3600,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
                 const derivedLines = (linesByPurchase.get(purchase.id) ?? []).map(line => {
                     const pricing = deriveSalesPricingLine(line, lineOverrides[line.id], effectiveRate);
                     return {
+                        supplierId: purchase.supplierId, purchaseContractNo: purchase.contractNo, sourceLineNumber: line.lineNumber,
                         purchaseOrderLineId: line.id, productName: line.productName, englishName: line.englishName, productDescription: line.productDescription,
                         modelSpecification: line.modelSpecification, unit: line.unit, quantity: line.quantity, hsCode: line.hsCode,
                         vatRate: line.vatRate, refundRate: line.refundRate, originCountry: line.originCountry, domesticSourceLocation: line.domesticSourceLocation,
@@ -3543,6 +3648,9 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             const contract = contractById.get(order.customerContractId);
             if (!contract)
                 continue;
+            order.lines = resolveSalesLineOrder(order.lines, contract.salesLineOrder);
+            order.salesLineOrderVersion = contract.salesLineOrderVersion ?? 0;
+            order.salesLineOrderCustomized = Array.isArray(contract.salesLineOrder);
             const baseCode = parseCustomerContractNo(contract.contractNo).baseCode;
             const groupPurchases = (purchasesByBaseCode.get(baseCode) ?? []).filter(purchase => order.purchaseOrderIds?.includes(purchase.id));
             // 销售单日期 = 客户合同与采购合同关联上、派生销售订单得以生成的日期
@@ -4384,12 +4492,13 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             return { ...supplier, ...productRisks.get(supplier.id), sanctionMatchCount, sanctionStatus: supplier.complianceCheckedAt == null ? 'UNCHECKED' : sanctionMatchCount ? 'HIT' : 'CLEAR' };
         });
     }
-    async salesCustomerDtos(scope, customers, includeRelatedProductRisks = true) {
+    async salesCustomerDtos(scope, customers, includeRelatedProductRisks = true, includeCredit = false) {
         const ids = customers.map(item => item.id);
-        const [matches, contracts, purchases] = await Promise.all([
+        const [matches, contracts, purchases, unreceivedByCustomer] = await Promise.all([
             ids.length ? this.dataSource.getRepository(CompanySanctionMatch).find({ where: { ...activeScope(scope), subjectType: 'CUSTOMER', customerId: In(ids), deletedAt: IsNull() } }) : [],
             includeRelatedProductRisks && ids.length ? this.dataSource.getRepository(CustomerContract).find({ where: { ...activeScope(scope), customerId: In(ids), deletedAt: IsNull() } }) : [],
-            includeRelatedProductRisks && ids.length ? this.dataSource.getRepository(PurchaseOrder).find({ where: { ...activeScope(scope), deletedAt: IsNull() } }) : []
+            includeRelatedProductRisks && ids.length ? this.dataSource.getRepository(PurchaseOrder).find({ where: { ...activeScope(scope), deletedAt: IsNull() } }) : [],
+            includeCredit && ids.length ? this.customerUnreceivedAmounts(scope, ids) : Promise.resolve(new Map())
         ]);
         const purchaseIdsByCustomer = new Map(customers.map(customer => {
             const contractBaseCodes = new Set(contracts.filter(contract => contract.customerId === customer.id).map(contract => parseCustomerContractNo(contract.contractNo).baseCode));
@@ -4398,7 +4507,8 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
         const productRisks = includeRelatedProductRisks ? await this.relatedProductRisks(scope, purchaseIdsByCustomer) : new Map();
         return customers.map(customer => {
             const sanctionMatchCount = matches.filter(match => match.customerId === customer.id).length;
-            return { ...customer, ...productRisks.get(customer.id), profitRateStatus: customer.pricingProfitRateStatus, sanctionMatchCount, sanctionStatus: customer.complianceCheckStatus === 'UNCHECKED' ? 'UNCHECKED' : sanctionMatchCount ? 'HIT' : 'CLEAR' };
+            const creditFields = includeCredit ? customerCreditFields(customer, unreceivedByCustomer.get(customer.id) ?? '0.00') : {};
+            return { ...customer, ...productRisks.get(customer.id), ...creditFields, profitRateStatus: customer.pricingProfitRateStatus, sanctionMatchCount, sanctionStatus: customer.complianceCheckStatus === 'UNCHECKED' ? 'UNCHECKED' : sanctionMatchCount ? 'HIT' : 'CLEAR' };
         });
     }
     async relatedProductRisks(scope, purchaseIdsByParty) {
@@ -4435,7 +4545,7 @@ let TradeComplianceWorkbenchService = class TradeComplianceWorkbenchService {
             const paymentStatus = received.lte(0) ? 'UNPAID' : received.gte(total) ? 'PAID' : 'PARTIAL';
             const orderPurchaseIds = order.purchaseOrderIds?.length ? order.purchaseOrderIds : [order.purchaseOrderId];
             const orderSupplierNames = [...new Set(orderPurchaseIds.map(id => supplierNames.get(purchaseSuppliers.get(id) ?? '') ?? '').filter(Boolean))];
-            return { ...order, customerName: customerNames.get(order.customerId) ?? '', supplierName: orderSupplierNames.join('、'), pricingProfitRateStatus: order.pricingStatus === 'UNPRICED' ? 'MISSING' : 'CONFIGURED', paymentStatus, lines: order.lines.map(line => ({ ...line, complianceCategories: [...new Set(line.complianceMatches.map(match => match.catalogType))] })) };
+            return { ...order, customerName: customerNames.get(order.customerId) ?? '', supplierName: orderSupplierNames.join('、'), pricingProfitRateStatus: order.pricingStatus === 'UNPRICED' ? 'MISSING' : 'CONFIGURED', paymentStatus, lines: order.lines.map(line => ({ ...line, supplierName: supplierNames.get(line.supplierId ?? '') ?? '', complianceCategories: [...new Set(line.complianceMatches.map(match => match.catalogType))] })) };
         });
     }
     async purchaseOrderDtos(scope, orders) {
@@ -5081,6 +5191,11 @@ function salesMetrics(rows) {
     };
 }
 function sum(rows, key) { return rows.reduce((value, row) => value.plus(row[key] ?? 0), new Decimal(0)).toFixed(2); }
+// 信用额度（人工维护）为静态值；未收款为运行时派生值，剩余额度 = 额度 - 未收款，可为负（已超额），绝不落库。
+function customerCreditFields(customer, unreceivedAmountCny) {
+    const remainingCreditCny = customer.creditLimit == null ? null : new Decimal(customer.creditLimit).minus(unreceivedAmountCny).toFixed(2);
+    return { creditLimit: customer.creditLimit, unreceivedAmountCny, remainingCreditCny };
+}
 function booleanFilter(value) { return value === true || value === 'true' ? true : value === false || value === 'false' ? false : null; }
 function purchaseEstimatedRefundSql(alias) { return `(SELECT COALESCE(SUM(refund_line."lineAmountTaxIncluded" / (1 + COALESCE(refund_line."vatRate", 0)) * COALESCE(refund_line."refundRate", 0)), 0) FROM plugin_trade_compliance_purchase_order_line refund_line WHERE refund_line."purchaseOrderId" = ${alias}.id AND refund_line."tenantId" = ${alias}."tenantId" AND refund_line."organizationId" = ${alias}."organizationId" AND refund_line."deletedAt" IS NULL)`; }
 function derivedSalesContractLinkSql(contractAlias, purchaseAlias) {