用户、角色与菜单权限

Campus

适用角色

系统管理员，以及被授予用户、角色、菜单维护权限的管理员。

功能说明

这一组功能负责“谁能进系统、能看到哪些菜单、能点哪些按钮”。基本关系是：

• 「菜单管理」维护系统的目录、菜单和按钮，构成一棵权限树。
• 「角色管理」新建角色后，通过「授权」把权限树上的节点勾给角色。
• 「用户管理」维护账号，并给用户挂上一个或多个角色；用户登录后能看到的菜单、能用的按钮，由其所有角色的授权合并决定。
• 「学校管理员」维护用户与学校的关联关系，用于按学校划分数据范围。

管理员角色（标识为 ROLE_ADMIN）比较特殊：它不需要授权，系统默认放行全部权限，因此在角色列表点它的「授权」会被拦下。

操作入口

系统管理 > 用户管理
系统管理 > 角色管理
系统管理 > 菜单管理
系统管理 > 学校管理员

菜单本身由「菜单管理」动态维护，上面的一级分组名称与层级以实际下发的客户环境为准。

截图待补：角色列表、角色授权窗口、用户表单、菜单表单。

一、维护角色

角色是权限的载体，先建角色再授权。

1. 进入「角色管理」，点击工具栏「新增」。
2. 在「添加角色」弹窗填写：
   • 角色名称（必填，为空提示“角色名称不能为空”）。
   • 角色标识（必填，为空提示“角色标识不能为空”）。
   • 角色描述（选填）。
   • 状态（必填，激活／禁用，未选提示“请选择角色状态”），默认“激活”。
3. 点击「提交」保存，成功后提示“创建成功”。
4. 列表按角色名称、角色标识、状态（全部／激活／停用）筛选，展示角色名称、角色标识、备注、状态、创建时间。
5. 行内操作有「编辑」「删除」「授权」；点击角色名称链接可打开角色详情。

「新增」「删除」按钮按角色控制，无权限时按钮为禁用态。

二、给角色授权（核心）

授权是把菜单权限树上的节点勾给角色的过程。

1. 在「角色管理」行内点击「授权」，打开“<角色名称> 授权”窗口。
   • 如果对管理员角色（ROLE_ADMIN）点「授权」，会提示“管理员无需授权”并中止，管理员默认拥有全部权限。
2. 窗口顶部是「菜单权限」控制区，有三个开关：
   • 展开/折叠：一键展开或收起整棵权限树。
   • 全选/全不选：一键勾选或清空所有节点。
   • 父子联动：默认开启。开启时勾选父节点会连带子节点、勾满子节点会回填父节点；关闭后父子节点各自独立勾选，可以只给某个父目录下的部分子项授权。
3. 在权限树里按需勾选目录、菜单、按钮节点。打开窗口时会自动回填该角色已有的授权。
4. 点击「提交」保存，成功后提示“授权成功”。提交时会同时保存已勾选与半勾选（父节点下只选了部分子项）的节点，确保父级目录不丢。

授权变更后，相关用户通常需要重新登录或刷新权限信息才会生效。

三、维护角色下的用户

从角色一侧也能管理它包含哪些用户。

1. 在「角色管理」点击角色名称链接，打开“角色绑定”详情。
2. 详情上半部分展示角色信息，下半部分「角色用户」表格列出该角色下的用户：姓名、手机号、状态、创建时间、备注。
3. 点击表头的「+」按钮，从用户选择窗口挑选用户加入该角色：
   • 选择前系统会拦截两类情况：管理员用户不能被加进其他角色（提示“不能将管理员用户添加到其他角色中”）；已在该角色中的用户会被跳过（提示“用户 [xxx] 已经在该角色中”）。
   • 确认时会二次弹窗“确定把用户 [xxx] 添加到角色: [角色名称] 中?”，确定后提示“用户已成功添加到角色中”。
4. 在用户行点击「删除」可把该用户移出角色，确认后提示移除成功。这里只解除“用户—角色”关系，不会删除用户账号。

四、维护用户

1. 进入「用户管理」，点击工具栏「新增」。
2. 在「添加用户」弹窗填写：
   • 账号（必填，为空提示“账号不能为空”）。
   • 姓名（必填，为空提示“姓名不能为空”）。
   • 邮箱（选填，但填了必须符合邮箱格式，否则提示“请输入正确的邮箱地址”）。
   • 手机号（必填，为空提示“手机号不能为空”）。
   • 身份证号（选填）。
   • 主学校（必填）：点右侧搜索按钮从学校选择窗口选取。
   • 额外学校（选填）：多选，支持按名称搜索；主学校会自动从额外学校中排除，无需手动去重。
   • 主部门（选填）：从部门树中选择。
   • 额外部门（选填）：多选；主部门会自动从额外部门中排除。
   • 职务（选填）：从职务选择窗口选取。
   • 职称（选填，部分客户环境不显示此项，以实际下发为准）。
   • 密码（新增时必填，为空提示“密码不能为空”；编辑时不显示此项）。
   • 状态（正常／禁用），默认“正常”。
   • 角色（必填）：点「+」从角色选择窗口添加，可挂多个角色，重复添加会提示“角色已存在.”；点角色标签上的关闭图标可移除。
3. 点击「提交」保存，成功后提示“创建成功”。
4. 列表支持按姓名、手机号、状态、角色、学校、部门、职务、职称组合筛选（职称筛选项在部分客户环境隐藏）。
5. 列表展示用户名、姓名、手机号、邮箱、角色、学校、部门、职务、职称、状态、创建时间。学校和部门列会用“（主）”标出主学校／主部门，额外项较多时折叠为“+N个”，悬停可展开查看全部。
6. 行内操作：
   • 编辑：修改用户资料。
   • 删除：二次确认“确认删除用户 [xxx] 吗？”后删除。
   • 更多下拉：复制、认证照片、重置密码。
