feat: api_v2

api_v2/user_quick_create.md

@@ -0,0 +1,44 @@
+# 快速创建员工用户 API
+
+- **URL**: `POST /api/v2/users/quick-create/`
+- **说明**: 一次性创建 Django User 与 `basic_info.Employee` 并建立关联，为前端提供统一的员工开通入口。
+- **权限**: 需要登录（任意已绑定员工的用户）。
+
+## 请求体
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `username` | string | 是 | 登录名，全局唯一 |
+| `password` | string | 是 | 至少 6 位密码 |
+| `display_name` | string | 是 | 员工姓名，同时写入 User.first_name |
+| `merchant_id` | int | 是 | 员工所属商户 |
+| `email` | string | 否 | 邮箱 |
+| `mobile` | string | 否 | 联系电话 |
+| `area` | string | 否 | 区域信息 |
+| `description` | string | 否 | 备注 |
+| `status` | enum | 否 | 员工状态，默认 `active` |
+
+## 响应示例
+
+```json
+{
+  "user": {
+    "id": 12,
+    "username": "new_user",
+    "display_name": "新员工"
+  },
+  "employee": {
+    "id": 45,
+    "name": "新员工",
+    "status": "active",
+    "merchant": 3
+  }
+}
+```
+
+## 失败响应
+
+- `400 用户名已存在`
+- `400 商户不存在`
+- `401 未认证`
+