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

# 联系人扩展指标

以下指标和功能当前不在前端展示，留待后续版本实现。

***

## DNC 指标

| # | 指标      | English       | 定义                          | 角色 | V1 就绪  | 作用         |
| - | ------- | ------------- | --------------------------- | -- | ------ | ---------- |
| 1 | DNC 标记率 | DNC Flag Rate | `doNotContact` = true 的客户占比 | M  | ✅ Auto | 监控不可联系客户占比 |

***

## 手动里程碑 (Manual Milestones)

V1 中到店 / 试课 / 成交无法自动获取，需员工通过 UI 按钮手动标记。

| 里程碑 | English   | UI 操作               | `leadStatus` 变更 | 角色           | V1 就绪     | 作用             |
| --- | --------- | ------------------- | --------------- | ------------ | --------- | -------------- |
| 到店  | Showed    | "Mark Showed" 按钮    | → `showed`      | S（输入）/ M（追踪） | 🔘 Manual | 标记客户到店，驱动到店率计算 |
| 试课  | Trialed   | "Mark Trialed" 按钮   | → `trialed`     | S（输入）/ M（追踪） | 🔘 Manual | 标记客户试课，驱动试课率计算 |
| 成交  | Converted | "Mark Converted" 按钮 | → `converted`   | S（输入）/ M（追踪） | 🔘 Manual | 标记客户成交，驱动转化率计算 |

这 3 个按钮是跑通完整 6 步漏斗的关键——前 4 步系统自动，后 2 步靠手动输入。

***

## AI 增强字段

AI 分析结果直接写入 Contacts 表。以下字段已在 [Contacts 数据来源](../contacts-feature/contacts-spec.md) 中定义，由 AI 写入：

| 字段     | English               | V1 Contacts 对应                                              | 角色 | V1 就绪         | 作用            |
| ------ | --------------------- | ----------------------------------------------------------- | -- | ------------- | ------------- |
| 购买意向   | Purchase Intent       | `purchaseIntent`（high / medium / low）                       | M  | ✅ Auto（AI 写入） | 识别高意向客户优先跟进   |
| 状态原因   | Lead Status Reason    | `leadStatusReason`                                          | M  | ✅ Auto（AI 写入） | 解释状态变更的具体原因   |
| 行动建议   | Suggested Action      | `suggestedActions`（含 action/reason/priority/priorityReason） | S  | ✅ Auto（AI 写入） | 为员工提供下一步操作指引  |
| 客户画像   | Customer Summary      | `customerSummary`                                           | S  | ✅ Auto（AI 写入） | 快速了解客户背景和需求   |
| 状态变更历史 | Lead Status Changelog | `contact_timeline` 的 `contact.lifecycle_changed` 事件         | M  | ✅ Auto        | 追溯状态变更全链路     |
| 未解决投诉  | Open Complaint        | `hasOpenComplaint`                                          | M  | ✅ Auto（AI+代码） | 识别当前有未解决投诉的客户 |

::: details 风险信号数据流
投诉和取消升级是 Per-Call 信号，由 Pipeline 1 Per-Call AI 从通话转录中检测，存储在 calls 表。其中投诉信号通过 ai-analysis-processor 实时提升到 Contacts 的 `hasOpenComplaint`；取消/升级信号则驱动现有 `actionNeeded` + `suggestedActions` 字段组，不另建 Contacts 字段。Contacts 数据来源完整说明见 [Contacts 数据来源](../contacts-feature/contacts-spec.md)。

## :::

## AI 衍生指标 (Derived Metrics)

| # | 指标             | English                       | 计算                                         | 角色 | V1 就绪         | 作用             |
| - | -------------- | ----------------------------- | ------------------------------------------ | -- | ------------- | -------------- |
| 1 | 条件性拒绝占比        | Conditional Rejection Rate    | `leadStatus` = bad\_timing ÷ 总拒绝数          | M  | ✅ Auto        | 评估可回捞客户比例      |
| 2 | AI Summary 覆盖率 | AI Summary Coverage           | 有 `customerSummary` 的客户 ÷ 总客户              | M  | ✅ Auto        | 衡量 AI 画像覆盖面    |
| 3 | 决策障碍分布         | Objection Distribution        | `leadObjections` 各标签出现频次                   | M  | ✅ Auto（AI 写入） | 了解客户顾虑的主要原因    |
| 4 | 拒绝原因分布         | Rejection Reason Distribution | `leadRejectionReasons` 各标签出现频次             | M  | ✅ Auto（AI 写入） | 了解客户拒绝的主要原因    |
| 5 | 客户目标分布         | Goal Distribution             | `goals[].goal` 各值出现频次                      | M  | ✅ Auto（AI 写入） | 了解客户需求类型结构     |
| 6 | 投诉率            | Complaint Rate                | `hasOpenComplaint` = true ÷ 总客户数           | M  | ✅ Auto（AI+代码） | 监控当前未解决投诉的客户占比 |
| 7 | 取消意向率          | Cancel Intent Rate            | calls 表中 `cancelIntent` = true 的客户数 ÷ 总会员数 | M  | ✅ Auto（AI 写入） | 监控表达过取消意向的会员占比 |