# M10 Dashboard 与报表 — 需求分析

| 项 | 值 |
|---|---|
| 模块 | M10 Dashboard 与报表 |
| 域 | E 平台通用 |
| 主要角色 | 管理层 / 全员 |
| 成熟度 | 🟡 已起草待细化 |
| 关联模块 | 全模块（消费其数据）；含通知/提醒/SLA |
| 逻辑设计(LDD) | [ldd/M10（KPI 计算口径/Widget 结构/通知机制/默认布局）](../ldd/M10-Dashboard与报表-设计.md) |
| 上级文档 | [需求分析总纲](../需求分析总纲.md) |

> 本文档只描述**做什么/为什么/规则/验收（What/Why）**；KPI 计算口径/公式、Dashboard/Widget 数据结构、通知/SLA 触发机制、各角色默认布局等**实现（How）见设计文档**。

## 目标（Why）
客户状态、项目状态、额度、续约、健康度一屏可视（痛点 #9）；含通知/提醒/SLA 触达。

## 功能需求（What）
| 编号 | 需求 | 优先级 |
|---|---|---|
| FR-RPT-01 | **客户状态看板**：健康度、生命周期阶段、风险、续约。 | P0 |
| FR-RPT-02 | **项目状态看板**：进度、里程碑、逾期、风险池（延期/超工时/投诉/无进展）。 | P0 |
| FR-RPT-03 | **Quota/工时报表**：额度消耗、剩余、超支排行；工时按人/项目/客户。 | P0 |
| FR-RPT-04 | 资源利用率、续约管道报表。 | P1 |
| FR-RPT-05 | 可配置 Dashboard（Widget 拼装）+ Portfolio 组合视图，按角色定制。 | P1 |
| FR-RPT-06 | **通知/提醒/SLA**：停滞、逾期、超支、缺报、续约临近等触达（**经统一「平台通知服务」，与 M9 共用**；飞书/邮件，频率可配）。 | P0 |
| FR-RPT-07 | **KPI 指标体系**：CS — NRR/GRR、流失率、健康分布、采用率、Time-to-Value、CSAT/NPS 趋势；PS — 利用率、realization、按时交付率、backlog、人天售出 vs 消耗。 | P0 |
| FR-RPT-08 | **管理层/高管视图 + 趋势/cohort**：CS Director 级跨 Region/团队汇总、同期对比与 cohort 分析。 | P1 |
| FR-RPT-09 | **报告与交付材料生成**：周报/月报定时自动生成、订阅推送与导出（呼应 Wiki 多类周报）；并支持生成 **Kickoff agenda / RCA 跟进 / QBR 素材** 草稿。**本期边界：草稿 = 模板 + 结构化信息（issue/risk/meeting/ticket 的结构化字段）槽位填充，非 NL 摘要**；对非结构化正文的**摘要式生成属 AI 增强、归 OQ-S9 后期**（Architecture §11 本期 AI 不落地）。草稿供人工确认后定稿，不自动对外发布。 | P1 |

## 验收标准（关键）
- 客户状态、项目状态、Quota/工时三类核心看板均可用；看板数据与源模块一致（不一致项=0），数据刷新延迟可统计（目标值待业务确认）。
- 五类触发（停滞/逾期/超支/缺报/续约临近）**系统触发率=100%**（条件命中即发起，可测）；**投递以回执/失败重试兜底**（外部渠道飞书/邮件不承诺 100% 投递）；频率可配。
- FR-RPT-07 列出的 CS/PS 指标展示齐全度=100%；**NRR/GRR/流失率按 M5 LDD 口径（基于 ARRSnapshot，分子分母客户集合明确）可回归校验正确性**，非仅"展示存在"（其余口径见设计文档，目标基线待业务确认）。
- Dashboard 支持按角色配置 Widget 与 Portfolio 组合视图（配置生效可验证通过）。
- 周报/月报按计划定时生成率=100%，支持订阅推送与导出。
- Kickoff/RCA/QBR 草稿：本期按模板 + 结构化槽位填充，结构化字段填充覆盖率可统计；**草稿 100% 供人工确认后定稿、不自动对外发布**；NL 摘要式生成不在本期验收（归 OQ-S9）。

## 遗留待确认
- 各角色默认 Dashboard 布局。
- 报表导出格式与数据下钻粒度。
- 各 KPI 统计口径与阈值（配置化，待业务确认）。