用户管理
一句话：本页是租户内人员的总台账——建账号、挂组织与岗位、启停账号、重置密码、分配角色，全在这里。左侧组织树 + 右侧用户表是它的标志布局。
功能在哪
- 菜单路径：系统管理 → 组织权限 → 用户管理
- 地址栏路由：
/system/org-permission/user
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 左侧组织树 | 按组织过滤右表 | 点节点只看该组织下用户；顶部搜索框按组织名过滤树 |
| 查询区 | 按 用户名称 / 手机号码 / 状态 / 创建时间 过滤 | 「搜索」「重置」 |
| 工具条 | 整页级动作 | 「新增」「导入」「导出」；勾选行后「批量删除」 |
| 列表 | 一人一行：序号 / 用户编号 / 用户名称 / 用户昵称 / 部门 / 手机号码 / 状态 / 创建时间 | 行内「修改」「删除」「重置密码」「分配角色」；状态列开关直接启停 |
| 分页 | 右下角 | 改每页条数、翻页 |
状态列的开关 = 快捷启停
直接拨开关等价于「修改表单里改状态再保存」，走同一条后端接口。关掉后该用户立刻登录不了，报 名字为【{}】的用户已被禁用。
常用操作
新建用户
- 点「新增」；
- 填「用户昵称」（界面显示名）；
- 选「归属部门」（组织管理的节点）；
- 填「手机号码」「邮箱」（都参与唯一性校验）；
- 填「用户名称」「用户密码」——仅新增时出现，即登录账号与初始密码；
- 可选「用户性别」「岗位」（多选）、「备注」；
- 点「确定」。
结果：列表多出一行；该用户即可用「租户名 + 用户名称 + 密码」登录——但能看到什么菜单，取决于下一步给他分配的角色。
建完用户一定要分配角色
没角色的用户登录后侧边栏几乎是空的。见下文「分配角色」。
导入用户（Excel 批量）
- 点工具条「导入」，弹出三步向导：上传文件 → 检查数据 → 导入结果；
- 点弹窗里的「下载导入模板」拿标准模板，按列填好（
.xls/.xlsx，最多 20000 行 / 10MB）； - 上传后系统先预检并列出问题行；确认无误点「导入」；
- 第三步显示导入结果。
表头按「列名」匹配，不按列位置
模板里的列可以调换顺序、甚至删掉不需要的列，只要第一行列名与模板一致即可。列名对不上会报：没有读到表头行。请确认第一行是列标题，且用的是模板里的列名。
预检结果 10 分钟内有效，且只能用一次
超时报 这份预检结果已经过期（超过 10 分钟），请重新上传文件；重复提交报 这份预检结果已经导入过了。重复提交不会再导一次，请重新上传文件。
导出用户表
点「导出」，按当前查询条件（含左侧组织树选中的节点）生成 Excel，无弹窗直接下载。
修改用户
行内「修改」。编辑态表单没有「用户名称/用户密码」两栏（账号名创建后不可改，密码走「重置密码」）。
重置密码
- 行内点「重置密码」；
- 在确认框输入新密码，确定。
结果：该用户下次登录用新密码；旧登录态失效。
分配角色
- 行内点「分配角色」，弹出角色勾选框；
- 勾上该用户应有的角色（可多选），确定。
结果：该用户下次登录即拥有这些角色的全部授权。反向操作（从角色侧加人）在角色管理的「成员」页。
删除 / 批量删除
行内「删除」或勾选后「批量删除」，确认即可。
删除不可恢复，且会连带失效其登录态
演示环境请只删自己建的测试账号；内置 admin 删不掉也不该删。
字段说明
| 字段 | 必填 | 取值 / 校验 | 说明 |
|---|---|---|---|
| 用户昵称 | 是 | 文本 | 界面显示名 |
| 归属部门 | 否 | 组织节点 | 行级数据权限的常用划界依据 |
| 手机号码 | 否 | 11 位手机号，唯一 | 重复报 手机号已经存在 |
| 邮箱 | 否 | 邮箱格式，唯一 | 重复报 邮箱已经存在 |
| 用户名称 | 是（仅新增） | 租户内唯一 | 登录账号；重复报 用户账号已经存在 |
| 用户密码 | 是（仅新增） | 文本 | 初始密码 |
| 用户性别 | 否 | 字典：男 / 女 | 见字典管理 |
| 岗位 | 否 | 岗位多选 | 人事属性，不控权限 |
| 备注 | 否 | 文本 | — |
视角对照
| 视角 | 看到什么 |
|---|---|
超管 admin / 租户管理员 docadmin | 本租户全部用户 + 完整组织树 |
套餐受限租户 aoteman@test | 只有 test 租户自己的用户（1 条），组织树为空——租户隔离 |
行级权限用户 docsales | 无入口：它没被授 system:user 族任何资源，直达路由 403。行级过滤的可见效果要在被授权的业务页上看，见配置行级数据权限 |
字段级权限也会作用在本页
本项目支持把某个字段配成「隐藏/只读」（见权限资源）。被隐藏的列整列不显示，被置空的字段显示为空白——同一页在不同角色下长相可以不同。
进阶
常见问题
Q：报「用户账号已经存在」？ A：同一租户内用户名称唯一。换一个，或先搜一下是否已有离职账号可复用（改昵称/重置密码）。
Q：报「创建用户失败，原因：超过租户最大租户配额(N)！」？ A：租户用户数到了租户列表里设的「账号额度」。让超管调大额度再建。
Q：导入报「勾选了『全对才导』，而还有 N 行没有通过校验，因此整批都没有导入」？ A：这是「全对才导」模式的保护：任一行不合格整批回滚。按预检列出的问题行改完重传，或取消勾选改为「跳过错误行」。
Q：新建的用户登录后什么都看不见？ A：没分配角色。回列表行内「分配角色」勾上角色，让用户重登。
Q：重置密码后用户还能用旧密码？ A：不会。若表现为「还能操作」，那是旧登录态未过期；退出重登即必须用新密码。