@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.11

package/skills/meritdata-platform-resource-auth/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: meritdata-platform-resource-auth
+description: MeritData 资源授权专项。用于角色绑定资源码、URL 级权限控制、按钮级权限、数据行级权限。
+metadata:
+  version: "1.0.0"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
+  risk: medium
+  allowed-tools: Read, Grep, Glob
+---
+
+## ⭐ MUST DO
+
+**权限校验必须在服务端执行，禁止依赖客户端；URL 权限与按钮权限分开管理。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- 角色绑定资源码
+- URL 级权限控制
+- 按钮级权限控制
+- 数据行级权限
+
+**不适用**：
+- SSO 登录 → `meritdata-platform-sso`
+- 平台角色实体 → `meritdata-platform-entities`
+
+## 工作方式
+
+1. URL 权限：`@RequiresPermissions("user:add")`
+2. 按钮权限：`MenuAuth` 组件 + 后端校验
+3. 数据权限：基于用户角色过滤数据行
+4. 角色绑定：`RoleAuthController`
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 仅前端隐藏按钮 | 安全漏洞 | 服务端强制校验 |
+| 权限硬编码 | 维护困难 | 资源码 + 角色绑定 |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 角色实体 → `meritdata-platform-entities`
+  - 登录 → `meritdata-platform-sso`
+- **强制要求**：服务端权限校验

package/skills/meritdata-platform-resource-auth/agents/openai.yaml

@@ -0,0 +1,14 @@
+display_name: "MeritData 资源授权"
+short_description: "角色绑定资源码、URL/按钮/数据权限"
+default_prompt: |
+  meritdata-platform-resource-auth 处理资源授权场景。
+
+  适用场景：
+  - 角色绑定资源码
+  - URL 级权限控制
+  - 按钮级权限控制
+  - 数据行级权限
+
+  强制约束：
+  - 服务端强制校验（不依赖前端隐藏）
+  - URL 权限与按钮权限分开管理

package/skills/meritdata-platform-resource-auth/references/endpoints.md

