# report.html · 月度复盘

## 用途与角色

月度复盘会材料（每月 60 分钟，总经理主持）。指标自动产出（三期验收项）。规格书 8.1/8.2 节。

## 区块

| 区块 | 内容 | 口径 |
|---|---|---|
| 五项指标卡 | P0/P1 响应达标率 · 服务闭环周期 · 根治闭环率 · 重复问题率 · 备件一次带齐率 | 见下 |
| 节点停留表 | 本月 vs 上月，红升绿降 | S1 状态流转 |
| 类别分布条形 | 机械/光学/电气/软件/其他 | 问题单分类字段 |
| 重复问题 Top3 | 设备/现象 × 次数 × 处置状态 | A8/A12 |
| P0/P1 占比趋势 | 近 5 月条形 | A15 数据 |

## 指标口径（V1.3 起四域八指标，严格对齐 ai-agents.md KPI 节）

- **服务体验**：首次响应时长＝T0→首次客户触达；跟踪及时率＝节点移动后 24h 内有跟进的比例。
- **断点治理**：断点率＝每百单断点次数（哨兵识别口径）；重复问题率＝90 天同设备同现象重复占比。
- **闭环效率**：服务闭环周期＝关闭−T0（净工作日，挂起顺延）；根治闭环率＝ECN/TIP 关闭占比。
- **平台价值**：AI 建议采纳率（按场景分列）；企微触达响应时长＝哨兵催办→首次响应。
- 原规格书 8.2 五项为本体系子集，规格书 V0.3 同步；备件一次带齐率并入维修顾问场景统计。

## 行为契约

1. 报表每月 1 日 02:00 自动生成快照（不可变），会中讨论批注挂在快照上。
2. 「对比上月」切换双月并排；导出 PDF 供归档。
3. 所有下钻（Top3、类别分布）点击穿透到对应筛选的列表页。

## 接口草案

- `GET /api/loop/report/monthly?ym=2026-09`
- `GET /api/loop/report/monthly/{ym}/export.pdf`

## 权限

- 总经理、经理、台账管理员可见；导出仅台账/总经理。

## 边界与空态

- 当月无关闭单：根治闭环率显示「—」而非 0（口径不满）。
- 双轨运行月（首月）：标注「数据不完整，仅参考」。

## AI 辅助（运营摘要 · M3）

- 「AI 月度解读」卡：指标归因（如根治闭环率拖累项）、前瞻（ECN 完成后预期影响）、知识沉淀效果关联；写进快照批注区，会上可逐条采纳或忽略。

## 验收要点

- 五项指标与手写 SQL 抽查一致（口径测试）。
- 月度自动产出（三期验收：无需人工汇总）。