@bit-sun/business-component 4.2.0-alpha.3 → 4.2.0-alpha.30

package/dist/plugin/TableColumnSetting/index.d.ts

@@ -38,14 +38,14 @@ declare class TableColumnSetting extends React.Component<TableColumnSettingProps
     } | {
         title: string;
         dataIndex: string;
-        render: (text: any, record: any) => React.JSX.Element;
+        render: (text: any, record: any) => JSX.Element;
         className?: undefined;
         width?: undefined;
     } | {
         title: string;
         dataIndex: string;
         className: string;
-        render: () => React.JSX.Element;
+        render: () => JSX.Element;
         width?: undefined;
     })[];
     showModal: () => void;
@@ -53,13 +53,13 @@ declare class TableColumnSetting extends React.Component<TableColumnSettingProps
     handleCancel: (e: React.MouseEvent<HTMLElement>) => void;
     handleTableHeadHidden: (title: string) => void;
     onSortEnd: ({ oldIndex, newIndex }: any) => void;
-    DraggableContainer: (props: any) => React.JSX.Element;
-    DraggableBodyRow: ({ className, style, ...restProps }: any) => React.JSX.Element;
+    DraggableContainer: (props: any) => JSX.Element;
+    DraggableBodyRow: ({ className, style, ...restProps }: any) => JSX.Element;
     onChange: (e: any, title: any) => void;
     handleReset: () => void;
     handleResetSetting: () => Promise<unknown>;
     onSearch: (e: any) => void;
     onSearchSort: (e: any) => void;
-    render(): React.JSX.Element;
+    render(): JSX.Element;
 }
 export default TableColumnSetting;

package/dist/utils/TableUtils.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import moment from 'moment';
 type mediaListType = {
     type: number;
@@ -49,24 +48,24 @@ declare const updateGuanDate: (requestParams: any, dateKeyParams?: any) => {
     };
     submit: any;
 };
-declare const textIcon: (type: string | number, text?: string) => React.JSX.Element | undefined;
-declare const handleTextDoubleOrId: (textOne: string | undefined, textTwo: string | undefined) => React.JSX.Element;
-declare const handleTextDouble: (textOne: string | undefined, textTwo: string | undefined) => React.JSX.Element;
-declare const handleTextOverflow: (text: string | undefined, width?: number) => React.JSX.Element;
-declare const handleTextLineFeed: (text: string | undefined, width?: number) => React.JSX.Element;
-declare const handleTextTooltip: (text: any) => React.JSX.Element;
-declare const handleTextBreakSpaces: (text: any) => React.JSX.Element;
-declare const handleStatusBadge: (text: any, color: any) => React.JSX.Element;
-declare const HandleTotalCount: (totalParams: any) => React.JSX.Element;
+declare const textIcon: (type: string | number, text?: string) => JSX.Element | undefined;
+declare const handleTextDoubleOrId: (textOne: string | undefined, textTwo: string | undefined) => JSX.Element;
+declare const handleTextDouble: (textOne: string | undefined, textTwo: string | undefined) => JSX.Element;
+declare const handleTextOverflow: (text: string | undefined, width?: number) => JSX.Element;
+declare const handleTextLineFeed: (text: string | undefined, width?: number) => JSX.Element;
+declare const handleTextTooltip: (text: any) => JSX.Element;
+declare const handleTextBreakSpaces: (text: any) => JSX.Element;
+declare const handleStatusBadge: (text: any, color: any) => JSX.Element;
+declare const HandleTotalCount: (totalParams: any) => JSX.Element;
 declare const handleCommonTimeRender: (text: any, format?: any) => any;
-declare const handleTooltip: (text: any, timeTrue?: boolean) => React.JSX.Element;
-declare const handleTooltipHours: (text: any, timeTrue?: boolean) => React.JSX.Element;
+declare const handleTooltip: (text: any, timeTrue?: boolean) => JSX.Element;
+declare const handleTooltipHours: (text: any, timeTrue?: boolean) => JSX.Element;
 type tableColumnsImageType = {
     width?: number | string;
     height?: number | string;
     [key: string]: any;
 };
