@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/205/254/345/205/261/350/265/204/344/272/247/346/270/205/345/215/225-/345/216/237/346/226/207/344/273/266.md

@@ -0,0 +1,3516 @@
+# 前后端公共资产清单
+
+**版本**：V1.0
+**日期**：2026-05-20
+**说明**：涵盖微服务前后端所有公共资产
+**统计范围**：前端 `cloud_front` 模块 + 后端 `cloud_back` 模块
+
+---
+
+## 文档结构
+
+- [一、基础设施类](#一基础设施类)
+  - [1.1 缓存操作](#11-缓存操作)
+    - [SysCacheServiceFacade](#syscacheservicefacade)
+    - [StringCacheFacade](#stringcachefacade)
+  - [1.2 配置中心](#12-配置中心)
+    - [NacosUtils](#nacosutils)
+- [二、通用工具类](#二通用工具类)
+  - [2.1 SM2 SM3 SM4 加解密](#21-sm2-sm3-sm4-加解密)
+    - [Sm2Utils](#sm2utils)
+    - [SM3Encoder](#sm3encoder)
+    - [Sm4Utils](#sm4utils)
+- [三、平台服务支撑](#三平台服务支撑)
+  - [3.1 日志服务](#31-日志服务)
+    - [ILogPostService](#ilogpostservice)
+    - [@LogDesc/@AddDesc/@DelDesc](#logdescadddescdeldesc)
+    - [@LogOperation](#logoperation)
+  - [3.3 会话信息获取](#33-会话信息获取)
+    - [SessionUtils](#sessionutils)
+    - [IUserOnlineTime](#iuseronlinetime)
+  - [3.4 多系统集成](#34-多系统集成)
+  - [3.5 数据密级过滤](#35-数据密级过滤)
+  - [3.6 服务通知](#36-服务通知)
+    - [租户同步](#租户同步)
+    - [用户权限同步](#用户权限同步)
+    - [服务通知二开接口](#服务通知二开接口)
+- [四、业务组件](#四业务组件)
+  - [4.1 工作流组件](#41-工作流组件)
+  - [4.2 调度组件](#42-调度组件)
+  - [4.3 定时任务](#43-定时任务)
+- [五、前端资产](#五前端资产)
+  - [5.1 UI组件库](#51-ui组件库)
+    - [CloudDialog](#511-通用对话框组件-clouddialog)
+    - [UserSelect](#512-用户选择组件-userselect)
+    - [UserSelectMulti](#513-多用户选择组件-userselectmulti)
+    - [DeptSelect](#514-部门选择组件-deptselect)
+    - [RoleSelect](#515-角色选择组件-roleselect)
+    - [ImportButton](#516-导入按钮组件-importbutton)
+    - [MenuAuth](#517-菜单权限认证组件-menuauth)
+    - [ResourceCodeAuth](#518-资源代码授权组件-resourcecodeauth)
+    - [ThreeMemberAuth](#519-三员授权组件-threememberauth)
+    - [TableHeadSearch](#5110-表格头部搜索组件-tableheadsearch)
+    - [VerifiyPassword](#5111-二级鉴别密码验证弹窗-verifiypassword)
+    - [CommonHeader](#5112-通用头部组件-commonheader)
+  - [5.2 前端工具函数库](#52-前端工具函数库)
+    - [数据格式化类](#数据格式化类)
+    - [表单校验类](#表单校验类)
+    - [防重复点击](#防重复点击)
+    - [加解密类](#加解密类)
+    - [访问日志类](#访问日志类)
+  - [5.3 流程组件与方法](#53-流程组件与方法)
+- [组件及方法统计](#组件及方法统计)
+- [A. Maven依赖坐标](#a-maven依赖坐标)
+- [B. 组件开发注意事项](#b-组件开发注意事项)
+
+---
+
+## 一、基础设施类
+
+### 1.1 缓存操作
+
+#### SysCacheServiceFacade
+
+##### 1.1.1 新增缓存
+
+完整包路径：`com.meritdata.tempo.syscache.service.SysCacheServiceFacade`
+
+方法：`put(key, value)`
+
+入参：String key, Object value
+
+返回：void
+
+使用场景：系统存在高频访问且不刷新的变量时，将信息存入redis，无固定期限（永不失效）
+
+示例：
+```java
+SysCacheServiceFacade.put("EXECPTION_EVENT_SESSION" + username, allSessions);
+SysCacheServiceFacade.put("user:session:" + userId, userSession);
+```
+
+##### 1.1.2 添加缓存并设置生存时间
+
+方法：`putExpire(key, value, seconds)`
+
+入参：String key, Object value, int seconds
+
+返回：void
+
+使用场景：需要设置缓存过期时间的场景，如token缓存，seconds为过期秒数
+
+示例：
+```java
+SysCacheServiceFacade.putExpire("nacosToken", accessToken, 14400);
+SysCacheServiceFacade.putExpire("temp:data:" + id, value, 3600);
+```
+
+##### 1.1.3 添加缓存并设置到期时间
+
+方法：`putExpireAt(key, value, unixTime)`
+
+入参：String key, Object value, long unixTime
+
+返回：void
+
+使用场景：需要在指定时间点过期的缓存，unixTime为Unix时间戳（毫秒）
+
+**注意**：实际实现内部会自动给unixTime加3000
+
+示例：
+```java
+// unixTime为毫秒时间戳
+SysCacheServiceFacade.putExpireAt("event:expire", value, System.currentTimeMillis() + 3600000);
+```
+
+##### 1.1.4 读取缓存
+
+方法：`get(key)`
+
+入参：String key
+
+返回：Object
+
+使用场景：获取已存储的缓存值
+
+示例：
+```java
+String token = SysCacheServiceFacade.get("nacosToken").toString();
+Object session = SysCacheServiceFacade.get("user:session:" + userId);
+```
+
+##### 1.1.5 判断key是否存在
+
+方法：`isExist(key)`
+
+入参：String key
+
+返回：Boolean
+
+使用场景：判断某个缓存是否已存在
+
+示例：
+```java
+boolean exists = SysCacheServiceFacade.isExist("nacosToken");
+if (exists) {
+    // token存在，刷新或使用
+}
+```
+
+##### 1.1.6 清除缓存
+
+方法：`remove(key)`
+
+入参：String key
+
+返回：void
+
+使用场景：主动清除某个缓存
+
+示例：
+```java
+SysCacheServiceFacade.remove("nacosToken");
+SysCacheServiceFacade.remove("user:session:" + userId);
+```
+
+##### 1.1.7 读取Hash缓存
+
+方法：`hget(h, hkey)`
+
+入参：String h, String hkey
+
+返回：Object
+
+使用场景：从Hash结构中获取单个字段值
+
+示例：
+```java
+User user = (User) SysCacheServiceFacade.hget(CACHE_SESSION_LIST_KEY, loginName);
+Object value = SysCacheServiceFacade.hget("user:hash", "username");
+```
+
+##### 1.1.8 写入Hash缓存
+
+方法：`hset(h, hkey, hvalue)`
+
+入参：String h, String hkey, Object hvalue
+
+返回：void
+
+使用场景：将数据以Hash结构存储，常用于存储用户会话信息
+
+示例：
+```java
+SysCacheServiceFacade.hset(CACHE_SESSION_LIST_KEY, user.getUsername(), user);
+SysCacheServiceFacade.hset("user:profile", userId, userProfile);
+```
+
+##### 1.1.9 获取Hash所有数据
+
+方法：`hgetAll(key)`
+
+入参：String key
+
+返回：Map<String, Object>
+
+使用场景：获取Hash结构中的所有键值对
+
+示例：
+```java
+Map<String, Object> allUsers = SysCacheServiceFacade.hgetAll(CACHE_SESSION_LIST_KEY);
+```
+
+##### 1.1.10 删除Hash字段
+
+方法：`hdel(h, hkey)`
+
+入参：String h, String hkey
+
+返回：Long
+
+使用场景：删除Hash中的指定字段
+
+示例：
+```java
+SysCacheServiceFacade.hdel(CACHE_SESSION_LIST_KEY, loginName);
+SysCacheServiceFacade.hdel("user:profile", userId);
+```
+
+##### 1.1.11 获取Hash所有字段
+
+方法：`hkeys(h)`
+
+入参：String h
+
+返回：Set<String>
+
+使用场景：获取Hash结构中的所有字段名
+
+示例：
+```java
+Set<String> fields = SysCacheServiceFacade.hkeys(CACHE_SESSION_LIST_KEY);
+for (String key : fields) {
+    // 遍历所有缓存的用户名
+}
+```
+
+##### 1.1.12 获取Hash所有值
+
+方法：`hvalues(h)`
+
+入参：String h
+
+返回：List<Object>
+
+使用场景：获取Hash结构中的所有值
+
+示例：
+```java
+List<Object> allUsers = SysCacheServiceFacade.hvalues(CACHE_SESSION_LIST_KEY);
+```
+
+##### 1.1.13 批量读取
+
+方法：`multiGet(keys)`
+
+入参：List keys
+
+返回：List<Object>
+
+使用场景：一次性获取多个缓存值，减少网络开销
+
+示例：
+```java
+List<String> keys = Arrays.asList("key1", "key2", "key3");
+List<Object> values = SysCacheServiceFacade.multiGet(keys);
+```
+
+##### 1.1.14 队列入队
+
+方法：`enqueue(key, value)`
+
+入参：String key, T value
+
+返回：Long
+
+使用场景：实现消息队列的入队操作
+
+示例：
+```java
+SysCacheServiceFacade.enqueue("task_queue", taskData);
+SysCacheServiceFacade.enqueue("async:job:queue", jobMessage);
+```
+
+##### 1.1.15 队列出队
+
+方法：`dequeue(key)`
+
+入参：String key
+
+返回：Object
+
+使用场景：实现消息队列的出队操作
+
+示例：
+```java
+Object data = SysCacheServiceFacade.dequeue("task_queue");
+while ((data = SysCacheServiceFacade.dequeue("task_queue")) != null) {
+    // 处理队列数据
+}
+```
+
+##### 1.1.16 批量出队
+
+方法：`dequeueList(key)`
+
+入参：String key
+
+返回：List<Object>
+
+使用场景：一次性出队多个数据
+
+示例：
+```java
+List<Object> batchData = SysCacheServiceFacade.dequeueList("task_queue");
+```
+
+##### 1.1.17 获取队列长度
+
+方法：`queueSize(key)`
+
+入参：String key
+
+返回：Long
+
+使用场景：查看队列中等待处理的任务数量
+
+示例：
+```java
+Long size = SysCacheServiceFacade.queueSize("task_queue");
+if (size > 100) {
+    // 队列积压告警
+}
+```
+
+##### 1.1.18 递增
+
+方法：`increment(k)` / `increment(k, delta)`
+
+入参：String k, long delta(可选)
+
+返回：Long
+
+使用场景：计数器实现，如访问次数统计、序列号生成
+
+示例：
+```java
+SysCacheServiceFacade.increment("page:views");
+SysCacheServiceFacade.increment("request:count", 1);
+Long newValue = SysCacheServiceFacade.increment("order:seq");
+```
+
+##### 1.1.19 递减
+
+方法：`decrement(k)` / `decrement(k, delta)`
+
+入参：String k, long delta(可选)
+
+返回：Long
+
+使用场景：计数器递减，如库存扣减
+
+示例：
+```java
+SysCacheServiceFacade.decrement("stock:count");
+Long remaining = SysCacheServiceFacade.decrement("inventory:qty", quantity);
+```
+
+##### 1.1.20 不存在则设置
+
+方法：`setIfAbsent(k, v)`
+
+入参：String k, Object v
+
+返回：boolean
+
+使用场景：分布式锁、幂等性控制、新用户标识
+
+示例：
+```java
+boolean locked = SysCacheServiceFacade.setIfAbsent("lock:order:" + orderId, "locked");
+if (locked) {
+    // 获取锁成功，处理订单
+}
+```
+
+##### 1.1.21 获取旧值并设置新值
+
+方法：`getAndSet(k, v)`
+
+入参：String k, Object v
+
+返回：Object
+
+使用场景：原子性获取旧值并设置新值，如token刷新
+
+示例：
+```java
+Object oldToken = SysCacheServiceFacade.getAndSet("user:token:" + userId, newToken);
+```
+
+##### 1.1.22 发布消息
+
+方法：`publish(channel, message)`
+
+入参：String channel, String message
+
+返回：void
+
+使用场景：Redis发布订阅模式的消息发布
+
+示例：
+```java
+SysCacheServiceFacade.publish("channel:notify", "有新消息通知");
+SysCacheServiceFacade.publish("event:update", JSON.toJSONString(event));
+```
+
+##### 1.1.23 订阅消息
+
+方法：`subscribe(channel, ICacheSubscribeListener)`
+
+入参：String channel, ICacheSubscribeListener listener
+
+返回：void
+
+使用场景：Redis发布订阅模式的消息订阅
+
+**调用链**：
+- `SysCacheServiceFacade.subscribe(channel, listener)` - 公开API，参数顺序 `(channel, listener)`
+- 内部调用 `SysCacheServiceContext.subscribe(listener, channel)` - 参数顺序被调换
+- 底层 `ICacheService.subscribe(listener, channel)` - Redis标准顺序
+
+**注意**：`ICacheSubscribeListener.onMessage(msg)`回调接口**只接收一个参数msg**
+
+示例：
+```java
+// subscribe方法接收(channel, listener)，回调onMessage只接收(msg)
+SysCacheServiceFacade.subscribe("channel:notify", (msg) -> {
+    // 处理接收到的消息
+    System.out.println("收到消息: " + msg);
+});
+```
+
+---
+
+#### StringCacheFacade
+
+##### 1.1.24 String类型缓存-新增
+
+完整包路径：`com.meritdata.tempo.syscache.service.StringCacheFacade`
+
+方法：`put(key, value)`
+
+入参：String key, String value
+
+返回：void
+
+使用场景：存储字符串类型的缓存数据
+
+示例：
+```java
+StringCacheFacade.put("config:version", "1.0.0");
+StringCacheFacade.put("user:name:" + userId, username);
+```
+
+##### 1.1.25 String类型缓存-读取
+
+方法：`get(key)`
+
+入参：String key
+
+返回：String
+
+使用场景：获取字符串类型的缓存值
+
+示例：
+```java
+String version = StringCacheFacade.get("config:version");
+```
+
+##### 1.1.26 String类型缓存-批量读取
+
+方法：`multiGet(keys)`
+
+入参：List keys
+
+返回：List<String>
+
+使用场景：批量获取字符串缓存
+
+示例：
+```java
+List<String> keys = Arrays.asList("key1", "key2");
+List<String> values = StringCacheFacade.multiGet(keys);
+```
+
+---
+
+### 1.2 配置中心
+
+#### NacosUtils
+
+**注意**：`NacosUtils` **不是静态工具类**，它是一个Spring Bean，需要通过依赖注入获取实例。类上有`@DisableEncrypt`注解，但方法使用`@Autowired`注入`MeritdataCloudProperties`和`Environment`。
+
+**正确用法**（通过Spring注入）：
+```java
+@Autowired
+private NacosUtils nacosUtils;
+```
+
+##### 1.2.1 获取配置列表
+
+完整包路径：`com.meritdata.cloud.utils.NacosUtils`
+
+方法：`getConfigList(dataId)`
+
+入参：String dataId
+
+返回：Map
+
+使用场景：获取Nacos上某个配置分组的所有配置项
+
+示例：
+```java
+Map configMap = nacosUtils.getConfigList("common-cloud-system-manage.properties");
+```
+
+##### 1.2.2 获取配置文件
+
+方法：`getConfigFile(dataId)`
+
+入参：String dataId
+
+返回：String
+
+使用场景：获取Nacos上某个配置文件的完整内容
+
+示例：
+```java
+String content = nacosUtils.getConfigFile("application.properties");
+```
+
+##### 1.2.3 获取配置值
+
+方法：`getConfigValue(dataId, configKey)`
+
+入参：String dataId, String configKey
+
+返回：String
+
+使用场景：获取Nacos上指定配置项的值
+
+示例：
+```java
+String value = nacosUtils.getConfigValue("common-cloud-system-manage.properties", "meritdata.cloud.security-label-show");
+```
+
+##### 1.2.4 获取所有配置文件
+
+方法：`getAllConfigFile()`
+
+入参：无
+
+返回：Map<String, String>
+
+使用场景：获取Nacos上所有配置文件的键值对
+
+示例：
+```java
+Map<String, String> allConfigs = nacosUtils.getAllConfigFile();
+```
+
+##### 1.2.5 修改配置
+
+方法：`updateConfig(dataId, configKey, configValue)`
+
+入参：String dataId, String configKey, String configValue
+
+返回：boolean
+
+使用场景：修改Nacos上的配置值
+
+示例：
+```java
+boolean success = nacosUtils.updateConfig("common-cloud-system-manage.properties",
+    "meritdata.cloud.security-label-show", "true");
+```
+
+##### 1.2.6 更新配置文件
+
+方法：`updateConfigFile(dataId, quote)`
+
+入参：String dataId, String quote
+
+返回：boolean
+
+使用场景：更新整个配置文件内容
+
+示例：
+```java
+boolean success = nacosUtils.updateConfigFile("application.properties", newConfigContent);
+```
+
+##### 1.2.7 新增配置
+
+方法：`addConfig(dataId, configKey, configValue)`
+
+入参：String dataId, String configKey, String configValue
+
+返回：boolean
+
+使用场景：在Nacos上新增配置项
+
+示例：
+```java
+boolean added = nacosUtils.addConfig("custom.properties", "custom.key", "customValue");
+```
+
+##### 1.2.8 重置配置文件
+
+方法：`reSetConfigFile(dataId, quote)`
+
+入参：String dataId, String quote
+
+返回：boolean
+
+使用场景：重置配置文件内容
+
+示例：
+```java
+nacosUtils.reSetConfigFile("reset.properties", defaultContent);
+```
+
+##### 1.2.9 清除配置文件
+
+方法：`clearConfigFile(dataId)`
+
+入参：String dataId
+
+返回：boolean
+
+使用场景：清除Nacos上某个配置文件的所有内容
+
+示例：
+```java
+nacosUtils.clearConfigFile(dataId);
+```
+
+##### 1.2.10 获取Nacos Token
+
+方法：`getNacosToken()`
+
+入参：无
+
+返回：String
+
+使用场景：获取Nacos访问令牌
+
+示例：
+```java
+String token = nacosUtils.getNacosToken();
+```
+
+---
+
+## 二、通用工具类
+
+### 2.1 SM2 SM3 SM4 加解密
+
+#### Sm2Utils
+
+##### 2.1.1 生成SM2密钥对
+
+完整包路径：`com.meritdata.cloud.utils.Sm2Utils`
+
+方法：`createSM2Key()`
+
+入参：无
+
+返回：MutablePair<String, String> (公钥, 私钥)
+
+使用场景：生成SM2密钥对用于数据加密传输
+
+示例：
+```java
+MutablePair<String, String> keyPair = Sm2Utils.createSM2Key();
+String publicKey = keyPair.getLeft();
+String privateKey = keyPair.getRight();
+```
+
+##### 2.1.2 SM2加密
+
+方法：`encrypt(data, publicKey)`
+
+入参：String data, String publicKey
+
+返回：String
+
+使用场景：SM2公钥加密，用于数据加密传输
+
+示例：
+```java
+String encrypted = Sm2Utils.encrypt(data, publicKey);
+```
+
+##### 2.1.3 SM2解密
+
+方法：`decrypt(data, privateKey)`
+
+入参：String data, String privateKey
+
+返回：String
+
+使用场景：SM2私钥解密，用于解密接收的加密数据，从header获取SM4密钥
+
+示例：
+```java
+// 从请求header获取SM4密钥
+String key = Sm2Utils.decrypt(request.getHeader("smPrivate"), meritdataCloudProperties.getSmPrivateKey());
+```
+
+#### SM3Encoder
+
+##### 2.1.4 SM3加密
+
+完整包路径：`com.meritdata.cloud.utils.SM3Encoder`
+
+方法：`encryptWithHMacMD5(str)` / `encode(str)`
+
+入参：String str
+
+返回：String
+
+使用场景：SM3哈希算法，用于数据完整性校验、密码加密
+
+**注意**：`SM3Encoder`没有`encrypt(str)`方法，应该使用`encryptWithHMacMD5(str)`或从`PasswordEncoder`接口继承的`encode(CharSequence)`方法
+
+示例：
+```java
+// 正确用法 - 使用encryptWithHMacMD5
+String hash = SM3Encoder.encryptWithHMacMD5(originalPassword);
+boolean matches = SM3Encoder.encryptWithHMacMD5(rawPassword).equals(hash);
+
+// 或者实现PasswordEncoder接口的encode方法
+String encoded = SM3Encoder.encode(rawPassword);
+```
+
+##### 2.1.5 SM3加密（带HMAC）
+
+方法：`encryptWithHMacMD5(src)`
+
+入参：String src
+
+返回：String
+
+使用场景：SM3带密钥的哈希运算
+
+示例：
+```java
+String sm3Data = SM3Encoder.encryptWithHMacMD5(word);
+```
+
+#### Sm4Utils
+
+##### 2.1.6 SM4加密（默认密钥）
+
+完整包路径：`com.meritdata.cloud.utils.Sm4Utils`
+
+常量：`SM4_KEY = "nXwqj7JVe@czbD4E"`
+
+方法：`encrypt(text)` / `encrypt(text, key)`
+
+入参：String text, String key(可选)
+
+返回：String
+
+使用场景：SM4对称加密，用于大量数据的加密存储
+
+示例：
+```java
+// 使用默认密钥加密
+String encrypted = Sm4Utils.encrypt(plainText);
+
+// 使用指定密钥加密
+String encrypted = Sm4Utils.encrypt(plainText, privateKey);
+
+// 加密用户数据
+handset = Sm4Utils.encrypt(handset, privateKey);
+email = Sm4Utils.encrypt(email, privateKey);
+```
+
+##### 2.1.7 SM4解密
+
+方法：`decrypt(encryptStr)` / `decrypt(encryptStr, key)` / `decrypt(encryptStr, sm4privateKey, privateKey, flag)`
+
+入参：String encryptStr, String key(可选), String sm4privateKey(可选), String flag(可选)
+
+返回：String
+
+使用场景：SM4对称解密，用于解密存储的加密数据
+
+示例：
+```java
+// 使用默认密钥解密
+String decrypted = Sm4Utils.decrypt(encryptStr);
+
+// 使用指定密钥解密
+String decrypted = Sm4Utils.decrypt(encryptStr, privateKey);
+
+// SM2解密后SM4解密 (flag="1"表示需要SM2解密)
+userNameDec = Sm4Utils.decrypt(username, key, "", "1");
+passwordDec = Sm4Utils.decrypt(password, key, "", "1");
+```
+
+---
+
+## 三、平台服务支撑
+
+### 3.1 日志服务
+
+基于 `ILogPostService` 的日志服务，所有对外接口均通过 Feign 远程调用实现。支持操作日志、访问日志、登录日志、错误日志等多种日志类型。
+
+**二开服务使用方式**：通过 `@Autowired` 注入 `ILogPostService`，直接调用其方法。
+
+#### ILogPostService
+
+完整包路径：`com.meritdata.cloud.log.service.ILogPostService`
+
+服务名称：`cloud-system-manage`
+
+基础路径：`/api/basic/log`
+
+##### 3.1.1 记录操作日志
+
+方法：`POST /post`
+
+入参：Message param
+
+返回：boolean
+
+使用场景：记录系统操作日志，支持新增、编辑、删除等操作类型的日志记录
+
+**使用步骤：**
+
+日志示例: [用户1:user1] 新增人员[测试用户1:testUser1]
+
+​				[用户1:user1] 编辑人员[测试用户1:testUser1]:"姓名"由[测试用户1]变更为[测试用户2],"身份证号码"变更,"邮件地址"变更,"手机号"变更
+
+​				[[用户1:user1] 删除人员[测试用户1:testUser1]
+
+1. **注入日志服务**
+
+   ```java
+   // 注入日志服务
+   @Autowired
+   private ILogPostService logPostService;
+   ```
+   
+2. **实体类添加日志注解**@LogDesc(value = "实体类描述", keyField = "name")标注实体描述和新增/编辑/删除等操作日志需要记录的主键字段
+
+3. 对实体类中需要记录到日志中的**字段添加操作日志注解@LogDesc**("字段的中文描述") ，当字段发生变化时会记录变化日志，当添加changeFlag=true时打印"xxx"变更，用于一些敏感信息日志不打印细节仅打印变更操作，多个字段变更操作逗号分隔。
+
+   ```java
+   // 此处为类上的注解，value为实体类的中文描述，如新增人员/编辑人员/删除人员，keyField为日志需要记录的字段：新增人员[用户1]
+   @LogDesc(value = "人员", keyField = "name")
+   @Entity
+   @Table(name = "[PF_ORG_USER]")
+   public class Emp extends CloudBaseEntity implements Serializable {
+   
+       @Id
+       @Column(name = "[ID]", length = 32)
+       private String id;
+   
+       // "姓名"由[修改前值]变更为[修改后值]
+       @Column(name = "[NAME]", length = 200)
+       @LogDesc("姓名")        // 字段描述
+       @DelDesc               // 删除时记录此字段
+       @AddDesc               // 新增时记录此字段
+       private String name;
+   
+       // "编码"由[修改前值]变更为[修改后值]
+       @Column(name = "[CODE]")
+       @LogDesc("编码")
+       private String code;
+       
+   	// "性别"由[空]变更为[女]
+       @Column(name = "[SEX]")
+       @LogDesc(value = "性别", lookupType = "sex")  // lookupType自动转换数据字典
+       private Integer sex;
+   
+       // changeFlag=true打印："手机号"变更
+       @Column(name = "[HANDSET]", length = 256)
+       @LogDesc(value = "手机号", changeFlag = true)  
+       private String handset;
+       
+   	// changeFlag=true打印："身份证号码"变更
+       @Column(name = "[CARD]", length = 60)
+       @LogDesc(value = "身份证号码", changeFlag = true)
+       private String card;
+   }
+   ```
+
+   与消息构造时进行消息比对搭配使用：
+
+   ```java
+   Emp empDb = service.getEmpById(emp.getId());
+   // 自动生成变更日志： "字段描述1"由[修改前值]变更为[修改后值],"字段描述2"由[修改前值]变更为[修改后值]
+   String compareLog = CompareUtils.getCompareLog(empDb, emp);  
+   ```
+
+4. **配置日志模板文件**
+
+   在 `src/main/resources/logs/` 目录下创建 `{module}.logs.properties` 文件：
+
+   必须配置业务模块： {module}.xxx.bmodule；功能模块{module}.xxx.fmodule;
+
+   在日志管理页面展示按业务模块、功能模块进行记录，可进行筛选
+
+   ```
+   # 配置文件示例：ou.logs.properties
+   ou.org.bmodule=组织机构
+   ou.emp.fmodule=人员维护
+   ou.emp.create=新增人员
+   ou.emp.create.message=新增人员[{}]
+   ou.emp.update=编辑人员
+   ou.emp.delete=删除人员
+   ou.emp.delete.message=删除人员{}
+   ```
+
+   搭配LogPattenUtils进行获取使用：
+
+   ```
+   LogPattenUtils.getProperty("ou.org.bmodule")
+   ```
+
+5. **日志对象构建与记录**
+
+   // 新增日志
+   Message msg = new Message(操作类型,业务模块,功能模块,操作说明,操作信息,操作状态);
+   logPostService.postLog(msg);
+   
+   ```java
+   // 新增日志
+   Message msg = new Message(Message.TYPE_OPT,
+           LogPattenUtils.getProperty("ou.org.bmodule"),        // 业务模块
+           LogPattenUtils.getProperty("ou.emp.fmodule"),       // 功能模块
+           LogPattenUtils.getProperty("ou.emp.create"),        // 操作说明
+           StrUtil.format(LogPattenUtils.getProperty("ou.emp.create.message"), emp.getName()), // 操作信息
+           Message.STATUS_SUCESS);                              // 操作状态
+   logPostService.postLog(msg);
+   
+   // 编辑日志（自动对比变更）
+   Emp empDb = service.getEmpById(emp.getId());
+   String compareLog = CompareUtils.getCompareLog(empDb, emp);  // 自动生成变更日志
+   Message msg = new Message(Message.TYPE_OPT,
+           LogPattenUtils.getProperty("ou.org.bmodule"),
+           LogPattenUtils.getProperty("ou.emp.fmodule"),
+           LogPattenUtils.getProperty("ou.emp.update"),
+           compareLog,
+           Message.STATUS_SUCESS);
+   logPostService.postLog(msg);
+   
+   // 删除日志
+   Message msg = new Message(Message.TYPE_OPT,
+           LogPattenUtils.getProperty("ou.org.bmodule"),
+           LogPattenUtils.getProperty("ou.emp.fmodule"),
+           LogPattenUtils.getProperty("ou.emp.delete"),
+           StrUtil.format(LogPattenUtils.getProperty("ou.emp.delete.message"),  emp.getName()),
+           Message.STATUS_SUCESS);
+   logPostService.postLog(msg);
+   ```
+
+###### 3.1.1.1. **Message 参数说明**：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| type | String | 是 | 日志类型：0-操作日志，1-访问日志，2-登录日志，3-错误日志，5-安全日志，6-服务日志，7-登出日志 |
+| bmodule | String | 是 | 业务模块 |
+| fmodule | String | 是 | 功能模块 |
+| operation | String | 是 | 操作描述，如"新增"、"编辑"、"删除" |
+| message | String | 否 | 日志内容/变更详情 |
+| status | String | 是 | 操作状态：1-成功，0-失败 |
+
+###### 3.1.1.2.**@LogDesc 实体字段注解**
+
+完整包路径：`com.meritdata.cloud.base.LogDesc`
+
+用于标注实体类字段，配合 `CompareUtils` 自动生成变更日志。
+
+```java
+@Target({ElementType.FIELD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface LogDesc {
+    String value() default "";           // 字段中文描述
+    String keyField() default "";         // 主键列名（用于生成日志前缀）
+    String[] relationField() default {};  // 关系列
+    String relationWord() default "";     // 关系列拼接字符
+    String lookupType() default "";       // 数据字典类型（自动转换编码为标签）
+    String moduleType() default "";      // 自定义字段MODULE_TYPE
+    String[] typeCustom() default {};    // 自定义类型映射
+    boolean booleanFlag() default false;  // 布尔类型转换标识
+    boolean changeFlag() default false;   // 变更类型标识（打印"XX变更"）
+    boolean themType() default false;    // 主题类型标识
+}
+```
+
+**相关注解**：
+- `@AddDesc` - 标记新增操作需要记录的字段
+
+- `@DelDesc` - 标记删除操作需要记录的字段
+
+  changeFlag = true时，打印："${字段描述}"变更
+
+**@LogDesc 实体类配置示例**
+
+来源：`Emp.java` - 人员实体类
+
+```java
+@LogDesc(value = "人员", keyField = "name")
+@Entity
+@Table(name = "[PF_ORG_USER]")
+public class Emp extends CloudBaseEntity implements Serializable {
+
+    @Id
+    @Column(name = "[ID]", length = 32)
+    private String id;
+
+    @Column(name = "[NAME]", length = 200)
+    @LogDesc("姓名")        // 字段描述
+    @DelDesc               // 删除时记录此字段
+    @AddDesc               // 新增时记录此字段
+    private String name;
+
+    @Column(name = "[CODE]")
+    @LogDesc("编码")
+    private String code;
+
+    @Column(name = "[SEX]")
+    @LogDesc(value = "性别", lookupType = "sex")  // lookupType自动转换数据字典
+    private Integer sex;
+
+    @Column(name = "[HANDSET]", length = 256)
+    @LogDesc(value = "手机号", changeFlag = true)  // changeFlag=true打印"手机号变更"
+    private String handset;
+
+    @Column(name = "[CARD]", length = 60)
+    @LogDesc(value = "身份证号码", changeFlag = true)
+    private String card;
+}
+```
+
+**CompareUtils 自动生成变更日志**
+
+完整包路径：`com.meritdata.cloud.log.compare.CompareUtils`
+
+```java
+// 对比两个实体对象，生成变更日志
+// 格式：编辑人员[张三]: "姓名"由[张三]变更为[李四], "编码"由[001]变更为[002]
+String compareLog = CompareUtils.getCompareLog(oldEmp, newEmp);
+
+// 示例输出：
+// 编辑人员[张三]: "姓名"由[张三]变更为[李四], "性别"由[男]变更为[女], "手机号"变更
+```
+
+---
+
+###### 3.1.1.3.**@LogOperation 注解说明**
+
+完整包路径：`com.meritdata.cloud.log.aspect.LogOperation`
+
+```java
+@Target({ElementType.METHOD})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface LogOperation {
+    /**
+     * 操作类型
+     */
+    String type() default "select";
+}
+```
+
+**type 参数可选值**：
+
+| 值 | 说明 |
+|---|---|
+| add | 新增 |
+| edit | 修改 |
+| delete | 删除 |
+| select | 查询 |
+| visit | 访问 |
+| loginIn | 登录 |
+| loginOut | 登出 |
+| import | 导入 |
+| export | 导出 |
+| download | 下载 |
+| upload | 上传 |
+| assign | 分配/变更 |
+
+---
+
+###### 3.1.1.4.**使用示例：**
+
+公共src\main\resources\logs\ou.logs.properties
+
+```
+ou.org.bmodule=组织机构
+# 人员维护
+ou.emp.fmodule=人员维护
+ou.emp.create=新增人员
+ou.emp.create.message=新增人员[{}]
+ou.emp.update=编辑人员
+ou.emp.delete=删除人员
+ou.emp.delete.message=删除人员{}
+```
+
+人员新增（add）
+
+```java
+@RequestMapping(value = "create", method = {RequestMethod.POST})
+@LogOperation(type = "add")
+@Operation(summary = "新增人员信息")
+@ResponseBody
+public boolean create(@RequestParam Map param) throws Exception {
+    Emp emp = mapperToEmp(param, null, "");
+    User user = null;
+    if (emp.getSystemUser() != null && 1 == (emp.getSystemUser())) {
+        user = mapperToUser(param, "");
+    }
+    boolean flag = service.insertEmp(emp, user);
+    if (flag) {
+        Message msg = new Message(Message.TYPE_OPT,
+                LogPattenUtils.getProperty("ou.org.bmodule"),
+                LogPattenUtils.getProperty("ou.emp.fmodule"),
+                LogPattenUtils.getProperty("ou.emp.create"),
+                StrUtil.format(LogPattenUtils.getProperty("ou.emp.create.message"), emp.getName()),
+                Message.STATUS_SUCESS);
+        logPostService.postLog(msg);
+    }
+    // ... 后续处理
+    return flag;
+}
+
+// 日志打印：[用户1:user1]新增人员[测试人员:test1]
+```
+
+---
+
+人员编辑（edit）
+
+```java
+@RequestMapping(value = "update", method = {RequestMethod.POST})
+@LogOperation(type = "edit")
+@ResponseBody
+public boolean update(@RequestParam Map map) throws Exception {
+    boolean flag = false;
+    Emp emp = mapperToEmp(map, null, "");
+    Emp empDb = service.getEmpById(emp.getId());
+    String compareLog = CompareUtils.getCompareLog(empDb, emp);
+    if (map != null) {
+        flag = service.updateEmp(emp);
+    }
+    if (flag && StrUtil.isNotBlank(compareLog)) {
+        Message msg = new Message(Message.TYPE_OPT,
+                LogPattenUtils.getProperty("ou.org.bmodule"),
+                LogPattenUtils.getProperty("ou.emp.fmodule"),
+                LogPattenUtils.getProperty("ou.emp.update"),
+                StrUtil.format(compareLog),
+                Message.STATUS_SUCESS);
+        logPostService.postLog(msg);
+    }
+    // ... 后续处理
+    return flag;
+}
+// 日志打印：[用户1:user1]编辑人员[测试人员:test1]:"姓名"由[测试人员]变更为[测试人员1]
+```
+
+---
+
+人员删除（delete）
+
+```java
+@RequestMapping("delete")
+@Operation(summary = "删除人员信息", description = "删除人员信息")
+@ResponseBody
+public Map<String, String> removeEmp(@RequestParam Map param) {
+    long l = System.currentTimeMillis();
+    EmpListDto empListDto = new EmpListDto();
+    UserListDto userListDto = new UserListDto();
+    String idStr = param.get("ids").toString();
+    List<String> ids = Arrays.asList(StringUtils.split(idStr, ","));
+
+    // ... 获取删除前的人员信息用于同步
+
+    Map<String, String> map = service.deleteEmp(param);
+
+    // 构建删除日志内容
+    String message = empList.stream()
+            .map(e -> String.format("[%s:%s]", e.getName(), e.getCode()))
+            .collect(Collectors.joining(","));
+
+    if ("true".equals(map.get("result"))) {
+        Message msg = new Message(Message.TYPE_OPT,
+                LogPattenUtils.getProperty("ou.org.bmodule"),
+                LogPattenUtils.getProperty("ou.emp.fmodule"),
+                LogPattenUtils.getProperty("ou.emp.delete"),
+                StrUtil.format(LogPattenUtils.getProperty("ou.emp.delete.message"), message),
+                Message.STATUS_SUCESS);
+        msg.setEndTime(System.currentTimeMillis());
+        msg.setStartTime(l);
+        msg.setOperationType("delete");
+        logPostService.postLog(msg);
+    }
+    return map;
+}
+// 日志打印：[用户1:user1]删除人员[测试人员1:test1]
+```
+
+---
+
+使用 @LogOperation 注解自动记录时间
+
+```java
+@RequestMapping(value = "/add", method = RequestMethod.POST)
+@Operation(summary = "新增调度任务", description = "新增调度任务")
+@LogOperation(type = "add")
+@ResponseBody
+public ReturnT<String> add(@Parameter(name = "调度任务对象", required = true) @Valid CloudJobInfo jobInfo) {
+    Message msg = new Message(Message.TYPE_OPT,
+            LogPattenUtils.getProperty("job.job-info.bmodule"),
+            LogPattenUtils.getProperty("job.job-info.fmodule"),
+            LogPattenUtils.getProperty("job.job-info.add"),
+            StrUtil.format(LogPattenUtils.getProperty("job.job-info.add.message"), jobInfo.getJobDesc()),
+            Message.STATUS_SUCESS);
+    // 可选：若不设置，@LogOperation中会自行设置
+    msg.setStartTime(System.currentTimeMillis());
+    msg.setEndTime(System.currentTimeMillis());
+    logPostService.postLog(msg);
+    return CloudJobService.add(jobInfo);
+}
+```
+
+##### 3.1.2 记录自定义日志
+
+方法：`POST /post-diy`
+
+入参：Message param
+
+返回：boolean
+
+使用场景：记录用户自定义日志，支持自定义日志类型和内容的灵活记录
+
+示例：
+```java
+@Autowired
+private ILogPostService logPostService;
+
+private void postLoginLog(User user,Long startTime) {
+        Long executeTime = 0L;
+        if(startTime !=null){
+            executeTime = System.currentTimeMillis()-startTime;
+        }
+        Message msg = new Message(Message.TYPE_LOGOUT,
+                LogPattenUtils.getProperty("common.basic.bmodule"),
+                LogPattenUtils.getProperty("common.logout.fmodule"),
+                LogPattenUtils.getProperty("common.logout.fmodule"),
+                StrUtil.format(LogPattenUtils.getProperty("common.loginout.user")),
+                Message.STATUS_SUCESS);
+        msg.setIp(user.getLoginIp());
+        msg.setFullname(user.getUsername());
+        msg.setUserid(user.getUserId());
+        msg.setTenantId(user.getTenantId());
+        msg.setGrade(user.getGrade());
+        msg.setCode(user.getCode());
+        msg.setOperationType("loginOut");
+        msg.setExecuteTime(executeTime);
+        logPostService.postDiyLog(msg);
+    }
+```
+
+---
+
+
+
+### 3.2 外部接口-详细参考技术共享中心文档《外部接口清单》
+
+**详细说明**：请参考技术共享中心文档《外部接口清单》
+
+---
+
+### 3.3 会话信息获取
+
+#### 3.3.1 SessionUtils会话工具类
+
+完整包路径：`com.meritdata.cloud.utils.SessionUtils`
+
+会话工具类，获取当前登录用户的相关信息
+
+##### 3.3.1.1 获取当前登录用户的用户ID
+
+方法：`getUserId()`
+
+入参：无
+
+返回：String (pf_user_info表的id字段)
+
+使用场景：获取当前登录用户的ID
+
+示例：`String userId = sessionUtils.getUserId();`
+
+##### 3.3.1.2 获取当前登录用户的用户名
+
+方法：`getUserName()` / `getCurrentUserName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户的用户名
+
+示例：`String userName = sessionUtils.getUserName();`
+
+##### 3.3.1.3 获取当前登录用户的人员ID
+
+方法：`getEmpId()`
+
+入参：无
+
+返回：String (pf_org_user表的id字段)
+
+使用场景：获取当前登录人员的ID
+
+示例：
+```java
+@Autowired
+private SessionUtils sessionUtils;
+
+String empId = sessionUtils.getEmpId();
+```
+
+##### 3.3.1.4 获取当前登录用户的人员姓名
+
+方法：`getEmpName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户的人员姓名
+
+示例：
+```java
+String empName = sessionUtils.getEmpName();
+```
+
+##### 3.3.1.5 获取当前登录用户的人员编号
+
+方法：`getEmpCode()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录人员的人员编号
+
+示例：
+```java
+String empCode = sessionUtils.getEmpCode();
+```
+
+##### 3.3.1.6 获取当前登录用户所属部门的部门ID
+
+方法：`getDeptId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属部门的部门ID
+
+示例：
+```java
+String deptId = sessionUtils.getDeptId();
+```
+
+##### 3.3.1.7 获取当前登录用户所属部门的部门编码
+
+方法：`getDeptCode()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属部门的部门编码
+
+示例：
+```java
+String deptCode = sessionUtils.getDeptCode();
+```
+
+##### 3.3.1.8 获取当前登录用户所属部门的部门名称
+
+方法：`getDeptName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属部门的部门名称
+
+示例：
+```java
+String deptName = sessionUtils.getDeptName();
+```
+
+##### 3.3.1.9 获取当前登录用户所属部门的部门对象
+
+方法：`getDept()`
+
+入参：无
+
+返回：Organization
+
+使用场景：获取当前登录用户所属部门的部门对象
+
+示例：
+```java
+Organization dept = sessionUtils.getDept();
+String deptId = dept.getId();
+String deptName = dept.getName();
+```
+
+##### 3.3.1.10 获取当前登录用户所属组织的组织ID
+
+方法：`getOrgId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属组织的组织ID
+
+示例：
+```java
+String orgId = sessionUtils.getOrgId();
+```
+
+##### 3.3.1.11 获取当前登录用户所属组织的组织名称
+
+方法：`getOrgName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属组织的组织名称
+
+示例：
+```java
+String orgName = sessionUtils.getOrgName();
+```
+
+##### 3.3.1.12 获取当前登录用户所属组织的组织层级编码
+
+方法：`getOrgDlevelCode()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前组织的层级编码
+
+示例：
+```java
+String dlevelCode = sessionUtils.getOrgDlevelCode();
+```
+
+##### 3.3.1.13 获取当前登录用户所属组织的根组织ID
+
+方法：`getRootOrgId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取根组织ID
+
+示例：
+```java
+String rootOrgId = sessionUtils.getRootOrgId();
+```
+
+##### 3.3.1.14 获取当前登录用户所属组织的根组织对象
+
+方法：`getRootOrg()`
+
+入参：无
+
+返回：Organization
+
+使用场景：获取当前登录用户所属组织的根组织对象
+
+示例：
+```java
+Organization rootOrg = sessionUtils.getRootOrg();
+String rootOrgName = rootOrg.getName();
+```
+
+##### 3.3.1.15 获取当前登录用户的系统角色编码列表
+
+方法：`getSysRoleCodes()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的系统角色编码列表
+
+示例：
+```java
+List<String> sysRoleCodes = sessionUtils.getSysRoleCodes();
+for (String roleCode : sysRoleCodes) {
+    System.out.println("系统角色: " + roleCode);
+}
+```
+
+##### 3.3.1.16 获取当前登录用户的角色编码列表
+
+方法：`getRoleCodes()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的所有角色编码
+
+示例：
+```java
+List<String> roleCodes = sessionUtils.getRoleCodes();
+```
+
+##### 3.3.1.17 获取当前登录用户的角色名称列表
+
+方法：`getRoleNames()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的所有角色名称
+
+示例：
+```java
+List<String> roleNames = sessionUtils.getRoleNames();
+```
+
+##### 3.3.1.18 获取当前登录用户的权限ID列表
+
+方法：`getAuthoritiesIds()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的所有权限ID
+
+示例：
+```java
+List<String> authoritiesIds = sessionUtils.getAuthoritiesIds();
+```
+
+##### 3.3.1.19 获取当前登录用户所属的租户ID
+
+方法：`getTenantId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前用户所属租户ID
+
+示例：
+```java
+String tenantId = sessionUtils.getTenantId();
+```
+
+##### 3.3.1.20 获取当前登录用户的当前登录IP
+
+方法：`getCurrentLoginIp()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前用户的当前登录IP
+
+示例：
+```java
+String loginIp = sessionUtils.getCurrentLoginIp();
+```
+
+##### 3.3.1.21 获取当前登录用户的整个用户对象
+
+方法：`getPrincipal()`
+
+入参：无
+
+返回：User
+
+使用场景：获取当前用户的整个用户对象
+
+示例：`User user = sessionUtils.getPrincipal();`
+
+---
+
+#### 3.3.2. IUserOnlineTime 在线用户服务
+
+完整包路径：`com.meritdata.cloud.security.sso.IUserOnlineTime`
+
+Feign客户端接口，用于在线用户相关操作，包括踢出用户、记录登录登出时间等。
+
+##### 3.3.2.1 踢出在线用户
+
+方法：getOutOnlineByUserNames
+
+接口路径：`POST /api/basic/online-account/getOutOnlineByUserNames`
+
+接口说明：批量踢出指定用户名的在线用户，清除其所有会话信息
+
+请求参数：
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| userNames | String | 是 | 用户名，多个用逗号分隔 |
+
+返回结果：`ResultBody` 结果集
+
+日志记录：操作类型为 `loginOut`，记录每个被踢出用户信息
+
+**使用示例**：
+
+```java
+@Autowired
+private IUserOnlineTime iUserOnlineTime;
+
+// 踢出单个用户
+iUserOnlineTime.getOutOnlineByUserNames(userName);
+
+// 踢出多个用户
+iUserOnlineTime.getOutOnlineByUserNames("user1,user2,user3");
+```
+
+---
+
+### 3.4 多系统集成
+
+**详细参考**：应用开发平台-基础平台-使用攻略（三）：组织和人员同步.md
+
+基于 WebService 和 RESTful API 的组织、人员、资源、角色、权限同步功能，支持外部系统数据接入。
+
+#### 3.4.1 WebService同步接口
+
+WebService 地址格式：`http://网关地址/应用名称/ws/{服务名}?wsdl`
+
+| 服务名 | 方法名 | 参数 | 返回值 | 说明 | 使用场景 |
+|--------|--------|------|--------|------|----------|
+| syncOrgWebService | syncOrg | xml字符串 | "1"成功/"0"失败 | 组织同步 | 外部HR系统同步组织架构到平台 |
+| syncUserWebService | syncUser | xml字符串 | "1"成功/"0"失败 | 人员同步 | 外部系统同步人员信息（入职、离职、调动） |
+| syncResourceWebService | syncResource | xml字符串 | "1"成功/"0"失败 | 资源同步 | 同步菜单、资源、按钮等权限数据 |
+| syncRoleWebService | syncRole | xml字符串 | "1"成功/"0"失败 | 角色同步 | 同步角色数据到平台 |
+| syncAssignWebService | syncAssign | xml字符串 | "1"成功/"0"失败 | 权限同步 | 同步人员-角色、资源-角色分配关系 |
+
+**完整包路径**：`com.meritdata.cloud.system.manager.ou.sync.ws.impl`
+
+#### 3.4.2 RESTful API同步接口
+
+完整包路径：`com.meritdata.cloud.system.manager.ou.sync.controller.WebApiSyncController`
+
+基础路径：`/webapi/ou/sync`
+
+| 接口路径 | 方法 | 参数 | 说明 | 使用场景 |
+|----------|------|------|------|----------|
+| /webapi/ou/sync/org | POST | orgInfo (xml字符串) | 组织同步 | 外部系统通过REST API同步组织数据 |
+| /webapi/ou/sync/user | POST | userInfo (xml字符串) | 人员同步 | 外部系统通过REST API同步人员数据 |
+| /webapi/ou/sync/resource | POST | resourceInfo (xml字符串) | 资源同步 | 外部系统同步菜单资源数据 |
+| /webapi/ou/sync/role | POST | roleInfo (xml字符串) | 角色同步 | 外部系统同步角色数据 |
+| /webapi/ou/sync/duty | POST | dutyInfo (xml字符串) | 职务同步 | 外部系统同步职务数据 |
+| /webapi/ou/sync/assign | POST | assignInfo (xml字符串) | 权限同步 | 外部系统同步权限分配数据 |
+
+**注意**：调用RESTful API需要在请求Header中携带app-key和app-token进行认证。
+
+---
+
+### 3.5 数据密级过滤
+
+数据密级过滤是基于 Hibernate `@Filter` 实现的行级数据访问控制机制，通过在实体类上标注 `@EnableDataSecretFilter` 注解，自动拦截并过滤用户可访问的数据范围。
+
+#### EnableDataSecretFilter 注解
+
+**使用说明**：
+
+在需要进行数据密级过滤的实体类或方法上添加 `@EnableDataSecretFilter` 注解，`DataSecretInterceptor` 拦截器会自动启用 Hibernate 的 `secretDataFilter`，根据当前用户的密级过滤高于当前用户密级的数据，只能看低于或等于其密级的数据。
+
+**使用示例**：
+
+```java
+// 标注在方法上
+@LogOperation(type = "select")
+@EnableDataSecretFilter
+public List<Emp> selectEmpList() {
+    return empRepository.findAll();
+}
+```
+
+
+### 3.6 服务通知
+
+#### 3.6.1 租户同步
+
+**使用场景**：创建租户时，同步信息给二开服务
+
+##### 3.6.1.1 动态FeignClient构建
+
+完整包路径：`com.meritdata.cloud.feignclient.DynamicCloudFeignClient`
+
+方法：`getFeignClient(serviceName, type)`
+
+入参：String serviceName, Class<T> type
+
+返回：T (泛型FeignClient)
+
+使用场景：根据服务名称动态获取FeignClient，用于调用二开服务的接口
+
+**Nacos配置**：
+```properties
+meritdata.cloud.sync-tenancy-receiver: cloud-system-demo  # 二开服务名称，多个服务用逗号分隔
+```
+
+##### 3.6.1.2 租户同步发送
+
+完整包路径：`com.meritdata.cloud.system.manager.ou.tenancy.dynsync.CloudTenancySync`
+
+方法：`syncAdd(Tenancy tenancy)`
+
+入参：Tenancy tenancy
+
+返回：ResultBody<String>
+
+使用场景：当新建租户时，平台异步向已配置的二开服务发送租户同步消息
+
+**Nacos配置**：
+```properties
+meritdata.cloud.sync-tenancy-receiver: cloud-system-demo1,cloud-system-demo2  # 多个服务用逗号分隔
+```
+
+##### 3.6.1.3 租户同步接收
+
+完整包路径：`com.meritdata.cloud.system.manager.ou.tenancy.dynsync.CloudTenancySync`
+
+方法：`POST /api/tenancy/sync/add`
+
+入参：Tenancy tenancy
+
+返回：ResultBody<String>
+
+使用场景：二开服务实现租户同步接收接口，接收平台发送的租户信息
+
+**二开服务实现示例**：
+```java
+/**
+ * 二开服务实现租户同步接收接口
+ */
+@RestController
+@RequestMapping("/api/tenancy/sync")
+public class TenancySyncReceiver {
+
+    @PostMapping("/add")
+    public ResultBody<String> syncAdd(@RequestBody Tenancy tenancy) {
+        log.info("收到租户同步消息: {}", tenancy);
+        // 创建租户专属数据空间、初始化租户配置等
+        return ResultBody.success("同步成功");
+    }
+}
+```
+
+---
+
+#### 3.6.2 用户权限同步
+
+**使用场景**：用户、角色、权限变更时，发送消息通知订阅的二开服务
+
+**Nacos配置**：
+```properties
+meritdata.cloud.sync-cloud-data-application-name: cloud-system-demo  # 订阅消息的二开服务名称
+```
+
+**公共消息体 MessageBody 字段说明**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| tid | String | 租户ID |
+| theme | String | 消息主题（ROLE/RESOURCE/USER_ROLE/ASSIGN） |
+| data | List | 消息数据列表（RoleMessage/ResourceMessage/RoleUserMessage/AssignMessage） |
+
+##### 3.6.2.1 发送角色变更消息
+
+完整包路径：`com.meritdata.cloud.feignclient.CloudFeignMessageClient`
+
+方法：`sendRoleMessage(MessageBody messageBody)`
+
+入参：MessageBody（data为List<RoleMessage>）
+
+返回：boolean
+
+使用场景：角色信息变更时，发送消息通知相关系统
+
+**角色消息（RoleMessage）字段说明**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | String | 角色ID |
+| deptId | String | 部门ID |
+| deptCode | String | 部门编码 |
+| code | String | 角色编码 |
+| name | String | 角色名称 |
+| type | Integer | 角色类型 |
+| application | String | 产品名称 |
+| operation | String | 操作：add新增、update更新、del删除 |
+| timeStamp | String | 时间戳 |
+
+**二开服务接收示例**：
+
+```java
+@PostMapping("/send-role-message")
+public boolean sendRoleMessage(@RequestBody MessageBody messageBody) {
+    List<RoleMessage> roleList = (List<RoleMessage>) messageBody.getData();
+    for (RoleMessage role : roleList) {
+        String operation = role.getOperation();  // add/update/del
+        String roleCode = role.getCode();
+        String roleName = role.getName();
+    }
+    return true;
+}
+```
+
+##### 3.6.2.2 发送资源变更消息
+
+方法：`sendResourceMessage(MessageBody messageBody)`
+
+入参：MessageBody（data为List<ResourceMessage>）
+
+返回：boolean
+
+使用场景：资源（菜单）信息变更时，发送消息通知相关系统
+
+**资源消息（ResourceMessage）字段说明**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | String | 资源ID |
+| parentId | String | 父资源ID |
+| type | String | 类型：0模块、1菜单、2组件、4分组 |
+| name | String | 资源名称 |
+| url | String | 菜单路由 |
+| embedUrl | String | 嵌入URL |
+| application | String | 产品名称 |
+| sort | Integer | 排序 |
+| iconPath | String | 图标路径 |
+| operation | String | 操作：add新增、update更新、del删除 |
+| timeStamp | String | 时间戳 |
+
+**二开服务接收示例**：
+
+```java
+@PostMapping("/send-resource-message")
+public boolean sendResourceMessage(@RequestBody MessageBody messageBody) {
+    List<ResourceMessage> resourceList = (List<ResourceMessage>) messageBody.getData();
+    for (ResourceMessage resource : resourceList) {
+        String operation = resource.getOperation();  // add/update/del
+        String type = resource.getType();            // 0模块/1菜单/2组件/4分组
+        String url = resource.getUrl();              // 菜单路由
+    }
+    return true;
+}
+```
+
+##### 3.6.2.3 发送用户角色变更消息
+
+方法：`sendUserRoleMessage(MessageBody messageBody)`
+
+入参：MessageBody（data为List<RoleUserMessage>）
+
+返回：boolean
+
+使用场景：用户角色分配变更时，发送消息通知相关系统
+
+**用户角色消息（RoleUserMessage）字段说明**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| userId | String | 用户ID |
+| userCode | String | 用户编码 |
+| roleCode | String | 角色编码 |
+| operation | String | 操作：add新增、del删除 |
+| timeStamp | String | 时间戳 |
+
+**二开服务接收示例**：
+
+```java
+@PostMapping("/send-user-role-message")
+public boolean sendUserRoleMessage(@RequestBody MessageBody messageBody) {
+    List<RoleUserMessage> userRoleList = (List<RoleUserMessage>) messageBody.getData();
+    for (RoleUserMessage userRole : userRoleList) {
+        String operation = userRole.getOperation();  // add/del
+        String userId = userRole.getUserId();
+        String roleCode = userRole.getRoleCode();
+    }
+    return true;
+}
+```
+
+##### 3.6.2.4 发送权限分配变更消息
+
+方法：`sendAssignMessage(MessageBody messageBody)`
+
+入参：MessageBody（data为List<AssignMessage>）
+
+返回：boolean
+
+使用场景：权限分配变更时，发送消息通知相关系统
+
+**权限分配消息（AssignMessage）字段说明**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| resourceId | String | 资源ID |
+| type | String | 授权类型：3按机构、4按角色、6按人员 |
+| code | String | 角色编码或机构编码 |
+| url | String | 菜单路由 |
+| application | String | 产品名称 |
+| operation | String | 操作：add新增、del删除 |
+| timeStamp | String | 时间戳 |
+
+**二开服务接收示例**：
+
+```java
+@PostMapping("/send-assign-message")
+public boolean sendAssignMessage(@RequestBody MessageBody messageBody) {
+    List<AssignMessage> assignList = (List<AssignMessage>) messageBody.getData();
+    for (AssignMessage assign : assignList) {
+        String operation = assign.getOperation();  // add/del
+        String type = assign.getType();            // 3按机构/4按角色/6按人员
+        String resourceId = assign.getResourceId();
+    }
+    return true;
+}
+```
+
+---
+
+#### 3.6.3 服务通知二开接口
+
+**使用场景**：平台端用户、组织、人员等变更时，通知二开服务进行相应处理
+
+##### 3.6.3.1 用户新增通知
+
+完整包路径：`com.meritdata.cloud.system.manager.ou.user.controller.IUserPortalService`
+
+FeignClient接口：`POST /user-add`
+
+入参：User user
+
+返回：void
+
+**Nacos配置（二开服务）**：
+```properties
+meritdata.cloud.user-customization-extension-application-name: cloud-system-demo  # 二开服务名，平台端调用
+```
+
+**二开服务实现**：
+```java
+@PostMapping("/user-add")
+public void userAdd(@RequestBody User user) {
+    // 处理用户新增逻辑
+}
+```
+
+##### 3.6.3.2 用户编辑通知
+
+方法：`POST /user-update`
+
+入参：User user
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/user-update")
+public void userUpdate(@RequestBody User user) {
+    // 处理用户编辑逻辑
+}
+```
+
+##### 3.6.3.3 用户删除通知
+
+方法：`POST /user-remove`
+
+入参：UserListDto userListDto
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/user-remove")
+public void userRemove(@RequestBody UserListDto userListDto) {
+    // 处理用户删除逻辑
+}
+```
+
+##### 3.6.3.4 初始化密码通知
+
+方法：`POST /resetPass`
+
+入参：User user
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/resetPass")
+public void resetPass(@RequestBody User user) {
+    // 处理初始化密码逻辑
+}
+```
+
+##### 3.6.3.5 修改密码通知
+
+方法：`POST /changePass`
+
+入参：User user
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/changePass")
+public void changePass(@RequestBody User user) {
+    // 处理修改密码逻辑
+}
+```
+
+##### 3.6.3.6 组织新增通知
+
+完整包路径：`com.meritdata.cloud.system.manager.ou.org.controller.IOrgPortalService`
+
+FeignClient接口：`POST /api/ou/org/create`
+
+入参：Organization org
+
+返回：void
+
+**Nacos配置（二开服务）**：
+```properties
+meritdata.cloud.org-emp-customization-extension-application-name: cloud-system-demo  # 二开服务名
+```
+
+**二开服务实现**：
+```java
+@PostMapping("/api/ou/org/create")
+public void orgAdd(@RequestBody Organization org) {
+    // 处理组织新增逻辑
+}
+```
+
+##### 3.6.3.7 组织修改通知
+
+方法：`POST /api/ou/org/update`
+
+入参：Organization org
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/api/ou/org/update")
+public void orgUpdate(@RequestBody Organization org) {
+    // 处理组织修改逻辑
+}
+```
+
+##### 3.6.3.8 组织删除通知
+
+方法：`POST /api/ou/org/delete`
+
+入参：OrgListDto orgListDto
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/api/ou/org/delete")
+public void orgRemove(@RequestBody OrgListDto orgListDto) {
+    // 处理组织删除逻辑
+}
+```
+
+##### 3.6.3.9 人员新增通知
+
+方法：`POST /emp-add`
+
+入参：Emp emp
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/emp-add")
+public void empAdd(@RequestBody Emp emp) {
+    // 处理人员新增逻辑
+}
+```
+
+##### 3.6.3.10 人员修改通知
+
+方法：`POST /emp-update`
+
+入参：Emp emp
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/emp-update")
+public void empUpdate(@RequestBody Emp emp) {
+    // 处理人员修改逻辑
+}
+```
+
+##### 3.6.3.11 人员删除通知
+
+方法：`POST /emp-delete`
+
+入参：EmpListDto empListDto
+
+返回：void
+
+**二开服务实现**：
+```java
+@PostMapping("/emp-delete")
+public void empRemove(@RequestBody EmpListDto empListDto) {
+    // 处理人员删除逻辑
+}
+```
+
+---
+
+## 四、业务组件
+
+### 4.1 工作流组件-详细参考：应用开发平台-流程管理-使用攻略（一)：流程API接口.md 
+
+基于 Camunda BPM 7.21.0 的工作流引擎，所有对外接口均通过 `BpmEngine` 提供。
+
+**二开服务使用方式**：通过 `@Autowired` 注入 `BpmEngine`，直接调用其方法。
+
+```
+@Autowired
+private BpmEngine bpmEngine;
+```
+
+方法概览表：
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | processRetfirnode | 退回拟稿人 | 退回流程至拟稿人（流程起点） |
+| BpmEngine | processRetprenode | 退回上一环节 | 退回流程至上一环节处理人 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+| BpmEngine | getOpinions | 审批意见 | 获取流程审批意见列表 |
+| BpmEngine | addOrUpdate | 填写意见 | 在节点填写审批意见 |
+| BpmEngine | getUndoPage | 个人待办列表 | 获取当前用户的待办任务列表 |
+
+**重要变量说明**：
+
+| 变量名 | 类型 | 说明 | 示例值 |
+|--------|------|------|--------|
+| businessId | String | 业务ID（唯一标识业务数据） | "3f28824f77d7e9a60177d8110b670002" |
+| procDefKey | String | 流程定义Key（在BPMN文件中定义） | "Process_Demo1" |
+| procInstId | String | 流程实例ID（启动后生成） | "57f63abb-74b1-11eb-bd66-00d861edd189" |
+| taskId | String | 任务ID（当前待办任务） | "9f2c6791-7748-11eb-90ec-00d861edd189" |
+| taskDefKey | String | 任务节点定义Key | "Activity_0vjczzn" |
+| procDefId | String | 流程定义ID（包含版本信息） | "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189" |
+| bpmOperValue | String | 操作按钮值（对应流程配置） | "bpmSendBtn"、"bpmRetfirnodeBtn" |
+| bpmOperName | String | 操作按钮名称 | "发送"、"退回" |
+| approve[type] | String | 审批方式 | "onlyApprove"（唯一审批）、"anyApprove"（或签）、"paraApprove"（会签）、"seqApprove"（顺序审批） |
+
+**组合场景表**：
+
+| 场景 | 使用场景 | 详细参考 |
+|------|----------|----------|
+| 流程API接口 | 了解BpmEngine提供的所有API接口，包括启动流程、完成任务、查询实例等 | 应用开发平台-流程管理-使用攻略（一）：流程API接口.md |
+| 工作流程应用开发 | 基于差旅费报销等业务场景，学习如何创建后端工程、配置流程、设计表单、集成前后端 | 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md |
+| 监听表达式开发 | 开发自定义监听器jar包，实现流程监听表达式，在流程事件触发时执行自定义业务逻辑 | 应用开发平台-流程管理-使用攻略（三）：监听表达式开发.md |
+| 自定义人员 | 配置自定义人员选择器，通过后端接口动态返回流程下一环节的处理人 | 应用开发平台-流程管理-使用攻略（四）：自定义人员.md |
+| 待办同步门户开发 | 将流程产生的待办信息同步到其他门户页面处理，支持Portal和RTX两种方式 | 应用开发平台-流程管理-使用攻略（五）：待办同步门户开发.md |
+| 流程追踪页面嵌入表单 | 将流程追踪页面（文字追踪、图表追踪、审批意见）嵌入到自定义表单页面中 | 应用开发平台-流程管理-使用攻略（六）：流程追踪页面嵌入表单开发.md |
+| 流程模块设计 | 了解流程模块的整体设计思路、架构组成和业务逻辑 | 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md |
+
+---
+
+### 4.2 调度组件-**详细可参考：应用开发平台-基础平台-使用攻略（十三）：调度编排二开说明.md**
+
+基于 Taier 调度平台（基于 DolphinScheduler）的任务调度引擎，所有对外接口均通过 `ICloudClient` 提供。
+
+**二开服务使用方式**：通过 `@Autowired` 注入 `ICloudClient`，直接调用其方法。
+
+```java
+@Autowired
+private ICloudClient cloudClient; 
+```
+
+方法概览表
+
+| 方法名 | 作用场景 | 说明 |
+|--------|----------|------|
+| submit | 提交任务 | 外部系统向调度平台提交任务执行 |
+| status | 获取任务状态 | 查询任务的执行状态 |
+| log | 获取任务日志 | 获取任务的执行日志 |
+| getTaskList | 获取任务列表 | 分页查询任务列表 |
+| getParamList | 获取任务参数列表 | 获取任务的参数配置列表 |
+| cancelJob | 取消任务 | 取消正在执行或等待执行的任务 |
+| getScheduleStatus | 获取调度状态 | 获取业务系统的任务是否在被编排 |
+| createFlowAndTask | 创建流程和任务 | 创建工作流和任务 |
+| frozenTask | 冻结任务 | 冻结或解冻任务 |
+| getTaskListBySyncId | 根据同步ID获取任务列表 | 根据同步ID获取任务列表 |
+| queryLastJobLogBySyncId | 查询最近任务日志 | 根据同步ID查询最近的任务执行日志 |
+| queryLastJobStatusBySyncId | 查询最近任务状态 | 根据同步ID查询最近的任务执行状态 |
+
+---
+
+
+### 4.3 定时任务-**详细方法说明请参考**：应用开发平台-基础平台-使用攻略（五)：定时调度任务.md
+
+基于 XXL-JOB 的分布式任务调度引擎，所有对外接口均通过 `IJobApi` 提供。
+
+**二开服务使用方式**：通过 `@Autowired` 注入 `IJobApi`，直接调用其方法。
+
+```java
+@Autowired
+private IJobApi webServerJobService;
+```
+
+方法概览表
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| webServerJobService | getJob | 获取任务信息 | 根据任务ID获取单个调度任务的详情 |
+| webServerJobService | pageList | 获取任务信息列表 | 分页查询调度任务列表 |
+| webServerJobService | triggerJob | 执行调度任务 | 手动触发任务立即执行 |
+| webServerJobService | startJob | 启动调度任务 | 启动一个已停止的调度任务 |
+| webServerJobService | stopJob | 停止调度任务 | 停止一个运行中的调度任务 |
+| webServerJobService | add | 新增调度任务 | 新增一个定时调度任务 |
+| webServerJobService | update | 更新调度任务 | 更新已存在的调度任务 |
+| webServerJobService | remove | 删除调度任务 | 删除指定的调度任务 |
+| webServerJobService | getByAppName | 根据应用名获取执行器 | 根据应用名获取执行器信息 |
+| webServerJobService | getHandlerList | 根据handler获取任务列表 | 根据执行器名称获取关联的任务列表 |
+| webServerJobService | getHandlerAndGroup | 根据handler和执行器获取job | 根据执行器名称和执行器组ID获取任务信息 |
+
+
+
+## 五、前端资产
+
+### 5.1 UI组件库
+
+#### 全局安装方式
+
+```javascript
+// cloud-module-base 全局安装
+import base from 'cloud-module-base';
+Vue.use(base);
+
+// cloud-module-bpm 全局安装
+import bpm from 'cloud-module-bpm';
+Vue.use(bpm);
+```
+
+---
+
+#### cloud-module-base 公共组件
+
+##### 5.1.1 通用对话框组件 (CloudDialog)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/cloud-dialog/cloud-dialog.vue`
+
+**功能说明**: 平台通用对话框组件，支持标题定制、密级标签提示、异步关闭控制等特性。
+
+**导入方式**:
+```javascript
+import cloudDialog from 'cloud-module-base/packages/cloud-dialog';
+Vue.component(cloudDialog.name, cloudDialog);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| visible | Boolean | null | 控制对话框显示/隐藏，支持 .sync 或 v-model 双向绑定 |
+| title | String | '' | 对话框主标题文本 |
+| tip | String/null | null | 强制指定的密级标签提示 |
+| beforeClose | Function | null | 自定义关闭前钩子，用于异步关闭控制 |
+| showSecretLabel | Boolean | true | 是否显示密级标签区域 |
+
+**Events 事件**:
+- `open` - 对话框打开时触发
+- `close` - 对话框关闭时触发
+- `opened` - 对话框打开动画完成时触发
+- `closed` - 对话框关闭动画完成时触发
+
+**Slots 插槽**:
+- `title` - 自定义标题区域
+- `secretTip` - 密级标签插槽
+- `default` - 对话框内容区
+- `footer` - 对话框底部
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-bpm/src/pages/procdesigner/view/ConfigDialog.vue -->
+<cloud-dialog
+  :title="titleconfig"
+  :visible.sync="dialogVisible"
+  width="600px"
+  top="8vh"
+  :before-close="handleClose"
+  @open="onOpen"
+  :close-on-click-modal="false"
+  append-to-body
+>
+  <div>对话框内容区域</div>
+  <template #footer>
+    <el-button @click="dialogVisible = false">取消</el-button>
+    <el-button type="primary" @click="handleConfirm">确定</el-button>
+  </template>
+</cloud-dialog>
+```
+
+**常用Props**:
+| 属性名 | 类型 | 说明 |
+|--------|------|------|
+| visible.sync | Boolean | 控制对话框显示/隐藏 |
+| title | String | 对话框标题 |
+| width | String | 宽度，如 "600px", "800px", "1030px" |
+| top | String | 距顶部距离，如 "8vh", "2vh" |
+| before-close | Function | 关闭前回调，可用于异步关闭控制 |
+| close-on-click-modal | Boolean | 点击遮罩是否关闭 |
+| append-to-body | Boolean | 是否插入到body |
+
+---
+
+##### 5.1.2 用户选择组件 (UserSelect)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/user-select/UserSelect.vue`
+
+**功能说明**: 人员选择对话框组件，支持组织机构、角色，工作组等多种选人模式。
+
+**导入方式**:
+```javascript
+import userSelect from 'cloud-module-base/packages/user-select';
+Vue.component(userSelect.name, userSelect);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| dialogVisible | Boolean | true | 控制对话框显示/隐藏 |
+| options | Object | false | 配置选项 |
+| showSecretLabel | Boolean | false | 是否显示密级标签 |
+
+**options 配置项**:
+| 属性名 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| title | String | 'base.user_select.title' | 对话框标题 |
+| selectType | String | 'org' | 选人模式：org/role/workgroup/category |
+| orgUrl | String | '/cloud-system-manage/api/ou/org/tree' | 组织机构树接口 |
+| listUserByOrgIdUrl | String | '/cloud-system-manage/api/ou/emp/listEmp' | 人员列表接口 |
+| selectedUsers | Array | [] | 已选择的人员ID或编码集合 |
+| filterSwitch | Boolean | false | 是否过滤已选人员 |
+| userIds | Array | [] | 需要过滤的已选人员列表 |
+| isShowNoUser | Boolean | true | 是否过滤没有账户的人员 |
+
+**Events 事件**:
+- `dialog-save` - 确认选择时触发，返回选中的人员数据
+- `dialog-close` - 关闭对话框时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-bpm/src/pages/procdesigner/view/ConfigDialog.vue -->
+<!-- 人员选择弹窗 -->
+<user-select
+  :showSecretLabel="true"
+  :dialogVisible="dialogVisibleUser"
+  :options="optionsUser"
+  @dialog-close="dialogClose"
+  @dialog-save="dialogSaveUser"
+/>
+```
+
+```javascript
+// 对话框数据
+dialogVisibleUser: false,
+optionsUser: {
+  selectedUsers: []
+},
+
+// 打开人员选择对话框
+changePeop () {
+  this.dialogVisibleUser = true;
+  this.optionsUser.selectedUsers = this.formData.userConfigIds 
+    ? this.formData.userConfigIds.split(',') : [];
+},
+
+// 保存选择的人员
+dialogSaveUser (selectedUser) {
+  selectedUser = selectedUser || [];
+  let selectCodes = '';
+  let selectNames = '';
+  if (selectedUser.length > 0) {
+    let userName = [];
+    let userCode = [];
+    selectedUser.forEach(item => {
+      userName.push(item.name);
+      userCode.push(item.code);
+    });
+    selectNames = userName.join(',');
+    selectCodes = userCode.join(',');
+  }
+  this.formData.userConfigNames = selectNames;
+  this.formData.userConfigIds = selectCodes;
+  this.dialogVisibleUser = false;
+}
+```
+
+---
+
+##### 5.1.3 多用户选择组件 (UserSelectMulti)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/user-select-multi/UserSelect.vue`
+
+**功能说明**: 增强版多用户选择组件，支持组织、角色，工作组、职务等多种维度选择。
+
+**导入方式**:
+```javascript
+import userSelectMulti from 'cloud-module-base/packages/user-select-multi';
+Vue.component(userSelectMulti.name, userSelectMulti);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| dialogVisible | Boolean | true | 控制对话框显示/隐藏 |
+| options | Object | false | 配置选项 |
+| showSecretLabel | Boolean | false | 是否显示密级标签 |
+
+**options 配置项**:
+| 属性名 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| title | String | - | 对话框标题 |
+| selectType | String | 'all' | 选人模式：org/role/workgroup/category/duty/all |
+| selectedUsers | Array | [] | 已选择的人员 |
+| limit | Number | null | 选择人数限制 |
+| radioFlag | Boolean | false | 是否单选模式 |
+| threeMemberApply | Boolean | false | 是否三员申请模式 |
+
+**Events 事件**:
+- `dialog-save` - 确认选择时触发
+- `dialog-close` - 关闭对话框时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-schedule/src/pages/monitor/view/messageSubscribe.vue -->
+<!-- 人员选择器 -->
+<user-select-multi
+  :showSecretLabel="true"
+  :dialogVisible="editDialogVisible"
+  :options="options"
+  @dialog-close="editDialogClose"
+  @dialog-save="editDialogSave"
+/>
+```
+
+```javascript
+// 数据
+editDialogVisible: false,
+options: {
+  title: "人员选择",
+  selectedUsers: [],
+  secirtFlag: false
+},
+
+// 事件处理
+editDialogSave (selectedUsers) {
+  // selectedUsers 为选中的人员数组
+  console.log('选中人员', selectedUsers);
+  this.editDialogVisible = false;
+},
+editDialogClose () {
+  this.editDialogVisible = false;
+}
+```
+
+---
+
+##### 5.1.4 部门选择组件 (DeptSelect)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/dept-select/dept-select.vue`
+
+**功能说明**: 部门机构树选择对话框组件。
+
+**导入方式**:
+```javascript
+import deptSelect from 'cloud-module-base/packages/dept-select';
+Vue.component(deptSelect.name, deptSelect);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| dialogVisible | Boolean | true | 控制对话框显示/隐藏 |
+| options | Object | false | 配置选项 |
+| showSecretLabel | Boolean | false | 是否显示密级标签 |
+
+**options 配置项**:
+| 属性名 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| title | String | 'base.dept_select.title' | 对话框标题 |
+| treeUrl | String | '/api/ou/org/orgDeptTree' | 部门树接口 |
+| checkedIds | Array | [] | 默认选中的部门ID列表 |
+
+**Events 事件**:
+- `dialog-save` - 确认选择时触发，返回选中的部门节点数据
+- `dialog-close` - 关闭对话框时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-bpm/src/pages/procdesigner/view/ConfigDialog.vue -->
+<!-- 部门选择弹窗 -->
+<dept-select
+  :showSecretLabel="true"
+  :dialogVisible="dialogVisibleDept"
+  :options="optionsDept"
+  @dialog-close="dialogClose"
+  @dialog-save="dialogSaveDept"
+/>
+```
+
+```javascript
+// 数据
+dialogVisibleDept: false,
+optionsDept: {
+  checkedIds: []
+},
+
+// 打开部门选择对话框
+changeDep () {
+  this.dialogVisibleDept = true;
+  this.optionsDept.checkedIds = this.formData.deptConfigIds 
+    ? this.formData.deptConfigIds.split(',') : [];
+},
+
+// 保存选择的部门
+dialogSaveDept (selectedDept) {
+  selectedDept = selectedDept || [];
+  let selectCodes = '';
+  let selectNames = '';
+  if (selectedDept.length > 0) {
+    let deptName = [];
+    let deptCode = [];
+    selectedDept.forEach(item => {
+      deptName.push(item.name);
+      deptCode.push(item.code);
+    });
+    selectCodes = deptCode.join(',');
+    selectNames = deptName.join(',');
+  }
+  this.formData.deptConfigNames = selectNames;
+  this.formData.deptConfigIds = selectCodes;
+  this.dialogVisibleDept = false;
+}
+```
+
+---
+
+##### 5.1.5 角色选择组件 (RoleSelect)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/role-select/role-select.vue`
+
+**功能说明**: 角色树选择对话框组件。
+
+**导入方式**:
+```javascript
+import roleSelect from 'cloud-module-base/packages/role-select';
+Vue.component(roleSelect.name, roleSelect);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| dialogVisible | Boolean | true | 控制对话框显示/隐藏 |
+| options | Object | false | 配置选项 |
+| showSecretLabel | Boolean | false | 是否显示密级标签 |
+
+**options 配置项**:
+| 属性名 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| title | String | 'base.role_select.title' | 对话框标题 |
+| treeUrl | String | '/api/ou/org/orgRoleTree' | 角色树接口 |
+| checkedIds | Array | [] | 默认选中的角色ID列表 |
+
+**Events 事件**:
+- `dialog-save` - 确认选择时触发
+- `dialog-close` - 关闭对话框时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/us/workbench/view/workbench-base.vue -->
+<role-select
+  :dialogVisible="dialogVisibleRole"
+  :options="optionsRoles"
+  @dialog-close="dialogClose"
+  @dialog-save="dialogSaveRole"
+/>
+```
+
+```javascript
+// 数据
+dialogVisibleRole: false,
+optionsRoles: {
+  checkedIds: []
+},
+
+// 事件处理
+dialogSaveRole (selectedRoles) {
+  // selectedRoles 为选中的角色数组
+  console.log('选中角色', selectedRoles);
+  this.dialogVisibleRole = false;
+},
+dialogClose () {
+  this.dialogVisibleRole = false;
+}
+```
+
+---
+
+##### 5.1.6 导入按钮组件 (ImportButton)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/import-button/import-button.vue`
+
+**功能说明**: 数据导入按钮组件，支持下载模板、上传文件、导入验证等功能。
+
+**导入方式**:
+```javascript
+import importButton from 'cloud-module-base/packages/import-button';
+Vue.component(importButton.name, importButton);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| options | Object | true | 导入配置选项 |
+| isDisAble | Boolean | true | 是否禁用按钮 |
+
+**options 配置项**:
+| 属性名 | 类型 | 说明 |
+|--------|------|------|
+| applicationName | String | 应用名称 |
+| configId | String | 导入配置ID |
+| text | String | 按钮文本，默认'导入' |
+| rootOrgCode | String | 根组织编码 |
+| rootOrgId | String | 根组织ID |
+| rootDLevelCode | String | 密级编码 |
+
+**Events 事件**:
+- `requestGridData` - 导入完成或取消时触发，用于刷新列表
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/emp/view/Grid.vue -->
+<cloud-import-button
+  buttonCode="emp_import"
+  :disabled_custom="canShowImport"
+  :options="importOpts"
+  class="marL8"
+  @requestGridData="requestGridData"
+/>
+```
+
+```javascript
+// 导入配置
+importOpts: {
+  applicationName: 'cloud-system-manage',
+  configId: 'emp_import_config',
+  rootOrgCode: 'YRD',
+  rootOrgId: 'org-root-id',
+  rootDLevelCode: '3'
+},
+
+// 刷新列表
+requestGridData () {
+  this.queryGridData(); // 重新查询列表数据
+}
+
+// 控制按钮是否禁用
+canShowImport () {
+  // 根据权限或其他业务逻辑判断
+  return false; // false=启用, true=禁用
+}
+```
+
+---
+
+##### 5.1.7 菜单权限认证组件 (MenuAuth)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/authenticate/menu-auth.vue`
+
+**功能说明**: 页面权限控制组件，用于控制用户是否有页面访问权限。
+
+**导入方式**:
+```javascript
+import MenuAuth from 'cloud-module-base/packages/authenticate/menu-auth';
+Vue.component(MenuAuth.name, MenuAuth);
+```
+
+**使用示例**:
+```vue
+<menu-auth>
+  <div>需要权限才能显示的内容</div>
+</menu-auth>
+```
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/webapi/app/Index.vue -->
+<!-- 包裹整个页面布局，根据菜单权限控制访问 -->
+<menu-auth>
+  <el-container class="el-root-container">
+    <el-header height="50px">
+      <v-header />
+    </el-header>
+    <el-container class="el-main-container">
+      <el-aside>
+        <v-tree />
+      </el-aside>
+      <v-grid />
+    </el-container>
+  </el-container>
+</menu-auth>
+```
+
+---
+
+##### 5.1.8 资源代码授权组件 (ResourceCodeAuth)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/resource-code-auth/resource-code-auth.vue`
+
+**功能说明**: 基于资源代码的权限控制组件。
+
+**导入方式**:
+```javascript
+import resourceCodeAuth from 'cloud-module-base/packages/resource-code-auth';
+Vue.component(resourceCodeAuth.name, resourceCodeAuth);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| resourceCode | String | true | 资源代码 |
+| url | String | true | 请求授权验证的URL |
+
+**使用示例**:
+```vue
+<resource-code-auth
+  resourceCode="emp_export"
+  url="/api/authority/resource/resource-code-auth">
+  <el-button>导出</el-button>
+</resource-code-auth>
+```
+
+**工作原理**: 组件会调用 `/api/authority/resource/resource-code-auth` 接口进行权限验证，只有授权通过才显示插槽内容。
+
+---
+
+##### 5.1.9 三员授权组件 (ThreeMemberAuth)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/three-member-auth/three-member-auth.vue`
+
+**功能说明**: 三员权限控制组件，用于判断角色是否具有三员授权。
+
+**导入方式**:
+```javascript
+import threeMemberAuth from 'cloud-module-base/packages/three-member-auth';
+Vue.component(threeMemberAuth.name, threeMemberAuth);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| roleCode | String | true | 角色代码 |
+
+**使用示例**:
+```vue
+<three-member-auth roleCode="security_admin">
+  <el-button>安全管理</el-button>
+</three-member-auth>
+```
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/authority/system/view/role-grid.vue -->
+<!-- 多角色逗号分隔，只要满足任一角色即可显示 -->
+<three-member-auth role-code="XTGLY,AQGLY">
+  <el-button
+    :disabled="addDisabled"
+    type="primary"
+    @click="addBtnClick"
+  >{{ $t('base.button.add') }}</el-button>
+  <el-button
+    :disabled="isdisabled"
+    @click="deleteBtnClick"
+  >
+    {{ $t('base.button.delete') }}
+  </el-button>
+</three-member-auth>
+```
+
+---
+
+##### 5.1.10 表格头部搜索组件 (TableHeadSearch)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/components/tableHeadSearch.vue`
+
+**功能说明**: 表格列筛选组件，用于表头的筛选操作。
+
+**导入方式**:
+```javascript
+import tableHeadSearch from 'cloud-module-base/packages/components/tableHeadSearch';
+Vue.component(tableHeadSearch.name, tableHeadSearch);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| filedSearchName | String | - | 表头显示名称 |
+| showSelectFlag | Boolean | - | 是否显示选中标识 |
+| value / v-model | Boolean | false | popover显示状态 |
+| checkList.sync | Array | - | 选中列表 |
+| filterList | Array | - | 筛选数据列表 |
+
+**Events 事件**:
+- `findTypeList` - 确认筛选时触发
+- `resetTypeList` - 重置筛选时触发
+- `showList` - 显示列表时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/org/view/Grid.vue -->
+<template slot="header" slot-scope="scope">
+  <div v-if="field.code == 'dLevel'">
+    <table-head-search
+      ref="resetDLevelSearch"
+      filedSearchName="组织类型"
+      :showSelectFlag="dLevelSelectFlag"
+      v-model="showDLevelPopover"
+      :checkList.sync="dLevelLists"
+      :filterList="filterDLevelList"
+      @findTypeList="findDLevel"
+      @resetTypeList="resetDLevel"
+      @showList="resetDLevelModule"
+    ></table-head-search>
+  </div>
+  <div v-else-if="field.code == 'isAble'">
+    <table-head-search
+      ref="resetStatusSearch"
+      filedSearchName="状态"
+      :showSelectFlag="statusSelectFlag"
+      v-model="showStatusPopover"
+      :checkList.sync="statusLists"
+      :filterList="filterStatusList"
+      @findTypeList="findStatusList"
+      @resetTypeList="resetStatus"
+      @showList="resetStatusModule"
+    ></table-head-search>
+  </div>
+</template>
+
+<script>
+import TableHeadSearch from '@/components/tableHeadSearch';
+export default {
+  components: { TableHeadSearch },
+  data() {
+    return {
+      dLevelLists: [],
+      filterDLevelList: [
+        { code: '0', name: '机构' },
+        { code: '1', name: '部门' }
+      ]
+    };
+  }
+}
+</script>
+```
+
+---
+
+##### 5.1.11 二级鉴别密码验证弹窗 (VerifiyPassword)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/components/verifiy-password.vue`
+
+**功能说明**: 二级密码鉴别组件，用于安全验证。
+
+**导入方式**:
+```javascript
+import verifiyPassword from 'cloud-module-base/packages/components/verifiy-password';
+Vue.component(verifiyPassword.name, verifiyPassword);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| dialogFormVisible | Boolean | false | 对话框显示状态 |
+| title | String | '' | 对话框标题 |
+
+**Events 事件**:
+- `close` - 关闭对话框时触发
+- `define` - 验证通过确认时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/user/view/Grid.vue -->
+<template>
+  <verifiy-password
+    :title="title1"
+    :dialogFormVisible="jianquanVisible"
+    @close="dialogClose"
+    @define="handelConfirm"
+  ></verifiy-password>
+</template>
+
+<script>
+import verifiyPassword from '@/components/verifiy-password';
+export default {
+  components: { verifiyPassword },
+  data() {
+    return {
+      title1: '安全验证',
+      jianquanVisible: false,
+      buttonCode: ''
+    };
+  },
+  methods: {
+    handelConfirmJianquan() {
+      // 打开验证弹窗
+      this.jianquanVisible = true;
+    },
+    dialogClose() {
+      // 关闭验证弹窗
+      this.jianquanVisible = false;
+    },
+    handelConfirm() {
+      // 验证通过后的回调
+      this.jianquanVisible = false;
+      if (this.buttonCode === 'user_delete') {
+        this.handleDeletes();
+      } else if (this.buttonCode === 'user_enable') {
+        this.enableDept();
+      }
+      // ... 其他操作
+    },
+    triggerVerify(code) {
+      // 触发验证前记录操作码
+      this.buttonCode = code;
+      this.jianquanVisible = true;
+    }
+  }
+}
+</script>
+```
+
+---
+
+##### 5.1.12 通用头部组件 (CommonHeader)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/components/common-header.vue`
+
+**功能说明**: 通用页面头部组件，包含面包屑导航和密级标签显示。
+
+**导入方式**:
+```javascript
+import commonHeader from 'cloud-module-base/packages/components/common-header';
+Vue.component(commonHeader.name, commonHeader);
+```
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/tenancy/view/Dialog.vue -->
+<template>
+  <el-container>
+    <el-header height="50px">
+      <el-row>
+        <el-col :span="12">
+          <v-header></v-header>
+        </el-col>
+        <el-col :span="12" style="text-align:right;line-height:50px;">
+          <el-button type="primary" size="medium" @click="submitForm">
+            {{ $t('base.button.save') }}
+          </el-button>
+        </el-col>
+      </el-row>
+    </el-header>
+    <el-main>
+      <!-- 表单内容 -->
+    </el-main>
+  </el-container>
+</template>
+
+<script>
+import header from 'cloud-module-base/packages/components/common-header';
+export default {
+  components: { 'v-header': header }
+}
+</script>
+```
+
+---
+
+### 5.2 前端工具函数库
+
+#### 工具类清单
+
+路径：`cloud-module/cloud-module-base/static/js/utils/`
+
+| 文件名 | 说明 | 分类 |
+|-------|------|------|
+| accessLogs.js | 访问日志工具 | 日志服务 |
+| dataFormat.js | 数据格式化工具 | 数据格式化 |
+| form-rules.js | 表单校验规则 | 表单校验 |
+| globalValitor.js | 全局校验器 | 表单校验 |
+| preventReClick.js | 防重复点击工具 | 安全生产 |
+| sm2.js | SM2加密工具 | 加解密 |
+| sm4-utils.js | SM4加密工具 | 加解密 |
+| sm4.js | SM4加密（简化版） | 加解密 |
+
+---
+
+#### 数据格式化类
+
+##### 5.2.1 日期格式化
+
+文件路径：`cloud-module/cloud-module-base/static/js/utils/dataFormat.js`
+
+方法：`formatter(value)`
+
+入参：Date 或 String（支持 Date 对象或日期字符串）
+
+返回：String (格式: 'yyyy-MM-dd hh:mm')
+
+使用场景：日期对象格式化为指定格式字符串，默认格式为 'yyyy-MM-dd hh:mm'
+
+**实际使用示例**:
+```javascript
+// 来源: cloud-system-bpm-demo/src/pages/example/form-edit.vue
+import dateFormat from 'cloud-module-base/static/js/utils/dataFormat.js';
+
+// 在模板中使用
+<span class="text">{{ dateFormat(row.createTime) }}</span>
+
+// 日期格式化
+dateFormat(new Date())       // 返回: '2026-04-30 10:30'
+dateFormat('2026-04-30')    // 返回: '2026-04-30 00:00'
+dateFormat(1744363800000)    // 返回: 对应日期的格式化字符串
+```
+
+---
+
+#### 表单校验类
+
+##### 5.2.2 表单校验规则库 form-rules.js
+
+文件路径：`cloud-module/cloud-module-base/static/js/utils/form-rules.js`
+
+说明：提供与 Element UI 表单规则格式兼容的校验规则对象，可直接作为 `rules` 属性使用。
+
+**导入方式**:
+```javascript
+import FormRules from 'cloud-module-base/static/js/utils/form-rules'
+```
+
+**校验规则清单**：
+
+| 规则名称 | 说明 | 正则表达式 | 错误提示 |
+|---------|------|-----------|---------|
+| `FormRules.required` | 必填校验，不允许空格 | `/^[^\s]*$/` | 不允许输入空格 |
+| `FormRules.nospecial` | 字母数字下划线校验 | `/^[a-zA-Z0-9_]+$/` | 只允许输入英文字符或数字或_ |
+| `FormRules.noSpecialCode` | 中文字母数字下划线校验 | `/^[\u4e00-\u9fa5A-Za-z0-9_]+$/` | 不允许输入特殊字符 |
+| `FormRules.name` | 名称校验 | `/^[a-zA-Z0-9\-_\u4e00-\u9fa5]*$/` | 仅支持数值、中文字符、英文字母、下划线、横线 |
+| `FormRules.cellphone` | 手机号校验 | `/^1[0-9]{10}$/` | 请输入正确的手机号码 |
+| `FormRules.telephone` | 电话号码校验 | `/^[0-9]{3,4}-[0-9]{7,8}$/` | 请输入正确的电话号码 |
+| `FormRules.email` | 邮箱校验 | `/^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$/` | 请输入有效的电子邮件地址 |
+| `FormRules.idcard` | 身份证校验 | `/^[1-9]\d{5}(18|19|([23]\d))\d{2}((0[1-9])|(10|11|12))(([0-2][1-9])|12|20|30|31)\d{3}[0-9Xx]$/` | 请输入有效的身份证号码 |
+| `FormRules.url` | URL校验 | 标准URL正则 | 请输入有效的URL地址 |
+| `FormRules.ip` | IP地址校验 | IPv4正则 | 请输入有效的ip地址 |
+| `FormRules.mac` | MAC地址校验 | `/^[A-Fa-f0-9]{2}(-[A-Fa-f0-9]{2}){5}$|^[A-Fa-f0-9]{2}(:[A-Fa-f0-9]{2}){5}$/` | 请输入有效的mac地址 |
+
+**实际使用示例**:
+```javascript
+// 来源: cloud-system-manage/src/pages/ou/workgroup/view/edit-workgroup.vue
+import formRules from 'cloud-module-base/static/js/utils/form-rules';
+
+// 在 el-form 的 rules 属性中使用
+rules: {
+  code: [
+    {
+      required: true,
+      message: this.$i18n.t("workgroup.code_add"),
+      trigger: "blur"
+    },
+    {
+      pattern: formRules.nospecial.pattern,   // 获取正则表达式
+      message: formRules.nospecial.message,   // 获取错误提示
+      trigger: "blur"
+    }
+  ],
+  name: [
+    { required: true, message: '名称不能为空', trigger: 'blur' },
+    {
+      pattern: formRules.name.pattern,
+      message: formRules.name.message,
+      trigger: 'blur'
+    }
+  ]
+}
+```
+
+**使用 pattern 和 message 的标准写法**:
+```javascript
+// 导入
+import formRules from 'cloud-module-base/static/js/utils/form-rules';
+
+// 使用 - 分别取出 pattern 和 message
+{
+  pattern: formRules.required.pattern,
+  message: formRules.required.message,
+  trigger: 'blur'
+}
+```
+
+---
+
+#### 防重复点击
+
+##### 5.2.4 防重复点击指令 preventReClick.js
+
+文件路径：`cloud-module/cloud-module-base/static/js/utils/preventReClick.js`
+
+说明：Vue 指令，用于防止用户快速重复点击按钮，防止重复提交。指令会在点击后禁用按钮，延迟指定时间后自动恢复。
+
+**导入方式**:
+```javascript
+import { preventReClick } from 'cloud-module-base/static/js/utils/preventReClick'
+```
+
+**入参说明**：
+- `delay`: 延迟毫秒数，默认 3000ms（3秒）
+
+**使用示例**：
+```javascript
+// 1. 注册全局指令
+import { preventReClick } from 'cloud-module-base/static/js/utils/preventReClick'
+Vue.directive('preventReClick', preventReClick)
+
+// 2. 在组件中使用
+export default {
+  methods: {
+    submitForm() {
+      // 提交表单逻辑
+    }
+  }
+}
+```
+
+```vue
+<!-- 模板中使用，3秒内不可重复点击 -->
+<el-button @click="submitForm" v-prevent-re-click>提交</el-button>
+
+<!-- 自定义延迟时间，1秒内不可重复点击 -->
+<el-button @click="submitForm" v-prevent-re-click="1000">快速提交</el-button>
+
+<!-- 禁用按钮（指令仍然生效） -->
+<el-button type="primary" :disabled="submitting" v-prevent-re-click="2000">
+  {{ submitting ? '提交中...' : '提交' }}
+</el-button>
+```
+
+**实际使用示例**:
+```javascript
+// 来源: cloud-system-schedule/src/pages/taskManage/main.js
+import { preventReClick } from 'cloud-module-base/static/js/utils/preventReClick';
+Vue.use(preventReClick);  // 全局注册指令
+
+// 来源: cloud-module-bpm/packages/bpm-form-tools/bpm-form-tools.vue
+// 直接在模板中使用
+<el-button type="primary" v-prevent-re-click @click="handleSubmit">提交</el-button>
+```
+
+---
+
+#### 加解密类
+
+##### 5.2.5 SM2加密 sm2.js
+
+文件路径：`cloud-module/cloud-module-base/static/js/utils/sm2.js`
+
+说明：SM2 国密算法加密解密工具，支持加密、解密、签名、验签等操作。
+
+**导入方式**:
+```javascript
+import sm2 from 'cloud-module-base/static/js/utils/sm2'
+```
+
+**方法说明**：
+
+| 方法 | 说明 | 入参 | 返回 |
+|------|------|------|------|
+| `sm2.generateKeyPairHex()` | 生成SM2密钥对 | 无 | `{ privateKey, publicKey }` |
+| `sm2.doEncrypt(data, publicKey, mode)` | SM2加密 | data: 待加密数据, publicKey: 公钥, mode: '0'=C1C3C2, '1'=C1C2C3 | 加密后字符串 |
+| `sm2.doDecrypt(data, privateKey, mode)` | SM2解密 | data: 加密数据, privateKey: 私钥, mode: 加密模式 | 解密后字符串 |
+| `sm2.doSignature(data, privateKey)` | SM2签名 | data: 待签名数据, privateKey: 私钥 | 签名字符串 |
+| `sm2.doVerifySignature(data, signature, publicKey)` | SM2验签 | data: 原始数据, signature: 签名, publicKey: 公钥 | boolean |
+| `sm2.getPublicKeyFromPrivateKey(privateKey)` | 从私钥获取公钥 | privateKey | 公钥 |
+
+**实际使用示例**:
+```javascript
+// 来源: cloud-system-portal/src/views/login.vue
+import sm2 from 'cloud-module-base/static/js/utils/sm2';
+
+// 生成SM4密钥并用SM2加密传输
+let sm4Key = this.getUUID();  // 生成随机16字节密钥
+let privateKey = sm2.doEncrypt(sm4Key, window.localStorage.getItem("smKey"), '1');
+// privateKey 用于后续解密
+```
+
+---
+
+##### 5.2.6 SM4加密 sm4-utils.js
+
+文件路径：`cloud-module/cloud-module-base/static/js/utils/sm4-utils.js`
+
+说明：SM4 国密算法对称加密工具，基于 sm4.js 封装，提供 encrypt 和 decrypt 方法。
+
+**导入方式**:
+```javascript
+import { encrypt, decrypt } from 'cloud-module-base/static/js/utils/sm4-utils'
+```
+
+**方法说明**：
+
+| 方法 | 说明 | 入参 | 返回 |
+|------|------|------|------|
+| `encrypt(msg, key)` | SM4加密 | msg: 待加密字符串, key: 16字节密钥 | Base64加密字符串 |
+| `decrypt(data, key)` | SM4解密 | data: 加密字符串, key: 16字节密钥 | 解密后字符串 |
+
+**使用示例**：
+```javascript
+import { encrypt, decrypt } from 'cloud-module-base/static/js/utils/sm4-utils'
+
+// 16字节密钥
+const key = 'nXwqj7JVe@czbD4E'
+
+// 加密
+const plainText = '需要加密的数据'
+const encrypted = encrypt(plainText, key)
+
+// 解密
+const decrypted = decrypt(encrypted, key)
+```
+
+**实际使用示例**:
+```javascript
+// 来源: cloud-system-portal/src/views/login.vue
+import { encrypt, decrypt } from 'cloud-module-base/static/js/utils/sm4-utils';
+import sm2 from 'cloud-module-base/static/js/utils/sm2';
+
+login () {
+  let sm4Key = this.getUUID();  // 生成随机密钥
+  // 用SM2加密SM4密钥
+  let privateKey = sm2.doEncrypt(sm4Key, window.localStorage.getItem("smKey"), '1');
+  window.sessionStorage.setItem("smPrivate", privateKey);
+
+  // 用SM4加密用户名和密码
+  let encryptedUserName = encrypt(this.account.username, sm4Key);
+  let encryptedPass = encrypt(this.account.pass, sm4Key);
+
+  // 发送到服务器
+  this.$http({
+    url: '/login',
+    data: { username: encryptedUserName, pass: encryptedPass }
+  });
+}
+```
+
+---
+
+#### 访问日志类
+
+##### 5.2.8 访问日志记录 accessLogs.js
+
+文件路径：`cloud-module/cloud-module-base/static/js/utils/accessLogs.js`
+
+说明：记录用户访问日志，用于审计追踪。
+
+**导入方式**:
+```javascript
+import saveAcessLog from 'cloud-module-base/static/js/utils/accessLogs'
+```
+
+**方法说明**：
+
+| 方法 | 说明 | 入参 |
+|------|------|------|
+| `saveAcessLog(bmodule, fmodule)` | 保存访问日志 | bmodule: 业务模块, fmodule: 功能模块 |
+
+**实际使用示例**:
+```javascript
+// 来源: cloud-system-manage/src/pages/basic/log/App.vue
+import saveAcessLog from 'cloud-module-base/static/js/utils/accessLogs';
+
+export default {
+  name: 'Index',
+  created () {
+    // 在页面创建时记录访问日志
+    saveAcessLog('基础数据', '系统日志')
+  },
+};
+
+// 更多示例
+saveAcessLog('在线管理', '用户在线时长')      // cloud-system-manage
+saveAcessLog('审核管理', '申请记录')          // cloud-system-manage
+saveAcessLog('组织机构', '用户维护')          // cloud-system-manage
+saveAcessLog('调度编排', '业务流管理')        // cloud-system-schedule
+saveAcessLog('调度编排', '统一调度监控')      // cloud-system-schedule
+```
+
+**参数说明**:
+- `bmodule`: 大模块名称，如 '基础数据'、'在线管理'、'审核管理'
+- `fmodule`: 功能模块名称，如 '系统日志'、'用户在线时长'、'申请记录'
+
+### 5.3 流程组件与方法-**详细说明请参考**：应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+
+#### 前端组件
+
+| 来源 | 组件/方法名 | 作用场景 | 说明 |
+|------|------------|----------|------|
+| bpm-form-tools.vue | BpmFormTools | BPM表单工具组件 | 流程表单核心组件，集成发送、暂存等流程操作按钮 |
+| bpm-grid-buttons-new.vue | BpmGridButtonsNew | BPM表格按钮组件 | 流程列表页操作按钮，提供新建、我的申请、我的审批等 |
+
+#### 后端接口
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+| BpmEngine | getOpinions | 审批意见 | 获取流程审批意见列表 |
+| BpmEngine | addOrUpdate | 填写意见 | 在节点填写审批意见 |
+| BpmEngine | getUndoPage | 个人待办列表 | 获取当前用户的待办任务列表 |
+
+#### MeritBPM方法与后端API对应关系
+
+| MeritBPM方法 | 后端API | 说明 |
+|--------------|---------|------|
+| MeritBPM.create / initRuleEngine | POST /api/engine/bpm/ruleengine/init/{procDefKey} | 创建流程/初始化规则引擎 |
+| MeritBPM.open / runRuleEngine | POST /api/engine/bpm/ruleengine/run | 打开流程/运行规则引擎 |
+| MeritBPM.startProcess | POST /api/engine/bpm/{procDefKey}/startprocess | 发起流程 |
+| MeritBPM.validatePermit | POST /api/engine/bpm/{procDefKey}/validate/permit | 验证流程权限 |
+| MeritBPM.openProcTrackWindow | POST /api/engine/track/port | 打开流程跟踪窗口 |
+
+---
+
+## 组件及方法统计
+
+本文档共涵盖 **9个后端工具类**、**7个后端组件**、**7组外部接口**、**14个前端组件**、**6个前端工具方法**，共计 **43个组件/工具类**，包含 **111+个方法**。
+
+---
+
+| 分类 | 序号 | 名称 | 方法数 | 作用说明 |
+|------|------|------|--------|----------|
+| **后端工具类** | 1 | SysCacheServiceFacade | 23 | Redis缓存操作工具类，提供put/get/hget/hset/queue等23种缓存操作方法 |
+| | 2 | StringCacheFacade | 3 | String类型缓存工具类，提供put/get/multiGet方法 |
+| | 3 | NacosUtils | 10 | Nacos配置中心工具类，提供获取/修改/新增配置等10种方法 |
+| | 4 | Sm2Utils | 3 | SM2非对称加密工具类，提供密钥生成/加密/解密3种方法 |
+| | 5 | SM3Encoder | 2 | SM3哈希加密工具类，提供encryptWithHMacMD5/encode方法 |
+| | 6 | Sm4Utils | 2 | SM4对称加密工具类，提供encrypt/decrypt方法 |
+| | 7 | SessionUtils | 21 | 会话信息工具类，提供获取当前用户ID/姓名/部门/角色等21种方法 |
+| | 8 | LogPattenUtils | 1 | 日志模板工具类，提供getProperty获取日志模板配置 |
+| | 9 | CompareUtils | 1 | 日志对比工具类，提供getCompareLog自动生成变更日志 |
+| **后端组件** | 1 | ILogPostService | 2 | 日志服务组件，提供postLog/POST /post（操作日志）、postDiyLog/POST /post-diy（自定义日志）2个接口 |
+| | 2 | BpmEngine | 13 | 工作流引擎组件，提供启动流程/完成任务/退回/删除/查询/追踪等13个接口 |
+| | 3 | IJobApi | 10 | 任务调度组件，提供getJob/pageList/triggerJob/startJob/stopJob/add/update/remove等10个接口 |
+| | 4 | CloudFeignMessageClient | 5 | 服务通知Feign客户端，提供sendRoleMessage/sendResourceMessage/sendUserRoleMessage/sendAssignMessage/sendUserAppMessage 5个消息发送方法 |
+| | 5 | @LogDesc/@AddDesc/@DelDesc | 3 | 日志注解组件，@LogDesc标注字段描述、@AddDesc新增记录、@DelDesc删除记录 |
+| | 6 | EnableDataSecretFilter | 1 | 数据脱敏注解组件，标注后自动启用Hibernate数据密级过滤 |
+| | 7 | DynamicCloudFeignClient | 1 | 动态FeignClient构建组件，提供getFeignClient动态构建Feign客户端 |
+| **外部接口** | 1 | ISecurityAuthService | 7 | 安全认证接口，提供用户认证、权限查询等7个方法 |
+| | 2 | ICloudClient | 4 | 云服务客户端接口，提供服务端注册/心跳等4个方法 |
+| | 3 | IJobApi | 10 | 任务调度API接口，提供任务CRUD/触发/启停等10个方法 |
+| | 4 | IMessageApi | 3 | 消息服务接口，提供消息发送等3个方法 |
+| | 5 | IResourceApi | 4 | 资源管理接口，提供资源查询/分配等4个方法 |
+| | 6 | IUserPortalApi | 3 | 用户门户接口，提供用户信息/Token等3个方法 |
+| | 7 | 其他Feign接口 | - | 包含ISysLogApi、IOrgApi、IEmpApi等若干Feign接口 |
+| **前端组件** | 1 | CloudDialog | - | 通用对话框组件，提供对话框显示/关闭等交互 |
+| | 2 | UserSelect | - | 用户选择组件，通过props控制选择模式，通过events交互 |
+| | 3 | UserSelectMulti | - | 多用户选择组件，通过props控制选择模式，通过events交互 |
+| | 4 | DeptSelect | - | 部门选择组件，通过props控制选择模式，通过events交互 |
+| | 5 | RoleSelect | - | 角色选择组件，通过props控制选择模式，通过events交互 |
+| | 6 | ImportButton | - | 导入按钮组件，支持导入模板下载/数据导入/错误文件下载，通过events交互 |
+| | 7 | MenuAuth | - | 菜单权限组件，通过props控制权限显示 |
+| | 8 | ResourceCodeAuth | - | 资源权限组件，通过props控制资源权限显示 |
+| | 9 | ThreeMemberAuth | - | 三员授权组件，通过props和events与外部交互 |
+| | 10 | TableHeadSearch | - | 表格头部搜索组件 |
+| | 11 | VerifiyPassword | - | 二级鉴别密码验证弹窗组件 |
+| | 12 | CommonHeader | - | 通用头部组件 |
+| | 13 | BpmGridButtonsNew | - | BPM表格按钮组件，提供新建/我的申请/我的审批/所有流程等操作按钮，通过props和events与外部交互 |
+| | 14 | BpmFormTools | - | BPM表单工具组件，集成发送/暂存等流程操作按钮 |
+| **前端工具方法** | 1 | sm4-utils.js | 2 | SM4加密解密工具，提供encrypt/decrypt方法 |
+| | 2 | sm2.js | - | SM2加密工具 |
+| | 3 | accessLogs.js | 1 | 访问日志工具，提供saveAcessLog方法 |
+| | 4 | dataFormat.js | 1 | 日期格式化工具，提供formatter方法 |
+| | 5 | form-rules.js | 12 | 表单校验规则，提供required/nospecial/noSpecialCode/name/cellphone/telephone/email/idcard/url/ip/mac等12种校验规则 |
+| | 6 | globalValitor.js | - | 全局校验器 |
+
+---
+
+### 统计汇总
+
+| 分类 | 数量 | 方法/接口数 |
+|------|------|-------------|
+| 后端工具类 | 9个 | 66个方法 |
+| 后端组件 | 7个 | 25个接口 |
+| 外部接口 | 7组 | 20+个接口 |
+| 前端组件 | 14个 | - |
+| 前端工具方法 | 6个 | - |
+| **合计** | **43个** | **111+个** |
+
+---
+
+### A. Maven依赖坐标
+
+```xml
+<!-- cloud-module-base -->
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-base</artifactId>
+    <version>6.13.2</version>
+</dependency>
+
+<!-- cloud-module-cache -->
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-cache</artifactId>
+    <version>6.13.2</version>
+</dependency>
+
+<!-- cloud-starter-core -->
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-starter-core</artifactId>
+    <version>6.13.2</version>
+</dependency>
+```
+
+---
+
+### B. 组件开发注意事项
+
+1. **EventBus**: 所有组件通过 `Vue.prototype.EventBus` 进行内部通信
+2. **国际化**: 组件使用 `$t()` 函数进行国际化处理，需要配置 i18n
+3. **依赖**: BPM 组件依赖 Element-UI 和 cloud-module-base
+4. **样式**: CloudDialog 组件需要引入样式文件: `import 'cloud-module-base/static/css/cloud-dialog.css';`
+