Skip to content

用户管理 ​

SYS-USER-01 | 模块 system | 创建、维护、停用后台账号,并绑定部门、岗位与角色。

1. 使用角色与场景 ​

角色:管理员、租户管理员

  • 新员工入职建号并分配部门
  • 批量导入员工名单
  • 离职停用账号但保留历史日志

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/system/user/createsystem:user:create新增用户UserController#L52
PUT/system/user/updatesystem:user:update修改用户UserController#L60
DELETE/system/user/deletesystem:user:delete删除用户UserController#L68
DELETE/system/user/delete-listsystem:user:delete批量删除用户UserController#L77
PUT/system/user/update-passwordsystem:user:update-password重置用户密码UserController#L86
PUT/system/user/update-statussystem:user:update修改用户状态UserController#L94
GET/system/user/pagesystem:user:query获得用户分页列表UserController#L102
GET/system/user/listsystem:user:query获得用户详情列表UserController#L118
GET/system/user/list-all-simple—获取用户精简信息列表UserController#L132
GET/system/user/simple-list—获取用户精简信息列表UserController#L132
GET/system/user/getsystem:user:query获得用户详情UserController#L150
GET/system/user/export-excelsystem:user:export导出用户UserController#L164
GET/system/user/get-import-template—获得导入用户模板UserController#L179
POST/system/user/importsystem:user:import导入用户UserController#L193
GET/system/user/get-simple—获得用户精简信息UserController#L208
GET/system/user/list-by-nickname—按昵称模糊搜索用户精简信息UserController#L223

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/user/UserController.java#L52
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/user/AdminUserDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/permission/UserRoleDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/dept/UserPostDO.java

4. 数据表 ​

表DO
system_usersAdminUserDO
system_user_roleUserRoleDO
system_user_postUserPostDO

5. 机制与配置 ​

  • 密码 BCrypt 加密;手机号/邮箱唯一性校验
  • 删除为逻辑删除(deleted 字段)
  • 用户与角色、岗位为多对多关联表

6. 常见问题与排查 ​

  • 用户名重复先查唯一索引与 Service 校验
  • 停用后令牌不自动失效,需要额外踢下线

7. 关联 ​