# 报告页面结构规范

> **注意**：日报/周报/月报的旧结构（含"在跟订单""订单状态 A-F""目的国家 TOP8""负责人分布""订单漏斗"等页面）已废弃，`build_daily_report()` / `build_weekly_report()` / `build_monthly_report()` 函数已删除。所有报告生成统一通过 `quality_assured_build()` / `build_report()` 接口，配置驱动。

## 通用报告页面结构

通用构建器支持动态页面结构，通过 `ReportConfig.pages` 配置，无需硬编码。

### 支持的页面类型

| page_type | 用途 | 布局模板 |
|-----------|------|---------|
| `cover` | 封面页 | 固定封面布局 |
| `toc` | 目录页 | 章节目录网格 |
| `kpi_overview` | 核心指标概览 | KPI 卡片网格（3×2 / 自定义行列） |
| `trend` | 趋势分析 | 左侧趋势图 + 右侧洞察文本 |
| `distribution` | 分布分析 | 左侧图表 + 右侧洞察文本 |
| `ranking` | 排行分析 | 左侧条形图 + 右侧排行说明 |
| `summary` | 总结与建议 | 全宽洞察文本块 |
| `forecast` | 预测与计划 | 左侧目标柱状图 + 右侧达成路径文本 |
| `end` | 结束页 | 固定尾页布局 |

### 分析维度

| 周期类型 | 对比维度 |
|---------|---------|
| DAILY | 与昨日对比、与上周同日对比 |
| WEEKLY | 周环比（WoW）、7日移动平均 |
| MONTHLY | 环比（MoM）、同比（YoY）、日均值 |
| CUSTOM | 用户自定义时间范围对比 |

### 页面确认项

用户需确认每页的：
1. 页面标题（如"月度销售额趋势"）
2. 结论标题（用于导航标签和洞察总结）
3. 图表类型（BAR / LINE / PIE / DOUGHNUT / TABLE / AUTO）
4. 布局模板（chart_left / two_column / full_width / kpi_grid）

---

## 通用占位符规则

所有模板幻灯片中的文本框使用 `{placeholder}` 格式命名，脚本通过遍历 shapes 匹配文本进行替换：

| 占位符 | 出现位置 | 说明 |
|--------|---------|------|
| `{report_title}` | 封面页眉、尾页 | 报告主标题 |
| `{report_type}` | 封面副标题 | 日报/周报/月报 |
| `{date}` | 封面、内容页页眉、尾页 | 报告日期或周期 |
| `{department}` | 封面、尾页 | 报告部门 |
| `{period}` | 封面、内容页底部 | 数据周期描述 |
| `{gen_time}` | 封面 | 报告生成时间 |
| `{page_title}` | 内容页 | 当前页面标题 |
| `{source}` | 内容页底部 | 数据来源 |
| `{page_num}` | 内容页底部 | 页码 |
| `{kpiN_label}` / `{kpiN_value}` | 封面/尾页KPI卡片 | 第N个指标的标签和数值 |
| `{chapterN_title}` / `{chapterN_desc}` | 目录页 | 第N章标题和描述 |
