用户管理使用说明

构建时间2026-06-26 20:10:33（Asia/Shanghai）来源项目中间件文档 / 中间件后端来源仓../cl-midserver-2026来源提交号69b951a07311e75887b57e0400d888f89dd72cac

查看文档来源信息

• 来源目录：addons/sys_base/docs
• 来源文件：功能说明/用户管理使用说明.md

## 功能概述 - 功能用途：维护后台用户资料、角色绑定、部门成员关系和部门管理员状态。 - 入口位置：PCWEB 一级菜单“用户”。 - 中间件用户和部门是全局基础数据，不按模块拆分；角色本身按模块归属，用户编辑时按模块分组展示和分配。

使用前提

1. 当前账号具备正式页面 organization.member.manage。
2. 超级管理员账号直接放行；普通角色仍按正式页面授权与动作授权校验。
3. 普通角色只能维护自身可管理角色范围内的角色；用户已经拥有但当前登录角色不可管理的角色只读展示，保存时保持不变。

操作方法

1. 进入一级菜单“用户”，查看当前账号可见的正式用户列表。
2. 新增用户或选择现有用户。
3. 维护用户资料和所属部门。用户资料与部门归属对所有模块通用。
4. 在“角色分配”区域按模块查看可分配角色，勾选或取消勾选该用户在各模块下的角色。
5. 如需调动、移除或重置密码，执行对应动作后重新校验结果。

用户编号规则

• 用户编号字段为 publicId，页面展示名为“用户编号”。
• 新增用户时，后端按“部门编码 + 4 位数字编号”生成用户编号，例如 CL0001、JS0002。
• 部门编码来自部门表 orgFlag，正式规则为 1 到 8 位大写英文字母或数字，必须以字母开头，并且部门之间不允许重复。
• 历史用户不会批量补写编号；列表中为空、前缀不匹配、大小写不符合或格式不符合规则的编号展示为“待修正”。
• 用户下次编辑保存或调动部门时，后端会按当前所属部门编码重新生成编号；如果目标部门编码本身不合法，保存会失败，需要先修正部门编码。

列表展示规则

• 用户列合并头像、昵称和登录账号，避免把同一用户信息拆成多列。
• 账号身份必须明确展示“超级管理员”或“普通账号”，普通账号不再显示为空。
• 角色列只展示模块数和角色数摘要，模块明细通过悬浮详情查看；完整角色维护仍在编辑用户弹窗中完成。

维护提示

• 用户页是正式一级菜单，不再挂在其他分组下。
• 页面入口、按钮权限和接口权限必须保持一致，不允许保留只有菜单外壳但不可操作的假入口。
• 中间件用户管理不展示“当前角色模块”，也不以当前 addons-type 过滤用户角色；下游单模块管理端如复用用户能力，可以继续按本模块角色池维护。
• 保存角色后，后端会失效该用户已登录会话，并清理已经指向失效角色的运行上下文。