PointLion | 点狮

Appearance

系统管理模块操作手册 ​

模块概述 ​

系统管理模块（System Module）是 PointLion Cloud 的核心基础模块，提供用户管理、角色管理、菜单管理、权限管理、部门管理、岗位管理等系统基础功能。所有其他业务模块都依赖本模块提供的用户认证和权限控制能力。

功能导航 ​

快速开始 ​

访问地址 ​

启动服务后，通过以下地址访问系统管理功能：

默认管理员 ​

  • 用户名: admin
  • 密码: admin123

⚠️ 首次登录后请立即修改密码！

用户管理 ​

功能说明 ​

用户管理功能用于管理系统中的所有用户账号，包括用户的基本信息、所属部门、岗位、角色等。

操作步骤 ​

1. 新增用户 ​

路径: 系统管理 → 用户管理 → 新增

操作说明:

  1. 点击「新增」按钮，打开用户信息表单
  2. 填写必填信息：
    • 用户账号: 登录系统的唯一标识，不能重复
    • 用户姓名: 用户的真实姓名
    • 归属部门: 选择用户所属的部门
    • 用户性别: 男/女
    • 手机号码: 11位手机号，用于找回密码
    • 用户邮箱: 用于接收系统通知
    • 登录密码: 初始密码，默认为 admin123
  3. 配置可选信息：
    • 用户昵称: 显示名称
    • 岗位: 选择用户的岗位（可多选）
    • 角色: 分配用户的角色（可多选）
    • 用户状态: 正常/停用
  4. 点击「确定」保存

注意事项:

  • 用户账号创建后不能修改
  • 同一部门下用户姓名可以重复
  • 初始密码建议统一设置，首次登录后强制修改
  • 手机号和邮箱用于接收验证码和通知

2. 编辑用户 ​

路径: 系统管理 → 用户管理 → 编辑

操作说明:

  1. 在用户列表中找到要编辑的用户
  2. 点击该行的「编辑」按钮
  3. 修改用户信息（账号不可修改）
  4. 点击「确定」保存

注意事项:

  • 编辑用户不会影响用户的登录状态
  • 修改手机号或邮箱后需要重新验证
  • 修改角色后，用户需要重新登录才能生效

3. 删除用户 ​

路径: 系统管理 → 用户管理 → 删除

操作说明:

  1. 在用户列表中找到要删除的用户
  2. 点击该行的「删除」按钮
  3. 确认删除操作

注意事项:

  • 删除用户会级联删除用户相关的业务数据
  • 删除操作不可恢复，请谨慎操作
  • 系统管理员（admin）不能删除

4. 重置密码 ​

路径: 系统管理 → 用户管理 → 重置密码

操作说明:

  1. 在用户列表中找到要重置密码的用户
  2. 点击「重置密码」按钮
  3. 系统会将密码重置为默认密码 admin123

注意事项:

  • 重置后用户需要使用默认密码登录
  • 建议通知用户立即修改密码
  • 可以通过邮件或短信发送新密码

5. 分配角色 ​

路径: 系统管理 → 用户管理 → 更多 → 分配角色

操作说明:

  1. 在用户列表中选择要分配角色的用户
  2. 点击「更多」→「分配角色」
  3. 在弹出框中选择要分配的角色（支持多选）
  4. 点击「确定」保存

注意事项:

  • 角色权限会立即生效
  • 用户下次登录时会获得新的权限
  • 建议按岗位分配角色，便于管理

用户状态说明 ​

状态说明影响
正常用户可以正常登录和使用系统无
停用用户无法登录系统用户被禁用

角色管理 ​

功能说明 ​

角色管理用于配置系统的角色及其权限，通过角色批量管理用户权限，实现基于角色的访问控制（RBAC）。

操作步骤 ​

1. 新增角色 ​

路径: 系统管理 → 角色管理 → 新增

操作说明:

  1. 点击「新增」按钮
  2. 填写角色信息：
    • 角色名称: 角色的显示名称，如「普通管理员」
    • 权限字符: 角色的唯一标识，用于代码判断，如 common
    • 显示顺序: 角色列表中的排序号
    • 状态: 正常/停用
  3. 点击「确定」保存基本信息

2. 菜单权限配置 ​

路径: 系统管理 → 角色管理 → 更多 → 菜单权限

