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

# Dashboard — 页面展示

> **prototype\_version**: V3.1
> **last\_verified**: 2026-05-29
> **source\_screenshots**: `03-dashboard-performance.png` · `04-dashboard-team.png`

Dashboard 是单店视角的运营总览。进入某家门店后的默认页面，帮 studio manager 快速判断"今天要关注什么"。

***

## 通用控件

| 控件    | 说明                                                    |
| ----- | ----------------------------------------------------- |
| 时间选择器 | 复用全站统一 date range picker                              |
| 趋势对比  | 环比（this week vs last week，或 this month vs last month） |

***

## Tab: Performance

两个 KPI 卡片 + 三个快捷牵引。

### KPI 卡片

| 卡片            | 展示内容                                                                                                  |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| Call Volume   | 总通话数 + inbound / outbound 拆分 + 环比趋势                                                                   |
| Task Outcomes | Tasks Closed 数量（⚠️ 当前 endpoint 只返回 tasksClosed，Intro Booked / Membership Sold / Cancel Saved 明细需后端扩展） |

### 快捷牵引

每个牵引只放一个关键数字 + 跳转按钮，不堆数据。

| 牵引             | 内容                      | 跳转             |
| -------------- | ----------------------- | -------------- |
| Lead Follow-up | 需要跟进的 lead 数            | → Lead Tracker |
| Task Queue     | 未关闭的 open tasks 数       | → Tasks        |
| Manager Review | 待 review 的 coaching 通话数 | → Coaching     |

***

## Tab: Team

员工维度的通话活动汇总。

::: warning 列定义待 Oliver 重新设计（2026-05-28 会议评论）
下表列定义尚未定案（Oliver 需重新设计）。其中 **Live / Voicemail / No Answer 三列后端尚未接线** —— staff endpoint 当前 SQL 仅返回 `human_conversation` + `voicemail`，`no_answer` 被过滤，需后端扩展。「按 call type 筛选追加列」能力 staff endpoint 也暂无支撑。以下列作 prototype 参考，非终态。
:::

| 列         | 含义                    |
| --------- | --------------------- |
| Staff     | 员工姓名 + 角色             |
| Calls     | 通话总数                  |
| In / Out  | inbound / outbound 拆分 |
| Live      | 真人接听的通话数              |
| Voicemail | 语音留言数                 |
| No Answer | 未接听数                  |

支持按 call type 筛选追加列。

***

## Tab: Impact / Reports

标注 "not in this version"，tab 保留但内容不开发。

***

## Schema 支持状态

| 指标                               | 状态                                                                                                                       |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Call Volume / inbound / outbound | ✅ 已接线（`GET /v3/dashboard/overview` 含 total/inbound/outbound；周环比趋势另由 `/v3/dashboard/summary` 提供，但 summary 不返回 inbound 拆分） |
| Tasks Closed                     | ✅ 已接线（同上）；core task 明细拆分 ⚠️ 待开发                                                                                          |
| Lead follow-up count             | ✅ 已接线（`GET /v3/dashboard/overview` leadFunnel）                                                                           |
| Open tasks count                 | ✅ 已接线（tasks list endpoint，`WHERE status = 'open'`；`/v3/dashboard/overview` 不返回 task 数据）                                  |
| Coaching review count            | ✅ 已接线（`GET /v3/dashboard/coaching-highlights`）                                                                           |
| Staff calls breakdown            | ✅ 已接线（`GET /v3/dashboard/staff`）                                                                                         |