forked from erp-dev/erp
106 lines
1.8 KiB
Markdown
106 lines
1.8 KiB
Markdown
# quick_create_employee_user 命令说明
|
||
|
||
这个命令是对现有 `api_v2` 快速创用户接口的命令化封装，底层复用同一套共享 service。
|
||
|
||
相关入口：
|
||
|
||
- API：`POST /api/v2/users/quick-create/`
|
||
- Command：`python manage.py quick_create_employee_user`
|
||
|
||
## 共享实现
|
||
|
||
共享业务逻辑在：
|
||
|
||
- [basic_info/services.py](/home/f/coding/flower/basic_info/services.py)
|
||
|
||
API 和 command 都调用：
|
||
|
||
- `EmployeeUserProvisioningService.quick_create_employee_user(...)`
|
||
|
||
这样可以避免：
|
||
|
||
- API 与命令校验规则不一致
|
||
- 后续 MCP server 再复制一份逻辑
|
||
|
||
## 参数
|
||
|
||
必填参数：
|
||
|
||
- `--username`
|
||
- `--password`
|
||
- `--display-name`
|
||
- `--merchant-id`
|
||
|
||
可选参数：
|
||
|
||
- `--email`
|
||
- `--mobile`
|
||
- `--area`
|
||
- `--description`
|
||
- `--status`
|
||
- `--role-id`
|
||
- `--json`
|
||
|
||
## 示例
|
||
|
||
普通输出：
|
||
|
||
```bash
|
||
python manage.py quick_create_employee_user \
|
||
--username demo_user \
|
||
--password pass123456 \
|
||
--display-name 演示员工 \
|
||
--merchant-id 1
|
||
```
|
||
|
||
JSON 输出：
|
||
|
||
```bash
|
||
python manage.py quick_create_employee_user \
|
||
--json \
|
||
--username demo_user \
|
||
--password pass123456 \
|
||
--display-name 演示员工 \
|
||
--merchant-id 1 \
|
||
--mobile 13800000000
|
||
```
|
||
|
||
成功时输出示例：
|
||
|
||
```json
|
||
{
|
||
"ok": true,
|
||
"result": {
|
||
"user": {
|
||
"id": 127,
|
||
"username": "demo_user",
|
||
"display_name": "演示员工",
|
||
"role_id": null
|
||
},
|
||
"employee": {
|
||
"id": 128,
|
||
"name": "演示员工",
|
||
"status": "在职",
|
||
"merchant": 1
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
失败时如果带 `--json`，输出示例：
|
||
|
||
```json
|
||
{
|
||
"ok": false,
|
||
"error": "用户名已存在"
|
||
}
|
||
```
|
||
|
||
## 设计目的
|
||
|
||
这个命令主要是为了：
|
||
|
||
- 让运维/开发可以不经过 HTTP 直接创建用户
|
||
- 给外部脚本或 MCP server 提供稳定入口
|
||
- 保持和现有 `api_v2` 行为一致
|