操作说明:

  1. 在角色列表中找到要配置的角色
  2. 点击「更多」→「菜单权限」
  3. 在树形菜单中勾选该角色可访问的菜单
  4. 可展开子菜单，进行细粒度权限配置
  5. 点击「确定」保存

权限级别说明:

  • 菜单权限: 控制用户是否能看到某个菜单
  • 按钮权限: 控制用户是否能进行某项操作（新增、编辑、删除等）

注意事项:

  • 勾选父菜单会自动勾选所有子菜单
  • 建议按业务职责配置权限，最小权限原则
  • 权限变更后，用户需要重新登录才能生效

3. 数据权限配置 ​

路径: 系统管理 → 角色管理 → 更多 → 数据权限

操作说明:

  1. 在角色列表中找到要配置的角色
  2. 点击「更多」→「数据权限」
  3. 选择数据权限范围：
    • 全部数据权限: 可以查看所有数据
    • 自定义数据权限: 指定可以查看哪些部门的数据
    • 本部门数据权限: 只能查看本部门的数据
    • 本部门及以下数据权限: 查看本部门及子部门的数据
    • 仅本人数据权限: 只能查看自己创建的数据
  4. 如果选择「自定义」，在部门树中选择可访问的部门
  5. 点击「确定」保存

注意事项:

  • 数据权限需要在业务代码中配合使用
  • 不是所有业务模块都支持数据权限
  • 数据权限优先级：自定义 > 本部门及以下 > 本部门 > 仅本人

4. 复制角色 ​

路径: 系统管理 → 角色管理 → 复制

用途: 快速创建类似的角色

操作说明:

  1. 在角色列表中找到要复制的角色
  2. 点击「复制」按钮
  3. 修改角色名称和权限字符
  4. 保存后会复制原角色的所有权限

预置角色说明 ​

角色权限字符说明
超级管理员admin拥有所有权限，不可删除
普通角色common默认角色，可根据需要配置权限
---

菜单管理 ​

功能说明 ​

菜单管理用于配置系统的菜单结构，包括左侧导航菜单和页面操作按钮。通过菜单管理可以灵活调整系统的菜单结构。

操作步骤 ​

1. 新增菜单 ​

路径: 系统管理 → 菜单管理 → 新增

菜单类型说明:

  1. 目录（Directory）: 一级菜单，点击展开子菜单，不跳转页面
  2. 菜单（Menu）: 具体的功能页面，点击跳转到对应页面
  3. 按钮（Button）: 页面内的操作按钮，如「新增」「编辑」

新增目录示例:

  1. 点击「新增」按钮
  2. 填写信息：
    • 菜单名称: 「系统管理」
    • 菜单类型: 「目录」
    • 显示顺序: 1
    • 菜单图标: 选择图标，如 setting
  3. 点击「确定」保存

新增菜单示例:

  1. 选择父级目录（如「系统管理」）
  2. 点击「新增」按钮
  3. 填写信息：
    • 菜单名称: 「用户管理」
    • 菜单类型: 「菜单」
    • 显示顺序: 1
    • 路由地址: /system/user
    • 组件路径: system/user/index
    • 是否外链: 否
  4. 点击「确定」保存

新增按钮示例:

  1. 选择父级菜单（如「用户管理」）
  2. 点击「新增」按钮
  3. 填写信息：
    • 菜单名称: 「用户查询」
    • 菜单类型: 「按钮」
    • 权限标识: system:user:query
    • 显示顺序: 1
  4. 点击「确定」保存

注意事项:

  • 菜单名称建议使用简短的中文名称
  • 路由地址必须唯一，不能重复
  • 权限标识格式：模块:功能:操作
  • 按钮类型菜单不会在导航栏显示

2. 编辑菜单 ​

路径: 系统管理 → 菜单管理 → 编辑

操作说明:

  1. 在菜单树中选择要编辑的菜单
  2. 点击「编辑」按钮
  3. 修改菜单信息
  4. 点击「确定」保存

注意事项:

  • 修改路由地址后需要刷新前端缓存
  • 修改菜单类型可能导致菜单显示异常

3. 删除菜单 ​

路径: 系统管理 → 菜单管理 → 删除

操作说明:

  1. 在菜单树中选择要删除的菜单
  2. 点击「删除」按钮
  3. 确认删除

注意事项:

  • 删除有子菜单的菜单会级联删除所有子菜单
  • 删除菜单后，对应的功能将无法访问
  • 删除操作不可恢复

权限标识规范 ​