-declare const tableColumnsImage: (url?: string, paramsObj?: tableColumnsImageType) => React.JSX.Element;
+declare const tableColumnsImage: (url?: string, paramsObj?: tableColumnsImageType) => JSX.Element;
 interface ColumnsEditInterfave {
     text?: string;
     record?: any;
@@ -82,7 +81,7 @@ interface ColumnsEditInterfave {
     };
     [key: string]: any;
 }
-declare const ColumnsEdit: (props: ColumnsEditInterfave) => React.JSX.Element;
+declare const ColumnsEdit: (props: ColumnsEditInterfave) => JSX.Element;
 type UserColumnsType = {
     name: string;
     department?: string;
@@ -90,13 +89,13 @@ type UserColumnsType = {
     company?: string;
     avatar?: string;
 };
-declare const userColumns: (props: UserColumnsType) => React.JSX.Element;
-declare const userInfoCard: (props: any) => React.JSX.Element;
+declare const userColumns: (props: UserColumnsType) => JSX.Element;
+declare const userInfoCard: (props: any) => JSX.Element;
 declare const getItemDefaultWidth: (item: any) => number;
-declare const sulaTableRenderTooltip: ({ text }: any) => React.JSX.Element;
+declare const sulaTableRenderTooltip: ({ text }: any) => JSX.Element;
 declare const renderNumberText: ({ text }: any) => any;
 declare const renderFixed2: (text: any) => any;
-declare const handleTextWarpCustom: (text: any, style?: {}) => React.JSX.Element;
+declare const handleTextWarpCustom: (text: any, style?: {}) => JSX.Element;
 declare const calculateValidPeriod: (start: any, end: any) => string;
-declare const handleTextWarp: (text: any) => React.JSX.Element;
+declare const handleTextWarp: (text: any) => JSX.Element;
 export { getSkuImg, updateGuanDate, textIcon, handleTextDoubleOrId, handleTextDouble, handleTextOverflow, handleTextLineFeed, handleTextTooltip, handleTextBreakSpaces, handleStatusBadge, HandleTotalCount, handleTooltip, handleCommonTimeRender, handleTooltipHours, tableColumnsImage, ColumnsEdit, userColumns, userInfoCard, getItemDefaultWidth, renderNumberText, sulaTableRenderTooltip, renderFixed2, handleTextWarpCustom, handleTextWarp, calculateValidPeriod };

package/dist/utils/auth.d.ts

@@ -1,3 +1,7 @@
+/**
+ * 根据上游权限编码获取关联的导入导出业务功能编码。
+ */
+export declare const getRelationTemplateCode: (authCode: string) => string;
 export declare const authFunc: (code: string) => any;
 export declare const handleJudgeAuthButtons: (buttonCodeArray: any[]) => true | boolean[];
 export declare const shouldUseAuth: () => boolean;

package/dist/utils/utils.d.ts

@@ -31,3 +31,44 @@ export declare const randomString: (len?: any) => string;
 export declare const createUniqID: (length: any) => string;
 export declare const handleConvertResponse: (items: any, total: number) => object;
 export declare const noEmptyArray: (targetObj: any) => boolean;
+export declare const formContainerAndItemLayout: (type: string, title: any, name: string) => {
+    container: {
+        type: string;
+        props: {
+            title: any;
+            id: number;
+            level: number;
+            name: string;
+            bordered?: undefined;
+            isWhiteCard?: undefined;
+        };
+    };
+    itemLayout: {
+        span: number;
+        labelCol: {
+            span: number;
+        };
+        wrapperCol: {
+            span: number;
+        };
+    };
+} | {
+    container: {
+        type: string;
+        props: {
+            title: any;
+            id: number;
+            level: number;
+            bordered: null;
+            isWhiteCard: boolean;
+            name: string;
+        };
+    };
+    itemLayout: {
+        wrapperCol: {
+            span: number;
+        };
+        span?: undefined;
+        labelCol?: undefined;
+    };
+};

package/docs/error-record.md

@@ -0,0 +1,52 @@
+# 错误记录
+
+## 2026-07-31 导入导出组件抽取
+
+### 复制后直接按应用项目类型环境判断
+
+- 现象：组件库严格构建发现可空 `serviceContext` 和对象展开重复字段错误。
+- 原因：原业务项目的类型检查强度低于组件库，复制完成不等于迁移完成。
+- 修正：把服务上下文改为显式必填参数；把任务默认字段放到服务响应展开之后。
+- 后续规则：跨仓库迁移必须执行目标仓库完整构建，不能只依赖源仓库结果。
+
+### 文档整站构建不可用
+
+- 现象：Dumi 无法解析旧组件中的 `@/` 别名、`umi` 和 `react-dom`。
+- 原因：现有文档工程依赖与别名配置不完整，与本次新增模块无直接关系。
+- 处理：保留失败证据并停止扩大修改范围；组件本体使用 Father 构建验证。
+
+### 业务项目独立类型校验不可用
+
+- 现象：临时消费端文件在业务项目中执行独立 `tsc` 时，大量第三方声明文件出现语法错误。
+- 原因：业务项目内置 TypeScript 版本无法解析当前安装的新版 `@types/node`、`@types/lodash` 等声明语法，错误未进入本次适配代码。
+- 处理：删除临时验证文件，不以该命令作为完成证据；业务项目正式切换应在组件包发布并升级依赖后使用项目原构建链验证。
+
+## 2026-08-01 导入导出入口解析测试
+
+### Jest 未解析源码路径别名
+
+- 现象：入口解析单元测试加载 `@/utils` 和 `@/utils/enumConfig` 失败，业务断言尚未执行。
+- 原因：现有 `umi-test` 配置没有为 Jest 注册 `@/` 路径映射。
+- 修正：本次被测工具链内部改用等价的相对路径引用，不扩大范围修改全局测试配置。
+- 后续规则：新增可独立测试的底层工具时，优先使用相对路径引用同目录或固定层级依赖，避免测试结果依赖构建器专属别名。
+
+### 默认服务测试路径预期不完整
+
+- 现象：默认快速导出服务测试预期缺少 `/import-export` 路径段，实际请求路径与路由工具输出不一致。
+- 原因：测试断言凭接口后缀手写，没有先对照 `buildSdkUrl` 的统一前缀规则。
+- 修正：按路由工具的实际输出更新断言。
+- 后续规则：服务路径测试必须以现有路由构造规则为依据，禁止省略中间路径段。
+
+### Umi peer dependency 缺少本地类型声明
+
+- 现象：导入宿主 `umi.request` 后，Father 构建提示找不到 `umi` 模块及类型声明。
+- 原因：`umi` 仅声明为 peer dependency，本仓库安装环境没有对应运行模块和类型。
+- 修正：保持 `umi` 为宿主依赖，补充最小请求类型声明，并在 Father 中显式标记为 external。
+- 后续规则：组件库直接使用 peer dependency 时，必须同时验证本地类型可解析且构建产物不会打包重复运行时。
+
+### Distribution-front 测试命令不可用
+
+- 现象：执行销售单导入导出目标测试时提示 `umi-test: command not found`。
+- 原因：当前 `distribution-front` 本地依赖环境没有生成 `umi-test` 可执行文件。
+- 处理：不下载或改动依赖，改为执行与目标测试一致的源码静态断言，并确认旧服务适配引用已清零。
+- 后续规则：消费端依赖未完整安装时，不宣称测试套件通过；应明确区分正式测试结果和等价静态验证结果。

package/docs/flow-control-readme.md

@@ -0,0 +1,283 @@
+# 按钮流程控制架构与使用说明（重构版）
+
+## 背景
+为统一“列表页与详情页按钮显隐”的流程控制，新增了一套基于本地数据源的轻量机制，支持按业务类型、单据状态与资源编码进行控制，同时不改变既有权限与显隐表达式的使用方式。
+
+## 架构概览
+- 核心思想：数据先标注、视图只引用，不侵入既有权限与显隐逻辑
+- 统一数据源：`BUSINESS_FLOW_BUTTONS`（本地存储）
+- 列表页：在 `converter` 增强每条记录，生成 `__flowAllowedMap`；权限列在生成最终 `columns` 时对 `visible` 追加流程布尔条件
+- 详情页：提供 `processDetailButtonsVisible(buttons, params)` 对外方法，融合原 `visible` 与流程允许判定后返回按钮数组
+- 保护策略：未传 `tradeType` 或无匹配配置时不执行任何流程控制；只控制 `controlButtons` 范围内按钮
+
+## 核心数据源
+- 本地存储键：`BUSINESS_FLOW_BUTTONS`
+- 结构：
+```json
+[
+  {
+    "tradeType": 180,
+    "controlButtons": ["DRP_Sale_Sales_submit", "DRP_Sale_Sales_examine"],
+    "config": [
+      { "fromStatus": 1,  "buttons": ["DRP_Sale_Sales_submit"] },
+      { "fromStatus": 25, "buttons": ["DRP_Sale_Sales_examine", "DRP_Sale_Sales_back"] }
+    ]
+  }
+]
+```
+- 说明：
+  - `tradeType`：业务类型
+  - `controlButtons`：参与流程控制的按钮编码集合（控制范围）；不在此集合的按钮不受流程控制影响
+  - `config[].fromStatus`：状态值
+  - `config[].buttons`：该状态下允许显示的按钮编码集合
+
+## 控制原则
+- 未传入 `tradeType` 时，不执行任何流程控制逻辑（列表与详情一致）
+- 仅对 `controlButtons` 范围内的按钮做流程控制；其他按钮不改动
+- 顶部按钮：在控制范围内，保留“所有状态允许集合”中的按钮
+- 列权限按钮：在控制范围内，于既有 `visible` 表达式末尾追加 `&& record.__flowAllowedMap['<code>'] == true`
+- 权限不重复判断：流程控制不改动既有权限过滤（仍使用 `authFn` / `shouldUseAuth`）
+
+## 列表页实现
+- 文件：`src/components/Business/BsSulaQueryTable/index.tsx`
+- 行状态读取：
+  - 属性：`statusFieldPath`（可选，支持嵌套路径，如 `saleInfo.tradeStatus`）
+  - 未配置时自动探测：`status`、`orderStatus`、`flowStatus`、`tradeStatus`、`currentStatus`
+- 数据增强（convert）：
+  - 覆盖 `remoteDataSource.converter` 为管道：原 `converter` → 增强阶段
+  - 增强阶段为每条记录生成 `__flowAllowedMap`：`{ [code]: true | undefined }`
+  - 仅在传入 `tradeType` 且存在非空 `controlButtons` 时启用
+- 列权限按钮 `visible` 合并：
+  - 仅在传入 `tradeType` 且存在非空控制范围时，对 `isPermissionColumn: true` 且 `render` 为数组的列追加流程布尔条件
+  - 合并格式：
+    - 原：`#{record.tradeStatus == 25}`
+    - 新：`#{(record.tradeStatus == 25) && (record.__flowAllowedMap['DRP_Sale_Sales_examine'] == true)}`
+
+## 详情页实现
+- 文件：`src/components/Business/DetailPageWrapper/index.tsx`
+- 入口方法（对外）：
+```ts
+processDetailButtonsVisible(buttons: any[], params: any): any[]
+// params: { tradeType: number; fromStatus: number; 以及按钮 visible 表达式使用到的上下文 }
+```
+- 行为：
+  - 求值原 `visible` 表达式为布尔
+  - 仅在传入 `tradeType` 且按钮 `code ∈ controlButtons` 时，叠加“当前 fromStatus 的允许集合”判定
+  - 返回 `visible` 为最终布尔值的按钮数组，直接用于渲染
+
+## 调试日志（列表）
+- 顶部按钮：`[FlowCtrl:top]`、`[FlowCtrl:top-element]`
+- 数据增强：`__flowAllowedMap` 可在表格数据中查看
+- 列合并：最终 `columns` 中的按钮 `visible` 可直接检视字符串是否追加流程条件
+
+## 快速使用示例
+- 设置数据源：
+```js
+localStorage.setItem('BUSINESS_FLOW_BUTTONS', JSON.stringify([
+  {
+    tradeType: 180,
+    controlButtons: ['DRP_Sale_Order_edit'],
+    config: [
+      { fromStatus: 1, buttons: ['DRP_Sale_Order_edit'] },
+      { fromStatus: 25, buttons: [] }
+    ]
+  }
+]));
+```
+- 列表组件传参：
+```tsx
+<BsSulaQueryTable
+  tradeType={180}
+  statusFieldPath="saleInfo.tradeStatus"
+  {...otherProps}
+/>
+```
+- 列权限列按钮（最终 `columns`）：
+  - 原：`visible: '#{record.tradeStatus == 25}'`
+  - 新：内部自动生成为 `#{(record.tradeStatus == 25) && (record.__flowAllowedMap['DRP_Sale_Sales_examine'] == true)}`（仅控制范围内按钮）
+- 详情页使用：
+```ts
+const processed = processDetailButtonsVisible(buttons, { tradeType, fromStatus, viewMode, tradeStatus, detail, orderNo });
+```
+
+## 列表跳转详情（携带查询参数）
+- 示例（销售单）：
+```tsx
+<Button
+  onClick={() => {
+    history.push({
+      pathname: `/sales-management/sales-slip/view/${record.id}/${record.orderNo}`,
+      search: `?fromStatus=${record.saleInfo.tradeStatus}`,
+    });
+  }}
+  type="link"
+>
+  {text}
+</Button>
+```
+- 说明：
+  - 详情页通过查询参数 `fromStatus` 获取当前单据状态；与 `processDetailButtonsVisible` 的 `fromStatus` 对齐
+  - 列表需设置 `statusFieldPath: 'saleInfo.tradeStatus'` 以生成 `__flowAllowedMap`
+  - 建议所有“查看详情”链接统一携带 `fromStatus`，保持列表与详情流程控制的一致性
+
+### 详情页读取 fromStatus 并使用
+```ts
+import { useLocation } from 'umi';
+
+const { search } = useLocation();
+const qs = new URLSearchParams(search);
+const fromStatus = Number(qs.get('fromStatus') || '');
+
+// 与按钮可见性处理对齐
+const processed = processDetailButtonsVisible(buttons, {
+  tradeType: 180,
+  fromStatus,
+  // 其他上下文
+});
+
+// 传入 DetailPageWrapper（如需）
+<DetailPageWrapper
+  actionList={processed}
+  tradeType={180}
+  fromStatus={fromStatus}
+/>;
+```
+
+## 详情页示例（重构）
+两部分：下部按钮数组 + 顶部 DetailPageWrapper 按钮。
+
+1) 下部按钮数组（以部分按钮为例）：
+```ts
+actionsRender: processDetailButtonsVisible([
+  {
+    type: 'button',
+    props: { type: 'primary', children: '提交' },
+    code: 'DRP_Sale_Sales_submit',
+    visible: viewMode && tradeStatus == 1,
+    confirm: '是否提交该销售单？',
+    action: [ (ctx) => { /* 提交逻辑 */ } ],
+  },
+  {
+    type: 'button',
+    props: { type: 'primary', children: '驳回' },
+    code: 'DRP_Sale_Sales_back',
+    visible: viewMode && tradeStatus == 25,
+    confirm: '确认驳回 ？',
+    action: [ { url: `/drp-ops/new/tradeSubOrder/trigger?code=${orderNo}&event=7`, method: 'POST', converter: () => { message.success('驳回成功'); refreshForm(); } } ],
+  },
+  {
+    type: 'button',
+    props: { type: 'primary', children: '审核' },
+    code: 'DRP_Sale_Sales_examine',
+    visible: viewMode && tradeStatus == 25,
+    action: [ (ctx) => onAuditing(detail) ],
+  },
+  // ... 其他按钮
+], {
+  tradeType: 180,
+  fromStatus: tradeStatus,
+  viewMode,
+  tradeStatus,
+  detail,
+  orderNo,
+  modeType,
+  isProcessing,
+  hasDeletedOnce,
+})
+```
+
+2) 顶部 DetailPageWrapper 按钮：
+```tsx
+<DetailPageWrapper
+  title="详情页演示"
+  actionList={processDetailButtonsVisible(topButtons, { tradeType, fromStatus: tradeStatus, viewMode, tradeStatus })}
+  tradeType={180}
+  fromStatus={tradeStatus}
+/>
+```
+
+## 参数说明
+- 列表组件：
+  - `tradeType: number`（必须）
+  - `statusFieldPath: string`（可选，嵌套路径，如 `saleInfo.tradeStatus`）
+- 详情方法 `processDetailButtonsVisible(buttons, params)`：
+  - `params.tradeType: number`（必须）
+  - `params.fromStatus: number`（必须）
+  - 其他上下文：`viewMode`、`tradeStatus`、`detail`、`orderNo`、`modeType`、`isProcessing`、`hasDeletedOnce` 等按需传入
+- visible 格式：
+  - 字符串表达式：`'#{viewMode && tradeStatus == 25}'`
+  - 布尔或未定义：`true/false/undefined`（未定义视为 `true`）
+
+## tradeType 映射
+- 180：销售单
+- 可按业务扩展其他类型（在 `BUSINESS_FLOW_BUTTONS` 中新增对应项）
+
+## 初始化数据结构示例
+```js
+const flowConfig = [
+  {
+    tradeType: 180,
+    controlButtons: ['DRP_Sale_Order_edit'],
+    config: [
+      { fromStatus: 1, buttons: ['DRP_Sale_Order_edit'] },
+      { fromStatus: 25, buttons: [] },
+    ],
+  },
+];
+localStorage.setItem('BUSINESS_FLOW_BUTTONS', JSON.stringify(flowConfig));
+```
+
+### 详情页示例（重构）
+两部分：下部按钮数组 + 顶部 DetailPageWrapper 按钮。
+
+1) 下部按钮数组（以提交/驳回为例）：
+```ts
+actionsRender: processDetailButtonsVisible([
+  {
+    type: 'button',
+    props: { type: 'primary', children: '提交' },
+    code: 'DRP_Sale_Sales_submit',
+    visible: viewMode && tradeStatus == 1,
+    confirm: '是否提交该销售单？',
+    action: [ (ctx) => { /* 业务处理 */ } ],
+  },
+  {
+    type: 'button',
+    props: { type: 'primary', children: '驳回' },
+    code: 'DRP_Sale_Sales_back',
+    visible: viewMode && tradeStatus == 25,
+    confirm: '确认驳回 ？',
+    action: [ { url: `/drp-ops/new/tradeSubOrder/trigger?code=${orderNo}&event=7`, method: 'POST', converter: () => { message.success('驳回成功'); refreshForm(); } } ],
+  },
+  // ... 其他按钮
+], {
+  tradeType: 180,
+  fromStatus: tradeStatus,
+  viewMode,
+  tradeStatus,
+  detail,
+  orderNo,
+  modeType,
+  isProcessing,
+  hasDeletedOnce,
+})
+```
+
+2) 顶部 DetailPageWrapper 按钮（保持原传参方式）：
+```tsx
+<DetailPageWrapper
+  title="详情页演示"
+  actionList={processDetailButtonsVisible(topButtons, { tradeType, fromStatus: tradeStatus, viewMode, tradeStatus })}
+  tradeType={180}
+  fromStatus={tradeStatus}
+/>
+```
+
+## 常见问题
+- 按钮未展示且不在控制范围：流程控制不会影响非控制按钮，请确认是否是权限或原 `visible` 条件拦截
+- 顶部按钮未展示：仅在控制范围内按“所有状态允许集合”过滤；不在控制范围的顶栏按钮不受影响
+- 未传 `tradeType`：不会执行任何流程控制（顶栏/列表/详情均一致）
+
+## 变更范围
+- 列表：`BsSulaQueryTable/index.tsx`（convert增强、columns合并、顶部过滤与保护）
+- 详情：`DetailPageWrapper/index.tsx`（流程过滤保护）与 `processDetailButtonsVisible` 方法导出

