report-structures.md 2.6 KB
报告页面结构规范
注意：日报/周报/月报的旧结构（含"在跟订单""订单状态 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 | 用户自定义时间范围对比 |
页面确认项
用户需确认每页的：
- 页面标题（如"月度销售额趋势"）
- 结论标题（用于导航标签和洞察总结）
- 图表类型（BAR / LINE / PIE / DOUGHNUT / TABLE / AUTO）
- 布局模板（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章标题和描述 |