998211c483
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
119 lines
3.3 KiB
Markdown
119 lines
3.3 KiB
Markdown
# 获取客户来访列表
|
||
|
||
## 接口信息
|
||
|
||
- **路径**：GET `/api/beauty/v1/visit/by-customer`
|
||
- **说明**：根据客户ID获取来访记录列表
|
||
|
||
## 请求参数
|
||
|
||
### Query参数
|
||
|
||
| 参数 | 必选 | 类型 | 默认值 | 描述 |
|
||
|------|------|------|--------|------|
|
||
| estateId | ✓ | integer(int64) | - | 项目ID |
|
||
| thirdCustomerId | ✓ | string | - | 三方顾客ID |
|
||
| visitTimeStart | - | string(date-time) | - | 来访时间开始（yyyy-MM-dd HH:mm:ss） |
|
||
| visitTimeEnd | - | string(date-time) | - | 来访时间结束（yyyy-MM-dd HH:mm:ss） |
|
||
|
||
### 请求示例
|
||
|
||
```bash
|
||
GET /api/beauty/v1/visit/by-customer?estateId=516799468310364162&thirdCustomerId=customer_001&visitTimeStart=2025-01-01%2000:00:00&visitTimeEnd=2025-01-31%2023:59:59
|
||
```
|
||
|
||
## 响应结果
|
||
|
||
### Body结构
|
||
|
||
| 参数 | 必选 | 类型 | 默认值 | 描述 |
|
||
|------|------|------|--------|------|
|
||
| - | - | object[] | - | 来访记录数组 |
|
||
| └─ id | - | integer(int64) | - | 接访单ID |
|
||
| └─ thirdVisitId | - | string | - | 三方接访单ID |
|
||
| └─ visitTime | - | string(date-time) | - | 来访时间 |
|
||
| └─ customerId | - | integer(int64) | - | 顾客ID（系统内部） |
|
||
| └─ visitCount | - | integer(int32) | - | 第几次接访 |
|
||
| └─ visitSpecial | - | integer(int32) | - | 是否打上特殊标签 |
|
||
| └─ specialReason | - | string | - | 特殊标签原因 |
|
||
| └─ userId | - | integer(int64) | - | 主销ID（员工ID） |
|
||
| └─ createTime | - | string(date-time) | - | 创建时间 |
|
||
| └─ updateTime | - | string(date-time) | - | 更新时间 |
|
||
|
||
### 响应示例
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"data": [
|
||
{
|
||
"id": 1001,
|
||
"thirdVisitId": "visit_001",
|
||
"visitTime": "2025-01-15 10:30:00",
|
||
"customerId": 2001,
|
||
"visitCount": 1,
|
||
"visitSpecial": 0,
|
||
"specialReason": "",
|
||
"userId": 3001,
|
||
"createTime": "2025-01-15 10:30:00",
|
||
"updateTime": "2025-01-15 10:35:00"
|
||
},
|
||
{
|
||
"id": 1002,
|
||
"thirdVisitId": "visit_002",
|
||
"visitTime": "2025-01-20 14:00:00",
|
||
"customerId": 2001,
|
||
"visitCount": 2,
|
||
"visitSpecial": 0,
|
||
"specialReason": "",
|
||
"userId": 3001,
|
||
"createTime": "2025-01-20 14:00:00",
|
||
"updateTime": "2025-01-20 14:30:00"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 字段说明
|
||
|
||
### visitCount
|
||
|
||
表示该客户第几次来访，用于区分新客户和回访客户。
|
||
|
||
### visitSpecial
|
||
|
||
- **0**：正常来访
|
||
- **1**：特殊标签（如投诉、纠纷等）
|
||
|
||
## 业务逻辑
|
||
|
||
1. 返回按visitTime倒序排列的来访记录
|
||
2. 可通过时间范围筛选特定时期的来访
|
||
3. visitCount自动累计，反映客户来访频次
|
||
|
||
## 使用场景
|
||
|
||
1. 查询客户历史来访记录
|
||
2. 分析客户回访频率
|
||
3. **获取员工服务的客户列表，进而获取对话记录**
|
||
4. 统计销售人员接待量
|
||
|
||
## 扩展用法
|
||
|
||
### 获取员工最近N条对话记录
|
||
|
||
1. 通过员工手机号获取userId
|
||
2. 反向查询：获取该userId服务的所有来访记录（需要额外接口支持）
|
||
3. 对每条来访记录调用"获取来访录音信息"
|
||
4. 对每个录音调用"获取录音ASR分析结果"
|
||
5. 组合返回完整对话记录
|
||
|
||
## 注意事项
|
||
|
||
1. 大量历史数据建议分页查询
|
||
2. 时间范围建议不超过1年
|
||
3. thirdCustomerId需要提前在系统中同步
|
||
|
||
|