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

package/README.md

@@ -1,36 +1,55 @@
-# Trade Compliance Workbench
+# 外贸合规工作台
 
-Trade Compliance Workbench is a data-xpert app plugin for export compliance workflows:
+`@chenchaolong/plugin-trade-compliance-workbench` 是面向 data-xpert 的组织级外贸合规插件，按照仓库内需求确认、重建设计、数据模型和固定 Excel 模板从零重建。
 
-- Controlled goods file intake and manual controlled goods maintenance.
-- Supplier contract extraction, product enrichment, and controlled goods warning matches.
-- Sales contract extraction and customs workbook generation.
+## 功能范围
 
-The Workbench exposes three pages inside one remote component:
+- 首页风险提示与固定业务流程
+- 管控商品目录、公司制裁目录及文件批次导入
+- 供应商、采购订单、采购商品三级采购合规管理
+- 唯一客户、客户合同七类关键条款及 AI 风险建议
+- 基于客户合同和采购订单编号实时派生销售订单与商品
+- 客户/订单定价利润率、收付款、退税、合规利润率与换汇成本
+- PI、CI、PL、报关单独立生成、历史下载与 Univer 在线审核
+- 采购和销售人民币实时分析
+- 企业、银行、风险提示、利润规则和月度美元汇率设置
 
-- Controlled Goods Management
-- Product Management
-- Customs Document Generation
+销售订单和销售商品不建立持久化副本；采购合同和客户合同重复时阻止入库；业务删除全部使用逻辑删除。
 
-## Build
+## 开发
 
-```sh
-pnpm --filter @chenchaolong/plugin-trade-compliance-workbench build
+```bash
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
 ```
 
-## Test
+插件入口为 `dist/index.js`，插件级别固定为 `organization`。
 
-```sh
-pnpm --filter @chenchaolong/plugin-trade-compliance-workbench test
-```
+## 配置
+
+- `TRADE_COMPLIANCE_DATA_DIR`：上传源文件和生成文件目录
+- `TRADE_COMPLIANCE_MAX_UPLOAD_MB`：上传上限，默认 20
+- `TRADE_COMPLIANCE_HS_BASE_URL`：HS编码网地址，默认 `https://hsbianma.com`
+- `TRADE_COMPLIANCE_HS_TIMEOUT_MS`：海关编码查询超时
+- `TRADE_COMPLIANCE_TRANSLATION_ENDPOINT`：可选 AI 翻译 HTTP 适配器
+- `TRADE_COMPLIANCE_TRANSLATION_API_KEY`：可选翻译服务密钥
 
-## Lifecycle Validation
+翻译适配器接收 `{ "text": "...", "targetLanguage": "English" }`，响应可使用 `translation` 或 `text` 字段。翻译失败时目标动态单元格留空并记录非阻断警告。
 
-From the repository root:
+## 生命周期验证
 
