经营决策罗盘 (Decision Compass Analytics)
Overview
将零散的经营分析指标、模型与方法论文献，综合成一套「可复用、可填数即用」的经营分析体系，并交付两份互为表里的成果：
- Excel 公式化分析模型（14 工作表，填数即出指标 / 评分 / 预警灯）
- Word 多视角决策框架报告（方法论 + 三视角解读 + 落地建议 + 版本一致性说明）
核心方法论特色：CFO / HRD / GM 三视角决策框架 与 经营质量与可持续性评价，而非单点算数。
When to Use（触发场景）
- 用户要求「建立 / 构建经营分析体系、经营分析模型、财务分析模型、多视角决策框架」
- 用户要求「经营质量与可持续性评价」「绩效指挥棒」「人效地图」「战略解码支撑」
- 用户希望把 IMA / 知识库 / 公众号方法论文献「综合成一套体系 + 模板 + 报告」
- 用户要求对已有分析模型做「真实样本压力测试 / 缺陷修复 / 双交付物一致性」
- 触发词示例：经营分析、财务分析模型、三视角、CFO/HRD/GM、人效、经营质量、稳健可持续、业财融合
Deliverables（双交付物结构）
Excel 分析模型（14 工作表）：说明 / 输入_财务 / 指标计算(30+) / 杜邦分析 / 本量利CVP / 现金流三表 / 人效指标 / 经营质量评分(8维) / 风险预警(10灯) / 三视角映射 / 行业基准 / 行业护城河 / 管理层治理 / 估值与资本市场。黄色单元格为输入区，其余为公式自动计算。
Word 报告（章节）：零·前言 → 一·指标体系 → 二·模型工具箱 → 三·三视角 → 四·经营质量评价卡 → 五·Excel使用说明 → 六·落地建议 → 七·上市公司视角融合 → 八·v3缺陷修复与一致性（见 references/v3_defects.md）→ 附录。
Standard Workflow（6 步）
- 综合知识源：抓取 IMA / 知识库本周更新或指定方法论文献，提炼指标字典、模型清单、三视角要点。用时间窗口按
time_wording（知识库更新日，非原文发布日）筛选。 - 设计指标体系：归为 5 大维度（盈利 / 营运 / 偿债 / 成长 / 成本人效）+ 经营分析会 8 指标速查 + 人效 10 公式 + 30 指标字典（含公式与关注方向）。
- 搭模型工具箱 + 三视角：15 基础模型 + 行业适配指引（制造 / 零售 / 专业服务 / SaaS / 工程）；三视角各自关注重心、核心方法、输出物。
- 构建 Excel（公式化）：用
scripts/build_model_excel.py+scripts/extend_model_excel.py（openpyxl 3.1.5）生成 14 表，内置演示数据。务必用scripts/validate_v3.py（formulas 库）端到端重算校验，确认无 #DIV/0! 且演示结果合理（见references/tech_stack.md踩坑）。 - 撰写 Word 报告：用 python-docx 生成；若需把版本修复同步进报告，用
scripts/append_v3_word.py（在指定章前 XML 前移插入章节、克隆标题样式，保证与 Excel 说明页一致）。 - 压力测试 + 缺陷修复 + 一致性：用三类真实样本（上市 / 非上市 / 亏损周期）代入模型，与官方披露交叉验证；按
references/v3_defects.md的 8 项红线修复；最后确保 Word 与 Excel 同版本。
Three-Perspective Framework（三视角要点）
- CFO（经营质量与内涵）：利润含金量（经营现金流/净利 > 1）、盈利质量（毛利率拆 价格/成本/结构/折扣）、资产质量（应收存货占用、现金循环周期）、杜邦（ROE = 净利率 × 总资产周转 × 权益乘数）、本量利敏感性。输出「经营质量五判断」。
- HRD（绩效指挥棒）：人效 10 公式、关键绩效地图（CSF → KPI → 业务动作 → 责任人）、链接绩效与业务、关键人才流失率红线。
- GM（系统能力与可持续）：战略解码（BLM 式）、五流一致（发票 / 资金 / 货 / 合同 / 信息）、风险地图、六条稳健可持续（增长健康 / 利润有现金 / 费用有产出 / 负债可控 / 人效向上 / 合规闭环）。
v3 Defect Red Lines（8 项，必守）
亏损负基数守卫 / 估值盈利为正闸门 / 现金流红灯亏损豁免 / 评分卡联动实际指标 / 经营报表模式（轻量套件）/ 空白=灰缺失 / 期间年/季开关 / 低基数 NM 守卫。详表、公式落地与验证场景见 references/v3_defects.md，绝不可删除或弱化。
Tech Stack & Pitfalls
- 运行环境：venv 解释器
.../envs/default/Scripts/python.exe；库 openpyxl 3.1.5、python-docx 1.2.0、formulas（Excel 求值）。 - 关键坑：openpyxl 写公式不写缓存值，必须 formulas 库或 LibreOffice 求值验证；LibreOffice headless 转 xlsx 不写缓存值，formula 求值不可靠 → 用 formulas 库。千元 / 亿元单位换算易多 / 少零（1 千元 = 0.00001 亿元）。指标「编号列」与「实际行号 / 公式坐标」易错位，提取须按 ROW 取列。详细见
references/tech_stack.md。
Bundled Resources
scripts/build_model_excel.py：基础 14 表（含输入区、指标计算、杜邦、CVP、现金流三表、人效、评分卡、风险灯、三视角映射、行业基准）+ v3 守卫与灰灯。scripts/extend_model_excel.py：追加 行业护城河 / 管理层治理 / 估值与资本市场 三表、估值闸门、评分卡联动、说明页 v3 清单。scripts/append_v3_word.py：向现有 Word 在指定章前插入 v3 章节并修订描述，保证与 Excel 一致。scripts/validate_v3.py：演示数据回归校验；scripts/test_v3_scenarios.py：4 类缺陷场景验证。- 以上脚本为本次实际产出骨架，使用时复制到目标工作区，按需调整输入输出文件名与演示数据。
Maintenance（双交付物一致性）
每次模板（Excel）迭代后，若涉及版本修复 / 缺陷清单变化，必须同步 Word（用 append_v3_word.py 模式或重建），并在两处均标注同一版本号（当前 v3）。Excel「说明」页清单与 Word 第八章逐条对应。
