用 WorkBuddy 生成 Excel 模板工程

第 0 轮：一句朴素需求

从真实工作里的模糊表达开始，而不是假装自己已经知道完整方案。

我想做一个集团年度经营分析的 Excel，很多部门都要填，最好能自动算一些指标。
先不要写代码，请先问我问题，帮我把这个需求梳理清楚。

第 1 轮：AI 追问业务边界

让 AI 先问清楚使用者、数据来源、维护频率、输出对象、权限边界和验收方式。

你先按这些方向问我：
1. 谁填写？谁查看？谁维护？
2. 数据是订单级、月度汇总，还是两者都有？
3. 需要哪些经营指标？
4. 哪些字段必须统一下拉？
5. 哪些公式必须自动计算？
6. 需要管理层 Dashboard 吗？
7. 交付物是一个 Excel，还是一个可以反复生成 Excel 的项目？

第 2 轮：补充模型结构

回答完追问后，再让 AI 把需求整理成大型复杂 Excel 的模型蓝图。

根据我的回答，请先不要写代码。
请把这个 Excel 模型拆成几类 Sheet：
- 说明与配置
- 基础字典
- 明细输入
- 目标预算
- 经营汇总
- 管理层 Dashboard
- 公式检查
- 变更日志

请输出每个 Sheet 的用途、关键字段、谁维护、哪些字段来自下拉。

第 3 轮：补充公式和验收

等结构稳定后，再补公式、校验和检查口径。这里才开始接近工程需求。

请继续补充：
- 收入、毛利、毛利率、费用率、利润率
- 目标达成率、环比增长率、同比增长率、预算偏差
- RANK 排名、IF 分段奖金系数、风险预警
- 哪些公式必须真实写入单元格
- 哪些字段需要数据验证
- 用什么方式检查模型是否完整

第 4 轮：升级为 WorkBuddy 工程交付

最后再把已经澄清的需求压缩成工程交付提示词，让 WorkBuddy 创建项目。

现在请把上面的模型蓝图整理成 WorkBuddy 工程任务。
请帮我创建一个本地 Excel 模板生成项目，项目文件夹名可以使用 workbuddy-excel-model。

目标：生成 集团年度经营分析.xlsx。

技术要求：
- 使用 Python 脚本式项目结构，贴近 WorkBuddy 实际输出。
- 优先使用 Python + xlsxwriter 生成 .xlsx，因为它可以稳定写入真实 Excel 图表。
- 不要生成单文件 HTML 页面。
- 使用 build_excel.py 定义工作簿结构、Sheet、字段、公式、样式、数据验证和 Dashboard 图表。
- 使用 fill_sample_data.py 写入示例数据，便于学员打开后直接看到公式和图表效果。
- 保留 .workbuddy/ 作为 WorkBuddy 的项目上下文和过程记录。
- 最终在项目根目录输出 集团年度经营分析.xlsx。
- 在 build_excel.py 中加入基础检查逻辑，确保关键 Sheet、公式和图表被生成。
- 如需更严格验收，可让 WorkBuddy 追加 check_workbook.py，但课堂主线以 build_excel.py 和 fill_sample_data.py 为准。
- 如果 WorkBuddy 生成 README，可以保留；如果没有 README，也要在课堂中讲清楚 build_excel.py 和 fill_sample_data.py 的职责。
- 增强版必须生成 31_管理层Dashboard 的真实 Excel 图表，不能只生成图表数据区；可使用 xlsxwriter 等能写入真实 Excel 图表的方案。

Excel 模板需要包含：
1. 00_使用说明：模型用途、填写流程、版本、负责人、更新频率、公式口径。
2. 01_参数配置：年份、币种、区域、事业部、产品线、费用类型、税率、汇率、目标版本。
3. 02_基础字典：区域、门店、产品、销售员、部门、费用科目等主数据。
4. 10_销售明细台账：订单号、日期、客户、区域、产品线、产品、数量、单价、折扣率、收入、成本、毛利、毛利率、状态。
5. 11_费用明细台账：日期、部门、区域、费用科目、供应商、金额、预算科目、审批状态。
6. 12_目标预算表：月份、区域、产品线、收入目标、毛利目标、费用预算、利润目标。
7. 20_月度经营汇总：收入、成本、毛利、费用、利润、达成率、环比增长率、同比增长率、预算偏差。
8. 21_区域业绩对比：区域维度排名、目标达成、费用率、利润率、风险预警。
9. 22_产品线分析：产品线收入贡献、毛利贡献、销量、均价、折扣率。
10. 23_销售员绩效：销售员订单数、收入、毛利、回款率、奖金系数、星级评定。
11. 30_经营看板数据：专门给图表和 Dashboard 使用的规整数据区，这是 Dashboard 数据层。
12. 31_管理层Dashboard：KPI 总览、趋势、区域排名、产品贡献、预警列表和真实 Excel 图表，这是 Dashboard 展示层。
13. 90_公式检查：关键公式、依赖字段、检查状态、异常说明。
14. 99_变更日志：版本、修改人、修改日期、修改内容、影响范围。

关键公式必须真实写入单元格：
- 收入 = 数量 * 单价 * 折扣率
- 毛利润 = 销售额 - 成本
- 毛利率 = IFERROR(毛利润 / 销售额, 0)
- 费用率 = IFERROR(费用 / 收入, 0)
- 利润 = 毛利 - 费用
- 利润率 = IFERROR(利润 / 收入, 0)
- 达成率 = 总销售额 / 目标销售额
- 环比增长率、同比增长率、预算偏差
- 排名 = RANK
- 平均订单金额 = 总销售额 / 总订单数
- 风险预警 = IF 组合判断低毛利、高费用率、未达标

验收标准：
- 运行 python build_excel.py 可以生成基础工作簿。
- 运行 python fill_sample_data.py 可以填入示例数据并刷新 Dashboard 数据源。
- 打开 集团年度经营分析.xlsx，检查 31_管理层Dashboard 是否包含真实图表。
- 修改 build_excel.py 后重新生成，不需要手工逐张 Sheet 重做。
- build_excel.py 和 fill_sample_data.py 的命名要让业务同事能看懂职责。

初始化项目

WorkBuddy 创建 Python 脚本和工作簿文件，必要时安装 xlsxwriter。

生成模板

运行构建命令，输出 集团年度经营分析.xlsx。

检查公式

填入示例数据后，打开 Excel 确认收入、毛利率、费用率、达成率、同比、预算偏差和风险预警等公式真实写入单元格。

继续迭代

业务要新增字段、调整公式或换模板名称时，优先修改 build_excel.py 后重新生成。