主题
功能卡模板(T1)
markdown
---
id: SYS-USER-01
title: 用户管理-新增用户
module: system
status: done
code:
- pmforge-module-system/src/main/java/com/pmforge/module/system/controller/admin/user/UserController.java#L120
- pmforge-module-system/src/main/java/com/pmforge/module/system/service/user/AdminUserServiceImpl.java#L80
prd: /prd/01-系统管理/01-02-用户管理
generated: false
---
# 新增用户
一句话价值:管理员在后台创建账号并分配组织与角色。
## 1. 场景
- 新员工入职,管理员创建账号并分配部门。
- 租户管理员为本租户新增子账号。
## 2. 权限与接口
| 方法 | 路径 | 权限点 | 摘要 |
| --- | --- | --- | --- |
| POST | /system/user/create | system:user:create | 创建用户 |
## 3. 代码定位
| 层 | 位置 |
| --- | --- |
| Controller | `.../controller/admin/user/UserController.java#L120` |
| VO | `.../controller/admin/user/vo/user/UserSaveReqVO.java` |
| Service | `.../service/user/AdminUserServiceImpl.java#L80` |
| DO / 表 | `AdminUserDO` / `system_users` |
## 4. 数据
| 表 | 关键字段 | 说明 |
| --- | --- | --- |
| system_users | username、password、dept_id、post_ids | 密码 BCrypt |
## 5. 机制与配置
- 租户:自动写入 `tenant_id`。
- 权限:方法级 `@PreAuthorize`。
- 日志:`@ApiAccessLog` + 操作日志。
## 6. 排错
| 现象 | 排查顺序 |
| --- | --- |
| 403 | 权限点是否写入 `system_menu`、角色是否勾选 |
| 用户名重复 | 唯一索引与 Service 校验 |
## 7. 关联
- 需求原件:[用户管理](/prd/01-系统管理/01-02-用户管理)
- 相关卡片:SYS-USER-02(修改用户)、SYS-ROLE-01(分配角色)