@@ -0,0 +1,171 @@
+# 资源授权 3.1-3.10 端点速查（基于源码实测，2026-09-10）
+
+> **来源**：`AssignController` + `ResourceController`（位于 `cloud-system-manage-module/.../authority/`）
+> **核实日期**：2026-09-10
+> **⚠️ 重要修正**：之前 skill 中大部分路径和 HTTP 方法错误。本文档**完全基于源码实测**。
+
+---
+
+## ⚠️ 关键差异说明（与之前 skill 对比）
+
+| 维度 | 之前 skill 声明 | 源码实测 |
+|------|---------------|---------|
+| 路径前缀 | `/api/resource/*` | `/api/authority/assign/*` 或 `/api/authority/resource/*` |
+| HTTP 方法 | GET / DELETE | **POST**（绝大多数） |
+| 接口命名 | `getByRole/delByUser/api` 等 | `resourceIdListByRole/deleteByResouce` 等 |
+| 缺失接口 | 多处 | 已实测补全 |
+
+---
+
+## 一、AssignController（资源授权分配，类级 `/api/authority/assign`）
+
+### 1.1 按角色授权（3.1 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/assign/save` | `save` | objId: String, resourceIds: String, type: String, hasProgeny: String | `ResultBody` |
+| 2 | POST | `/api/authority/assign/modify` | `modify` | objId, resourceId, type, hasProgeny, extendColumn1..8: String | `ResultBody` |
+| 3 | POST | `/api/authority/assign/modifyAll` | `modifyAll` | `@RequestBody List<ResourceDto>` | `ResultBody` |
+| 4 | POST | `/api/authority/assign/reverse-save` | `reverseSave` | resourceId, type, objIds, hasProgeny: String | `ResultBody` |
+| 5 | POST | `/api/authority/assign/reverse-assign-list` | `listReverseAssignResource` | resourceId, type: String | `ResultBody` |
+| 6 | POST | `/api/authority/assign/resourceIdListByRole` | `resourceIdListByRole` | roleId: String | `ResultBody<List<String>>` |
+| 7 | POST | `/api/authority/assign/getAssign` | `getAssign` | roleId, type: String | `Object` |
+| 8 | POST | `/api/authority/assign/existRole` | `existRole` | name: String, cateFlag: int | `boolean` |
+| 9 | POST | `/api/authority/assign/roleTreeEasyUi` | `roleTreeEasyUi` | id: String | `ResultBody<List<TreeModel>>` |
+| 10 | POST | `/api/authority/assign/commonRoleTree` | `commonRoleTree` | id: String | `ResultBody<List<TreeModel>>` |
+| 11 | POST | `/api/authority/assign/roletree` | `roletree` | id: String | `ResultBody<List<TreeModel>>` |
+
+### 1.2 按用户授权（3.3 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/assign/resourceIdListByUser` | `resourceIdListByUser` | userId: String | `ResultBody<List<String>>` |
+| 2 | POST | `/api/authority/assign/queryhasProgeny` | `queryhasProgeny` | objId: String | `ResultBody<String>` |
+| 3 | POST | `/api/authority/assign/usertree` | `usertree` | id: String | `ResultBody<List<TreeModel>>` |
+| 4 | POST | `/api/authority/assign/userTreeEasyUi` | `userTreeEasyUi` | id: String | `ResultBody<List<TreeModel>>` |
+
+### 1.3 按人授权详情（3.4/3.5 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/assign/list-user-by-auth6` | `listUserByAuth6` | extendColumn1..8, page, rows, name: String | `ResultBody<GridView>` |
+| 2 | POST | `/api/authority/assign/resource-permission-list` | `listResourcePermission` | objId, type, resExtendColumn1..8: String | `ResultBody<List>` |
+| 3 | POST | `/api/authority/assign/resourceAssignManage` | `saveSubResourceList` | assignId, resourceIds: String | `ResultBody<Boolean>` |
+
+### 1.4 资源授权树（3.7 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/assign/resourceTree4Assign` | `resourceTree4Assign` | index: String | `ResultBody<List<TreeModel>>` |
+| 2 | POST | `/api/authority/assign/resourceTableTree4Assign` | `resourceTableTree4Assign` | index, objId, resourceName: String | `ResultBody<List<TreeModel>>` |
+| 3 | POST | `/api/authority/assign/resourceTableTree` | `resourceTableTree` | workbenchId: String | `ResultBody<List<TreeModel>>` |
+| 4 | POST | `/api/authority/assign/resourceAssignTableTree` | `resourceAssignTableTree` | index, objId: String | `ResultBody<GridView>` |
+| 5 | POST | `/api/authority/assign/aaignTreeByOrg` | `aaignTreeByOrg` | orgId: String | `ResultBody<List<TreeModel>>` |
+| 6 | POST | `/api/authority/assign/zxtassign` | `resourceGroupTableTree4Assign` | id: String | `ResultBody<List<Tree>>` |
+| 7 | POST | `/api/authority/assign/save-easyui` | `add` | roleId, resourceIds, type: String | `boolean` |
+| 8 | POST | `/api/authority/assign/orgtree` | `orgtree` | id: String | `ResultBody<List<TreeModel>>` |
+
+### 1.5 删除授权（3.2/3.4 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/assign/delete-by-resouce` | `deleteByResouce` | resourceId, extendColumn1..8, type: String | `ResultBody<Boolean>` |
+| 2 | POST | `/api/authority/assign/delete-by-resouce-all` | `deleteByResouceAll` | `@RequestBody List<ResourceDto>` | `ResultBody<Boolean>` |
+| 3 | POST | `/api/authority/assign/delete-by-resouce-objid` | `deleteByResouceAndObjId` | objId, resourceId, extendColumn1..8: String | `ResultBody<Boolean>` |
+
+**⚠️ 拼写错误保留**：源码中 `resouce`（少一个 r）是历史拼写错误，**按源码原样引用**。
+
+---
+
+## 二、ResourceController（资源 CRUD，类级 `/api/authority/resource`）
+
+### 2.1 资源查询（3.5/3.10 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/resource/list` | `list` | page, rows, parentId, name, type, secret, searchType, sysResouce: String | `ResultBody<GridView>` |
+| 2 | POST | `/api/authority/resource/tree` | `tree` | id, sysResouce: String | `ResultBody<List<TreeModel>>` |
+| 3 | POST | `/api/authority/resource/tree4Resource` | `tree4Resource` | - | `ResultBody<List<TreeModel>>` |
+| 4 | POST | `/api/authority/resource/groupTree4Resource` | `groupTree4Resource` | - | `ResultBody<List<TreeModel>>` |
+| 5 | POST | `/api/authority/resource/getUserPermission` | `getUserPermissionTree` | sysResource: String | `Object` |
+| 6 | POST | `/api/authority/resource/getUserPermissionList` | `getUserPermissionList` | - | - |
+| 7 | POST | `/api/authority/resource/getUserPermissionProductCtrl` | `getUserPermissionProductCtrl` | - | - |
+| 8 | POST | `/api/authority/resource/resource-code-auth` | `resourceCodeAuth` | url, resourceCode: String | `ResultBody` |
+| 9 | POST | `/api/authority/resource/getAssignTree` | `getAssignTree` | `Map param` | `Object` |
+| 10 | POST | `/api/authority/resource/get-by-embed-url` | `getByEmbedUrl` | - | - |
+| 11 | POST | `/api/authority/resource/query-resource-by-id` | `queryResourceById` | - | - |
+| 12 | POST | `/api/authority/resource/query-resource-by-name` | `queryResourceByName` | - | - |
+| 13 | POST | `/api/authority/resource/query-resource-by-product-name` | `queryResourceByProductName` | - | - |
+
+### 2.2 资源 CRUD（3.15 章节对应）
+
+| # | HTTP | 完整路径 | 方法名 | 入参 | 返回 |
+|---|------|---------|--------|------|------|
+| 1 | POST | `/api/authority/resource/add` | `add` | `Resource resource` | `Resource` |
+| 2 | POST | `/api/authority/resource/create` | `create` | 多字段（parentId/name/type/showType/uri/embedUrl/...）| `ResultBody<Resource>` |
+| 3 | POST | `/api/authority/resource/update` | `update` | id + 多字段 | `ResultBody<Resource>` |
+| 4 | POST | `/api/authority/resource/delete` | `delete` | `Map param` | - |
+| 5 | POST | `/api/authority/resource/exist` | `exist` | - | - |
+| 6 | POST | `/api/authority/resource/get` | `get` | - | - |
+| 7 | GET | `/api/authority/resource/findAll` | `findAll` | rootOrgId: String | `ResultBody` |
+| 8 | POST | `/api/authority/resource/maxsort` | `queryMaxSort` | - | `ResultBody` |
+| 9 | POST | `/api/authority/resource/set-main-product` | `setMainProduct` | - | - |
+| 10 | POST | `/api/authority/resource/cancel-main-product` | `cancelMainProduct` | - | - |
+
+### 2.3 扩展字段查询（特殊查询）
+
+| # | HTTP | 完整路径 | 方法名 |
+|---|------|---------|--------|
+| 1 | POST/GET | `/api/authority/resource/list-by-extendcolumn` | `listByExtendColumn` |
+| 2 | POST/GET | `/api/authority/resource/delete-by-extendcolumn` | `deleteByExtendColumn` |
+| 3 | POST | `/api/authority/resource/update-by-extendcolumn` | `updateByExtendColumn` |
+
+---
+
+## 三、不存在的方法（之前 skill 声明但源码无）
+
+| skill 声明 | 实测 | 建议 |
+|-----------|------|------|
+| `GET /api/resource/delAuthByRole` | ❌ 不存在 | 用 `POST /api/authority/assign/delete-by-resouce-objid` |
+| `GET /api/resource/userAuth` | ❌ 不存在 | 用 `POST /api/authority/assign/resourceIdListByUser` 间接实现 |
+| `GET /api/resource/api?resourceId=` | ❌ 不存在 | 通过 `ResourceController` 其他接口组合 |
+| `GET /api/resource/buttons?resourceId=` | ❌ 不存在 | 按业务场景从 `resource-code-auth` 推断 |
+| `POST /api/resource/cancelAuth` | ❌ 不存在 | 通过 `save`/`modify` 清除 |
+
+---
+
+## 四、实际 Feign Client（基于源码修正）
+
+```java
+// ⚠️ 之前 skill 中描述的 ResourceFeignClient 接口源码中无此文件
+// 实际接入：通过 @Autowired AssignController 内部方法，或通过 Feign 调用 cloud-system-manage 服务
+```
+
+---
+
+## 五、关键差异对照（之前 vs 实测）
+
+| 之前声明 | 实测正确 |
+|---------|---------|
+| `GET /api/resource/getByRole?roleId=` | `POST /api/authority/assign/resourceIdListByRole?roleId=` |
+| `DELETE /api/resource/delAuthByRole` | `POST /api/authority/assign/delete-by-resouce-objid` |
+| `POST /api/resource/setRoleResources` | `POST /api/authority/assign/save` |
+| `GET /api/resource/roleAuth` | `POST /api/authority/assign/getAssign` |
+| `GET /api/resource/getByUser` | `POST /api/authority/assign/resourceIdListByUser` |
+| `POST /api/resource/setUserResources` | `POST /api/authority/assign/save`（共用） |
+| `DELETE /api/resource/delByUser` | 通过 `save`/`modify` 实现 |
+| `GET /api/resource/authInfo` | `POST /api/authority/assign/resource-permission-list` |
+| `GET /api/resource/getAuthorizedPersons` | `POST /api/authority/assign/list-user-by-auth6` |
+| `DELETE /api/resource/delAllAuth` | `POST /api/authority/assign/delete-by-resouce` |
+| `POST /api/resource/authRole` | `POST /api/authority/assign/save`（按 type=4） |
+| `GET /api/resource/tree` | `POST /api/authority/resource/tree` |
+| `GET /api/resource/authTree` | `POST /api/authority/resource/getAssignTree` |
+
+---
+
+## 🔗 相关文档
+
+- `dev-docs/36_3.1-3.7资源授权基础.md`（资源授权基础）
+- `dev-docs/37_3.8-3.10资源授权进阶.md`（资源授权进阶）
+- `dev-docs/43_3.15资源维护-上半.md`（资源 CRUD）
+- `dev-docs/44_3.16人员选择器-上半.md`（人员选择器）

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

