主题
用户管理
SYS-USER-01 | 模块
system| 创建、维护、停用后台账号,并绑定部门、岗位与角色。
1. 使用角色与场景
角色:管理员、租户管理员
- 新员工入职建号并分配部门
- 批量导入员工名单
- 离职停用账号但保留历史日志
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/user/create | system:user:create | 新增用户 | UserController#L52 |
| PUT | /system/user/update | system:user:update | 修改用户 | UserController#L60 |
| DELETE | /system/user/delete | system:user:delete | 删除用户 | UserController#L68 |
| DELETE | /system/user/delete-list | system:user:delete | 批量删除用户 | UserController#L77 |
| PUT | /system/user/update-password | system:user:update-password | 重置用户密码 | UserController#L86 |
| PUT | /system/user/update-status | system:user:update | 修改用户状态 | UserController#L94 |
| GET | /system/user/page | system:user:query | 获得用户分页列表 | UserController#L102 |
| GET | /system/user/list | system:user:query | 获得用户详情列表 | UserController#L118 |
| GET | /system/user/list-all-simple | — | 获取用户精简信息列表 | UserController#L132 |
| GET | /system/user/simple-list | — | 获取用户精简信息列表 | UserController#L132 |
| GET | /system/user/get | system:user:query | 获得用户详情 | UserController#L150 |
| GET | /system/user/export-excel | system:user:export | 导出用户 | UserController#L164 |
| GET | /system/user/get-import-template | — | 获得导入用户模板 | UserController#L179 |
| POST | /system/user/import | system:user:import | 导入用户 | UserController#L193 |
| GET | /system/user/get-simple | — | 获得用户精简信息 | UserController#L208 |
| GET | /system/user/list-by-nickname | — | 按昵称模糊搜索用户精简信息 | UserController#L223 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/user/UserController.java#L52 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/user/AdminUserDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/permission/UserRoleDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/dept/UserPostDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_users | AdminUserDO |
system_user_role | UserRoleDO |
system_user_post | UserPostDO |
5. 机制与配置
- 密码 BCrypt 加密;手机号/邮箱唯一性校验
- 删除为逻辑删除(deleted 字段)
- 用户与角色、岗位为多对多关联表
6. 常见问题与排查
- 用户名重复先查唯一索引与 Service 校验
- 停用后令牌不自动失效,需要额外踢下线
7. 关联
- 需求原件:01-02-用户管理
- 相关卡片:SYS-USER-02
- 相关卡片:SYS-ROLE-01
- 相关卡片:SYS-DEPT-01