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

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

@@ -0,0 +1,210 @@
+---
+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

@@ -0,0 +1,349 @@
+---
+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

@@ -0,0 +1,63 @@
+---
+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`（会话信息获取）