# 用户基础服务
用户基础服务 提供账号、角色、权限与视图的一体化能力，是业务系统搭建用户体系的常用模块。其管理系统（子系统）用于维护该模块下的用户体系数据。
进入方式见 子系统 - 进入方式。
# 菜单总览
| 菜单 | 用途 |
|---|---|
| 用户管理 | 维护账号信息，并为账号分配角色 |
| 角色管理 | 维护角色，并为角色分配权限与视图 |
| 权限管理 | 维护权限项（树形结构） |
| 视图管理 | 维护视图（前端页面/路由）项（树形结构） |
| 登录日志 | 查询用户登录记录（只读） |
| 配置中心 | 维护模块的键值配置 |
权限模型：用户 → 角色 → 权限 / 视图。用户通过被赋予角色来获得权限，角色则决定了该角色可以使用哪些功能权限（权限）和哪些界面（视图）。
# 一、用户管理
# 列表与查询
| 列 | 说明 |
|---|---|
| 用户ID | 用户唯一标识 |
| 用户名 | 登录账号 |
| 手机号 | 用户手机号 |
| 真实姓名 | 用户姓名 |
| 邮箱 | 用户邮箱 |
| 状态 | 启用 / 禁用 |
| 创建时间 | 账号创建时间 |
查询条件：用户名、手机号（均支持模糊查询）。填写后点击 查询 生效。
# 添加用户
点击右上角 添加用户，填写以下字段后确定：
| 字段 | 必填 | 说明 |
|---|---|---|
| 用户名 | 是 | 登录账号，建议使用唯一且规范的值 |
| 密码 | 是 | 初始密码，建议首次登录后由用户自行修改 |
| 手机号 | 否 | 用户手机号 |
| 真实姓名 | 否 | 用户姓名 |
| 邮箱 | 否 | 用户邮箱 |
| 状态 | 否 | 默认 启用；关闭则账号不可登录 |
# 编辑用户
在目标用户行点击 编辑 修改信息。其中 密码 为可选字段：
- 留空 表示不修改当前密码；
- 填写 则会将密码重置为所填内容。
# 分配角色
在目标用户行点击 分配角色，在弹窗中多选角色后确定。
- 已拥有的角色会默认勾选；
- 状态为「禁用」的角色不可选择；
- 保存后立即生效，用户下次登录即按新角色鉴权。
# 删除用户
在目标用户行点击 删除，二次确认后删除。删除为不可恢复操作，请谨慎处理。
# 二、角色管理
# 列表与查询
| 列 | 说明 |
|---|---|
| 角色ID | 角色唯一标识 |
| 角色名称 | 角色的显示名称 |
| 角色编码 | 角色的业务编码 |
| 状态 | 启用 / 禁用 |
| 创建时间 | 角色创建时间 |
查询条件：角色名称、角色编码。
# 添加 / 编辑角色
填写 角色名称、角色编码 与 状态。
建议：角色编码保持稳定、语义清晰（如
admin、operator），避免随意变更，以免影响业务侧按编码的鉴权逻辑。
# 分配权限
在目标角色行点击 分配权限，在权限树中勾选该角色可使用的功能权限：
- 已分配的权限会默认勾选；
- 状态为「禁用」的权限节点不可勾选；
- 点击确定后立即生效。
# 分配视图
在目标角色行点击 分配视图，在视图树中勾选该角色可访问的界面。
- 规则与分配权限一致，禁用节点不可勾选。
说明：权限 控制「能做什么」，视图 控制「能看到哪些界面」，两者相互独立，需分别分配。
# 删除角色
在目标角色行点击 删除，二次确认后删除。
注意：删除角色后，已分配该角色的用户将失去对应的权限与视图，请在删除前确认影响范围。
# 三、权限管理
权限以 树形结构 展示，用于定义功能的层级与粒度。
- 每个节点鼠标 悬停 时显示 编辑 与 删除 按钮；
- 点击右上角 添加权限 新增权限项。
# 权限字段
| 字段 | 必填 | 说明 |
|---|---|---|
| 权限名称 | 是 | 权限的显示名称 |
| 权限编码 | 是 | 权限的业务编码，供业务侧鉴权使用 |
| 父权限 | 否 | 默认为 顶级权限；选择其它权限则成为其子权限 |
| 状态 | 否 | 默认启用，禁用后该权限不可被角色分配 |
提示：删除父级权限前，请先处理其子权限，避免产生无效的层级关系。
# 四、视图管理
视图同样以 树形结构 展示，用于定义可被授权的界面（前端页面 / 路由）集合。操作方式与权限管理一致（悬停显示编辑 / 删除，右上角添加视图）。
# 视图字段
| 字段 | 必填 | 说明 |
|---|---|---|
| 视图名称 | 是 | 视图的显示名称 |
| 视图路径 | 是 | 视图对应的前端路径 / 路由标识 |
| 父视图 | 否 | 默认为 顶级视图；选择其它视图则成为其子视图 |
| 状态 | 否 | 默认启用，禁用后该视图不可被角色分配 |
# 五、登录日志
用于查询该模块下用户的登录记录，仅支持查询，不提供新增、修改与删除。
# 查询条件
| 条件 | 说明 |
|---|---|
| 用户名 | 按用户名筛选 |
| 用户ID | 按用户ID筛选 |
| 登录IP | 按登录来源 IP 筛选 |
| 登录时间 | 按时间范围筛选（起止日期） |
# 列表字段
日志ID、用户ID、用户名、登录IP、登录时间、状态（成功 / 失败）。
提示：排查「用户无法登录」类问题时，可结合登录日志中的失败记录与登录时间定位原因。
# 六、配置中心
页面标题为 信息配置，用于维护模块的键值型配置项。
# 列表与查询
| 列 | 说明 |
|---|---|
| 配置ID | 配置唯一标识 |
| 配置键 | 配置的键（key） |
| 配置值 | 配置的值（value） |
| 配置名称 | 配置的中文名称 |
| 配置描述 | 配置的用途说明 |
| 状态 | 启用 / 禁用 |
| 创建时间 | 创建时间 |
查询条件：配置键、配置名称。
# 添加 / 编辑 / 删除配置
- 添加配置：填写配置键、配置值、配置名称、配置描述与状态；
- 编辑：修改目标配置行的内容；
- 删除：二次确认后删除。
注意：配置键通常被业务代码直接读取，随意修改或删除可能导致业务异常，建议变更前确认其用途。
# 常见问题
Q1：用户忘记密码，能否在管理系统中重置？
管理系统的用户编辑弹窗中可以填写新密码进行重置（填写即覆盖，留空则不改）。此外，模块的开放接口也提供了 重置密码 能力，供业务侧自行实现「忘记密码」流程。
Q2：给用户分配角色时，为什么某些角色是灰色的？
该角色的状态为 禁用。请先在「角色管理」中将其启用后再分配。
Q3：角色已分配权限，为什么用户仍无法使用？
请依次检查：
- 用户是否已分配该角色（用户管理 → 分配角色）；
- 角色状态是否为 启用；
- 对应的权限 / 视图节点状态是否为 启用。
Q4：权限与视图都要分配吗？
需要。两者用途不同：权限 决定功能是否可用，视图 决定界面是否可见，请按业务需要分别分配。