# 获取客户来访列表

## 接口信息

- **路径**：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需要提前在系统中同步


