# 客诉（投诉）数据处理参考

## 项目位置

客诉数据不在销售管理项目中。它在 **售后管理** 项目中：

| 项 | 值 |
|----|-----|
| 项目名 | 售后管理 |
| simple_name | br-shgl |
| project_key | 658288abfb8bd616b17025f1 |
| 工作项类型 | 客户反馈单 |
| type_key | 6669433056a98249604376de |
| api_name | khts |

## 发现方法

```python
# 1. 查所有项目
mcp_call('search_project_info', {})

# 2. 逐个 list_workitem_types
mcp_call('list_workitem_types', {'project_key': '658288abfb8bd616b17025f1'})
# → 找到 '6669433056a98249604376de' = 客户反馈单 (khts)
```

## 关键字段

| field_key | 含义 | 类型 |
|-----------|------|------|
| name | 流程名称（客诉标题） | text |
| start_time | 创建时间 | date |
| work_item_status | 当前状态 | [{key,label}] 数组 |
| finish_status | 是否完成 | bool |
| finish_time | 完成时间 | date |
| field_9e2144 | 反馈区域（销售拓展部/大客户/浙江/广东） | select |
| field_6fb810 | 产品线 | select |
| field_3ce9fe | 反馈/客诉类型 | select |
| field_d107b0 | 是否性能问题 | bool |
| field_502a85 | 货值是否超过5万 | select(是/否) |
| field_ac5caf | 关联客户 | workitem_related_multi_select |
| current_status_operator | 当前负责人 | multi-user |
| owner | 创建者 | user object {name_cn, email} |

## adaptMcpFields 处理要点

1. **work_item_status** 是 `[{key, label}]` 数组，取 `[0].label`
2. **current_status_operator** 是 `[user_object,...]`，提取 `name_cn`
3. **owner** 是 user object `{name_cn, email, user_key}`，取 `name_cn`
4. **finish_status** 是 boolean，与 status 文本双重判断是否为已关闭
5. **field_ac5caf** 是 `[{key, label}]` 数组，取 `[0].label` 作为客户名
6. **priority 计算**：`field_502a85='是'` → 高，`field_d107b0=true` → 中，否则低

## MQL 查询

```sql
SELECT `name`,`work_item_id`,`start_time`,`work_item_status`,
       `field_9e2144`,`field_6fb810`,`field_3ce9fe`,
       `field_d107b0`,`field_502a85`,`field_ac5caf`,
       `owner`,`business`,`current_status_operator`,
       `finish_time`,`finish_status`
FROM `658288abfb8bd616b17025f1`.`6669433056a98249604376de`
```