权限标识用于代码级别的权限控制，格式为：模块:功能:操作

示例:

功能权限标识说明
用户查询system:user:query查询用户列表
用户新增system:user:add新增用户
用户编辑system:user:edit编辑用户
用户删除system:user:remove删除用户
用户导出system:user:export导出用户数据
用户导入system:user:import导入用户数据

部门管理 ​

功能说明 ​

部门管理用于维护企业的组织架构，支持树形结构的部门层级，用于用户归属和数据权限控制。

操作步骤 ​

1. 新增部门 ​

路径: 系统管理 → 部门管理 → 新增

操作说明:

  1. 在部门树中选择父部门（如不选则新增顶级部门）
  2. 点击「新增」按钮
  3. 填写部门信息：
    • 部门名称: 部门的名称
    • 显示排序: 部门在同级别中的排序
    • 负责人: 部门负责人
    • 联系电话: 部门联系电话
    • 邮箱: 部门邮箱
    • 部门状态: 正常/停用
  4. 点击「确定」保存

注意事项:

  • 部门名称在同一父部门下不能重复
  • 删除有用户的部门需要先迁移用户
  • 删除有子部门的部门会级联删除

2. 编辑部门 ​

路径: 系统管理 → 部门管理 → 编辑

操作说明:

  1. 在部门树中选择要编辑的部门
  2. 点击「编辑」按钮
  3. 修改部门信息
  4. 点击「确定」保存

岗位管理 ​

功能说明 ​

岗位管理用于维护企业的岗位信息，岗位与部门解耦，用于用户的多角色管理。

操作步骤 ​

1. 新增岗位 ​

路径: 系统管理 → 岗位管理 → 新增

操作说明:

  1. 点击「新增」按钮
  2. 填写岗位信息：
    • 岗位名称: 岗位的名称，如「总经理」「部门经理」
    • 岗位编码: 岗位的唯一标识
    • 显示顺序: 岗位列表中的排序
    • 状态: 正常/停用
    • 备注: 岗位说明
  3. 点击「确定」保存

注意事项:

  • 岗位编码不能重复
  • 一个用户可以拥有多个岗位
  • 岗位主要用于用户身份标识，不直接关联权限

字典管理 ​

功能说明 ​

字典管理用于维护系统的字典数据，如下拉选项、状态选项等。字典数据在业务模块中广泛使用。

操作步骤 ​

1. 新增字典类型 ​

路径: 系统管理 → 字典管理 → 新增

操作说明:

  1. 点击「新增」按钮
  2. 填写字典类型信息：
    • 字典名称: 字典的名称，如「用户性别」
    • 字典类型: 字典的唯一标识，如 sys_user_sex
    • 状态: 正常/停用
  3. 点击「确定」保存

2. 配置字典数据 ​

路径: 系统管理 → 字典管理 → 字典数据

操作说明:

  1. 在字典类型列表中找到要配置的字典
  2. 点击「字典数据」按钮
  3. 在字典数据页面点击「新增」
  4. 填写字典数据：
    • 字典标签: 显示的文本，如「男」
    • 字典键值: 实际的值，如 0
    • 字典排序: 显示顺序
    • 样式属性: CSS 样式类，如 badge-primary
    • 回显样式: 用于表单回显的样式
    • 状态: 正常/停用
  5. 点击「确定」保存

示例 - 用户性别字典:

字典标签字典键值样式属性
男0badge-primary
女1badge-danger
未知2badge-info

注意事项:

  • 字典键值在同一字典类型下不能重复
  • 字典数据变更后需要刷新缓存才能生效
  • 删除字典类型会级联删除所有字典数据

参数设置 ​

功能说明 ​

参数设置用于维护系统的配置参数，支持动态调整系统行为，无需重启服务。

操作步骤 ​

1. 新增参数 ​

路径: 系统管理 → 参数设置 → 新增

操作说明:

  1. 点击「新增」按钮
  2. 填写参数信息：
    • 参数名称: 参数的名称，如「用户初始密码」
    • 参数键名: 参数的唯一标识，如 sys.user.initPassword
    • 参数键值: 参数的值，如 123456
    • 是否系统内置: 是/否（内置参数不可删除）
  3. 点击「确定」保存

常用参数说明:

参数键名说明默认值
sys.user.initPassword用户初始密码123456
sys.index.skinName前端主题skin-blue
sys.user.captchaEnabled是否开启验证码true

