From ecf2e4250455217a324e07e771b1a73f309b4c04 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=AE=97=E9=98=B3?= <1627320840@qq.com>
Date: Tue, 21 Oct 2025 05:59:06 +0000
Subject: [PATCH 1/3] update
 src/components/Common/FlowDesign/Config/Nodes/ConditionNode/index.tsx.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: 王宗阳 <1627320840@qq.com>
---
 .../Config/Nodes/ConditionNode/index.tsx      | 126 ++++++++++++++----
 1 file changed, 98 insertions(+), 28 deletions(-)

diff --git a/src/components/Common/FlowDesign/Config/Nodes/ConditionNode/index.tsx b/src/components/Common/FlowDesign/Config/Nodes/ConditionNode/index.tsx
index 0ad67de7c..10e1e7d1c 100644
--- a/src/components/Common/FlowDesign/Config/Nodes/ConditionNode/index.tsx
+++ b/src/components/Common/FlowDesign/Config/Nodes/ConditionNode/index.tsx
@@ -11,6 +11,12 @@ import { AiOutlineDelete } from 'react-icons/ai';
 import { model } from '@/ts/base';
 import orgCtrl from '@/ts/controller';
 
+/** 
+ * 组件的属性接口定义 
+ * @param current 当前节点对象（包含条件等信息）
+ * @param conditions 可供选择的字段条件列表（字段模型数组）
+ * @param refresh 父组件传入的刷新方法，用于更新视图
+ */
 interface Iprops {
   current: WorkNodeDisplayModel;
   conditions: model.FieldModel[];
@@ -18,38 +24,58 @@ interface Iprops {
 }
 
 /**
- * @description: 条件
- * @return {*}
+ * @description 条件节点组件（用于渲染一个可动态添加、编辑、删除的条件组）
+ * @returns React 组件
  */
-
 const ConditionNode: React.FC<Iprops> = (props) => {
+  // 若没有可供选择的条件字段，直接提示
   if (props.conditions.length < 1) return <>请先选择主表且有特性</>;
+
+  /** key用于强制重新渲染Form，当条件列表变化时更新 */
   const [key, setKey] = useState(0);
+
+  /** antd Form 实例 */
   const [form] = Form.useForm();
+
+  /** 当前节点的状态（包含所有条件） */
   const [currentNode, setCurrentNode] = useState<WorkNodeDisplayModel>();
 
+  /** 
+   * 当 props.current 变化时（比如切换节点）
+   * 同步更新 currentNode 和 Form 表单数据 
+   */
   useEffect(() => {
     setCurrentNode(props.current);
     form.setFieldsValue({ allContent: props.current.conditions });
   }, [props]);
 
-  /**点击添加的时候默认增加一行 */
+  /** 
+   * 点击 “添加条件” 按钮时调用
+   * 在当前节点的条件数组中新增一个空条件对象
+   */
   const addConditionGroup = () => {
     props.current?.conditions?.push({
-      pos: props.current?.conditions.length + 1,
-      paramKey: '',
-      paramLabel: '',
-      key: '',
-      label: '',
-      type: dataType.NUMERIC,
-      val: undefined,
-      display: '',
+      pos: props.current?.conditions.length + 1, // 条件位置序号
+      paramKey: '',   // 参数键（字段id）
+      paramLabel: '', // 参数名
+      key: '',        // 条件符号（例如 >、=）
+      label: '',      // 条件文字描述
+      type: dataType.NUMERIC, // 数据类型（默认数值型）
+      val: undefined, // 值
+      display: '',    // 显示文本
     });
+    // 更新key以强制重新渲染
     setKey(key + 1);
   };
 
+  /**
+   * 根据字段类型返回不同的“操作符选择框”（例如 =、>、<、≠ 等）
+   * @param condition 当前条件对象
+   * @param index 条件索引
+   */
   const loadOperateItem = (condition: conditiondType, index: number) => {
     if (condition.type != 'NUMERIC') {
+      // 非数值类型（字符串/枚举等），仅提供“等于/不等于”
       return (
         <Form.Item name={['allContent', index, 'key']}>
           <Select
@@ -65,6 +91,7 @@ const ConditionNode: React.FC<Iprops> = (props) => {
         </Form.Item>
       );
     } else {
+      // 数值类型，提供更多比较运算符
       return (
         <Form.Item name={['allContent', index, 'key']}>
           <Select
@@ -86,9 +113,14 @@ const ConditionNode: React.FC<Iprops> = (props) => {
     }
   };
 
+  /**
+   * 根据字段类型渲染不同的“值输入框”
+   * 比如：字典型显示下拉框，数值型显示数字输入框，其他显示普通文本框
+   */
   const loadValueItem = (condition: conditiondType, index: number) => {
     switch (condition.type) {
       case 'DICT':
+        // 枚举/字典类型
         return (
           <Form.Item name={['allContent', index, 'val']}>
             <Select
@@ -105,6 +137,7 @@ const ConditionNode: React.FC<Iprops> = (props) => {
           </Form.Item>
         );
       case 'NUMERIC':
+        // 数值类型
         return (
           <Form.Item name={['allContent', index, 'val']}>
             <InputNumber
@@ -114,6 +147,7 @@ const ConditionNode: React.FC<Iprops> = (props) => {
           </Form.Item>
         );
       default:
+        // 默认字符串输入
         return (
           <Form.Item name={['allContent', index, 'val']}>
             <Input
@@ -127,64 +161,83 @@ const ConditionNode: React.FC<Iprops> = (props) => {
     }
   };
 
+  /**
+   * 将字段的 valueType（文本类型）转换为统一的数据类型枚举
+   */
   const convertType = (valueType?: string) => {
     switch (valueType) {
       case '分类型':
       case '选择型':
-        return dataType.DICT;
+        return dataType.DICT; // 枚举/字典
       case '日期型':
-        return dataType.DATE;
+        return dataType.DATE; // 日期
       case '用户型':
-        return dataType.BELONG;
+        return dataType.BELONG; // 用户
       case '数值型':
       case '货币型':
-        return dataType.NUMERIC;
+        return dataType.NUMERIC; // 数值
     }
-    return dataType.STRING;
+    return dataType.STRING; // 默认字符串
   };
 
+  /**
+   * 表单值变化时调用（例如选择字段、修改值等）
+   * 作用：同步 form 中的值到 currentNode.conditions
+   */
   const onChange = async () => {
     const currentValue = await form.getFieldsValue();
-    const newArr: string[] = []; // 重置当前条件 不然会越来越多 给不上值
+    const newArr: string[] = []; // 用于记录参数key（防止重复累积）
+
     currentNode?.conditions.map((item: conditiondType, index: number) => {
-      /** 怎么知道paramKey有没有变化 */
+      // 将表单值写回到 condition 对象中
       item.val = String(currentValue.allContent[index].val);
       item.label = currentValue.allContent[index].label;
       item.paramKey = currentValue.allContent[index].paramKey;
       item.paramLabel = currentValue.allContent[index].paramLabel;
-      /**当前数组得替换一下 */
       newArr.push(currentValue.allContent[index].paramKey);
-      // setParamKeyArr(newArr);
+
       item.type = currentValue.allContent[index].type;
-      /**当前条件查找，填写paramLabel */
+
+      // 查找当前选择的字段信息（来自 props.conditions）
       const findCon = props.conditions.find((innItem) => {
         return innItem.id === currentValue.allContent[index].paramKey;
       });
+
+      // 同步字段名称、类型
       item.paramLabel = findCon ? findCon?.name : '';
       item.type = convertType(findCon?.valueType);
       item.key = currentValue.allContent[index].key;
+
       if (findCon) {
-        /** 大于小于条件查找 */
+        // 查找操作符的文字描述
         const conkeys = getConditionKeys(item.type).find(
           (innItem: { value: string; label: string }) => {
             return innItem.value === currentValue.allContent[index].key;
           },
         );
         item.label = conkeys ? conkeys?.label : '';
-        /** 查询符合条件的枚举值 */
+
+        // 若为字典类型，则查找选中项的显示文本
         if (item.type === dataType.DICT) {
           const findConLabel = findCon?.lookups?.find((innItem) => {
             return innItem.value === currentValue.allContent[index].val;
           });
-          /** 枚举值赋值 */
           item.valLabel = findConLabel?.text || '';
         }
       }
+
+      // 拼接完整的显示文本，例如 “年龄 > 18”
       item.display = `${item.paramLabel} ${item.label} ${item.valLabel || item.val} `;
     });
+
+    // 通知父组件刷新
     props.refresh();
   };
 
+  /**
+   * 组件渲染部分
+   * 使用 Card + Form 动态渲染条件列表
+   */
   return (
     <div>
       <Card
@@ -212,10 +265,14 @@ const ConditionNode: React.FC<Iprops> = (props) => {
         }
         className={cls['card-info']}
         bodyStyle={{ padding: '0px', border: 'none' }}
-        extra={<a onClick={addConditionGroup}>+ 添加</a>}>
+        extra={<a onClick={addConditionGroup}>+ 添加</a>} // “添加条件”按钮
+      >
+        {/* 使用Form包裹所有条件输入项 */}
         <Form key={key} form={form} onValuesChange={onChange}>
+          {/* 遍历渲染每一组条件 */}
           {(currentNode?.conditions || []).map((condition, index) => (
             <div key={index + '_g'} className={cls['group']}>
+              {/* 条件组头部（删除按钮 + 序号） */}
               <div className={cls['group-header']}>
                 <div
                   style={{
@@ -224,16 +281,21 @@ const ConditionNode: React.FC<Iprops> = (props) => {
                     cursor: 'pointer',
                   }}
                   onClick={() => {
+                    // 点击删除当前条件
                     currentNode!.conditions.splice(index, 1);
                     setCurrentNode(currentNode);
-                    setKey(key + 1);
-                  }}>
+                    setKey(key + 1); // 触发刷新
+                  }}
+                >
                   <AiOutlineDelete />
                 </div>
                 <span className={cls['group-name']}>参数 {index + 1}</span>
                 <div className={cls['group-operation']}></div>
               </div>
+
+              {/* 条件组内容（参数选择 + 操作符 + 值输入） */}
               <div className={cls['group-content']}>
+                {/* 参数字段选择 */}
                 <Form.Item name={['allContent', index, 'paramKey']}>
                   <Select
                     style={{ width: 130, backgroundColor: '#fff' }}
@@ -244,22 +306,29 @@ const ConditionNode: React.FC<Iprops> = (props) => {
                       return { label: i.name, value: i.id };
                     })}
                     onChange={(e) => {
+                      // 当用户选择了某个字段时，自动设置该条件的类型和其他属性
                       props.conditions.forEach((element) => {
                         if (element.id == e) {
                           condition.type = convertType(element.valueType);
                           condition.paramKey = e;
                           condition.val = '';
                           condition.paramLabel = element.name;
+                          // 如果字段有字典值，赋值给 condition.dict
                           if (element.lookups && element.lookups.length > 0) {
                             condition.dict = element.lookups;
                           }
+                          // 强制刷新
                           setKey(key + 1);
                         }
                       });
                     }}
                   />
                 </Form.Item>
+
+                {/* 渲染操作符选择 */}
                 {loadOperateItem(condition, index)}
+
+                {/* 渲染值输入框 */}
                 {loadValueItem(condition, index)}
               </div>
             </div>
@@ -269,4 +338,5 @@ const ConditionNode: React.FC<Iprops> = (props) => {
     </div>
   );
 };
+
 export default ConditionNode;
-- 
Gitee


From db4fe028ce9f4cea40a729f5ea591bec4566dac9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=AE=97=E9=98=B3?= <1627320840@qq.com>
Date: Tue, 21 Oct 2025 06:02:35 +0000
Subject: [PATCH 2/3] update
 src/components/Common/FlowDesign/Config/Nodes/ConfluenceNode/index.tsx.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: 王宗阳 <1627320840@qq.com>
---
 .../Config/Nodes/ConfluenceNode/index.tsx     | 109 ++++++++++++------
 1 file changed, 73 insertions(+), 36 deletions(-)

diff --git a/src/components/Common/FlowDesign/Config/Nodes/ConfluenceNode/index.tsx b/src/components/Common/FlowDesign/Config/Nodes/ConfluenceNode/index.tsx
index 3f6599b63..107c32b84 100644
--- a/src/components/Common/FlowDesign/Config/Nodes/ConfluenceNode/index.tsx
+++ b/src/components/Common/FlowDesign/Config/Nodes/ConfluenceNode/index.tsx
@@ -7,6 +7,15 @@ import { schema } from '@/ts/base';
 import { Card, Divider } from 'antd';
 import { ItemDragging } from 'devextreme-react/list';
 import SelectAuth from '@/components/Common/SelectAuth';
+
+
+/**
+ * @description 组件的参数类型定义
+ * @param current 当前工作节点（包含配置数据）
+ * @param work 当前所属工作对象
+ * @param belong 当前节点所属的组织或单位
+ * @param refresh 外部传入的刷新函数，用于更新父组件
+ */
 interface IProps {
   current: WorkNodeDisplayModel;
   work: IWork;
@@ -15,25 +24,39 @@ interface IProps {
 }
 
 /**
- * @description: 成员节点配置信息
- * @return {*}
+ * @description 合流节点配置组件（ConfluenceNode）
+ * 主要功能：配置节点的“是否包含单位级审核”和“权限配置”
+ * @returns React.FC<IProps>
  */
-
 const ConfluenceNode: React.FC<IProps> = (props) => {
+  /** 当前选中的权限对象（用于添加新的权限） */
   const [selectAuthority, setSelectAuthority] = useState<schema.XAuthority>();
+
+  /** 是否包含单位级审核选项的状态 */
   const [containCompany, setContainCompany] = useState<boolean>(
-    props.current.containCompany,
+    props.current.containCompany, // 从当前节点初始化
   );
+
+  /** 已选权限列表（从节点数据中读取） */
   const [selectAuthoritys, setSelectAuthoritys] = useState<schema.XAuthority[]>(
-    props.current.authoritys ?? [],
+    props.current.authoritys ?? [], // 如果为空则用空数组
   );
+
+  /**
+   * 拖拽排序事件
+   * 当列表中权限项被拖动时触发，用于调整权限顺序
+   * e.fromIndex 表示原位置索引
+   * e.toIndex 表示新位置索引
+   */
   const onReorder = React.useCallback((e: { fromIndex: number; toIndex: number }) => {
-    const fromAttr = props.current.authoritys.splice(e.fromIndex, 1);
-    props.current.authoritys.splice(e.toIndex, 0, ...fromAttr);
+    const fromAttr = props.current.authoritys.splice(e.fromIndex, 1); // 取出拖动项
+    props.current.authoritys.splice(e.toIndex, 0, ...fromAttr); // 插入到目标位置
   }, []);
+
   return (
     <div className={cls[`app-roval-node`]}>
       <div className={cls[`roval-node`]}>
+        {/* === 审核配置卡片 === */}
         <Card
           className={cls[`card-info`]}
           type="inner"
@@ -49,27 +72,28 @@ const ConfluenceNode: React.FC<IProps> = (props) => {
               <span>审核配置</span>
             </div>
           }>
+          {/* 是否包含单位级审核下拉框 */}
           <div style={{ width: '300px', paddingLeft: 10, display: 'inline-block' }}>
             <SelectBox
               label="是否包含单位级审核"
-              labelMode="static"
-              displayExpr={'label'}
-              valueExpr={'value'}
-              value={containCompany}
+              labelMode="static" // 固定显示标签
+              displayExpr={'label'} // 显示字段名
+              valueExpr={'value'} // 绑定的值字段名
+              value={containCompany} // 当前选择的值
               onSelectionChanged={(e) => {
+                // 当用户选择变化时更新当前节点与本地状态
                 props.current.containCompany = e.selectedItem.value;
                 setContainCompany(e.selectedItem.value);
               }}
               dataSource={[
                 { label: '包含', value: true },
-                {
-                  label: '不包含',
-                  value: false,
-                },
+                { label: '不包含', value: false },
               ]}
             />
           </div>
         </Card>
+
+        {/* === 权限配置卡片 === */}
         <Card
           className={cls[`card-info`]}
           type="inner"
@@ -87,69 +111,81 @@ const ConfluenceNode: React.FC<IProps> = (props) => {
           }
           extra={
             <>
+              {/* 选择权限组件（SelectAuth） */}
               <div style={{ width: '300px', paddingLeft: 10, display: 'inline-block' }}>
                 <SelectAuth
-                  excludeAll
+                  excludeAll // 排除“全部”选项
                   disableExp={(auth: IAuthority) => {
+                    // 禁止已存在的权限再次选择
                     return selectAuthoritys.some((s) => s.id == auth.id);
                   }}
-                  space={props.belong}
-                  value={selectAuthority?.id}
+                  space={props.belong} // 当前组织空间
+                  value={selectAuthority?.id} // 当前选中的权限
                   onChange={(_value, _label, authority) => {
+                    // 选中权限时更新状态
                     setSelectAuthority(authority);
                   }}
                 />
               </div>
+
+              {/* “添加”按钮 */}
               <a
                 style={{ paddingLeft: 10, display: 'inline-block' }}
                 onClick={() => {
+                  // 点击添加新权限
                   if (
                     selectAuthority &&
                     props.current.authoritys.every((a) => a.id !== selectAuthority.id)
                   ) {
+                    // 若当前选择的权限不存在于列表中，则添加
                     props.current.authoritys.push({ ...selectAuthority, count: 1 });
-                    setSelectAuthoritys([...props.current.authoritys]);
-                    setSelectAuthority(undefined);
+                    setSelectAuthoritys([...props.current.authoritys]); // 更新状态
+                    setSelectAuthority(undefined); // 清空当前选择
                   }
                 }}>
                 添加
               </a>
             </>
           }>
+          {/* === 权限列表 === */}
           <List<schema.XAuthority, string>
-            itemKeyFn={(attr: schema.XAttribute) => attr.id}
-            dataSource={props.current.authoritys}
+            itemKeyFn={(attr: schema.XAttribute) => attr.id} // 唯一键函数
+            dataSource={props.current.authoritys} // 列表数据源（当前节点的权限列表）
             height={'600px'}
             width={'100%'}
-            searchEnabled
-            scrollingEnabled
-            searchMode="contains"
+            searchEnabled // 启用搜索功能
+            scrollingEnabled // 启用滚动
+            searchMode="contains" // 搜索模式为包含
             focusStateEnabled={false}
             activeStateEnabled={false}
-            pageLoadMode="scrollBottom"
-            searchExpr={['name', 'remark']}
+            pageLoadMode="scrollBottom" // 向下滚动加载模式
+            searchExpr={['name', 'remark']} // 搜索字段
             scrollByContent={false}
-            allowItemDeleting
-            onItemReordered={onReorder}
+            allowItemDeleting // 允许删除
+            onItemReordered={onReorder} // 拖拽排序事件
             onItemDeleted={(e) => {
+              // 删除事件：从节点和本地状态中移除选项
               props.current.authoritys = props.current.authoritys.filter(
                 (a) => a.id != e.itemData?.id,
               );
               setSelectAuthoritys([...props.current.authoritys]);
             }}
             itemRender={(auth: schema.XAuthority) => {
+              // 列表项渲染：显示权限名称
               return <span>{auth.name}</span>;
             }}
-            itemDeleteMode="static">
+            itemDeleteMode="static" // 静态删除模式（点击删除按钮）
+          >
+            {/* === 拖拽排序配置 === */}
             <ItemDragging
-              autoScroll
-              allowReordering
-              dragDirection="both"
-              dropFeedbackMode="push"
+              autoScroll // 拖拽时自动滚动
+              allowReordering // 允许重新排序
+              dragDirection="both" // 可双向拖拽
+              dropFeedbackMode="push" // 拖拽时的反馈模式
               bindingOptions={{
-                location: 'before',
+                location: 'before', // 拖放位置绑定
               }}
-              data={props.current.authoritys}
+              data={props.current.authoritys} // 拖拽绑定的数据
             />
           </List>
         </Card>
@@ -157,4 +193,5 @@ const ConfluenceNode: React.FC<IProps> = (props) => {
     </div>
   );
 };
+
 export default ConfluenceNode;
-- 
Gitee


From d85accf8a59a6e507df9e94195559242d05ce407 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=AE=97=E9=98=B3?= <1627320840@qq.com>
Date: Tue, 21 Oct 2025 06:09:25 +0000
Subject: [PATCH 3/3] update
 src/components/Common/FlowDesign/Config/Nodes/Custom/index.tsx.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: 王宗阳 <1627320840@qq.com>
---
 .../FlowDesign/Config/Nodes/Custom/index.tsx  | 94 ++++++++++++++-----
 1 file changed, 69 insertions(+), 25 deletions(-)

diff --git a/src/components/Common/FlowDesign/Config/Nodes/Custom/index.tsx b/src/components/Common/FlowDesign/Config/Nodes/Custom/index.tsx
index e25844793..2fb36ce55 100644
--- a/src/components/Common/FlowDesign/Config/Nodes/Custom/index.tsx
+++ b/src/components/Common/FlowDesign/Config/Nodes/Custom/index.tsx
@@ -21,41 +21,49 @@ import DocumentConfig from '../../Components/Document';
 import FormItem from '@/components/DataStandard/WorkForm/Viewer/formItem';
 import { FieldModel } from '@/ts/base/model';
 
+// 定义组件的 props 类型
 interface IProps {
-  work: IWork;
-  rootNode: WorkNodeDisplayModel;
-  current: WorkNodeDisplayModel;
-  belong: IBelong;
-  refresh: () => void;
+  work: IWork; // 当前工作流
+  rootNode: WorkNodeDisplayModel; // 根节点
+  current: WorkNodeDisplayModel; // 当前正在配置的节点
+  belong: IBelong; // 所属组织
+  refresh: () => void; // 刷新函数
 }
 
 /**
- * @description: 审核对象
- * @return {*}
+ * @description: 审核节点配置组件（CustomNode）
+ * 用于配置自定义审批节点的审批对象、执行器、打印模板等信息。
  */
-
 const CustomNode: React.FC<IProps> = (props) => {
-  const [executors, setExecutors] = useState<model.Executor[]>([]);
-  const [destType, setDestType] = useState(props.current.destType ?? '人员');
-  const [destId, setDestId] = useState<string | undefined>(props.current.destId);
-  const [executorModal, setExecutorModal] = useState(false);
-  const [openType, setOpenType] = useState<string>(''); // 打开弹窗
-  const [primaryPrints, setPrimaryPrints] = useState(props.current.print ?? []);
+  /** ------------------ 状态定义区 ------------------ **/
+  const [executors, setExecutors] = useState<model.Executor[]>([]); // 当前节点的执行器配置
+  const [destType, setDestType] = useState(props.current.destType ?? '人员'); // 审核对象类型（人员/角色/权限）
+  const [destId, setDestId] = useState<string | undefined>(props.current.destId); // 审核对象ID
+  const [executorModal, setExecutorModal] = useState(false); // 执行器配置弹窗开关
+  const [openType, setOpenType] = useState<string>(''); // 当前打开的弹窗类型（打印模板设置/添加）
+  const [primaryPrints, setPrimaryPrints] = useState(props.current.print ?? []); // 已选择的打印模板列表
   const [printType, setPrintType] = useState<string>(
-    (props.current.printData && props.current.printData.type) ?? '默认无',
+    (props.current.printData && props.current.printData.type) ?? '默认无', // 当前打印模板类型
   );
+  // 异步加载所有打印模板（useAsyncLoad返回 [加载完成状态, 数据]）
   const [printLoaded, prints] = useAsyncLoad(async () => {
     return await props.work.application.loadAllPrint();
   });
-  const [gatewayFields, setGatewayFields] = useState<FieldModel>();
-  const [loading, setLoading] = useState(true);
+  const [gatewayFields, setGatewayFields] = useState<FieldModel>(); // 审核对象关联字段（用于表单渲染）
+  const [loading, setLoading] = useState(true); // 加载状态（打印模板）
+
+  /** ------------------ 打印模板加载逻辑 ------------------ **/
   useEffect(() => {
     const fetchData = async () => {
       setLoading(true);
       const newData: any = [];
       try {
+        // 加载默认打印模板 ID 列表
         const IDsIprint = await orgCtrl.loadAllDefaultIPrint(props.work.belongId);
+        // 加载当前组织下所有打印模板
         const IPrints = await props.belong.directory.loadAllPrints();
+
+        // 过滤出可用的模板（排除已删除）
         IPrints.forEach((item) => {
           if (
             props.work.belongId == item.belongId &&
@@ -70,9 +78,13 @@ const CustomNode: React.FC<IProps> = (props) => {
             }
           }
         });
+
+        // 去除已存在的模板，防止重复
         const newPrimaryPrint = primaryPrints.filter(
           (obj1) => !newData.some((obj2: any) => obj1.id === obj2.id),
         );
+
+        // 检查是否存在“默认无”模板，没有则补充
         let newPrintData = primaryPrints.filter((item) => item.id == '默认无');
         if (newPrintData.length == 0) {
           setPrimaryPrints([
@@ -91,22 +103,27 @@ const CustomNode: React.FC<IProps> = (props) => {
     };
     fetchData();
   }, []);
+
+  /** ------------------ 初始化当前节点的执行器与表单数据 ------------------ **/
   useEffect(() => {
     props.current.primaryForms = props.current.primaryForms || [];
     props.current.executors = props.current.executors || [];
     setExecutors(props.current.executors);
   }, [props.current]);
+
+  /** ------------------ 同步打印模板到当前节点 ------------------ **/
   useEffect(() => {
     props.current.print = primaryPrints;
   }, [primaryPrints]);
+
+  /** ------------------ 删除打印模板逻辑 ------------------ **/
   const handleRemoveItem = (
     e: React.MouseEvent<HTMLSpanElement, MouseEvent>,
     data: { id: string },
   ) => {
-    e.stopPropagation();
-    if (data.id == '默认无') {
-      return false;
-    }
+    e.stopPropagation(); // 阻止事件冒泡，避免触发SelectBox点击
+    if (data.id == '默认无') return false; // 默认模板不可删除
+    // 删除模板数据
     const newPrintData = props.current.print.filter((option) => option.id !== data.id);
     const newPrintData2 = props.current.printData.attributes.filter(
       (option) => option.title !== data.id,
@@ -115,25 +132,26 @@ const CustomNode: React.FC<IProps> = (props) => {
     setPrimaryPrints([...newPrintData]);
     props.current.printData.attributes = newPrintData2;
   };
-  /** 审核对象选择组件 */
+
+  /** ------------------ 审核对象选择渲染 ------------------ **/
   const rednerSelectedFC = (type: '身份' | '角色') => {
+    // 递归生成树形数据
     const getTreeItems = (targets: ITarget[], pid?: string): any[] => {
       return targets.reduce((result, item) => {
-        // 递归处理子目标
         const children = item.subTarget ? getTreeItems(item.subTarget, item.id) : [];
-        // 添加当前项到结果数组
         result.push({
           id: item.id,
           text: item.name,
           parentId: pid,
           value: item.id,
         } as model.FiledLookup);
-        // 添加子项到结果数组
         result.push(...children);
         return result;
       }, [] as model.FiledLookup[]);
     };
+
     switch (type) {
+      /** ---- 身份选择（组织结构） ---- **/
       case '身份': {
         const dataSource: model.FiledLookup[] = getTreeItems([props.belong]);
         return (
@@ -163,6 +181,7 @@ const CustomNode: React.FC<IProps> = (props) => {
                 }
               }}
             />
+            {/* 选择身份后显示表单项配置 */}
             {props.current.destId && gatewayFields && (
               <FormItem
                 rules={[]}
@@ -179,6 +198,8 @@ const CustomNode: React.FC<IProps> = (props) => {
           </Space>
         );
       }
+
+      /** ---- 角色选择（权限配置） ---- **/
       case '角色':
         return (
           <SelectAuth
@@ -194,14 +215,18 @@ const CustomNode: React.FC<IProps> = (props) => {
             }}
           />
         );
+
+      /** ---- 其他类型暂不支持 ---- **/
       default:
         return <div>暂不支持配置 {type}</div>;
     }
   };
 
+  /** ------------------ 渲染 UI 结构 ------------------ **/
   return (
     <div className={cls[`app-roval-node`]}>
       <div className={cls[`roval-node`]}>
+        {/* 审核对象配置 */}
         <Card
           type="inner"
           title={
@@ -213,6 +238,7 @@ const CustomNode: React.FC<IProps> = (props) => {
           className={cls[`card-info`]}
           extra={
             <>
+              {/* 审核对象类型选择框 */}
               <SelectBox
                 value={destType}
                 valueExpr={'value'}
@@ -237,12 +263,16 @@ const CustomNode: React.FC<IProps> = (props) => {
           }>
           {destType && rednerSelectedFC(destType as '身份')}
         </Card>
+
+        {/* 主表配置 */}
         <FormBinding
           {...props}
           title="主表配置"
           formType="主表"
           xforms={props.current.primaryForms}
         />
+
+        {/* 执行器配置 */}
         <Card
           type="inner"
           title={
@@ -277,13 +307,19 @@ const CustomNode: React.FC<IProps> = (props) => {
             </span>
           )}
         </Card>
+
+        {/* 规则配置 */}
         <Rule
           work={props.work}
           current={props.current}
           primaryForms={props.current.primaryForms}
           detailForms={[]}
         />
+
+        {/* 文档配置 */}
         <DocumentConfig formHost={props.work} current={props.current} />
+
+        {/* 打印模板配置 */}
         <Card
           type="inner"
           title={
@@ -326,6 +362,7 @@ const CustomNode: React.FC<IProps> = (props) => {
                 setOpenType('打印模板设置');
               }
             }}
+            // 渲染模板选项，同时显示删除按钮
             itemRender={(data) => (
               <div style={{ display: 'flex', justifyContent: 'space-between' }}>
                 <span style={{ whiteSpace: 'nowrap' }}>{data.name}</span>
@@ -335,6 +372,8 @@ const CustomNode: React.FC<IProps> = (props) => {
           />
         </Card>
       </div>
+
+      {/* 执行器配置弹窗 */}
       {executorModal ? (
         <ExecutorConfigModal
           refresh={(param) => {
@@ -359,6 +398,8 @@ const CustomNode: React.FC<IProps> = (props) => {
           current={props.current}
         />
       ) : null}
+
+      {/* 打印模板设置弹窗 */}
       {openType == '打印模板设置' && (
         <PrintConfigModal
           refresh={() => {
@@ -372,6 +413,8 @@ const CustomNode: React.FC<IProps> = (props) => {
           detailForms={[]}
         />
       )}
+
+      {/* 打印模板添加弹窗 */}
       {openType == '打印模板添加' && printLoaded && (
         <OpenFileDialog
           multiple
@@ -404,4 +447,5 @@ const CustomNode: React.FC<IProps> = (props) => {
     </div>
   );
 };
+
 export default CustomNode;
-- 
Gitee