erpnew/docs/quick_create_employee_user_command.md

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

API 和 command 都调用：

• EmployeeUserProvisioningService.quick_create_employee_user(...)

这样可以避免：

• API 与命令校验规则不一致
• 后续 MCP server 再复制一份逻辑

参数

必填参数：

• --username
• --password
• --display-name
• --merchant-id

可选参数：

• --email
• --mobile
• --area
• --description
• --status
• --role-id
• --json

示例

普通输出：

python manage.py quick_create_employee_user \
  --username demo_user \
  --password pass123456 \
  --display-name 演示员工 \
  --merchant-id 1

JSON 输出：

python manage.py quick_create_employee_user \
  --json \
  --username demo_user \
  --password pass123456 \
  --display-name 演示员工 \
  --merchant-id 1 \
  --mobile 13800000000

成功时输出示例：

{
  "ok": true,
  "result": {
    "user": {
      "id": 127,
      "username": "demo_user",
      "display_name": "演示员工",
      "role_id": null
    },
    "employee": {
      "id": 128,
      "name": "演示员工",
      "status": "在职",
      "merchant": 1
    }
  }
}

失败时如果带 --json，输出示例：

{
  "ok": false,
  "error": "用户名已存在"
}

设计目的

这个命令主要是为了：

• 让运维/开发可以不经过 HTTP 直接创建用户
• 给外部脚本或 MCP server 提供稳定入口
• 保持和现有 api_v2 行为一致