# 权限管理 > 模块编码：permission > 端侧：Web专属（仅超级管理员） > 关联文档：01-模块划分 §8 / 02-功能清单-超级管理员 §2 / 03-业务流转逻辑-超级管理员 §4~6 / 05-接口规范 §4.2~4.3 / 06-项目技术要求 §4.2 ## 功能概览 | 项目 | 说明 | |------|------| | 菜单名称 | 权限管理 | | 子菜单 | 角色管理、权限配置注册、权限审计日志 | | 功能编号 | SA-P-01 ~ SA-P-10 | | 权限编码前缀 | permission:role:* / permission:config:* | --- ## 页面1：角色管理列表页 **页面编号**：SA-P-01-P01 **端侧归属**：Web专属 **页面路径**：/permission/roles ### 界面布局 ``` ┌──────────────────────────────────────────────────────────────────┐ │ [面包屑] 权限管理 > 角色管理 │ ├──────────────────────────────────────────────────────────────────┤ │ [查询条件区] │ │ 角色名称[____] 适用范围[▼] 状态[▼] [查询] [重置] │ ├──────────────────────────────────────────────────────────────────┤ │ [操作栏] [新增角色] │ ├──────────────────────────────────────────────────────────────────┤ │ [列表区] │ │ 序号 | 角色名称 | 适用范围 | 预设模板 | 关联账号数 | 状态 | 操作 │ │ 1 | 医院查看 | 医院 | 是 | 5 | 启用 | 编辑 停用│ │ 2 | 巡检主管 | 物业下属| 否 | 8 | 启用 | 编辑 停用│ │ 3 | 维修员 | 物业下属| 是 | 23 | 启用 | 编辑 停用│ ├──────────────────────────────────────────────────────────────────┤ │ [分页] 共15条 每页[20▼] < 1 > │ └──────────────────────────────────────────────────────────────────┘ ``` ### 查询条件 | 字段名 | 控件类型 | 必填 | 默认值 | 说明 | |--------|----------|------|--------|------| | 角色名称 | 文本输入 | 否 | — | 模糊匹配 | | 适用范围 | 下拉单选 | 否 | 全部 | 医院账号/物业管理员/物业下属 | | 状态 | 下拉单选 | 否 | 全部 | 启用/停用 | ### 列表字段 | 序号 | 字段名 | 列宽 | 支持排序 | 说明 | |------|--------|------|----------|------| | 1 | 序号 | 60px | — | 自增 | | 2 | 角色名称 | 150px | 是 | — | | 3 | 适用范围 | 120px | 否 | 医院账号/物业管理员/物业下属 | | 4 | 预设模板 | 80px | 否 | 是/否标签 | | 5 | 关联账号数 | 100px | 是 | 点击查看关联账号列表 | | 6 | 状态 | 80px | 是 | 启用/停用 | | 7 | 操作 | 220px | — | 编辑/权限预览/停用/删除 | ### 操作按钮 | 按钮 | 权限编码 | 位置 | 显示条件 | 说明 | |------|----------|------|----------|------| | 新增角色 | permission:role:create | 操作栏 | 始终 | 跳转新增页 | | 编辑 | permission:role:update | 行操作 | 始终 | 跳转编辑页 | | 权限预览 | permission:role:view | 行操作 | 始终 | 弹窗展示完整权限清单 | | 停用 | permission:role:update | 行操作 | 状态=启用 | 二次确认 | | 删除 | permission:role:delete | 行操作 | 关联账号数=0 | 二次确认 | ### 角色差异化视图 | 角色 | 可见按钮 | 数据范围 | 备注 | |------|----------|----------|------| | 超级管理员 | 全部按钮 | 全部角色 | — | ### API端点 | 页面操作 | API路径 | 方法 | 说明 | |----------|---------|------|------| | 列表查询 | /api/v1/roles | GET | 分页查询 | | 停用角色 | /api/v1/roles/{id}/disable | PUT | — | | 删除角色 | /api/v1/roles/{id} | DELETE | 仅无关联账号时可删 | --- ## 页面2：角色新增/编辑页 **页面编号**：SA-P-01-P02 **端侧归属**：Web专属 **页面路径**：/permission/roles/create 或 /permission/roles/:id/edit ### 界面布局 ``` ┌──────────────────────────────────────────────────────────────────┐ │ [面包屑] 权限管理 > 角色管理 > 新增角色 │ ├──────────────────────────────────────────────────────────────────┤ │ ── 基本信息 ── │ │ 角色名称：[____________] │ │ 角色描述：[____________________________] │ │ 适用范围：[▼] (医院账号/物业管理员/物业下属) │ │ 选择预设模板：[▼可选] 选择后自动填充权限，可微调 │ ├──────────────────────────────────────────────────────────────────┤ │ ── 权限分配（四级树形勾选）── │ │ ☑ 功能菜单：在线报修 │ │ ├── ☑ 页面：工单列表 │ │ │ ├── ☑ 功能点：工单管理 │ │ │ │ ├── ☑ 查看 ☑ 新增 ☑ 编辑 │ │ │ │ ├── ☐ 删除 ☐ 审批 ☑ 导出 ☑ 分配 │ │ │ └── ☑ 功能点：批量操作 │ │ │ ├── ☑ 查看 ☐ 新增 ☐ 编辑 │ │ │ └── ☐ 删除 ☐ 审批 ☐ 导出 ☐ 分配 │ │ ├── ☑ 页面：工单详情 │ │ │ ├── ☑ 功能点：延期审批 │ │ │ │ ├── ☑ 查看 ☐ 新增 ☐ 编辑 │ │ │ │ └── ☐ 删除 ☑ 审批 ☐ 导出 ☐ 分配 │ │ │ └── ☑ 功能点：工单验收 │ │ │ ├── ☑ 查看 ☐ 新增 ☐ 编辑 │ │ │ └── ☐ 删除 ☑ 审批 ☐ 导出 ☐ 分配 │ │ └── ☐ 页面：报修类型管理 │ │ ... │ │ ☐ 功能菜单：巡检管理 │ │ ... │ ├──────────────────────────────────────────────────────────────────┤ │ [取消] [权限预览] [保存] │ └──────────────────────────────────────────────────────────────────┘ ``` ### 表单字段（基本信息） | 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 | |--------|----------|------|--------|----------|----------| | 角色名称 | 文本输入 | 是 | — | 自填 | 最大30字，全局唯一 | | 角色描述 | 多行文本 | 否 | — | 自填 | 最大200字 | | 适用范围 | 下拉单选 | 是 | — | 固定选项 | 医院账号/物业管理员/物业下属 | | 预设模板 | 下拉单选 | 否 | — | 预设模板列表 | 选择后自动填充权限 | ### 预设模板选项 | 模板名称 | 适用对象 | 典型权限 | 文档来源 | |----------|----------|----------|----------| | 物业管理员模板 | 物业公司管理员 | 全部日常业务管理权限 | 01 §8.4 | | 主管模板 | 主管 | 本班组管理+审批+查看+导出 | 01 §8.4 | | 班组长模板 | 班组长 | 本班组查看+分配+导出 | 01 §8.4 | | 维修员模板 | 维修人员 | 接单+完工+延期申请 | 01 §8.4 | | 巡检员模板 | 巡检人员 | 巡检执行+打卡+异常上报 | 01 §8.4 | | 保洁员模板 | 保洁人员 | 保洁执行+打卡确认 | 01 §8.4 | | 医院查看模板 | 医院账号 | 全部日常数据查看+合同+招标 | 01 §8.4 | ### 操作按钮 | 按钮 | 权限编码 | 位置 | 显示条件 | 说明 | |------|----------|------|----------|------| | 权限预览 | permission:role:view | 底部操作栏 | 始终 | 弹窗展示已勾选的完整权限清单 | | 保存 | permission:role:create/update | 底部操作栏 | 始终 | 保存后权限审计日志+实时生效 | ### 通知触发 | 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 | |----------|----------|----------|----------|----------| | 权限变更 | 关联账号用户 | Redis Pub/Sub | 毫秒级刷新权限缓存，无需重新登录 | 03-超级管理员 §6 | | 权限变更 | 关联账号用户 | 小程序 | 下次接口请求时返回新权限集 | 03-超级管理员 §6 | ### API端点 | 页面操作 | API路径 | 方法 | 说明 | |----------|---------|------|------| | 新增角色 | /api/v1/roles | POST | — | | 编辑角色 | /api/v1/roles/{id} | PUT | — | | 获取权限树 | /api/v1/permissions/tree | GET | 四级权限树结构 | | 权限预览 | /api/v1/roles/{id}/permissions | GET | 已分配的完整权限列表 | --- ## 页面3：权限预览弹窗 **页面编号**：SA-P-06-P01 **端侧归属**：Web专属 **页面路径**：弹窗形式 ### 界面布局 ``` ┌──────────────────────────────────────────────────────────────────┐ │ 权限预览 — 巡检主管 [×] │ ├──────────────────────────────────────────────────────────────────┤ │ ☑ 在线报修 │ │ ├─ ☑ 工单列表 │ │ │ ├─ ☑ 工单管理：查看 ✓ 新增 ✗ 编辑 ✓ 删除 ✗ 审批 ✓ 导出 ✓ 分配 ✗│ │ │ └─ ☐ 批量操作 │ │ ├─ ☑ 工单详情 │ │ │ ├─ ☑ 延期审批：查看 ✓ 审批 ✓ │ │ │ └─ ☑ 工单验收：查看 ✓ 审批 ✓ │ │ └─ ☐ 报修类型管理 │ │ ☑ 巡检管理 │ │ ├─ ☑ 巡检计划：查看 ✓ 新增 ✓ 编辑 ✓ │ │ ... │ ├──────────────────────────────────────────────────────────────────┤ │ [关闭] │ └──────────────────────────────────────────────────────────────────┘ ``` ### 说明 - 展示角色当前已分配的完整权限清单 - 四级展开：功能菜单→页面→功能点→动作 - 每个动作用 ✓/✗ 标识是否有权限 - 支持搜索功能菜单/页面名称 --- ## 页面4：权限配置注册页 **页面编号**：SA-P-10-P01 **端侧归属**：Web专属 **页面路径**：/permission/registry ### 界面布局 ``` ┌──────────────────────────────────────────────────────────────────┐ │ [面包屑] 权限管理 > 权限配置注册 │ ├──────────────────────────────────────────────────────────────────┤ │ [说明] 此页面展示系统自动注册的权限配置（来源：IModulePlugin）， │ │ 开发新增功能时自动同步，超级管理员可查看但不可手动编辑 │ ├──────────────────────────────────────────────────────────────────┤ │ [查询条件区] │ │ 模块名称[____] 页面名称[____] [查询] [重置] │ ├──────────────────────────────────────────────────────────────────┤ │ [列表区] │ │ 模块编码 | 模块名称 | 页面编码 | 页面名称 | 功能点 | 可用动作 │ │ repair | 在线报修 | repair_list| 工单列表 | 工单管理 | 查看,新增..│ │ repair | 在线报修 | repair_detail|工单详情| 延期审批| 查看,审批 │ │ ... │ ├──────────────────────────────────────────────────────────────────┤ │ [分页] 共120条 每页[20▼] < 1 2 3 ... 6 > │ └──────────────────────────────────────────────────────────────────┘ ``` ### 查询条件 | 字段名 | 控件类型 | 必填 | 默认值 | 说明 | |--------|----------|------|--------|------| | 模块名称 | 文本输入 | 否 | — | 模糊匹配 | | 页面名称 | 文本输入 | 否 | — | 模糊匹配 | ### 列表字段 | 序号 | 字段名 | 列宽 | 支持排序 | 说明 | |------|--------|------|----------|------| | 1 | 模块编码 | 100px | 否 | — | | 2 | 模块名称 | 100px | 否 | — | | 3 | 页面编码 | 130px | 否 | — | | 4 | 页面名称 | 120px | 否 | — | | 5 | 功能点编码 | 140px | 否 | — | | 6 | 功能点名称 | 120px | 否 | — | | 7 | 可用动作 | 200px | 否 | view,create,update,delete,approve,export,assign | ### 操作按钮 | 按钮 | 权限编码 | 位置 | 显示条件 | 说明 | |------|----------|------|----------|------| | — | — | — | — | 此页面只读，数据由IModulePlugin自动注册 | ### API端点 | 页面操作 | API路径 | 方法 | 说明 | |----------|---------|------|------| | 列表查询 | /api/v1/permissions/registry | GET | 查看已注册的权限配置 | | 刷新 | /api/v1/permissions/registry/refresh | POST | 手动触发权限重新扫描 | --- ## 页面5：权限审计日志页 **页面编号**：SA-P-08-P01 **端侧归属**：Web专属 **页面路径**：/permission/audit-log ### 界面布局 ``` ┌──────────────────────────────────────────────────────────────────┐ │ [面包屑] 权限管理 > 权限审计日志 │ ├──────────────────────────────────────────────────────────────────┤ │ [查询条件区] │ │ 操作人[____] 操作类型[▼] 角色[____] 日期[起始]~[结束] [查询] [重置]│ ├──────────────────────────────────────────────────────────────────┤ │ [列表区] │ │ 序号 | 操作时间 | 操作人 | 操作类型 | 目标角色 | 变更详情 | 操作 │ │ 1 | 14:00 | admin | 权限修改 | 巡检主管 | [+2项][-1项]| 查看│ │ 2 | 11:30 | admin | 角色创建 | 保洁主管 | — | 查看│ ├──────────────────────────────────────────────────────────────────┤ │ [分页] 共80条 每页[20▼] < 1 2 3 4 > │ └──────────────────────────────────────────────────────────────────┘ ``` ### 查询条件 | 字段名 | 控件类型 | 必填 | 默认值 | 说明 | |--------|----------|------|--------|------| | 操作人 | 文本输入 | 否 | — | 模糊匹配 | | 操作类型 | 下拉单选 | 否 | 全部 | 角色创建/权限修改/角色分配/角色移除 | | 角色 | 文本输入 | 否 | — | 模糊匹配角色名称 | | 日期范围 | 日期范围 | 否 | — | 操作时间范围 | ### 列表字段 | 序号 | 字段名 | 列宽 | 支持排序 | 说明 | |------|--------|------|----------|------| | 1 | 序号 | 60px | — | 自增 | | 2 | 操作时间 | 150px | 是 | 默认倒序 | | 3 | 操作人 | 100px | 否 | — | | 4 | 操作类型 | 100px | 否 | 标签样式 | | 5 | 目标角色 | 120px | 否 | — | | 6 | 变更详情 | 120px | 否 | [+N项][-M项]，简洁展示 | | 7 | 操作 | 80px | — | 查看详情 | ### 操作按钮 | 按钮 | 权限编码 | 位置 | 显示条件 | 说明 | |------|----------|------|----------|------| | 查看详情 | audit-log:permission:view | 行操作 | 始终 | 弹窗展示变更前后对比 | ### 审计日志详情弹窗 ``` ┌──────────────────────────────────────────────────────────────────┐ │ 权限变更详情 [×] │ ├──────────────────────────────────────────────────────────────────┤ │ 角色：巡检主管 │ │ 操作人：超级管理员(admin) │ │ 操作时间：2026-04-16 14:00:00 │ │ 操作类型：权限修改 │ ├──────────────────────────────────────────────────────────────────┤ │ 变更对比： │ │ [+新增] 在线报修 → 工单详情 → 延期审批 → 审批 │ │ [+新增] 在线报修 → 工单列表 → 工单管理 → 导出 │ │ [-移除] 巡检管理 → 巡检计划 → 计划管理 → 删除 │ ├──────────────────────────────────────────────────────────────────┤ │ [关闭] │ └──────────────────────────────────────────────────────────────────┘ ``` ### API端点 | 页面操作 | API路径 | 方法 | 说明 | |----------|---------|------|------| | 列表查询 | /api/v1/audit-logs/permission | GET | 分页查询 | | 详情查询 | /api/v1/audit-logs/permission/{id} | GET | 含变更前后对比 | --- ## 需求追溯 | 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 | |------------|----------|----------|----------|----------| | SA-P-01 | 角色定义 | 02-超级管理员 §2 / 03-超级管理员 §4 | 创建角色→权限分配 | 账号管理(角色绑定) | | SA-P-02 | 角色权限分配 | 02-超级管理员 §2 / 03-超级管理员 §4 / 01 §8.1 | 权限变更→审计日志+实时生效 | 权限审计日志 / 权限实时生效 | | SA-P-03 | 角色管理 | 02-超级管理员 §2 | 停用→关联账号权限失效 | 账号管理(角色绑定) | | SA-P-04 | 权限预设模板 | 02-超级管理员 §2 / 01 §8.4 | 选择模板→自动填充权限 | 角色新增页(模板选择) | | SA-P-05 | 账号角色绑定 | 02-超级管理员 §2 / 03-超级管理员 §4 | 在账号管理中操作 | 账号管理 / 物业组织架构(下属角色分配) | | SA-P-06 | 权限预览 | 02-超级管理员 §2 | 预览→确认权限分配 | 角色新增/编辑页 | | SA-P-07 | 权限自动同步 | 02-超级管理员 §2 / 03-超级管理员 §5 / 01 §8.2 | IModulePlugin注册→权限树自动更新 | 权限配置注册页 | | SA-P-08 | 权限审计日志 | 02-超级管理员 §2 / 03-超级管理员 §8.2 / 01 §8.5 | 权限变更→自动记录 | 操作日志 | | SA-P-09 | 权限实时生效 | 02-超级管理员 §2 / 03-超级管理员 §6 / 01 §8.3 | Redis Pub/Sub毫秒级生效 | — | | SA-P-10 | 权限配置注册 | 02-超级管理员 §2 / 03-超级管理员 §5 | 查看IModulePlugin注册的权限 | 05-接口规范 §4.2 | ## 业务规则 1. **四级权限粒度**：功能菜单→页面→功能点→动作，7种动作类型（view/create/update/delete/approve/export/assign）（来源：01 §8.1 / 06 §4.2） 2. **权限自动同步**：新模块通过IModulePlugin.getPermissionDefinitions()自动注册，权限管理页面自动渲染新可勾选项（来源：01 §8.2 / 05 §4.2） 3. **权限实时生效**：权限变更后通过Redis Pub/Sub毫秒级生效，无需重新登录（来源：01 §8.3 / 03-超级管理员 §6 / 06 §3.1） 4. **权限审计日志**：记录操作人、时间、类型、变更前后对比（来源：01 §8.5 / 03-超级管理员 §8.2） 5. **角色删除条件**：仅关联账号数为0时才可删除（来源：02-超级管理员 SA-P-03） 6. **预设模板使用**：创建角色时选择模板→系统自动填充权限→管理员微调后保存（来源：01 §8.4） 7. **权限配置表只读**：权限配置注册页数据来源于IModulePlugin自动注册，超管只可查看不可手动编辑（来源：03-超级管理员 §5）