注意事项:

  • 系统内置参数不要随意修改
  • 参数键名建议使用 . 分隔层级
  • 修改参数后可能需要清除缓存

通知公告 ​

功能说明 ​

通知公告用于向系统用户发布重要通知，支持富文本编辑，可按部门和用户定向推送。

操作步骤 ​

1. 发布公告 ​

路径: 系统管理 → 通知公告 → 新增

操作说明:

  1. 点击「新增」按钮
  2. 填写公告信息：
    • 公告标题: 公告的标题
    • 公告类型: 通知/公告
    • 公告内容: 公告的详细内容（支持富文本）
    • 公告状态: 正常/关闭
    • 发布范围: 全部/指定用户
  3. 点击「确定」发布

注意事项:

  • 发布的公告会实时推送给在线用户
  • 公告会保存历史记录，用户可随时查看
  • 关闭状态的公告不会推送

日志管理 ​

功能说明 ​

日志管理包括登录日志和操作日志，用于审计和问题排查。

登录日志 ​

路径: 系统管理 → 日志管理 → 登录日志

功能说明: 记录用户的登录行为，包括登录时间、IP地址、登录状态等。

查询条件:

  • 用户账号
  • 登录IP
  • 登录状态（成功/失败）
  • 登录时间范围

操作日志 ​

路径: 系统管理 → 日志管理 → 操作日志

功能说明: 记录用户的操作行为，包括操作模块、操作类型、请求参数、返回结果等。

查询条件:

  • 操作模块
  • 操作类型（新增/修改/删除/查询等）
  • 操作人
  • 操作时间范围

注意事项:

  • 操作日志可能包含敏感信息，注意权限控制
  • 大量日志会影响查询性能，建议定期归档

在线用户 ​

功能说明 ​

在线用户用于监控当前登录系统的用户，支持强制退出功能。

操作步骤 ​

1. 查看在线用户 ​

路径: 系统管理 → 在线用户

显示信息:

  • 用户账号
  • 用户姓名
  • 所属部门
  • 登录IP
  • 登录地点
  • 浏览器类型
  • 操作系统
  • 登录时间

2. 强制退出 ​

路径: 系统管理 → 在线用户 → 强制退出

操作说明:

  1. 在在线用户列表中找到要退出的用户
  2. 点击「强制退出」按钮
  3. 确认操作

注意事项:

  • 强制退出后用户需要重新登录
  • 当前登录的管理员不能强制退出自己
  • 强制退出操作会记录到操作日志

常见问题 ​

Q: 用户登录后看不到某些菜单？ ​

A: 检查以下几点：

  1. 用户的角色是否有该菜单的权限
  2. 菜单状态是否为「正常」
  3. 用户是否重新登录（权限修改后需要重新登录）

Q: 如何批量导入用户？ ​

A: 系统提供了用户导入功能：

  1. 下载用户导入模板
  2. 按照模板格式填写用户信息
  3. 在用户管理页面点击「导入」
  4. 选择文件并确认导入

Q: 忘记管理员密码怎么办？ ​

A: 可以通过以下方式重置：

  1. 直接修改数据库中 sys_user 表的 password 字段
  2. 密码使用 BCrypt 加密，可以复制其他用户的密码
  3. 或使用 SQL 工具生成新的 BCrypt 密码

Q: 如何配置数据权限？ ​

A:

  1. 在角色管理中配置数据权限范围
  2. 在业务代码中使用 @DataScope 注解
  3. 系统会自动过滤数据

技术说明 ​

API 端点 ​

功能方法路径说明
用户列表GET/system/user/list分页查询用户列表
用户详情GET/system/user/获取用户详情
新增用户POST/system/user新增用户
修改用户PUT/system/user修改用户
删除用户DELETE/system/user/删除用户
重置密码PUT/system/user/resetPwd重置用户密码

权限注解 ​

系统使用 @PreAuthorize 注解进行权限控制：

java
@PreAuthorize("@ss.hasPermi('system:user:query')")
public TableDataInfo list(User user) {
    // 只有拥有 system:user:query 权限的用户才能访问
}

数据权限注解 ​

系统使用 @DataScope 注解进行数据权限控制：

java
@DataScope(deptAlias = "d", userAlias = "u")
public List<User> selectUserList(User user) {
    // 会自动根据用户的数据权限过滤数据
}

📖 下一篇: 基础设施模块操作手册