F1-5: 系统管理只读页面(amis schema + 后端端点)

新增 4 个系统管理只读页 amis JSON schema(admin-schemas/)及对应后端端点:
- AdminController: /api/admin/users(用户分页,密码不下发)、
  /api/admin/roles/{id}/users(角色成员)、
  /api/admin/menu-all(全量菜单树,管理视角)、
  /api/admin/filterrules(数据权限规则分页)
- 4 个 schema 以 sys-admin-* 为 template_id 入库 sys_page_schema,
  经既有 GET /api/page/schema/{id} 渲染链路下发(零前端改动)
- 幂等 upsert SQL(docs/sql/F1-5_sys_admin_schemas_upsert.sql),
  已在 eip4dev(eip3) 和 eip4m0(public) 两库执行
- AdminControllerTest 9 个单测全部通过;8094 临时实例实测所有端点 200

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 20:30:02 +08:00
parent 7a48a0ba29
commit 3c70e84de6
7 changed files with 859 additions and 0 deletions

View File

@@ -0,0 +1,307 @@
package com.eip4.platform.metadata.web;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import org.springframework.jdbc.core.JdbcOperations;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
/**
* F1-5 系统管理只读端点(管理视角,不触发行级过滤)。
*
* <p>提供 4 个只读端点,供 sys-admin-* 系列 amis schema 页面使用:
* <ul>
* <li>{@code GET /api/admin/users} — 用户分页查询,关键字过滤,密码列不下发</li>
* <li>{@code GET /api/admin/roles/{id}/users} — 某角色下的用户列表(经岗位组中转)</li>
* <li>{@code GET /api/admin/menu-all} — 全量菜单树(不按用户裁剪的管理视角)</li>
* <li>{@code GET /api/admin/filterrules} — 数据权限规则分页,支持实体名过滤</li>
* </ul>
*
* <p>纪律:零改 com.dsasp;SQL 全参数化;密码列绝不下发。
*/
@Tag(name = "系统管理(只读)", description = "F1-5 管理视角只读端点,供 sys-admin-* amis schema 页面使用")
@RestController
public class AdminController {
private final JdbcOperations jdbcTemplate;
public AdminController(JdbcOperations jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
// ---------------------------------------------------------------- 用户查询
/**
* 用户分页查询(管理视角,不触发行级过滤)。
*
* <p>密码列绝不下发(SELECT 中排除 password 列)。
* 关键字按 account/name 模糊匹配(ILIKE,大小写不敏感)。
* 部门名通过 sys_position + sys_depart 关联取首个在岗部门。
*
* @param page 页码(从 1 开始),默认 1
* @param perPage 每页条数,默认 20,上限 200(防超大请求)
* @param keyword 账号/姓名关键字,为空则不过滤
* @return amis crud 约定格式 {@code {status,data:{items,total}}}
*/
@Operation(summary = "用户分页查询(管理视角,密码不下发)",
description = "关键字按 account/name ILIKE 过滤;返回格式 {status,data:{items,total}} 适配 amis crud")
@GetMapping("/api/admin/users")
public Map<String, Object> users(
@Parameter(description = "页码,从 1 开始") @RequestParam(defaultValue = "1") int page,
@Parameter(description = "每页条数,最大 200") @RequestParam(defaultValue = "20") int perPage,
@Parameter(description = "账号/姓名关键字,空则不过滤") @RequestParam(required = false) String keyword) {
// 上限保护,防止超大分页请求
int safePerPage = Math.min(Math.max(perPage, 1), 200);
int offset = (Math.max(page, 1) - 1) * safePerPage;
// 关键字条件(参数化,防 SQL 注入)
boolean hasKeyword = keyword != null && !keyword.isBlank();
String like = hasKeyword ? "%" + keyword.trim() + "%" : null;
// 主查询:用户基本信息 + 首个在岗部门名(LEFT JOIN,无部门岗位时 departName 为 null)
// 密码列不出现在 SELECT 中
String sql = "SELECT TRIM(u.sys_user_id) AS id,"
+ " TRIM(u.account) AS account,"
+ " TRIM(u.name) AS name,"
+ " TRIM(d.name) AS \"departName\","
+ " u.state"
+ " FROM sys_user u"
+ " LEFT JOIN LATERAL ("
+ " SELECT d2.name FROM sys_position p"
+ " JOIN sys_positionuser pu ON pu.positionid = p.sys_position_id"
+ " JOIN sys_depart d2 ON TRIM(d2.sys_depart_id) = TRIM(p.parentdepartid)"
+ " WHERE TRIM(pu.userid) = TRIM(u.sys_user_id)"
+ " LIMIT 1"
+ " ) d ON TRUE"
+ (hasKeyword ? " WHERE u.account ILIKE ? OR u.name ILIKE ?" : "")
+ " ORDER BY u.account"
+ " LIMIT ? OFFSET ?";
// 计数查询
String countSql = "SELECT COUNT(*) FROM sys_user u"
+ (hasKeyword ? " WHERE u.account ILIKE ? OR u.name ILIKE ?" : "");
List<Map<String, Object>> items;
int total;
if (hasKeyword) {
items = jdbcTemplate.queryForList(sql, like, like, safePerPage, offset);
total = jdbcTemplate.queryForObject(countSql, Integer.class, like, like);
} else {
items = jdbcTemplate.queryForList(sql, safePerPage, offset);
total = jdbcTemplate.queryForObject(countSql, Integer.class);
}
return okList(items, total);
}
// ---------------------------------------------------------------- 角色成员
/**
* 某角色下的用户列表(通过 sys_usergrouprole → sys_usergroupuser 中转)。
*
* <p>引擎角色-用户关联语义:角色挂在岗位组(sys_usergroup),用户加入岗位组,
* 关联路径:sys_role ← sys_usergrouprole → sys_usergroup → sys_usergroupuser → sys_user。
*
* @param roleId SYS_ROLE.SYS_ROLE_ID(36 位 UUID)
* @return amis service 约定格式 {@code {status,data:{items,total}}}
*/
@Operation(summary = "某角色下的用户列表(通过岗位组中转,密码不下发)",
description = "关联路径: sys_usergrouprole → sys_usergroupuser → sys_user;返回 {status,data:{items,total}}")
@GetMapping("/api/admin/roles/{roleId}/users")
public Map<String, Object> roleUsers(
@Parameter(description = "SYS_ROLE.SYS_ROLE_ID 角色 ID(36 位)") @PathVariable String roleId) {
// 密码列不出现在 SELECT 中;DISTINCT + ORDER BY 必须用 SELECT 列表别名(PostgreSQL 要求)
String sql = "SELECT DISTINCT TRIM(u.sys_user_id) AS id,"
+ " TRIM(u.account) AS account,"
+ " TRIM(u.name) AS \"userName\","
+ " u.state"
+ " FROM sys_usergrouprole ugr"
+ " JOIN sys_usergroupuser ugu ON ugu.usergroupid = ugr.usergroupid"
+ " JOIN sys_user u ON TRIM(u.sys_user_id) = TRIM(ugu.userid)"
+ " WHERE TRIM(ugr.roleid) = ?"
+ " ORDER BY account";
List<Map<String, Object>> items = jdbcTemplate.queryForList(sql, roleId.trim());
return okList(items, items.size());
}
// ---------------------------------------------------------------- 菜单全量树(管理视角)
/**
* 全量菜单树(不按用户裁剪的管理视角)。
*
* <p>与 {@link MenuController} 的区别:不 JOIN view_sys_usermenuid,
* 返回所有 isactive=1 的菜单,供系统管理员查看全量菜单结构。
* 结构:roots → children(每个目录/叶子节点带 childCount 统计子菜单数)。
*
* @return {@code { roots: [ {id, name, seq, children: [ {id, name, templateId, typename, seq, childCount, children:[...]} ]} ] }}
*/
@Operation(summary = "全量菜单树(管理视角,不按用户裁剪)",
description = "不 JOIN view_sys_usermenuid;返回所有 isactive=1 菜单;管理视角 @Operation 标记")
@GetMapping("/api/admin/menu-all")
public Map<String, Object> menuAll() {
// 查询所有根节点
List<Map<String, Object>> roots = jdbcTemplate.query(
"SELECT TRIM(sys_menu_root_id) AS id, TRIM(name) AS name, seq"
+ " FROM sys_menu_root WHERE isactive = 1 ORDER BY seq",
(rs, i) -> {
Map<String, Object> m = new LinkedHashMap<>();
m.put("id", rs.getString("id"));
m.put("name", rs.getString("name"));
m.put("seq", rs.getObject("seq"));
return m;
});
// 查询所有活跃菜单(全量,不裁剪)
List<Map<String, Object>> menus = jdbcTemplate.query(
"SELECT TRIM(sys_menu_id) AS id, TRIM(name) AS name,"
+ " TRIM(parentid) AS parentid, TRIM(menuroot) AS menuroot,"
+ " TRIM(view_templateid) AS templateId,"
+ " TRIM(typename) AS typename, seq"
+ " FROM sys_menu WHERE isactive = 1 ORDER BY seq",
(rs, i) -> {
Map<String, Object> m = new LinkedHashMap<>();
m.put("id", rs.getString("id"));
m.put("name", rs.getString("name"));
m.put("parentid", rs.getString("parentid"));
m.put("menuroot", rs.getString("menuroot"));
m.put("templateId", rs.getString("templateId"));
m.put("typename", rs.getString("typename"));
m.put("seq", rs.getObject("seq"));
return m;
});
// 按 root 分组构建两级树(目录→叶子)
List<Map<String, Object>> result = new ArrayList<>();
for (Map<String, Object> root : roots) {
String rootId = (String) root.get("id");
List<Map<String, Object>> children = buildMenuChildren(menus, rootId, null);
Map<String, Object> rootNode = new LinkedHashMap<>(root);
rootNode.put("children", children);
result.add(rootNode);
}
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
resp.put("msg", "");
resp.put("roots", result);
return resp;
}
/**
* 递归构建菜单子树(两级:目录→叶子;目录 parentid=null,叶子 parentid≠null)。
* childCount 统计直接子菜单数量,供管理视角快速了解菜单规模。
*/
private List<Map<String, Object>> buildMenuChildren(
List<Map<String, Object>> allMenus, String rootId, String parentId) {
List<Map<String, Object>> children = new ArrayList<>();
for (Map<String, Object> m : allMenus) {
String menuRoot = (String) m.get("menuroot");
String mParentId = (String) m.get("parentid");
// 根节点匹配 + parentid 匹配(null 比对用 isEmpty 兼容空白字符)
boolean rootMatch = rootId != null && rootId.equals(menuRoot);
boolean parentMatch = (parentId == null || parentId.isBlank())
? (mParentId == null || mParentId.isBlank())
: parentId.equals(mParentId);
if (rootMatch && parentMatch) {
Map<String, Object> node = new LinkedHashMap<>();
node.put("id", m.get("id"));
node.put("name", m.get("name"));
node.put("templateId", m.get("templateId"));
node.put("typename", m.get("typename"));
node.put("seq", m.get("seq"));
// 递归取子节点
List<Map<String, Object>> subChildren = buildMenuChildren(allMenus, rootId, (String) m.get("id"));
node.put("childCount", subChildren.size());
node.put("children", subChildren);
children.add(node);
}
}
return children;
}
// ---------------------------------------------------------------- 数据权限规则
/**
* 数据权限规则分页列表(SYS_FILTERRULE,1,079 条)。
*
* <p>关联 SYS_ENTITY 取实体名/表名,关联 SYS_FILTERRULEROLE→SYS_ROLE 聚合角色名。
* 支持按实体名关键字过滤(ILIKE,大小写不敏感)。
*
* @param page 页码(从 1 开始),默认 1
* @param perPage 每页条数,默认 20,上限 200
* @param entityName 实体名关键字(按 sys_entity.name ILIKE 过滤),空则不过滤
* @return amis crud 约定格式 {@code {status,data:{items,total}}}
*/
@Operation(summary = "数据权限规则分页列表(按实体名过滤)",
description = "关联 sys_entity(实体名/表名) + sys_filterrulerole→sys_role(角色名聚合);返回 {status,data:{items,total}}")
@GetMapping("/api/admin/filterrules")
public Map<String, Object> filterRules(
@Parameter(description = "页码,从 1 开始") @RequestParam(defaultValue = "1") int page,
@Parameter(description = "每页条数,最大 200") @RequestParam(defaultValue = "20") int perPage,
@Parameter(description = "实体名关键字,空则不过滤") @RequestParam(required = false) String entityName) {
int safePerPage = Math.min(Math.max(perPage, 1), 200);
int offset = (Math.max(page, 1) - 1) * safePerPage;
boolean hasFilter = entityName != null && !entityName.isBlank();
String like = hasFilter ? "%" + entityName.trim() + "%" : null;
// 主查询:filterrule + 实体名/表名 + 聚合角色名(STRING_AGG)
String sql = "SELECT TRIM(fr.sys_filterrule_id) AS id,"
+ " TRIM(e.name) AS \"entityName\","
+ " TRIM(e.tablename) AS \"tableName\","
+ " fr.filterrule AS \"filterRule\","
+ " STRING_AGG(TRIM(r.name), ', ' ORDER BY r.name) AS roles"
+ " FROM sys_filterrule fr"
+ " LEFT JOIN sys_entity e ON TRIM(e.sys_entity_id) = TRIM(fr.entityid)"
+ " LEFT JOIN sys_filterrulerole frr ON TRIM(frr.filterruleid) = TRIM(fr.sys_filterrule_id)"
+ " LEFT JOIN sys_role r ON TRIM(r.sys_role_id) = TRIM(frr.roleid)"
+ (hasFilter ? " WHERE e.name ILIKE ?" : "")
+ " GROUP BY fr.sys_filterrule_id, e.name, e.tablename, fr.filterrule"
+ " ORDER BY e.name, fr.sys_filterrule_id"
+ " LIMIT ? OFFSET ?";
String countSql = "SELECT COUNT(*) FROM sys_filterrule fr"
+ " LEFT JOIN sys_entity e ON TRIM(e.sys_entity_id) = TRIM(fr.entityid)"
+ (hasFilter ? " WHERE e.name ILIKE ?" : "");
List<Map<String, Object>> items;
int total;
if (hasFilter) {
items = jdbcTemplate.queryForList(sql, like, safePerPage, offset);
total = jdbcTemplate.queryForObject(countSql, Integer.class, like);
} else {
items = jdbcTemplate.queryForList(sql, safePerPage, offset);
total = jdbcTemplate.queryForObject(countSql, Integer.class);
}
return okList(items, total);
}
// ---------------------------------------------------------------- 内部工具
private Map<String, Object> okList(List<Map<String, Object>> items, int total) {
Map<String, Object> data = new LinkedHashMap<>();
data.put("items", items);
data.put("total", total);
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
resp.put("msg", "");
resp.put("data", data);
return resp;
}
}

View File

@@ -0,0 +1,67 @@
{
"type": "page",
"title": "数据权限规则",
"body": [
{
"type": "crud",
"syncLocation": false,
"api": {
"method": "get",
"url": "/api/admin/filterrules?page=${page}&perPage=${perPage}&entityName=${entityName}",
"adaptor": "if(payload&&payload.data){return payload;}return {status:0,data:{items:payload.items||[],total:payload.total||0}};"
},
"headerToolbar": [
{
"type": "tpl",
"tpl": "共 ${total} 条规则",
"className": "v-middle"
},
"pagination"
],
"footerToolbar": ["statistics", "pagination"],
"perPage": 20,
"filter": {
"title": "查询条件",
"submitText": "查询",
"body": [
{
"type": "input-text",
"name": "entityName",
"label": "实体名",
"placeholder": "按实体名过滤",
"clearable": true
}
]
},
"columns": [
{
"name": "entityName",
"label": "实体名",
"sortable": false,
"width": 150
},
{
"name": "tableName",
"label": "表名",
"sortable": false,
"width": 180
},
{
"name": "roles",
"label": "关联角色",
"sortable": false,
"width": 200,
"type": "tpl",
"tpl": "<span title='${roles}'>${roles|truncate:60}</span>"
},
{
"name": "filterRule",
"label": "规则内容",
"sortable": false,
"type": "tpl",
"tpl": "<pre style='font-size:0.8em;max-height:80px;overflow:auto;white-space:pre-wrap;word-break:break-all'>${filterRule}</pre>"
}
]
}
]
}

View File

@@ -0,0 +1,52 @@
{
"type": "page",
"title": "菜单总览(管理视角)",
"body": [
{
"type": "service",
"api": {
"method": "get",
"url": "/api/admin/menu-all"
},
"body": [
{
"type": "each",
"name": "roots",
"className": "mb-4",
"items": {
"type": "panel",
"title": "${name}",
"body": {
"type": "table",
"source": "${children}",
"columns": [
{
"name": "name",
"label": "目录/菜单名"
},
{
"name": "templateId",
"label": "模板 ID",
"type": "tpl",
"tpl": "<span class='text-muted' style='font-size:0.85em'>${templateId}</span>"
},
{
"name": "typename",
"label": "类型"
},
{
"name": "seq",
"label": "排序"
},
{
"name": "childCount",
"label": "子菜单数"
}
]
}
}
}
]
}
]
}

View File

@@ -0,0 +1,82 @@
{
"type": "page",
"title": "角色与成员",
"body": [
{
"type": "crud",
"syncLocation": false,
"api": {
"method": "get",
"url": "/api/org/roles",
"adaptor": "var d=payload.data||{};return {status:0,data:{items:d.items||[],total:d.total||0}};"
},
"headerToolbar": [
{
"type": "tpl",
"tpl": "共 ${total} 条角色",
"className": "v-middle"
}
],
"footerToolbar": ["statistics", "pagination"],
"perPage": 20,
"columns": [
{
"name": "name",
"label": "角色名称",
"sortable": false
},
{
"name": "description",
"label": "描述",
"sortable": false
},
{
"name": "roleType",
"label": "类型",
"type": "mapping",
"map": {
"1": "功能角色",
"2": "数据角色",
"*": "其他"
}
},
{
"type": "operation",
"label": "成员",
"buttons": [
{
"type": "button",
"label": "查看成员",
"level": "link",
"actionType": "dialog",
"dialog": {
"title": "角色「${name}」成员列表",
"size": "lg",
"body": {
"type": "service",
"api": {
"method": "get",
"url": "/api/admin/roles/${id}/users",
"adaptor": "var d=payload.data||{};return {status:0,data:{items:d.items||[],total:d.total||0}};"
},
"body": {
"type": "table",
"source": "${items}",
"columns": [
{"name": "account", "label": "账号"},
{"name": "userName", "label": "姓名"},
{"name": "state", "label": "激活状态", "type": "mapping", "map": {"1": "激活", "2": "停用", "3": "未激活", "*": "未知"}}
]
}
},
"actions": [
{"type": "button", "label": "关闭", "actionType": "close"}
]
}
}
]
}
]
}
]
}

View File

@@ -0,0 +1,66 @@
{
"type": "page",
"title": "用户查询",
"body": [
{
"type": "crud",
"syncLocation": false,
"api": {
"method": "get",
"url": "/api/admin/users?page=${page}&perPage=${perPage}&keyword=${keyword}",
"adaptor": "if(payload&&payload.data){return payload;}return {status:0,data:{items:payload.items||[],total:payload.total||0}};"
},
"headerToolbar": [
{
"type": "tpl",
"tpl": "共 ${total} 条",
"className": "v-middle"
},
"pagination"
],
"footerToolbar": ["statistics", "pagination"],
"perPage": 20,
"filter": {
"title": "查询条件",
"submitText": "查询",
"body": [
{
"type": "input-text",
"name": "keyword",
"label": "账号/姓名",
"placeholder": "输入账号或姓名关键字",
"clearable": true
}
]
},
"columns": [
{
"name": "account",
"label": "账号",
"sortable": false
},
{
"name": "name",
"label": "姓名",
"sortable": false
},
{
"name": "departName",
"label": "部门",
"sortable": false
},
{
"name": "state",
"label": "激活状态",
"type": "mapping",
"map": {
"1": "<span class='label label-success'>激活</span>",
"2": "<span class='label label-warning'>停用</span>",
"3": "<span class='label label-default'>未激活</span>",
"*": "<span class='label label-default'>未知</span>"
}
}
]
}
]
}