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

# Calls — 页面展示

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

Calls 是通话记录的完整列表，供员工回顾通话详情和 AI 分析结果。

***

## 布局

三栏式：左侧筛选面板（可折叠）+ 中间通话列表 + 右侧通话详情。

### 筛选面板

| 筛选项  | 选项                                                                                                                                                                                |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 时间范围 | 复用全站统一 date range picker                                                                                                                                                          |
| 员工   | 按员工多选 ⚠️ 待开发（后端 `/v3/calls` 的 `staff` 参数当前为单值，多选待扩展）                                                                                                                              |
| 通话结果 | 对应 `primary_outcome_result`：success / attempted / pending\_follow\_up / retained / cancelled / na ⚠️ 待开发（后端 `/v3/calls` 当前只支持按 RC 原始 `result` 筛选，无 `primary_outcome_result` 筛选参数） |
| 通话主题 | Intro booking / Membership / Cancellation / Billing 等（对应 AI subcategory）                                                                                                          |
| 方向   | Inbound / Outbound                                                                                                                                                                |

支持 Advanced Filter 折叠展开（默认折叠，只露基础筛选）。

### 通话列表

每行展示：

| 元素    | 说明                                            |
| ----- | --------------------------------------------- |
| 来电方   | 姓名 + 电话号码                                     |
| AI 摘要 | 一行通话内容概述                                      |
| 主题标签  | 彩色 badge（intro / membership / cancellation 等） |
| 时间    | 日期 + 时长                                       |
| 方向    | inbound / outbound 图标                         |

### 通话详情面板

点击列表中的某通电话，右侧展开详情：

| Tab               | 内容                         |
| ----------------- | -------------------------- |
| Call Analysis     | AI 生成的通话摘要 + outcome badge |
| Transcript        | 对话逐字稿（按说话人分气泡，关键片段高亮）      |
| Communication Log | 该联系人的完整互动历史                |

底部有 "Flag for Coaching" 按钮，将此通话标记到 Coaching 页面供经理 review。

***

## Schema 支持状态

| 功能                   | 状态                                |
| -------------------- | --------------------------------- |
| 通话列表 + 筛选            | ✅ 已接线                             |
| AI 分析摘要 / transcript | ✅ 已接线（`calls` 表 AI 字段）            |
| Flag for Coaching    | ⚠️ 待开发（需在 calls 表加 coaching 状态字段） |