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

package/skills/meritdata-platform-session/references/assets/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-platform-session/references/assets/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`（会话信息获取）

package/skills/meritdata-platform-session/references/session.md

@@ -0,0 +1,125 @@
+## 前置条件
+
+Maven 依赖已包含在 `cloud-starter-core` 基础包中，二开项目继承平台脚手架后自动引入，无需额外配置。
+
+---
+
+## SessionUtils — 会话工具类
+
+**完整包路径**: `com.meritdata.cloud.utils.SessionUtils`
+
+通过依赖注入使用：
+
+```java
+@Autowired
+private SessionUtils sessionUtils;
+```
+
+> **注意**: `getUserName()` 和 `getCurrentUserName()` 方法均可用，返回相同结果。
+
+### 用户信息
+
+| 方法 | 返回 | 说明 |
+|------|------|------|
+| `getUserId()` | String | 用户 ID（`pf_user_info.id`） |
+| `getUserName()` | String | 用户名 |
+| `getCurrentUserName()` | String | 用户名（同 getUserName） |
+| `getPrincipal()` | User | 整个用户对象 |
+
+```java
+String userId = sessionUtils.getUserId();
+String userName = sessionUtils.getUserName();
+User user = sessionUtils.getPrincipal();
+```
+
+### 人员信息
+
+| 方法 | 返回 | 说明 |
+|------|------|------|
+| `getEmpId()` | String | 人员 ID（`pf_org_user.id`） |
+| `getEmpName()` | String | 人员姓名 |
+| `getEmpCode()` | String | 人员编号 |
+
+```java
+String empId = sessionUtils.getEmpId();
+String empName = sessionUtils.getEmpName();
+String empCode = sessionUtils.getEmpCode();
+```
+
+### 部门信息
+
+| 方法 | 返回 | 说明 |
+|------|------|------|
+| `getDeptId()` | String | 部门 ID |
+| `getDeptCode()` | String | 部门编码 |
+| `getDeptName()` | String | 部门名称 |
+| `getDept()` | Organization | 部门对象 |
+
+```java
+String deptId = sessionUtils.getDeptId();
+Organization dept = sessionUtils.getDept();
+String deptName = dept.getName();
+```
+
+### 组织信息
+
+| 方法 | 返回 | 说明 |
+|------|------|------|
+| `getOrgId()` | String | 组织 ID |
+| `getOrgName()` | String | 组织名称 |
+| `getOrgDlevelCode()` | String | 组织层级编码 |
+| `getRootOrgId()` | String | 根组织 ID |
+| `getRootOrg()` | Organization | 根组织对象 |
+
+```java
+String orgId = sessionUtils.getOrgId();
+Organization rootOrg = sessionUtils.getRootOrg();
+```
+
+### 角色与权限
+
+| 方法 | 返回 | 说明 |
+|------|------|------|
+| `getSysRoleCodes()` | List\<String\> | 系统角色编码列表 |
+| `getRoleCodes()` | List\<String\> | 所有角色编码列表 |
+| `getRoleNames()` | List\<String\> | 所有角色名称列表 |
+| `getAuthoritiesIds()` | List\<String\> | 所有权限 ID 列表 |
+
+### 租户与登录信息
+
+| 方法 | 返回 | 说明 |
+|------|------|------|
+| `getTenantId()` | String | 租户 ID |
+| `getCurrentLoginIp()` | String | 当前登录 IP |
+
+---
+
+## IUserOnlineTime — 在线用户管理
+
+**完整包路径**: `com.meritdata.cloud.security.sso.IUserOnlineTime`
+
+Feign 客户端接口，通过依赖注入使用：
+
+```java
+@Autowired
+private IUserOnlineTime iUserOnlineTime;
+```
+
+### 踢出在线用户
+
+**接口**: `POST /api/basic/online-account/getOutOnlineByUserNames`
+
+批量踢出指定用户名的在线用户，清除其所有会话信息。
+
+这是高影响操作。调用前确认操作权限、目标用户名和业务影响，并记录操作者、原因与结果。
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| userNames | String | 用户名，多个用逗号分隔 |
+
+---
+
+## 会话注意事项
+
+1. `SessionUtils` 通过 `@Autowired` 注入，不是静态工具类
+2. `IUserOnlineTime` 是 Feign 远程调用，踢出操作会记录登录日志（`loginOut` 类型）

package/skills/meritdata-platform-sso/SKILL.md

@@ -1,41 +1,59 @@
 ---
 name: meritdata-platform-sso
-description: |
-  SSO 单点登录。OAuth2/CAS 接入、Token 管理、过滤器配置、跳转登录、退出登录、Token 刷新、跨域。
-  触发场景：新二开模块接入平台 SSO；需要统一登录态；对接第三方 OAuth（微信/钉钉/企业微信）。
-  何时不用：纯前端登录 → 用 frontend；权限点控制 → L3 资源授权（待建）。
+description: MeritData SSO/CAS 单点登录接入。用于多应用统一登录、会话共享、Token 透传、CAS 协议对接。
 metadata:
   version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-07"
-  last_modified: "2026-09-07"
-  risk: high
-  layer: L2
-  sub-layer: L2-C
-  stack: java
-allowed-tools: Read, Grep, Glob, Bash
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
+  risk: medium
+  allowed-tools: Read, Grep, Glob
 ---
 
-# SSO 单点登录（sso）
+## ⭐ MUST DO
 
-## 触发
-- 新二开模块需要接入平台 SSO
-- 需要对接第三方 OAuth（微信/钉钉/企业微信）
-- 需要 Token 刷新 / 跨域登录
-- 需要统一退出登录
+**SSO Token 通过 Header 传递，禁止 URL 携带；登出必须调用中心会话失效接口。**
 
-## 不触发
-- 纯前端样式调整 → 用 `meritdata-platform-frontend`
-- 资源/数据权限控制 → L3 资源授权（待建）
-- 已登录态使用 → 用 `meritdata-platform-entities` 获取 UserDTO
+## 触发条件 / 不适用
 
-## 前置约束
-- Token **禁止**写入 URL（详见 [rules/security-rules.md](../../rules/security-rules.md)）
-- 认证失败提示信息**不能过于详细**（不能区分"密码错误"vs"用户不存在"）
-- 敏感操作（修改密码/绑定手机）必须二次认证
+**适用**：
+- 多应用统一登录
+- CAS 协议对接
+- Token 透传与校验
 
-## 路由
-- SSO 接入流程 + Token 管理 → [references/sso-guide.md](references/sso-guide.md)
-- 第三方 OAuth 接入 → [references/oauth-providers.md](references/oauth-providers.md)
-- 过滤器配置 + 拦截规则 → [references/filter-config.md](references/filter-config.md)
+**不适用**：
+- 单应用 Session → `meritdata-platform-session`
+- 平台基础会话 → `meritdata-platform-core`
+
+## 主题路由
+
+| 任务 | 优先读取 |
+| --- | --- |
+
+### 公司级研发攻略（dev-docs 整合）
+
+| 攻略 | 内容 | 入口 |
+|------|------|------|
+| **攻略06：系统认证（6 章）** | token 认证集成、CAS 统一认证中心、第三方认证 | [`references/auth/攻略-06-系统认证-00_总览.md`](references/auth/攻略-06-系统认证-00_总览.md) |
+
+## 工作方式
+
+1. 确认 SSO 服务地址（cas.example.com）
+2. 配置 Filter 拦截未登录请求
+3. 登录后从 SSO 获取 ticket，校验后写入本地 Session
+4. Feign 调用通过 Header 透传 token
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| Token 写入 URL | 日志泄露 | Header 透传 |
+| 登出不调中心 | 跨应用仍登录 | 调 SSO logout |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 单应用 Session → `meritdata-platform-session`
+  - 鉴权 → `meritdata-platform-resource-auth`
+- **强制要求**：Token 通过 Header 传递

package/skills/meritdata-platform-sso/agents/openai.yaml

@@ -0,0 +1,19 @@
+display_name: "MeritData SSO"
+short_description: "SSO/CAS 单点登录接入"
+default_prompt: |
+  meritdata-platform-sso 处理 SSO/CAS 单点登录场景。
+
+  适用场景：
+  - 多应用统一登录
+  - CAS 协议对接
+  - Token 透传与校验
+
+  使用方式：
+  ```
+  meritdata-platform-sso <SSO 需求>
+  ```
+
+  强制约束：
+  - Token 通过 Header 传递（不写入 URL）
+  - 登出调用 SSO 中心会话失效接口
+  - 跨应用会话通过 SSO 中心共享

package/skills/meritdata-platform-sso/references/auth//346/224/273/347/225/245-06-/347/263/273/347/273/237/350/256/244/350/257/201-00_/346/200/273/350/247/210.md

@@ -0,0 +1,47 @@
+---
+name: 攻略-06-系统认证-00_总览
+description: 美林平台系统认证集成攻略（token 认证 / CAS 统一认证 / 第三方认证中心）
+keywords: [系统认证, token认证, CAS单点登录, 第三方认证, SSO, JRE证书, RSAUtils]
+use-cases: [token 集成, CAS 单点登录集成, 第三方认证中心对接, 认证中心端配置]
+related: [cloud-system-manage / 1.16 外部接口]
+source: 应用开发平台-基础平台-使用攻略（四）：系统认证集成.md
+---
+
+# 应用开发平台使用攻略（四）：系统认证集成 — 总览
+
+**摘要**：美林平台系统认证集成攻略（token 认证 / CAS 统一认证 / 第三方认证中心）
+
+**关联**：cloud-system-manage / 1.16 外部接口
+
+## 章节索引
+
+01. [系统认证集成介绍](攻略-06-系统认证-章节01_系统认证集成介绍.md) (原 1)
+02. [token 认证集成](攻略-06-系统认证-章节02_token_认证集成.md) (原 2)
+03. [cas 统一认证中心](攻略-06-系统认证-章节03_cas_统一认证中心.md) (原 3)
+04. [第三方认证中心](攻略-06-系统认证-章节04_第三方认证中心.md) (原 4)
+05. [附录 1: 认证中心端配置](攻略-06-系统认证-章节05_附录_1_认证中心端配置.md)
+
+
+## 📑 API 速查
+
+本攻略共 **1 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节02_token_认证集成 | `IPortalSSOApi` | - | `class IPortalSSOApi` | java | 2nd-dev 必实现的 SSO 接口（getUserIdAndToken） |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节02_token_认证集成",
+    "apiName": "IPortalSSOApi",
+    "method": "",
+    "urlPattern": "",
+    "type": "java",
+    "signature": "class IPortalSSOApi",
+    "functionDesc": "2nd-dev 必实现的 SSO 接口（getUserIdAndToken）"
+  }
+]
+```

package/skills/meritdata-platform-sso/references/auth//346/224/273/347/225/245-06-/347/263/273/347/273/237/350/256/244/350/257/201-/347/253/240/350/212/20201_/347/263/273/347/273/237/350/256/244/350/257/201/351/233/206/346/210/220/344/273/213/347/273/215.md

@@ -0,0 +1,14 @@
+---
+name: 攻略-06-系统认证-章节01_系统认证集成介绍
+description: 系统认证集成介绍 — 美林平台系统认证集成攻略（token 认证 / CAS 统一认证 / 第三方认证中心）
+keywords: [系统认证, token认证, CAS单点登录, 第三方认证, SSO, JRE证书, RSAUtils, 系统认证集成介绍]
+use-cases: [token 集成, CAS 单点登录集成, 第三方认证中心对接, 认证中心端配置]
+source-section: 1. 系统认证集成介绍
+source-file: 应用开发平台-基础平台-使用攻略（四）：系统认证集成.md
+---
+
+# 1 系统认证集成介绍
+
+针对不同项目集成场景的不同，平台目前提供三种集成方式： token 认证，Cas 统一认证中心，第三方认证中心。
+
+- token 认证：目前平台提供两种登录方式，分别为平台默认 token 登录、自定义 token 登录。