@@ -1,42 +1,47 @@
 ---
 name: meritdata-platform-session
-description: |
-  会话管理。SSO 单点登录 / Token 续期 / 多端登录互踢 / 强制下线 / 在线用户查询。
-  触发场景：登录认证 / Token 校验 / 会话状态查询 / 单点登出。
-  何时不用：纯 SSO 协议细节 → 用 meritdata-platform-sso；菜单权限 → 用 menu-config。
+description: MeritData Session 专项。用于会话创建、失效、SessionUtils 使用、Session 与 Cookie 关系。
 metadata:
   version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-07"
-  last_modified: "2026-09-07"
-  risk: high
-  layer: L3
-  sub-layer: L3-C
-  stack: java
-allowed-tools: Read, Grep, Glob, Bash
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
+  risk: low
+  allowed-tools: Read, Grep, Glob
 ---
 
-# 会话管理（session）
-
-## 触发
-- 需要登录、登出、Token 校验、Token 续期
-- 多端登录互踢（同一账号新登录踢旧设备）
-- 强制下线（管理员踢指定会话）
-- 在线用户查询（在线列表、活跃会话）
-
-## 不触发
-- SSO 协议实现细节（SAML/OIDC/CAS）→ 用 `meritdata-platform-sso`
-- 菜单权限 / 按钮权限 → 用 `meritdata-platform-permission`
-- 用户/组织 CRUD → 用 `meritdata-platform-org-user-api`
-
-## 前置约束
-- 会话**必须**存服务端（Redis），不依赖客户端 Cookie
-- Token 校验在网关层 + 服务层双重校验
-- 敏感操作必须强制二次认证或会话强度检查
-
-## 路由
-- 会话接口 + Token 生命周期 → [references/guide.md](references/guide.md)
-- 多端登录互踢 / 强制下线 → [references/multi-device.md](references/multi-device.md)
-- 在线用户 / 会话监控 → [references/online-monitor.md](references/online-monitor.md)
-- [SKILL.md](../SKILL.md)
+## ⭐ MUST DO
+
+**会话超时合理设置（推荐 30 分钟）；登出必须显式失效 Session；Session ID 不可预测。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- 单应用会话管理
+- SessionUtils 使用
+- 会话超时与续期
+
+**不适用**：
+- 跨应用 SSO → `meritdata-platform-sso`
+- 平台当前用户 → `meritdata-platform-core`
+
+## 工作方式
+
+1. 设置 `server.session.timeout=30m`
+2. 登出：`session.invalidate()`
+3. 会话 ID 使用 UUID 随机生成
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 会话永不过期 | 安全风险 | 合理超时 |
+| 不显式失效 | 内存泄漏 | 登出 invalidate |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 跨应用 SSO → `meritdata-platform-sso`
+  - 当前用户 API → `meritdata-platform-core/references/session.md`
+- **强制要求**：会话超时显式设置

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