-```sh
-pnpm -C plugin-dev-harness build
-node plugin-dev-harness/dist/index.js \
-  --workspace ./community/apps/trade-compliance-workbench \
+```bash
+pnpm -C /Users/chenchaolong/项目/xpert-plugins/plugin-dev-harness install
+pnpm -C /Users/chenchaolong/项目/xpert-plugins/plugin-dev-harness build
+node /Users/chenchaolong/项目/xpert-plugins/plugin-dev-harness/dist/index.js \
+  --workspace /Users/chenchaolong/项目/trade-compliance-workbench \
   --plugin @chenchaolong/plugin-trade-compliance-workbench
 ```
+
+业务规则以以下文件为准：
+
+- `docs/superpowers/specs/2026-07-22-trade-compliance-workbench-requirements-confirmation.md`
+- `docs/superpowers/specs/2026-07-22-trade-compliance-workbench-redesign.md`
+- `docs/superpowers/specs/2026-07-23-trade-compliance-workbench-data-model-confirmation.md`

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { TradeComplianceWorkbenchPlugin } from './lib/workbench.plugin.js';
 declare const plugin: {
     meta: {
         name: any;
@@ -37,7 +38,6 @@ declare const plugin: {
                 runtime: {
                     middlewareProviders: string[];
                     viewProviders: string[];
-                    templateProviders: string[];
                 };
             };
         };
@@ -54,280 +54,167 @@ declare const plugin: {
     };
     config: {
         schema: import("zod").ZodObject<{
-            enrichment: import("zod").ZodOptional<import("zod").ZodObject<{
-                apiBaseUrl: import("zod").ZodOptional<import("zod").ZodString>;
-                timeoutMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+            storage: import("zod").ZodOptional<import("zod").ZodObject<{
+                dataDirectory: import("zod").ZodOptional<import("zod").ZodString>;
+                maxUploadMb: import("zod").ZodDefault<import("zod").ZodNumber>;
             }, "strip", import("zod").ZodTypeAny, {
-                apiBaseUrl?: string;
-                timeoutMs?: number;
+                maxUploadMb: number;
+                dataDirectory?: string | undefined;
             }, {
-                apiBaseUrl?: string;
-                timeoutMs?: number;
+                dataDirectory?: string | undefined;
+                maxUploadMb?: number | undefined;
             }>>;
-            templateDefaults: import("zod").ZodOptional<import("zod").ZodObject<{
-                sellerEnglishName: import("zod").ZodOptional<import("zod").ZodString>;
-                sellerEnglishAddress: import("zod").ZodOptional<import("zod").ZodString>;
-                phone: import("zod").ZodOptional<import("zod").ZodString>;
-                email: import("zod").ZodOptional<import("zod").ZodString>;
-                bankBeneficiary: import("zod").ZodOptional<import("zod").ZodString>;
-                bankName: import("zod").ZodOptional<import("zod").ZodString>;
-                bankAddress: import("zod").ZodOptional<import("zod").ZodString>;
-                bankAccountNo: import("zod").ZodOptional<import("zod").ZodString>;
-                cnapsCode: import("zod").ZodOptional<import("zod").ZodString>;
-                swiftCode: import("zod").ZodOptional<import("zod").ZodString>;
-                paymentTerm: import("zod").ZodOptional<import("zod").ZodString>;
-                tradeTerm: import("zod").ZodOptional<import("zod").ZodString>;
-                origin: import("zod").ZodOptional<import("zod").ZodString>;
-                destination: import("zod").ZodOptional<import("zod").ZodString>;
-                packageType: import("zod").ZodOptional<import("zod").ZodString>;
-                supervisionMode: import("zod").ZodOptional<import("zod").ZodString>;
-                taxExemptionNature: import("zod").ZodOptional<import("zod").ZodString>;
-                domesticSourceLocation: import("zod").ZodOptional<import("zod").ZodString>;
-                exchangeRate: import("zod").ZodOptional<import("zod").ZodNumber>;
+            hsBianma: import("zod").ZodOptional<import("zod").ZodObject<{
+                baseUrl: import("zod").ZodDefault<import("zod").ZodString>;
+                timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+                cacheMinutes: import("zod").ZodDefault<import("zod").ZodNumber>;
             }, "strip", import("zod").ZodTypeAny, {
-                sellerEnglishName?: string;
-                sellerEnglishAddress?: string;
-                phone?: string;
-                email?: string;
-                bankBeneficiary?: string;
-                bankName?: string;
-                bankAddress?: string;
-                bankAccountNo?: string;
-                cnapsCode?: string;
-                swiftCode?: string;
-                paymentTerm?: string;
-                tradeTerm?: string;
-                origin?: string;
-                destination?: string;
-                packageType?: string;
-                supervisionMode?: string;
-                taxExemptionNature?: string;
-                domesticSourceLocation?: string;
-                exchangeRate?: number;
+                baseUrl: string;
+                timeoutMs: number;
+                cacheMinutes: number;
+            }, {
+                baseUrl?: string | undefined;
+                timeoutMs?: number | undefined;
+                cacheMinutes?: number | undefined;
+            }>>;
+            translation: import("zod").ZodOptional<import("zod").ZodObject<{
+                endpoint: import("zod").ZodOptional<import("zod").ZodString>;
+                apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+                timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+            }, "strip", import("zod").ZodTypeAny, {
+                timeoutMs: number;
+                endpoint?: string | undefined;
+                apiKey?: string | undefined;
             }, {
-                sellerEnglishName?: string;
-                sellerEnglishAddress?: string;
-                phone?: string;
-                email?: string;
-                bankBeneficiary?: string;
-                bankName?: string;
-                bankAddress?: string;
-                bankAccountNo?: string;
-                cnapsCode?: string;
-                swiftCode?: string;
-                paymentTerm?: string;
-                tradeTerm?: string;
-                origin?: string;
-                destination?: string;
-                packageType?: string;
-                supervisionMode?: string;
-                taxExemptionNature?: string;
-                domesticSourceLocation?: string;
-                exchangeRate?: number;
+                timeoutMs?: number | undefined;
+                endpoint?: string | undefined;
+                apiKey?: string | undefined;
             }>>;
         }, "strip", import("zod").ZodTypeAny, {
-            enrichment?: {
-                apiBaseUrl?: string;
-                timeoutMs?: number;
-            };
-            templateDefaults?: {
-                sellerEnglishName?: string;
-                sellerEnglishAddress?: string;
-                phone?: string;
-                email?: string;
-                bankBeneficiary?: string;
-                bankName?: string;
-                bankAddress?: string;
-                bankAccountNo?: string;
-                cnapsCode?: string;
-                swiftCode?: string;
-                paymentTerm?: string;
-                tradeTerm?: string;
-                origin?: string;
-                destination?: string;
-                packageType?: string;
-                supervisionMode?: string;
-                taxExemptionNature?: string;
-                domesticSourceLocation?: string;
-                exchangeRate?: number;
-            };
+            storage?: {
+                maxUploadMb: number;
+                dataDirectory?: string | undefined;
+            } | undefined;
+            hsBianma?: {
+                baseUrl: string;
+                timeoutMs: number;
+                cacheMinutes: number;
+            } | undefined;
+            translation?: {
+                timeoutMs: number;
+                endpoint?: string | undefined;
+                apiKey?: string | undefined;
+            } | undefined;
         }, {
-            enrichment?: {
-                apiBaseUrl?: string;
-                timeoutMs?: number;
-            };
-            templateDefaults?: {
-                sellerEnglishName?: string;
-                sellerEnglishAddress?: string;
-                phone?: string;
-                email?: string;
-                bankBeneficiary?: string;
-                bankName?: string;
-                bankAddress?: string;
-                bankAccountNo?: string;
-                cnapsCode?: string;
-                swiftCode?: string;
-                paymentTerm?: string;
-                tradeTerm?: string;
-                origin?: string;
-                destination?: string;
-                packageType?: string;
-                supervisionMode?: string;
-                taxExemptionNature?: string;
-                domesticSourceLocation?: string;
-                exchangeRate?: number;
-            };
+            storage?: {
+                dataDirectory?: string | undefined;
+                maxUploadMb?: number | undefined;
+            } | undefined;
+            hsBianma?: {
+                baseUrl?: string | undefined;
+                timeoutMs?: number | undefined;
+                cacheMinutes?: number | undefined;
+            } | undefined;
+            translation?: {
+                timeoutMs?: number | undefined;
+                endpoint?: string | undefined;
+                apiKey?: string | undefined;
+            } | undefined;
         }>;
         formSchema: {
             type: string;
             properties: {
-                enrichment: {
+                storage: {
                     type: string;
                     title: {
-                        en_US: any;
-                        zh_Hans: any;
+                        en_US: string;
+                        zh_Hans: string;
                     };
                     properties: {
-                        apiBaseUrl: {
+                        dataDirectory: {
                             type: string;
                             title: {
-                                en_US: any;
-                                zh_Hans: any;
+                                en_US: string;
+                                zh_Hans: string;
                             };
                         };
-                        timeoutMs: {
+                        maxUploadMb: {
                             type: string;
                             title: {
-                                en_US: any;
-                                zh_Hans: any;
+                                en_US: string;
+                                zh_Hans: string;
                             };
                         };
                     };
                 };
-                templateDefaults: {
+                hsBianma: {
                     type: string;
                     title: {
-                        en_US: any;
-                        zh_Hans: any;
+                        en_US: string;
+                        zh_Hans: string;
                     };
                     properties: {
-                        sellerEnglishName: {
-                            type: string;
-                            title: {
-                                en_US: any;
-                                zh_Hans: any;
-                            };
-                        };
-                        sellerEnglishAddress: {
-                            type: string;
-                            title: {
-                                en_US: any;
-                                zh_Hans: any;
-                            };
-                        };
-                        paymentTerm: {
-                            type: string;
-                            title: {
-                                en_US: any;
-                                zh_Hans: any;
-                            };
-                        };
-                        tradeTerm: {
+                        baseUrl: {
                             type: string;
                             title: {
-                                en_US: any;
-                                zh_Hans: any;
+                                en_US: string;
+                                zh_Hans: string;
                             };
                         };
-                        origin: {
+                        timeoutMs: {
                             type: string;
                             title: {
-                                en_US: any;
-                                zh_Hans: any;
+                                en_US: string;
+                                zh_Hans: string;
                             };
                         };
-                        destination: {
+                    };
+                };
+                translation: {
+                    type: string;
+                    title: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    properties: {
+                        endpoint: {
                             type: string;
                             title: {
-                                en_US: any;
-                                zh_Hans: any;
+                                en_US: string;
+                                zh_Hans: string;
                             };
                         };
-                        exchangeRate: {
+                        apiKey: {
                             type: string;
                             title: {
-                                en_US: any;
-                                zh_Hans: any;
+                                en_US: string;
+                                zh_Hans: string;
                             };
+                            secret: boolean;
                         };
                     };
                 };
             };
         };
         defaults: {
-            enrichment: {
-                apiBaseUrl: any;
+            storage?: {
+                maxUploadMb: number;
+                dataDirectory?: string | undefined;
+            } | undefined;
+            hsBianma?: {
+                baseUrl: string;
                 timeoutMs: number;
-            };
-            templateDefaults: {
-                sellerEnglishName: any;
-                sellerEnglishAddress: any;
-                phone: any;
-                email: any;
-                bankBeneficiary: any;
-                bankName: any;
-                bankAddress: any;
-                bankAccountNo: any;
-                cnapsCode: any;
-                swiftCode: any;
-                paymentTerm: any;
-                tradeTerm: any;
-                origin: any;
-                destination: any;
-                packageType: any;
-                supervisionMode: any;
-                taxExemptionNature: any;
-                domesticSourceLocation: any;
-                exchangeRate: number;
-            };
+                cacheMinutes: number;
+            } | undefined;
+            translation?: {
+                timeoutMs: number;
+                endpoint?: string | undefined;
+                apiKey?: string | undefined;
+            } | undefined;
         };
     };
-    templates: {
-        key: string;
-        name: string;
-        title: string;
-        description: string;
-        category: string;
-        type: import("@xpert-ai/contracts").XpertTypeEnum;
-        targetApps: string[];
-        targetAppMeta: {
-            'data-xpert': {
-                types: string[];
-                capabilities: string[];
-                requiredPlugins: string[];
-                defaultConfig: {
-                    assistantKind: string;
-                    businessDomain: string;
-                    managedBy: string;
-                    viewProvider: string;
-                };
-            };
-        };
-        dslContent: string;
-        order: number;
-        default: boolean;
-        startPrompts: string[];
-        releaseNotes: string;
-        xpertName: string;
-        providerKey: string;
-    }[];
     register(ctx: any): {
-        module: {
-            new (): {
-                onPluginBootstrap(): void;
-                onPluginDestroy(): void;
-            };
-        };
+        module: typeof TradeComplianceWorkbenchPlugin;
         global: boolean;
     };
     onStart(ctx: any): Promise<void>;
@@ -337,12 +224,12 @@ export default plugin;
 export * from './lib/constants.js';
 export * from './lib/types.js';
 export * from './lib/entities/index.js';
-export * from './lib/trade-compliance-workbench.plugin.js';
-export * from './lib/trade-compliance-workbench.service.js';
-export * from './lib/trade-compliance-workbench.middleware.js';
-export * from './lib/trade-compliance-workbench-view.provider.js';
-export * from './lib/trade-compliance-workbench.templates.js';
-export * from './lib/trade-compliance.matching.js';
-export * from './lib/trade-compliance.enrichment.js';
-export * from './lib/trade-compliance-workbook.js';
+export * from './lib/domain/normalization.js';
+export * from './lib/domain/contract-number.js';
+export * from './lib/domain/finance.js';
+export * from './lib/workbench.service.js';
+export * from './lib/sales-file.service.js';
+export * from './lib/workbench.middleware.js';
+export * from './lib/workbench-view.provider.js';
+export * from './lib/workbench.plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGX,CAAC;AACF,eAAe,MAAM,CAAC;AACtB,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mDAAmD,CAAC;AAClE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAA;AAK1E,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAcI,GAAG;;;;iBACE,GAAG;gBACJ,GAAG;CACtB,CAAA;AAED,eAAe,MAAM,CAAA;AACrB,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kCAAkC,CAAA;AAChD,cAAc,2BAA2B,CAAA"}