@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.12

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/07_/344/270/211/345/271/263/345/217/260/346/234/215/345/212/241-3.1/346/227/245/345/277/227/346/263/250/350/247/243-LogDesc-LogOperation.md

@@ -1,210 +0,0 @@
----
-name: 三平台服务-3.1日志注解-LogDesc-LogOperation
-source-file: 公共资产清单
-source-section: 三、平台服务支撑 → 3.1 日志服务 → @LogDesc / @AddDesc / @DelDesc / @LogOperation L1128-L1304
-keywords: [@LogDesc, @LogOperation, @AddDesc, @DelDesc, 日志注解, CompareUtils, type=add, type=edit, type=delete, 实体字段日志]
-use-cases: [方法级别日志记录, 实体字段日志, 变更自动对比, 登录登出日志]
-related: [06_三平台服务-3.1日志服务-ILogPostService.md]
----
-
-> **OCR 异常提示**：原文件 L1128 行混入 `# 人员维护` 代码注释，本拆分文件**按原貌保留**，便于追溯。下方「使用示例」一节即从此处开始。
-
-# 3.1 日志注解 — @LogDesc / @AddDesc / @DelDesc / @LogOperation
-
-> **原文章节**：`公共资产清单 → 三、平台服务支撑 → 3.1 日志服务 → @LogDesc / @AddDesc / @DelDesc / @LogOperation`
-> **行号范围**：L1128-L1304
-
-## 🎯 一句话
-本章节给出 `@LogDesc` 注解完整字段含义、`@LogOperation` 注解使用，以及 add / edit / delete / 自定义日志四大场景的完整 Controller 代码示例，是 06 文件的**实战配套**。
-
-## 📋 接口/方法清单
-
-> 上一行原文为配置文件块结尾，本处保留原文样式，紧接其后
-
-公共src\main\resources\logs\ou.logs.properties
-
-```
-# 人员维护  ← OCR 异常（原文件 L1128 混入的注释）
-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);
-    }
-```
-
----
-
-## 💡 使用建议
-- **`@LogOperation` 适用场景**：Controller 方法级别一键打点（自动捕获 type/操作时间），常用于调度任务等"一个方法 = 一个动作"的接口。
-- **`@LogDesc` 三件套配合**：`@LogDesc("姓名") + @AddDesc + @DelDesc` 标记字段在新增 / 删除日志中均打印；变更日志依赖 `CompareUtils` 自动对比。
-- **执行时间追踪**：自定义日志可手动 `setStartTime` + `setEndTime` + `setExecuteTime` 写入接口耗时；如未设置，`@LogOperation` AOP 会自动计算。
-- **登录/登出走 `postDiyLog`**：登录登出场景建议使用 `POST /post-diy` 接口（`Message.TYPE_LOGOUT`），运维侧按类型检索更方便。
-
-## 🔗 相关章节
-- 06_三平台服务-3.1日志服务-ILogPostService.md

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/08_/344/270/211/345/271/263/345/217/260/346/234/215/345/212/241-3.3/344/274/232/350/257/235/344/277/241/346/201/257-SessionUtils.md

@@ -1,349 +0,0 @@
----
-name: SessionUtils 会话工具类
-source-file: 公共资产清单
-source-section: 3.3.1 SessionUtils会话工具类
-keywords: [Session, 会话, 当前用户, getUserId, getDeptId, getOrgId, getRootOrgId, getRoleCodes, getTenantId, getEmpId]
-use-cases: [获取当前登录用户信息, 获取部门组织架构信息, 权限判断, 多租户识别, 审计日志记录]
-related: [09, 10, 11]
----
-
-# SessionUtils 会话工具类
-
-> **原文章节**：`公共资产清单 → 3.3.1 SessionUtils会话工具类`
-> **行号范围**：L1313–L1636
-
-## 🎯 一句话
-提供 21 个方法获取当前登录会话的用户ID、姓名、人员、部门、组织、角色、权限、租户、IP 等完整会话信息。
-
-## 📋 接口/方法清单
-
-完整包路径：`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();`
-
-## 💡 使用建议
-
-1. **统一在 SessionUtils 注入**：所有业务 Controller/Service 优先调用 `SessionUtils` 自动注入的 Spring Bean，避免在多个位置重复解析 Token。
-2. **审计场景必填**：操作日志、审批流、消息通知都需要记录 `getUserId()` / `getEmpId()` / `getCurrentLoginIp()` 用于审计。
-3. **多租户隔离**：`getTenantId()` 是数据隔离核心字段，所有租户级业务查询必须传该值（与 `ISecurityAuthService` 配合）。
-
-## 🔗 相关章节
-
-- `09_三平台服务-3.3在线用户-IUserOnlineTime.md`（在线用户踢出）
-- `10_三平台服务-3.4多系统集成+3.5数据密级.md`（多系统集成 + 数据密级）
-- `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md`（服务通知）

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/09_/344/270/211/345/271/263/345/217/260/346/234/215/345/212/241-3.3/345/234/250/347/272/277/347/224/250/346/210/267-IUserOnlineTime.md

@@ -1,63 +0,0 @@
----
-name: IUserOnlineTime 在线用户服务
-source-file: 公共资产清单
-source-section: 3.3.2 IUserOnlineTime 在线用户服务
-keywords: [IUserOnlineTime, 踢出用户, 在线用户, 注销, 会话失效]
-use-cases: [强制踢出在线用户, 离职人员立即下线, 异地登录保护后下线]
-related: [08]
----
-
-# IUserOnlineTime 在线用户服务
-
-> **原文章节**：`公共资产清单 → 3.3.2 IUserOnlineTime 在线用户服务`
-> **行号范围**：L1636–L1674
-
-## 🎯 一句话
-通过 Feign 接口 `getOutOnlineByUserNames` 批量踢出指定用户名对应的在线会话，常用于人员离职/异常登录强制下线。
-
-## 📋 接口/方法清单
-
-完整包路径：`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");
-```
-
-## 💡 使用建议
-
-1. **离职/调岗触发**：在人员状态变更/角色回收完成后调用，确保其会话立即失效。
-2. **逗号分隔批量**：支持一次传入多个用户名（`"user1,user2,user3"`），减少远程调用次数。
-3. **鉴权要求**：调用方需具备平台管理员或对应租户管理员权限，否则会返回无权限。
-
-## 🔗 相关章节
-
-- `08_三平台服务-3.3会话信息-SessionUtils.md`（会话信息获取）