@@ -0,0 +1,9 @@
+display_name: "MeritData Session"
+short_description: "单应用会话管理、SessionUtils"
+default_prompt: |
+  meritdata-platform-session 处理单应用 Session 场景。
+
+  强制约束：
+  - 会话超时显式设置（推荐 30 分钟）
+  - 登出显式 invalidate
+  - Session ID 不可预测

package/skills/meritdata-platform-session/references/api-quick-ref.md

@@ -0,0 +1,52 @@
+# SessionUtils 21 方法速查
+
+## 当前用户（6）
+
+| 方法 | 返回 | 用途 |
+|------|------|------|
+| `getCurrentUserId()` | `String` | 当前用户 ID |
+| `getCurrentUserName()` | `String` | 当前用户姓名 |
+| `getCurrentUser()` | `UserInfo` | 当前完整信息 |
+| `getCurrentUserAccount()` | `String` | 当前登录账号 |
+| `getCurrentUserPhone()` | `String` | 当前手机号 |
+| `getCurrentUserEmail()` | `String` | 当前邮箱 |
+
+## 当前部门（3）
+
+| 方法 | 返回 |
+|------|------|
+| `getCurrentDeptId()` | `String` |
+| `getCurrentDeptName()` | `String` |
+| `getCurrentDept()` | `DeptInfo` |
+
+## 当前组织（2）
+
+| 方法 | 返回 |
+|------|------|
+| `getCurrentOrgId()` | `String` |
+| `getCurrentOrgName()` | `String` |
+
+## 角色（3）
+
+| 方法 | 返回 |
+|------|------|
+| `getCurrentRoleIds()` | `List<String>` |
+| `getCurrentRoleNames()` | `List<String>` |
+| `getCurrentRoles()` | `List<RoleInfo>` |
+
+## 权限（2）
+
+| 方法 | 返回 |
+|------|------|
+| `hasPermission(String code)` | `boolean` |
+| `getCurrentPermissions()` | `List<String>` |
+
+## 租户 / 会话（5）
+
+| 方法 | 返回 |
+|------|------|
+| `getCurrentTenantId()` | `String` |
+| `getSessionId()` | `String` |
+| `getOnlineTime()` | `Long`（秒）|
+| `isAuthenticated()` | `boolean` |
+| `getToken()` | `String` |