package/docs/task-records/2026-07-31-import-export-extraction.md

@@ -0,0 +1,81 @@
+# 导入导出组件抽取记录
+
+日期：2026-07-31
+
+## 完成标准
+
+- 完整导入、快速导出、按模板导出、任务进度和最近任务进入 `business-component`。
+- 组件库不依赖业务项目的 `@/utils`、Umi 请求实例或微前端路由实现。
+- 业务项目可以注入自己的请求函数、查询条件、权限开关和任务中心跳转。
+- 组件库 CJS、ESM 构建通过。
+
+## 抽取结果
+
+- 新增业务组件：`src/components/Business/ImportExport`。
+- 新增公开入口：`ImportExportActions`。
+- 新增请求适配工厂：`createImportExportServices(request, overrides)`。
+- 新增高级组件导出：`ImportWizard`、`ExportButton`、`TaskProgress`、`TaskDrawer`。
+- 新增类型、路由安全校验、任务归一化和场景能力工具。
+- 新增 Dumi 使用文档和业务项目接入示例。
+- 样式改为 CSS Modules，避免业务页面样式污染。
+
+## 依赖边界
+
+- 组件库负责：界面、弹窗、上传与校验流程、导出流程、任务轮询、最近任务。
+- 业务项目负责：按钮权限、业务功能编码、当前列表条件、结果数量、请求拦截器、微前端跳转。
+- 接口差异通过服务覆盖处理，不在组件内部增加项目名称判断。
+
+## 验证结果
+
+- `npm run build`：CJS 和 ESM 构建通过。
+- 生成的声明文件包含 `ImportExportActions` 和 `createImportExportServices`。
+- 组件源码和声明文件未残留业务项目路径、`@/utils` 或 `jumpRoutePath` 依赖。
+
+## 发布与业务项目切换
+
+当前组件库版本为 `4.2.0-alpha.25`，本次未修改版本号、未发布包，也未写入不可复现的本地绝对路径依赖。销售单源码已按发布包模式切换为从 `@bit-sun/business-component` 引用，并通过 `src/services/importExport.ts` 注入业务请求实例；业务项目当前安装的 `4.2.0-alpha.26` 尚不包含新导出，需要先手动替换本地产物或升级正式发布版本。
+
+发布新版本后，业务项目只需：
+
+1. 升级 `@bit-sun/business-component`。
+2. 用业务项目已有的 `request` 创建请求适配器并传给 `createImportExportServices`。
+3. 从组件库导入 `ImportExportActions`，传入权限开关、查询条件和跳转回调。
+4. 验证完成后删除业务项目原有的 `src/components/ImportExport` 副本。
+
+## 受限项
+
+`npm run docs:build` 被仓库原有文档工程问题阻断：旧组件存在 `@/` 别名、`umi`、`react-dom` 等解析失败。本次组件库产物构建不受影响；未扩大范围修改旧文档工程。
+
+## 2026-08-01 任务中心路由修正
+
+- 完成标准：上游未传 `taskCenterPath` 时，任务进度和最近任务入口都使用组件默认路由；上游显式传入时，两处同时使用传入值。
+- 根因：`ImportExportActions` 已声明顶层默认值，但子组件仍读取 `config.taskCenterPath`，导致默认值被绕过。
+- 修正：以 `ImportExportActionsProps.taskCenterPath` 为唯一来源，统一传给 `TaskProgress` 和 `TaskDrawer`，并移除 `ImportExportConfig` 中的重复字段。
+- 验证：`npm run build` 执行成功，CJS 和 ESM 构建均通过。
+
+## 2026-08-01 导入导出业务入口拆分
+
+- 完成标准：导入通过 `importCode` 获取独立业务功能编码；快速导出和模板导出通过两个权限编码关联结果的“或”值共用一个导出业务功能编码。
+- 数据来源：从权限菜单按钮的 `relationExcelTemplateCode` 读取业务功能编码，不再要求上游通过 `config.businessFunctionCode` 重复传入。
+- 调用链：入口解析后同时用于业务功能服务解析、模板查询、导入导出任务创建和最近任务查询。
+- 单元测试：入口解析测试 3 项通过，覆盖导入独立入口、快速导出入口存在、仅模板导出入口存在。
+- 构建验证：`npm run build` 执行成功，CJS 和 ESM 构建均通过。
+
+## 2026-08-01 默认请求服务内置
+
+- 完成标准：Umi 消费项目不传 `services` 也能使用完整导入导出服务，同时允许通过可选属性覆盖个别差异接口。
+- 修正：组件库使用宿主 `umi.request` 创建默认服务；`services` 改为可选的 `Partial<ImportExportServices>`，并保留请求工厂作为扩展入口。
+- 构建边界：`umi` 保持 peer dependency 并显式 external，组件包不打包重复 Umi 运行时。
+- 消费端：销售单移除 `importExportServices` import、`services` 属性和无业务逻辑的服务适配文件。
+- 单元测试：默认服务与局部覆盖测试 2 项、业务入口解析测试 3 项，共 5 项通过。
+- 构建验证：`npm run build` 执行成功，CJS 和 ESM 构建均通过；声明文件中 `services` 为可选属性。
+- 消费端验证：销售单等价源码静态断言通过；正式目标测试因本地缺少 `umi-test` 命令未执行。
+- 后续处理：按用户要求删除本次新增的两个组件库测试文件，保留上述已执行结果作为历史验证记录。
+
+## 2026-08-03 任务中心默认跳转
+
+- 完成标准：上游未传 `onNavigateTaskCenter` 时，任务抽屉和任务进度中的任务中心入口仍可执行默认跳转；显式传入时继续优先使用上游回调。
+- 默认行为：无界子应用调用主应用注入的 `jump` 并保留任务中心页签，独立运行时打开主应用对应的 Hash 路由。
+- 兼容边界：`onNavigateTaskCenter` 保持可选并作为覆盖点，`taskCenterPath` 继续支持上游修改目标路径。
+- 文档：业务项目接入示例不再要求重复传入 `jumpRoutePath`，API 表补充内置默认值和覆盖说明。
+- 验证：`git diff --check` 通过；`npm run build` 执行成功，CJS 和 ESM 构建均通过。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bit-sun/business-component",
-  "version": "4.2.0-alpha.3",
+  "version": "4.2.0-alpha.30",
   "scripts": {
     "start": "dumi dev",
     "docs:build": "dumi build",

package/src/components/Business/AddSelectBusiness/index.tsx

@@ -433,7 +433,7 @@ export const AddSkuSelect = (parProps: any) => {
         'ctl-withAuth': true
       },
       resType: 'list',
-      resPosition: isNoUseItemBarcode ? 3 : 4,
+      resPosition: isNoUseItemBarcode ? 4 : 5,
       resKeyValue: ['id','name']
     },
     {
@@ -443,7 +443,7 @@ export const AddSkuSelect = (parProps: any) => {
         currentPage: 1,
       },
       resType: 'treeList',
-      resPosition: isNoUseItemBarcode ? 4 : 5
+      resPosition: isNoUseItemBarcode ? 5 : 6
     },
   ]
   const mTpPromiseLoadList = handleFormSearchSourceLoad(initialPromiseLoadList, parProps);
@@ -486,6 +486,7 @@ export const AddSkuSelect = (parProps: any) => {
     tableColumns: mTpTableColumn,
     selectColumn: mTpSelectColumn,
     promiseLoadList: mTpPromiseLoadList,
+    topTablePagination: parProps?.pagination || {},
   }
 
   return (