@chenchaolong/plugin-trade-compliance-workbench 1.0.0 → 1.0.2

package/dist/lib/workbench.service.d.ts

@@ -1,6 +1,12 @@
-import { DataSource } from 'typeorm';
-import { BankAccountSettings, CompanySettings, ControlledCatalogBatch, ControlledGoodsRecord, Customer, CustomerContract, CustomerContractAnalysisRun, CustomerContractClause, CustomerContractClauseAnalysis, DerivedSalesOrderManualData, GeneratedSalesFile, ImportTask, MonthlySafeExchangeRate, ProfitRuleSettings, PurchaseOrder, PurchaseOrderLine, RiskNoticeSettings, SanctionCatalogBatch, SanctionedCompanyRecord, Supplier } from './entities/index.js';
-import type { CatalogType, ClauseType, DerivedSalesOrder, PageQuery, RequestScope } from './types.js';
+import { DataSource, EntityManager, type ObjectLiteral } from 'typeorm';
+import ExcelJS from 'exceljs';
+import { type WriteStream } from 'node:fs';
+import { BankAccountSettings, CompanySettings, ControlledCatalogBatch, ControlledGoodsRecord, Customer, CustomerContract, CustomerContractAnalysisRun, CustomerContractClause, CustomerContractClauseAnalysis, DerivedSalesOrderManualData, GeneratedSalesFile, ImportTask, ManagedAsset, MonthlySafeExchangeRate, ProfitRuleSettings, PurchaseOrder, PurchaseOrderLine, RiskNoticeSettings, SanctionCatalogBatch, SanctionedCompanyRecord, Supplier } from './entities/index.js';
+import type { AnalyticsDetailRow, AnalyticsQuery, CatalogType, ClauseType, DeleteMonthlyRateInput, DerivedSalesOrder, ImportExecutionCommand, PageQuery, RequestScope, RestoreSettingsInput, SettingsType } from './types.js';
+import { DEFAULT_RISK_NOTICE } from './domain/risk-notice.js';
+import { TradeComplianceFileStorage } from './adapters/file-storage.js';
+export { DEFAULT_RISK_NOTICE };
+export declare function writeWorkbookFile(filePath: string, populate: (workbook: ExcelJS.stream.xlsx.WorkbookWriter) => Promise<void>, openOutput?: (path: string) => WriteStream): Promise<void>;
 export interface CatalogImportRow {
     productName?: string;
     hsCode?: string;
@@ -21,14 +27,22 @@ export interface PurchaseDraft {
     order: Partial<PurchaseOrder> & {
         contractNo: string;
         contractAmountCny: string;
+        amountMismatch?: boolean;
+        amountMismatchConfirmed?: boolean;
     };
     lines: Array<Partial<PurchaseOrderLine> & {
         productName: string;
         quantity: string;
         unitPriceTaxIncluded: string;
         lineAmountTaxIncluded: string;
+        amountMismatch?: boolean;
+        amountMismatchConfirmed?: boolean;
     }>;
 }
+type DerivedSalesOrderIdentity = {
+    customerContractId: string;
+    purchaseOrderId: string;
+};
 export interface CustomerContractDraft {
     customer: Partial<Customer> & {
         name: string;
@@ -38,9 +52,9 @@ export interface CustomerContractDraft {
     };
     clauses: Array<{
         clauseType: ClauseType;
-        extractionStatus?: 'FOUND' | 'NOT_FOUND';
+        extractionStatus: 'FOUND' | 'NOT_FOUND';
         sourceText?: string;
-        reviewedText?: string;
+        reviewedText?: string | null;
         sourceLocation?: string;
         sourceContent?: string;
     }>;
@@ -51,15 +65,33 @@ export interface CustomerContractDraft {
         suggestionZh: string;
     }>;
 }
+export interface CustomerContractReviewUpdate {
+    customer?: Partial<Customer>;
+    contract?: Partial<Pick<CustomerContract, 'contractNo' | 'contractAmountReviewCny' | 'signedAt'>>;
+    clauses?: Array<Pick<CustomerContractClause, 'id' | 'clauseType' | 'reviewedText' | 'extractionStatus'>>;
+    customerTransferConfirmation?: {
+        type: 'CONFIRMED_CUSTOMER_TRANSFER';
+        targetNormalizedName: string;
+    };
+}
+export interface CustomerContractReanalysisItem {
+    clauseType: ClauseType;
+    riskLevel: 'LOW' | 'MEDIUM' | 'HIGH';
+    riskMessageZh: string;
+    suggestionZh: string;
+}
 export declare class TradeComplianceWorkbenchService {
     private readonly dataSource;
-    constructor(dataSource: DataSource);
+    private readonly storage?;
+    constructor(dataSource: DataSource, storage?: TradeComplianceFileStorage | undefined);
     bootstrapSettings(scope: RequestScope): Promise<{
         risk: RiskNoticeSettings;
         profit: ProfitRuleSettings;
         company: CompanySettings;
         banks: BankAccountSettings[];
     }>;
+    private ensureBuiltinCompanyLogo;
+    private ensureSettingsDefault;
     dashboard(scope: RequestScope): Promise<{
         riskNotice: RiskNoticeSettings;
         controlledRiskCount: number;
@@ -68,7 +100,9 @@ export declare class TradeComplianceWorkbenchService {
         unlinkedCustomerCount: number;
     }>;
     listControlledGoods(scope: RequestScope, query?: PageQuery): Promise<{
-        items: ControlledGoodsRecord[];
+        items: (ControlledGoodsRecord & {
+            sourceFileName: string | undefined;
+        })[];
         total: number;
         page: number;
         pageSize: number;
@@ -105,7 +139,37 @@ export declare class TradeComplianceWorkbenchService {
         rows: CatalogImportRow[];
     }): Promise<ControlledCatalogBatch>;
     listSanctionedCompanies(scope: RequestScope, query?: PageQuery): Promise<{
-        items: SanctionedCompanyRecord[];
+        items: (SanctionedCompanyRecord & {
+            sourceFileName: string | undefined;
+        })[];
+        total: number;
+        page: number;
+        pageSize: number;
+    }>;
+    getImportTaskResult(scope: RequestScope, taskId: string): Promise<{
+        commands: ImportExecutionCommand[];
+        polling: {
+            intervalMs: number;
+            timeoutMs: number;
+        };
+        task: ImportTask;
+    } | {
+        commands: ImportExecutionCommand[];
+        polling: {
+            intervalMs: number;
+            timeoutMs: number;
+        };
+        task: ImportTask;
+        batch: SanctionCatalogBatch | undefined;
+    }>;
+    listImportIssues(scope: RequestScope, query: {
+        documentType: 'CONTROLLED_CATALOG' | 'SANCTION_CATALOG';
+        batchId: string;
+        issueType: 'DUPLICATE' | 'INVALID';
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        items: ObjectLiteral[];
         total: number;
         page: number;
         pageSize: number;
@@ -126,27 +190,209 @@ export declare class TradeComplianceWorkbenchService {
         rows: CatalogImportRow[];
     }): Promise<SanctionCatalogBatch>;
     createImportTask(scope: RequestScope, input: Pick<ImportTask, 'documentType' | 'sourceFileId' | 'sourceFileName' | 'sourceFileFormat'> & Partial<ImportTask>): Promise<ImportTask>;
+    saveImportTaskExecution(scope: RequestScope, id: string, command: ImportExecutionCommand): Promise<ImportTask>;
+    markImportCommandDispatched(scope: RequestScope, id: string): Promise<ImportTask>;
+    markImportTaskFailed(scope: RequestScope, id: string, failure: {
+        errorCode: string;
+        errorMessage: string;
+    }): Promise<ImportTask>;
+    createRetryImportTask(scope: RequestScope, sourceTaskId: string): Promise<ImportTask>;
     updateImportTaskDraft(scope: RequestScope, id: string, payload: Record<string, unknown>, version?: string): Promise<ImportTask>;
     markImportTaskParsing(scope: RequestScope, id: string): Promise<ImportTask>;
     savePurchaseDraft(scope: RequestScope, importTaskId: string, draft: PurchaseDraft): Promise<PurchaseOrder>;
     listSuppliers(scope: RequestScope, query?: PageQuery): Promise<{
-        items: Supplier[];
+        items: {
+            sanctionMatchCount: number;
+            sanctionStatus: "UNCHECKED" | "CLEAR" | "HIT";
+            code: string | null;
+            name: string;
+            normalizedName: string;
+            shortName: string | null;
+            address: string | null;
+            contactName: string | null;
+            phone: string | null;
+            wechat: string | null;
+            email: string | null;
+            taxNumber: string | null;
+            paymentAccount: string | null;
+            bankName: string | null;
+            taxpayerRating: string | null;
+            website: string | null;
+            businessProducts: string | null;
+            complianceCheckedAt: Date | null;
+            deletedAt: Date | null;
+            deletedById: string | null;
+            deleteOperation: import("./types.js").DeleteOperation | null;
+            createdById: string | null;
+            updatedById: string | null;
+            updatedAt: Date;
+            createdAt: Date;
+            id: string;
+            tenantId: string;
+            organizationId: string;
+        }[];
         total: number;
         page: number;
         pageSize: number;
     }>;
+    getSupplier(scope: RequestScope, id: string): Promise<{
+        sanctionMatchCount: number;
+        sanctionStatus: "UNCHECKED" | "CLEAR" | "HIT";
+        code: string | null;
+        name: string;
+        normalizedName: string;
+        shortName: string | null;
+        address: string | null;
+        contactName: string | null;
+        phone: string | null;
+        wechat: string | null;
+        email: string | null;
+        taxNumber: string | null;
+        paymentAccount: string | null;
+        bankName: string | null;
+        taxpayerRating: string | null;
+        website: string | null;
+        businessProducts: string | null;
+        complianceCheckedAt: Date | null;
+        deletedAt: Date | null;
+        deletedById: string | null;
+        deleteOperation: import("./types.js").DeleteOperation | null;
+        createdById: string | null;
+        updatedById: string | null;
+        updatedAt: Date;
+        createdAt: Date;
+        id: string;
+        tenantId: string;
+        organizationId: string;
+    }>;
     listPurchaseOrders(scope: RequestScope, supplierId?: string, query?: PageQuery): Promise<{
-        items: PurchaseOrder[];
+        items: {
+            lineCount: number;
+            estimatedRefundAmountCny: string;
+            customerContractId: string | null;
+            customerContractNo: string | null;
+            customerContractLinkStatus: "LINKED" | "UNLINKED";
+            supplierId: string;
+            contractNo: string;
+            normalizedContractNo: string;
+            orderDate: string | null;
+            contractAmountCny: string;
+            paidAmountCny: string;
+            refundedAmountCny: string;
+            sourceFileId: string;
+            sourceFileName: string;
+            importTaskId: string;
+            amountMismatchConfirmedAt: Date | null;
+            amountMismatchConfirmedById: string | null;
+            deletedAt: Date | null;
+            deletedById: string | null;
+            deleteOperation: import("./types.js").DeleteOperation | null;
+            createdById: string | null;
+            updatedById: string | null;
+            updatedAt: Date;
+            createdAt: Date;
+            id: string;
+            tenantId: string;
+            organizationId: string;
+        }[];
         total: number;
         page: number;
         pageSize: number;
     }>;
+    getPurchaseOrder(scope: RequestScope, id: string): Promise<{
+        lineCount: number;
+        estimatedRefundAmountCny: string;
+        customerContractId: string | null;
+        customerContractNo: string | null;
+        customerContractLinkStatus: "LINKED" | "UNLINKED";
+        supplierId: string;
+        contractNo: string;
+        normalizedContractNo: string;
+        orderDate: string | null;
+        contractAmountCny: string;
+        paidAmountCny: string;
+        refundedAmountCny: string;
+        sourceFileId: string;
+        sourceFileName: string;
+        importTaskId: string;
+        amountMismatchConfirmedAt: Date | null;
+        amountMismatchConfirmedById: string | null;
+        deletedAt: Date | null;
+        deletedById: string | null;
+        deleteOperation: import("./types.js").DeleteOperation | null;
+        createdById: string | null;
+        updatedById: string | null;
+        updatedAt: Date;
+        createdAt: Date;
+        id: string;
+        tenantId: string;
+        organizationId: string;
+    }>;
     listPurchaseLines(scope: RequestScope, purchaseOrderId?: string, query?: PageQuery): Promise<{
-        items: PurchaseOrderLine[];
+        items: {
+            sourceType: "CONTRACT_EXTRACTED" | "MANUAL_ENTRY";
+            hsCodeStatus: "UNCONFIRMED" | "AI_CONFIRMED" | "MANUALLY_CONFIRMED";
+            complianceCategories: ("DUAL_USE" | "OVERSEAS_SANCTION")[];
+            purchaseOrderId: string;
+            lineNumber: number;
+            productName: string;
+            normalizedProductName: string;
+            englishName: string | null;
+            englishNameSource: import("./types.js").EnglishNameSource | null;
+            productDescription: string | null;
+            modelSpecification: string | null;
+            unit: string | null;
+            quantity: string;
+            unitPriceTaxIncluded: string;
+            lineAmountTaxIncluded: string;
+            vatRate: string | null;
+            vatRateSource: import("./types.js").VatRateSource | null;
+            hsCode: string | null;
+            hsCodeSource: import("./types.js").HsCodeSource | null;
+            hsCodeReferenceSnapshotId: string | null;
+            originCountry: string | null;
+            domesticSourceLocation: string | null;
+            refundRate: string | null;
+            refundRateSource: import("./types.js").RefundRateSource | null;
+            refundPolicyReference: string | null;
+            refundPolicyDate: string | null;
+            refundValidationMethod: import("./types.js").RefundValidationMethod | null;
+            refundConfirmedAt: Date | null;
+            refundConfirmedById: string | null;
+            amountMismatchConfirmedAt: Date | null;
+            amountMismatchConfirmedById: string | null;
+            sourceLocation: string | null;
+            sourceContent: string | null;
+            complianceCheckedAt: Date | null;
+            deletedAt: Date | null;
+            deletedById: string | null;
+            deleteOperation: import("./types.js").DeleteOperation | null;
+            createdById: string | null;
+            updatedById: string | null;
+            updatedAt: Date;
+            createdAt: Date;
+            id: string;
+            tenantId: string;
+            organizationId: string;
+        }[];
         total: number;
         page: number;
         pageSize: number;
     }>;
+    getSupplierProcurementMetrics(scope: RequestScope, supplierId: string, currentYear?: number): Promise<{
+        totalOrderCount: number;
+        totalPurchaseAmountCny: number;
+        currentYearOrderCount: number;
+        currentYearPurchaseAmountCny: number;
+        topProducts: {
+            productName: string;
+            amountCny: number;
+        }[];
+        orderBalances: Record<string, {
+            unpaidAmountCny: number;
+            unrefundedAmountCny: number;
+        }>;
+    }>;
     updateSupplier(scope: RequestScope, id: string, input: Partial<Supplier>): Promise<Supplier>;
     updatePurchaseOrder(scope: RequestScope, id: string, input: Partial<PurchaseOrder>): Promise<PurchaseOrder>;
     updatePurchaseLine(scope: RequestScope, id: string, input: Partial<PurchaseOrderLine>): Promise<PurchaseOrderLine>;
@@ -163,8 +409,273 @@ export declare class TradeComplianceWorkbenchService {
         page: number;
         pageSize: number;
     }>;
+    listSalesCustomers(scope: RequestScope, query?: PageQuery): Promise<{
+        items: {
+            profitRateStatus: "MISSING" | "CONFIGURED";
+            sanctionMatchCount: number;
+            sanctionStatus: "UNCHECKED" | "CLEAR" | "HIT";
+            code: string | null;
+            name: string;
+            normalizedName: string;
+            shortName: string | null;
+            country: string | null;
+            address: string | null;
+            contactName: string | null;
+            phone: string | null;
+            wechat: string | null;
+            email: string | null;
+            taxNumber: string | null;
+            paymentAccount: string | null;
+            bankName: string | null;
+            taxpayerRating: string | null;
+            website: string | null;
+            businessProducts: string | null;
+            defaultPricingProfitRate: string | null;
+            pricingProfitRateStatus: import("./types.js").CustomerProfitRateStatus;
+            complianceCheckStatus: import("./types.js").ComplianceCheckStatus;
+            complianceCheckedAt: Date | null;
+            deletedAt: Date | null;
+            deletedById: string | null;
+            deleteOperation: import("./types.js").DeleteOperation | null;
+            createdById: string | null;
+            updatedById: string | null;
+            updatedAt: Date;
+            createdAt: Date;
+            id: string;
+            tenantId: string;
+            organizationId: string;
+        }[];
+        total: number;
+        page: number;
+        pageSize: number;
+    }>;
+    listSalesOrders(scope: RequestScope, customerId: string, query?: PageQuery): Promise<{
+        items: {
+            customerName: string;
+            supplierName: string;
+            pricingProfitRateStatus: "CONFIGURED";
+            paymentStatus: "UNPAID" | "PARTIAL" | "PAID";
+            lines: {
+                complianceCategories: ("DUAL_USE" | "OVERSEAS_SANCTION")[];
+                purchaseOrderLineId: string;
+                productName: string;
+                englishName?: string | null;
+                productDescription?: string | null;
+                modelSpecification?: string | null;
+                unit?: string | null;
+                quantity: string;
+                hsCode?: string | null;
+                hsCodeStatus: import("./types.js").HsCodeStatus;
+                vatRate?: string | null;
+                refundRate?: string | null;
+                originCountry?: string | null;
+                domesticSourceLocation?: string | null;
+                salesUnitPriceCny: string;
+                salesLineAmountCny: string;
+                complianceMatches: import("./types.js").DerivedSalesComplianceMatch[];
+            }[];
+            customerContractId: string;
+            purchaseOrderId: string;
+            customerId: string;
+            salesOrderNo: string;
+            customerContractNo: string;
+            purchaseContractNo: string;
+            orderDate?: string | null;
+            currencyCode: "CNY";
+            pricingProfitRateSource: import("./types.js").PricingProfitRateSource;
+            effectivePricingProfitRate: string;
+            orderAmountCny: string;
+            receivedAmountCny: string;
+            unreceivedAmountCny: string;
+        }[];
+        customer: {
+            profitRateStatus: "MISSING" | "CONFIGURED";
+            sanctionMatchCount: number;
+            sanctionStatus: "UNCHECKED" | "CLEAR" | "HIT";
+            code: string | null;
+            name: string;
+            normalizedName: string;
+            shortName: string | null;
+            country: string | null;
+            address: string | null;
+            contactName: string | null;
+            phone: string | null;
+            wechat: string | null;
+            email: string | null;
+            taxNumber: string | null;
+            paymentAccount: string | null;
+            bankName: string | null;
+            taxpayerRating: string | null;
+            website: string | null;
+            businessProducts: string | null;
+            defaultPricingProfitRate: string | null;
+            pricingProfitRateStatus: import("./types.js").CustomerProfitRateStatus;
+            complianceCheckStatus: import("./types.js").ComplianceCheckStatus;
+            complianceCheckedAt: Date | null;
+            deletedAt: Date | null;
+            deletedById: string | null;
+            deleteOperation: import("./types.js").DeleteOperation | null;
+            createdById: string | null;
+            updatedById: string | null;
+            updatedAt: Date;
+            createdAt: Date;
+            id: string;
+            tenantId: string;
+            organizationId: string;
+        };
+        metrics: {
+            orderCount: number;
+            salesAmountCny: any;
+            receivedAmountCny: any;
+            unreceivedAmountCny: any;
+            currentYearOrderCount: number;
+            currentYearSalesAmountCny: any;
+            topProducts: {
+                productName: string;
+                amountCny: string;
+            }[];
+        };
+        total: number;
+        page: number;
+        pageSize: number;
+    }>;
+    listSalesLines(scope: RequestScope, query: PageQuery & {
+        customerId: string;
+        customerContractId: string;
+        purchaseOrderId: string;
+    }): Promise<{
+        order: {
+            customerName: string;
+            supplierName: string;
+            pricingProfitRateStatus: "CONFIGURED";
+            paymentStatus: "UNPAID" | "PARTIAL" | "PAID";
+            lines: {
+                complianceCategories: ("DUAL_USE" | "OVERSEAS_SANCTION")[];
+                purchaseOrderLineId: string;
+                productName: string;
+                englishName?: string | null;
+                productDescription?: string | null;
+                modelSpecification?: string | null;
+                unit?: string | null;
+                quantity: string;
+                hsCode?: string | null;
+                hsCodeStatus: import("./types.js").HsCodeStatus;
+                vatRate?: string | null;
+                refundRate?: string | null;
+                originCountry?: string | null;
+                domesticSourceLocation?: string | null;
+                salesUnitPriceCny: string;
+                salesLineAmountCny: string;
+                complianceMatches: import("./types.js").DerivedSalesComplianceMatch[];
+            }[];
+            customerContractId: string;
+            purchaseOrderId: string;
+            customerId: string;
+            salesOrderNo: string;
+            customerContractNo: string;
+            purchaseContractNo: string;
+            orderDate?: string | null;
+            currencyCode: "CNY";
+            pricingProfitRateSource: import("./types.js").PricingProfitRateSource;
+            effectivePricingProfitRate: string;
+            orderAmountCny: string;
+            receivedAmountCny: string;
+            unreceivedAmountCny: string;
+        };
+        items: {
+            complianceCategories: ("DUAL_USE" | "OVERSEAS_SANCTION")[];
+            purchaseOrderLineId: string;
+            productName: string;
+            englishName?: string | null;
+            productDescription?: string | null;
+            modelSpecification?: string | null;
+            unit?: string | null;
+            quantity: string;
+            hsCode?: string | null;
+            hsCodeStatus: import("./types.js").HsCodeStatus;
+            vatRate?: string | null;
+            refundRate?: string | null;
+            originCountry?: string | null;
+            domesticSourceLocation?: string | null;
+            salesUnitPriceCny: string;
+            salesLineAmountCny: string;
+            complianceMatches: import("./types.js").DerivedSalesComplianceMatch[];
+        }[];
+        total: number;
+        page: number;
+        pageSize: number;
+    }>;
+    listSalesFileOrders(scope: RequestScope, query?: PageQuery): Promise<{
+        items: {
+            customerName: string;
+            supplierName: string;
+            pricingProfitRateStatus: "CONFIGURED";
+            paymentStatus: "UNPAID" | "PARTIAL" | "PAID";
+            lines: {
+                complianceCategories: ("DUAL_USE" | "OVERSEAS_SANCTION")[];
+                purchaseOrderLineId: string;
+                productName: string;
+                englishName?: string | null;
+                productDescription?: string | null;
+                modelSpecification?: string | null;
+                unit?: string | null;
+                quantity: string;
+                hsCode?: string | null;
+                hsCodeStatus: import("./types.js").HsCodeStatus;
+                vatRate?: string | null;
+                refundRate?: string | null;
+                originCountry?: string | null;
+                domesticSourceLocation?: string | null;
+                salesUnitPriceCny: string;
+                salesLineAmountCny: string;
+                complianceMatches: import("./types.js").DerivedSalesComplianceMatch[];
+            }[];
+            customerContractId: string;
+            purchaseOrderId: string;
+            customerId: string;
+            salesOrderNo: string;
+            customerContractNo: string;
+            purchaseContractNo: string;
+            orderDate?: string | null;
+            currencyCode: "CNY";
+            pricingProfitRateSource: import("./types.js").PricingProfitRateSource;
+            effectivePricingProfitRate: string;
+            orderAmountCny: string;
+            receivedAmountCny: string;
+            unreceivedAmountCny: string;
+        }[];
+        total: number;
+        page: number;
+        pageSize: number;
+    }>;
     listCustomerContracts(scope: RequestScope, query?: PageQuery): Promise<{
-        items: CustomerContract[];
+        items: {
+            contractAmountReviewCny: string | null;
+            customerName: string;
+            customerCode: string | null;
+            sanctionStatus: string;
+            latestAnalysisAt: Date | null;
+            customerId: string;
+            contractNo: string;
+            normalizedContractNo: string;
+            signedAt: string | null;
+            overallRiskLevel: import("./types.js").RiskLevel | null;
+            latestAnalysisRunId: string | null;
+            currentReanalysisRunId: string | null;
+            sourceFileId: string;
+            sourceFileName: string;
+            importTaskId: string;
+            deletedAt: Date | null;
+            deletedById: string | null;
+            deleteOperation: import("./types.js").DeleteOperation | null;
+            createdById: string | null;
+            updatedById: string | null;
+            updatedAt: Date;
+            createdAt: Date;
+            id: string;
+            tenantId: string;
+            organizationId: string;
+        }[];
         total: number;
         page: number;
         pageSize: number;
@@ -174,24 +685,67 @@ export declare class TradeComplianceWorkbenchService {
         customer: Customer | null;
         clauses: CustomerContractClause[];
         analyses: CustomerContractClauseAnalysis[];
-        latestRun: CustomerContractAnalysisRun;
+        latestRun: CustomerContractAnalysisRun | null;
+        analysisRuns: CustomerContractAnalysisRun[];
+        sanctionStatus: string;
     }>;
-    updateCustomerContractReview(scope: RequestScope, id: string, input: {
-        customer?: Partial<Customer>;
-        contract?: Partial<CustomerContract>;
-        clauses?: Array<Pick<CustomerContractClause, 'id' | 'reviewedText' | 'extractionStatus'>>;
+    startCustomerContractReanalysis(scope: RequestScope, input: {
+        reviewSource: 'IMPORT_DRAFT' | 'EXISTING_CONTRACT';
+        id?: string;
+        importTaskId?: string;
     }): Promise<{
+        run: CustomerContractAnalysisRun;
+        resumed: boolean;
+        reviewSource: "IMPORT_DRAFT" | "EXISTING_CONTRACT";
+        clauses: import("./types.js").CustomerContractReanalysisClauseInput[];
+    }>;
+    saveCustomerContractReanalysisExecution(scope: RequestScope, id: string, command: ImportExecutionCommand): Promise<CustomerContractAnalysisRun>;
+    markCustomerContractReanalysisDispatched(scope: RequestScope, id: string): Promise<CustomerContractAnalysisRun>;
+    markCustomerContractReanalysisFailed(scope: RequestScope, id: string, input: {
+        errorCode: string;
+        errorMessage: string;
+    }): Promise<CustomerContractAnalysisRun>;
+    getCustomerContractReanalysisResult(scope: RequestScope, id: string): Promise<{
+        run: CustomerContractAnalysisRun;
+        review?: undefined;
+        task?: undefined;
+    } | {
+        run: CustomerContractAnalysisRun;
+        review: {
+            contract: CustomerContract;
+            customer: Customer | null;
+            clauses: CustomerContractClause[];
+            analyses: CustomerContractClauseAnalysis[];
+            latestRun: CustomerContractAnalysisRun | null;
+            analysisRuns: CustomerContractAnalysisRun[];
+            sanctionStatus: string;
+        };
+        task?: undefined;
+    } | {
+        run: CustomerContractAnalysisRun;
+        task: ImportTask;
+        review?: undefined;
+    }>;
+    saveCustomerContractReanalysis(scope: RequestScope, analysisRunId: string, analyses: CustomerContractReanalysisItem[]): Promise<CustomerContractAnalysisRun>;
+    getSourceFileDescriptor(scope: RequestScope, sourceFileId: string): Promise<{
+        sourceFileId: string;
+        sourceFileName: string;
+    }>;
+    updateCustomerContractReview(scope: RequestScope, id: string, input: CustomerContractReviewUpdate): Promise<{
         contract: CustomerContract;
         customer: Customer;
     }>;
-    listDerivedSalesOrders(scope: RequestScope, customerId?: string): Promise<DerivedSalesOrder[]>;
+    listDerivedSalesOrders(scope: RequestScope, customerId?: string, selectedIdentities?: DerivedSalesOrderIdentity[]): Promise<DerivedSalesOrder[]>;
+    private derivedSalesIdentityQuery;
+    private selectAllDerivedSalesOrderIdentities;
+    private selectDerivedSalesOrderIdentities;
     saveCustomerProfitRate(scope: RequestScope, customerId: string, rate: string): Promise<Customer>;
     updateCustomer(scope: RequestScope, id: string, input: Partial<Customer>): Promise<Customer>;
     saveDerivedManualData(scope: RequestScope, customerContractId: string, purchaseOrderId: string, input: {
         pricingProfitRateOverride?: string | null;
         receivedAmountCny?: string;
     }): Promise<DerivedSalesOrderManualData>;
-    softDelete(scope: RequestScope, entityType: string, id: string): Promise<import("typeorm").ObjectLiteral>;
+    softDelete(scope: RequestScope, entityType: string, id: string): Promise<PurchaseOrderLine | ObjectLiteral>;
     listGeneratedFiles(scope: RequestScope, query?: PageQuery): Promise<{
         items: GeneratedSalesFile[];
         total: number;
@@ -199,40 +753,60 @@ export declare class TradeComplianceWorkbenchService {
         pageSize: number;
     }>;
     settings(scope: RequestScope): Promise<{
-        risk: RiskNoticeSettings;
+        risk: RiskNoticeSettings | null;
         company: CompanySettings | null;
         banks: BankAccountSettings[];
-        profit: ProfitRuleSettings;
+        profit: ProfitRuleSettings | null;
         rates: MonthlySafeExchangeRate[];
     }>;
-    saveSettings(scope: RequestScope, type: 'risk' | 'company' | 'bank' | 'profit' | 'rate', input: Record<string, unknown>): Promise<any>;
-    analytics(scope: RequestScope, filters?: Record<string, unknown>): Promise<{
-        purchase: {
-            count: number;
-            totalCny: any;
-            paidCny: any;
-            unpaidCny: any;
-            rows: Record<string, any>[];
+    saveSettings(scope: RequestScope, type: SettingsType, input: Record<string, unknown>, expectedRevision: number): Promise<RiskNoticeSettings | CompanySettings | BankAccountSettings | ProfitRuleSettings | MonthlySafeExchangeRate>;
+    restoreSettingsDefault(scope: RequestScope, input: RestoreSettingsInput): Promise<RiskNoticeSettings | CompanySettings | BankAccountSettings | ProfitRuleSettings>;
+    deleteMonthlyRate(scope: RequestScope, input: DeleteMonthlyRateInput): Promise<MonthlySafeExchangeRate>;
+    private persistSettings;
+    private persistCompanySettings;
+    createCompanyLogoDraft(scope: RequestScope, buffer: Buffer, fileName: string): Promise<ManagedAsset>;
+    discardCompanyLogoDraft(scope: RequestScope, assetId: string): Promise<ManagedAsset>;
+    readCompanyLogo(scope: RequestScope, assetId: string): Promise<Buffer<ArrayBufferLike> | undefined>;
+    private persistMonthlyRate;
+    analytics(scope: RequestScope, query: AnalyticsQuery, source?: DataSource | EntityManager): Promise<{
+        mode: "PURCHASE" | "SALES";
+        currentYear: number;
+        dimension: "SUPPLIER" | "CUSTOMER" | "PRODUCT";
+        metrics: {
+            orderTotalCny: string;
+            paidCny: string;
+            unpaidCny: string;
+            refundedCny: string;
+            unrefundedCny: string;
+            receivedCny?: undefined;
+            unreceivedCny?: undefined;
+        } | {
+            orderTotalCny: string;
+            receivedCny: string;
+            unreceivedCny: string;
+            paidCny?: undefined;
+            unpaidCny?: undefined;
+            refundedCny?: undefined;
+            unrefundedCny?: undefined;
         };
-        sales: {
-            count: number;
-            totalCny: any;
-            paidCny: any;
-            unpaidCny: any;
-            rows: Record<string, any>[];
-        };
-        annualPurchaseCount: number;
-        annualSalesCount: number;
-        purchaseTop5: {
-            name: string;
-            amountCny: string;
-        }[];
-        salesTop5: {
-            name: string;
+        top5: {
+            key: string;
+            label: string;
             amountCny: string;
         }[];
-        filters: Record<string, unknown>;
+        details: {
+            items: AnalyticsDetailRow[];
+            page: number;
+            pageSize: number;
+            total: number;
+            pageCount: number;
+        };
+    }>;
+    exportAnalytics(scope: RequestScope, query: AnalyticsQuery): Promise<{
+        fileName: string;
+        buffer: NonSharedBuffer;
     }>;
+    private withAnalyticsSnapshot;
     recalculateProductRisks(scope: RequestScope, reason: 'SOURCE_CHANGED' | 'CATALOG_CHANGED'): Promise<{
         scanned: number;
         matches: number;
@@ -242,11 +816,18 @@ export declare class TradeComplianceWorkbenchService {
         matches: number;
     }>;
     private pagedQuery;
+    private pagedCatalogQuery;
     private upsertSupplier;
+    private supplierDtos;
+    private salesCustomerDtos;
+    private salesOrderDtos;
+    private purchaseOrderDtos;
     private upsertCustomer;
-    private deriveSingleOrder;
-    private assertExistingReceiptsRemainValid;
-    private assertPurchaseOrderReceiptsRemainValid;
+    private lockCustomerName;
+    private lockAndAssertPartyCodeAvailable;
+    private withLockedPurchaseLines;
+    private assertLockedPurchaseReceipts;
+    private deletePurchaseLine;
     private cascadePurchaseOrder;
     private cascadeCustomerContract;
     private expireStaleImportTasks;