> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Contacts — 页面展示

> **prototype\_version**: V3.1
> **last\_verified**: 2026-05-29
> **source\_screenshots**: `06-contacts.png`

Contacts 是联系人数据库，查看所有客户的档案、状态和互动历史。Overview 和 Communication Log 作为可复用组件，在 Tasks 和 Coaching 页面同样引用。

***

## 布局

左右分栏：左侧联系人列表 + 右侧联系人详情。

### 顶部汇总卡片

| 卡片             | 内容           |
| -------------- | ------------ |
| Total Contacts | 联系人总数        |
| Leads          | lead 阶段的联系人数 |
| Members        | 会员数          |
| Churned        | 已流失数         |

### 联系人列表

支持搜索和排序。

| 列               | 含义                                                                                       |
| --------------- | ---------------------------------------------------------------------------------------- |
| Contact         | 姓名 + 头像                                                                                  |
| Phone           | 电话号码                                                                                     |
| Stage           | Lead / Member / Churned                                                                  |
| Lead Status     | 漏斗状态（Attempted / Contacted / Booked 等）                                                   |
| Purchase Intent | High / Medium / Low（prototype 展示为 Hot / Warm / Cold 色标，底层字段是 `contacts.purchase_intent`） |
| Card            | 是否有信用卡存档                                                                                 |
| SMS             | 短信状态                                                                                     |
| Action Needed   | 是否需要跟进                                                                                   |
| Open Complaint  | 是否有未解决投诉                                                                                 |

### 联系人详情（右侧面板）

| Tab               | 内容                                                 |
| ----------------- | -------------------------------------------------- |
| Overview          | 个人信息、活动数据、Lead 状态管线、AI 分析摘要、备注                     |
| Communication Log | 完整互动时间线（通话录音 + SMS + voicemail + 系统事件 + AI XCA 卡片） |

***

## Schema 支持状态

| 功能                | 状态                                                                                                             |
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
| 联系人列表 + 筛选        | ✅ 已接线                                                                                                          |
| Overview 各字段      | ✅ 已接线（`contacts` 表）                                                                                            |
| Communication Log | ✅ 已接线（当前 route 用 `calls + messages UNION ALL`；`contact_timeline` 用于 task/events audit，system events 展示 ⚠️ 待开发） |