7. 点击用户姓名标签可打开「用户详情」，查看联系信息、组织信息、关联范围（额外学校／额外部门）、角色、创建／更新／最后登录信息；登录历史仅管理员可见。

重置密码

在「更多 > 重置密码」中确认“确认重置用户 [xxx] 的密码吗? 确定后, 密码将会修改为手机号后六位”，确定后密码被重置为该用户手机号的后六位。

批量下发与打印

工具栏的「下发信息」和「打印」都需要先在列表勾选记录，未勾选会提示“请勾选记录后继续.”。「下发信息」把选中用户的信息下发到门禁设备，「打印」跳转到打印页。

五、维护菜单

菜单管理决定授权树的结构，通常只由系统管理员维护。

1. 进入「菜单管理」，列表以树形展示，可按菜单名称、状态（正常／停用）筛选。
2. 列表展示模块名称、路由地址、类型、图标、排序、状态、创建时间；类型分为目录、菜单、按钮三种。
3. 点击「新增」，在「添加模块」弹窗填写：
   • 菜单类别（必填，目录／菜单／按钮，未选提示“请选择类型.”）。
   • 菜单编码（必填，为空提示“菜单编码不能为空”）。
   • 菜单名称（必填，为空提示“模块名称不能为空.”）。
   • 所属应用（类别为“按钮”时不显示）。
   • 上级菜单（类别为“目录”时不显示）。
   • 重定向（仅“目录”类别显示，用于指定打开该目录时加载的菜单路由）。
   • 权限标识（“目录”外的类别必填，为空提示“权限标识不能为空”），系统按此标识做按钮级权限控制。
   • 路由地址（“按钮”外的类别必填，为空提示“路由地址不能为空”）。
   • 请求参数（选填）。
   • 按钮（新增“目录／菜单”时可批量勾选生成子按钮：添加、修改、删除、导出、查看城市数据、查看所有数据）。
   • 组件路径（“按钮”外的类别必填，为空提示“组件路径不能为空”）。
   • 图标：点右侧搜索按钮从图标库选取。
   • 排序（数字，默认 999）。
   • 状态（激活／禁用）。
   • 备注（选填）。
4. 行内操作有「编辑」「复制」「删除」；系统内置节点（编辑按钮不可用）不允许编辑。
5. 「复制」以当前节点为模板新建一条，便于批量维护同类菜单。

六、维护学校管理员

「学校管理员」维护用户与学校的关联，用于按学校划定数据范围。

1. 进入「学校管理员」，可按用户姓名、用户号码、学校名称筛选，列表展示用户姓名、用户号码、学校、创建人、创建时间。
2. 点击「新增」，在「添加学校管理员」弹窗中：
   • 用户（必填，为空提示“用户不能为空”）：从用户选择窗口选取。
   • 学校（必填，为空提示“学校不能为空”）：从学校选择窗口选取。
3. 点击「提交」保存。行内可「编辑」「删除」已有关联。

关键规则与注意事项

• 用户能看到的菜单和按钮，由其所有角色的授权合并决定；授权或角色变更后通常需重新登录或刷新权限才生效。
• 管理员角色（ROLE_ADMIN）默认拥有全部权限，无需也无法授权；管理员用户不能被加入其他角色。
• 授权时「父子联动」默认开启，需要精细授权（只给部分子项）时可关闭；提交会连同半勾选的父节点一起保存，避免父目录缺失导致菜单不显示。
• 新增用户必填账号、姓名、手机号、主学校、角色和密码；主学校、主部门分别会自动从额外学校、额外部门中排除。
• 重置密码后新密码为手机号后六位，应提醒用户及时登录修改。
• 「下发信息」「打印」需先勾选列表记录。
• 菜单结构调整（新增、停用、改层级）后，需回头检查相关角色授权是否仍然正确。
• 权限遵循最小必要原则：只授予岗位所需的菜单、按钮和数据范围；调整管理员角色前，先确保至少保留一个可用的管理员账号。

常见问题

用户登录后看不到新菜单

依次检查：角色是否已「授权」并保存、对应菜单是否处于“正常”状态、该用户是否已挂上这个角色；确认无误后让用户退出重新登录。若菜单可见但页面内容为空，再检查其学校／部门等数据范围是否限制了可见数据。

授权时勾了子菜单，父目录却没生效

确认提交是在授权窗口点的「提交」。系统提交时会带上半勾选的父节点，正常情况下父目录不会丢；若关闭了「父子联动」后只勾了子项，请确认父级目录也在勾选或半勾选状态。

点某个角色的「授权」没有反应

如果这是管理员角色（ROLE_ADMIN），系统会提示“管理员无需授权”并不打开授权窗口，这是预期行为，管理员默认拥有全部权限。

把用户加入角色时被拦下

两种常见情况：该用户是管理员用户（提示“不能将管理员用户添加到其他角色中”），或该用户已在此角色中（提示“已经在该角色中”）。按提示更换用户即可。

编辑用户时额外学校／部门迟迟不显示

打开编辑时会异步拉取用户的多学校、多部门明细，期间会显示“正在加载用户学校信息…”。若加载失败会提示重新打开编辑，重试即可。

版本记录

版本	日期	修改说明
v1.0	2026-07-27	首次建立
v1.1	2026-07-27	依据前端源码完善内容