feat: bind employee to customer (v2)

docs/api_v2_customer_employee_binding.md

@@ -0,0 +1,105 @@
+# 客户员工绑定 API
+
+## 接口说明
+
+将指定员工添加到指定客户的可见员工列表中（`Customer.visible_employees`）。
+
+## 接口信息
+
+- **URL**: `/api/v2/customers/bind-employee/`
+- **方法**: `POST`
+- **认证**: 需要登录（Bearer Token）
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| customer_name | string | 是 | 客户名称 |
+| employee_name | string | 是 | 员工姓名 |
+
+## 请求示例
+
+```bash
+curl -X POST "http://your-domain/api/v2/customers/bind-employee/" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "customer_name": "张三服装厂",
+    "employee_name": "李四"
+  }'
+```
+
+## 响应说明
+
+### 成功响应（201 Created）
+
+```json
+{
+  "message": "成功将员工 \"李四\" 添加到客户 \"张三服装厂\" 的可见列表",
+  "customer_id": 123,
+  "customer_name": "张三服装厂",
+  "employee_id": 456,
+  "employee_name": "李四"
+}
+```
+
+### 已存在响应（200 OK）
+
+如果该员工已经在客户的可见列表中：
+
+```json
+{
+  "message": "员工 \"李四\" 已在客户 \"张三服装厂\" 的可见列表中",
+  "customer_id": 123,
+  "employee_id": 456
+}
+```
+
+### 错误响应
+
+#### 未找到数据（400 Bad Request）
+
+```json
+{
+  "error": "未找到名为 \"李四\" 的员工"
+}
+```
+
+或
+
+```json
+{
+  "error": "未找到名为 \"张三服装厂\" 的客户"
+}
+```
+
+#### 找到多条数据（403 Forbidden）
+
+```json
+{
+  "error": "找到多个名为 \"李四\" 的员工（3 个），请使用更精确的标识"
+}
+```
+
+或
+
+```json
+{
+  "error": "找到多个名为 \"张三服装厂\" 的客户（2 个），请使用更精确的标识"
+}
+```
+
+#### 参数验证失败（400 Bad Request）
+
+```json
+{
+  "customer_name": ["该字段是必填项。"],
+  "employee_name": ["该字段是必填项。"]
+}
+```
+
+## 注意事项
+
+1. 该操作是**幂等的**：重复绑定同一对客户和员工不会报错，会返回 200 状态码
+2. 如果客户或员工名称不唯一，系统会返回 403 错误，建议在数据库中确保名称唯一性
+3. 绑定关系为多对多，一个客户可以有多个可见员工，一个员工也可以被多个客户可见