docs: 归档历史文档 + 新增战略外脑实施方法论

- 归档根目录散落文档到 docs/20260812/ 和 docs/20260812-1/
- 新增 16-战略外脑实施方法论.md：七项能力、十二步工作法、AI与决策治理、成熟度和验收
- 新增 17-SBrainCO战略外脑建设对照表.md：方法论映射为领域模型、产品模块、API和分阶段待办
- 新增 调查表/战略外脑能力验收Checklist.csv：35项能力验收检查项
- 更新 01-总体框架与八步工作法.md：新增战略外脑扩展章节
- 更新 README.md：新增战略外脑体系导航

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs/20260812/2026年4月与5月数据导入文件差异说明.md

@@ -0,0 +1,346 @@
+# 2026年4月与5月数据导入文件差异说明
+
+> 生成日期：2026-08-01
+> 数据源目录：`/Users/freedak/Documents/AIDashboard/西部马华数据分析/`
+> 对比口径：4月 `[2026-04-01, 2026-05-01)`；5月 `[2026-05-01, 2026-06-01)`
+
+---
+
+## 一、文件目录结构对比
+
+### 1.1 4月目录结构
+
+```
+4月/
+├── 营业费用分析.xls (54KB, 213列)
+├── 账单查询-菜品销售明细表/ (56个Excel + ZIP压缩包)
+├── 盘点倒挤成本报表2026年4月明细.xlsx (9.3MB, 35列)
+├── 菜品成本分析报表.xlsx (596KB)
+├── 全部门店-全部仓库-统计货品明细报表2026年4月1-15日.xlsx (51MB)
+├── 全部门店-全部仓库-统计货品明细报表2026年4月16-30日.xlsx (50MB)
+├── 中央厨房4月.rar
+├── 各店信息新.xls
+├── 91家门店5月工作计划.csv/xlsx
+└── [分析报告、SQL脚本等]
+```
+
+### 1.2 5月目录结构
+
+```
+5月/
+├── 2026年5月营业费用分析.xls (55KB, 213列)
+├── 2026年5月管理费用分析.xls (47KB, 213列) ← 新增
+├── 营业数据/
+│   ├── 2026年5月考勤数据表.xlsx (23KB)
+│   ├── 2026年5月菜品成本分析报表.xlsx (652KB)
+│   ├── 2026年5月薪资拆分明细表.xlsx (1.6MB, 98列)
+│   ├── 账单查询-菜品销售明细表/ (57个Excel) ← 多1个分片
+│   ├── 正餐事业部_全渠道订单明细.xlsx (3.7MB) ← 新增
+│   └── 正餐事业部_品项销售明细.xlsx (24MB) ← 新增
+├── 供应链数据/
+│   ├── 2026-05-01--2026-05-31 23_59_59采购货品明细.xlsx (7.7MB)
+│   ├── 4.13盘点倒挤成本报表2026年5月.xlsx (9.6MB)
+│   ├── 全部门店-全部仓库-统计货品明细报表2026年5月1-15日.xlsx (51MB)
+│   ├── 全部门店-全部仓库-统计货品明细报表2026年5月16-31日.xlsx (55MB)
+│   └── 采购订货单导出-20260730.zip (244KB) ← 新增
+└── 中央厨房/
+    ├── 按货品导出-货品实际与理论耗用.xlsx (552KB)
+    ├── 按配方导出-货品实际与理论耗用.xlsx (1.1MB)
+    ├── 2026-05-01--2026-05-31 23 59 59完工入库统计分析报表.xlsx (386KB)
+    └── 加工单价分析报表.xlsx (53KB)
+```
+
+---
+
+## 二、数据文件详细对比
+
+> 行数说明：下文同时存在“工作表行数”和“数据库导入行数”。工作表行数通常包含标题或表头，不能直接与数据库有效记录数相减；文中已尽量标明口径。
+
+### 2.1 账单与菜品销售数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 分片数量 | 56个Excel | 57个Excel | +1个分片 |
+| 文件命名格式 | `账单查询-菜品销售明细表*.xlsx` | `账单查询-菜品销售明细表0730105605_*.xlsx` | 命名格式变化 |
+| 文件总大小 | ~490MB (ZIP) | ~523MB | +33MB |
+| 字段数 | 20列 | 20列 | 不变 |
+| 主要字段 | 门店、账单号、人数、开结账时间、菜品、销量、金额、实收金额 | 同4月 | 兼容 |
+
+**关键差异**：
+- 5月文件命名增加了时间戳后缀（0730105605），需调整导入脚本的文件名匹配规则
+- 5月20列文件可同时生成**基础账单事实**和**菜品销售事实**，足以支持营收、账单数、客单价、菜品、品类、业务类型和时段分析
+- 4月另有17个196列主账单文件，原始约1,677,990行；5月当前目录没有同等扩展字段。因此会员、支付方式、营销方案、收银员、账单状态、理论成本等分析不能仅凭5月20列文件完整复现
+- 5月正餐事业部两份报表仅覆盖9家门店，应作为补充核验数据，不得与57个全公司分片重复累计
+- 4月源文件包含少量3月及5月1日边界记录，所有月份必须按业务时间半开区间过滤，不能按文件名直接归月
+
+### 2.2 营业费用数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 文件 | `2026年4月营业费用分析.xls` | `2026年5月营业费用分析.xls` | 月份更新 |
+| 文件大小 | 54KB | 55KB | +1KB |
+| 行数 | 21行 | 18行 | -3行 |
+| 列数 | 213列 | 213列 | 不变 |
+| 费用科目数 | 19个 | 16个 | -3个 |
+| 合计金额 | 36,960,829.47元 | 48,775,884.64元 | +11,815,055.17元（科目范围变化，不宜直接解释为同口径费用增长） |
+
+#### 费用科目变化
+
+**4月独有科目（5个）**：
+| 科目编码 | 科目名称 | 可能原因 |
+|---|---|---|
+| 50301 | 刷卡手续费 | 可能合并到其他支付渠道科目 |
+| 50318 | 清洗费 | 可能改为其他费用项目 |
+| 50334 | 烟道清洗 | 可能改为其他费用项目 |
+| 50365 | 自送快递费 | 可能为临时性费用 |
+| 50383 | 外卖佣金 | 可能已包含在其他佣金科目 |
+
+**5月新增科目（2个）**：
+| 科目编码 | 科目名称 | 说明 |
+|---|---|---|
+| 11901 | 备用金 | 资产类科目出现在费用报表中，需确认 |
+| 50384 | 维修费手工报销 | 替代原50315维修费的补充报销 |
+
+**共同科目（14个）**：餐厅房租、水费、电费、燃气费、员工宿舍费用、暖气费、维修费、月薪员工工资、前厅/后厨员工工资、垃圾费、物业费、菜品提成、设备租赁费
+
+### 2.3 管理费用数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 文件 | 不存在 | `2026年5月管理费用分析.xls` | **新增文件** |
+| 文件大小 | — | 47KB | — |
+| 行数 | — | 16行 | — |
+| 列数 | — | 213列 | — |
+| 合计金额 | — | 5,754,540.18元 | — |
+
+**说明**：管理费用是5月新增的数据域，单独统计总部/管理层的费用，与门店营业费用是不同利润层级的数据。
+
+### 2.4 库存倒挤成本数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 文件 | `4.13盘点倒挤成本报表2026年4月明细.xlsx` | `4.13盘点倒挤成本报表2026年5月.xlsx` | 月份更新 |
+| 文件大小 | 9.3MB | 9.6MB | +0.3MB |
+| 行数 | 源行54,974行，正式导入54,973行 | 工作表56,538行 | 工作表规模约增加1,564行，需按同口径复核 |
+| 列数 | 35列 | 35列 | 结构基本一致 |
+
+### 2.5 菜品成本/BOM数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 文件 | `菜品成本分析报表.xlsx` | `2026年5月菜品成本分析报表.xlsx` | 月份更新 |
+| 文件大小 | 596KB | 652KB | +56KB |
+| 行数 | 工作簿数据区3,749行；解析出788条菜品汇总、3,568条原料明细 | 工作表4,146行（含标题/表头） | 工作表规模约增加397行 |
+| 列数 | 24列 | 24列 | 结构一致 |
+
+**期间风险**：4月菜品成本导入记录中的期间字段为空。5月导入时必须明确写入 `report_period_start`、`report_period_end`，后续视图不得继续仅以 `max(import_id)` 判断“最新月份”。
+
+### 2.6 薪资数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 文件 | 4月脱敏薪资明细 | `2026年5月薪资拆分明细表_北京西部马华餐饮有限公司.xlsx` | 月份更新、文件名变化 |
+| 文件大小 | 待确认 | 1.6MB | — |
+| 行数 | 3,596行 | 3,529行 | -67行 |
+| 列数 | 99列（8级组织） | 98列（3级成本中心） | **列数减少但组织层级变化** |
+| 新增字段 | — | 姓名、身份证等 | 需脱敏处理 |
+
+**关键差异**：
+- 5月组织层级从8级压缩为3级成本中心
+- 列位置发生变化，现有导入脚本按固定列号读取会错位
+- 新增姓名、身份证等敏感字段，导入时需受限存储
+
+### 2.7 考勤数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 文件 | 4月脱敏考勤明细 | `2026年5月考勤数据表.xlsx` | 月份更新、文件名变化 |
+| 行数 | 3,556行 | 10行 | **严重缺失** |
+| 列数 | 当前脚本假定33列：工号、岗位、部门及1—30日 | 工作表35列：工号、姓名、岗位、所在部门及1—31日 | 新增姓名列且多31日，固定列号脚本会错位 |
+| 覆盖范围 | 全部门店员工 | 仅总部少量人员 | **仅10名总部人员** |
+
+**阻断说明**：5月考勤数据严重不完整（仅10条 vs 4月3556条），不能用于门店排班和人效分析。
+
+### 2.8 配送/供应链数据
+
+| 指标 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 配送明细1-15日 | 工作表165,245行；导入165,244行 | 工作表165,272行 | 基本持平 |
+| 配送明细16-30/31日 | 工作表160,679行；导入160,678行 | 工作表178,949行 | 5月下半月多1天 |
+| 配送工作表合计 | 325,924行 | 344,221行 | +18,297行，约+5.61% |
+| 采购货品明细 | 不存在 | 7.7MB（30,555行×63列） | **新增** |
+| 采购订货单 | 不存在 | 244KB ZIP（71个.xls） | **新增，含跨月文件** |
+
+### 2.9 中央厨房数据
+
+| 数据域 | 4月 | 5月 | 变化说明 |
+|---|---|---|---|
+| 按货品实际与理论耗用 | 工作簿3,332行；导入3,329行 | 工作表3,396行×33列 | 小幅增加，结构兼容 |
+| 按配方实际与理论耗用 | 工作簿4,844行；导入4,842行 | 工作表4,948行×42列 | 小幅增加，结构兼容 |
+| 完工入库统计 | 工作簿1,721行；导入1,708行 | 工作表1,784行×43列 | 小幅增加，结构兼容 |
+| 加工单价 | 工作簿170行；导入157行 | 工作表179行×37列 | 小幅增加，结构兼容 |
+
+---
+
+## 三、文件格式兼容性总结
+
+| 数据域 | 4月→5月兼容性 | 主要差异 | 风险等级 |
+|---|---|---|---|
+| 账单菜品明细 | 高 | 文件命名格式变化 | 低 |
+| 营业费用 | 中 | 科目集合变化、合计行位置变化 | 中 |
+| 管理费用 | 新增 | 无4月对照 | 中 |
+| 库存倒挤成本 | 高 | 月份更新，结构基本不变 | 低 |
+| 菜品成本/BOM | 高 | 月份更新，结构一致 | 低 |
+| 薪资 | 低 | 列位置变化、组织层级变化、新增敏感字段 | **高** |
+| 考勤 | 阻断 | 仅10条记录（vs 4月3556条） | **P0** |
+| 配送/采购 | 中高 | 采购数据新增，结构需验证 | 中 |
+| 中央厨房 | 高 | 月份更新，结构兼容 | 低 |
+| 正餐事业部补充 | 新增 | 独立数据域 | 低 |
+
+### 3.1 按处理方式分类
+
+- **规则基本可复用**：20列账单菜品明细、库存倒挤成本、菜品成本/BOM、中央厨房、配送。复用的前提是增加月份区间、源文件哈希、批次号和重复导入控制。
+- **必须调整后再导入**：营业费用、薪资、考勤、采购订货单。主要原因分别是科目行变化、表头位置变化、数据缺失及ZIP跨月。
+- **5月新增数据域**：管理费用、采购货品明细、采购订货单、正餐事业部补充报表。新增数据不得未经口径确认就并入原有事实表。
+- **5月当前缺少的完整能力**：与4月196列主账单相对应的会员、支付、营销、收银、账单状态和理论成本等扩展字段。
+
+---
+
+## 四、导入前需确认事项
+
+### 4.1 P0级阻断（必须解决）
+
+1. **考勤数据严重缺失**：5月仅10条记录，需补充完整门店考勤才能发布排班和人效模块
+
+### 4.2 P1级风险（需调整导入规则）
+
+1. **营业费用科目白名单**：需建立5月费用科目白名单，确认4月独有科目（刷卡手续费、清洗费等）的去向
+2. **薪资脚本改造**：5月列位置和组织层级变化，必须改为表头映射方式，不能按固定列号读取
+3. **管理费用独立域**：5月新增管理费用，需确认是否用于总部损益桥及分摊规则
+4. **采购订货单跨月**：ZIP包含4月和6月文件，需按业务日期筛选
+
+### 4.3 P2级优化（建议）
+
+1. **账单分片命名**：5月文件命名增加时间戳后缀，需更新导入脚本的文件名匹配规则
+2. **薪资敏感字段**：5月新增姓名、身份证等字段，导入时需受限存储或脱敏
+3. **正餐事业部报表去重**：两份补充表仅覆盖9家门店，只能独立核验，不可与全公司账单明细相加
+4. **采购事实落表**：采购货品明细可填充当前为空的采购入库事实，但应先确认单据状态、数量、含税金额和退货冲销口径
+
+---
+
+## 五、文件就绪度评估
+
+| 等级 | 数据域 | 说明 |
+|---|---|---|
+| 绿色 | 账单菜品明细、库存成本、菜品成本、中央厨房、配送 | 可进入预检 |
+| 黄色 | 营业费用、管理费用、薪资、采购订货单、正餐事业部补充报表 | 需调整规则或确认范围 |
+| **红色** | **完整考勤** | **严重不完整，阻断排班和人效模块** |
+
+---
+
+## 六、差异文件清单
+
+### 6.1 5月新增文件
+
+- `2026年5月管理费用分析.xls` (47KB)
+- `营业数据/正餐事业部_全渠道订单明细_20260730_1112_1785381233074.xlsx` (3.7MB)
+- `营业数据/正餐事业部_品项销售明细_20260730_1128_1785382191936.xlsx` (24MB)
+- `供应链数据/2026-05-01--2026-05-31 23_59_59采购货品明细.xlsx` (7.7MB)
+- `供应链数据/采购订货单导出-20260730.zip` (244KB)
+
+### 6.2 5月缺失/变化文件
+
+| 4月文件 | 5月对应文件 | 变化 |
+|---|---|---|
+| `账单查询-菜品销售明细表.zip` (490MB) | `账单查询-菜品销售明细表/` (57个Excel, 523MB) | ZIP改为文件夹，增加1个分片 |
+| `菜品成本分析报表.xlsx` | `2026年5月菜品成本分析报表.xlsx` | 月份更新 |
+| `4.13盘点倒挤成本报表2026年4月明细.xlsx` | `4.13盘点倒挤成本报表2026年5月.xlsx` | 月份更新 |
+| `中央厨房4月.rar` | `中央厨房/` (4个Excel) | RAR改为文件夹，结构整理 |
+
+### 6.3 5月需特别关注的文件
+
+| 文件 | 关注原因 |
+|---|---|
+| `2026年5月考勤数据表.xlsx` | 仅10条记录，严重不完整 |
+| `2026年5月薪资拆分明细表.xlsx` | 组织层级变化，列位置变化 |
+| `2026年5月营业费用分析.xls` | 科目集合变化，合计行位置变化 |
+| `采购订货单导出-20260730.zip` | 含跨月文件，需按业务日期筛选 |
+
+---
+
+## 七、建议的5月导入文件清单
+
+按优先级排序的推荐导入顺序：
+
+1. **账单菜品明细**（57个Excel）- 基础营收数据，一次解析生成账单和菜品事实
+2. **库存倒挤成本** - 成本核算基础
+3. **菜品成本/BOM** - 成本分析
+4. **配送货品明细**（上下半月）- 供应链数据
+5. **采购货品明细** - 采购事实（新增）
+6. **中央厨房**（4个文件）- 加工成本
+7. **营业费用** - 费用分析（需调整导入规则）
+8. **管理费用** - 总部费用（新增，需确认用途）
+9. **正餐事业部补充报表** - 补充数据域（独立使用）
+10. **薪资** - 人事成本（需改造导入脚本）
+11. **考勤** - **暂不导入，等待完整数据**
+
+---
+
+## 八、4月与5月文件映射及处理结论
+
+| 数据域 | 4月来源 | 5月来源 | 5月处理结论 |
+|---|---|---|---|
+| 完整主账单 | 17个196列主账单分片 | 当前未提供同等文件 | 不发布会员、支付、营销等完整分析 |
+| 基础账单/菜品销售 | 56个20列明细分片 | 57个20列明细分片 | 可复用解析，按5月业务时间过滤并去重 |
+| 库存倒挤成本 | 4月盘点倒挤文件 | 5月盘点倒挤文件 | 35列一致，可进入预检 |
+| 菜品成本/BOM | 4月菜品成本文件 | 5月菜品成本文件 | 24列一致，必须补齐报告期间 |
+| 营业费用 | 4月营业费用分析 | 5月营业费用分析 | 按科目编码识别，不得依赖固定行号 |
+| 管理费用 | 无独立同类输入 | 5月管理费用分析 | 建立独立管理费用域，先确认分摊规则 |
+| 薪资 | 4月薪资明细 | 5月薪资拆分明细 | 暂停直接复用脚本，改为表头映射后再导入 |
+| 考勤 | 4月全量考勤 | 5月仅10条人员记录 | 阻断全公司排班、人效分析，等待补数 |
+| 配送 | 1—15日、16—30日 | 1—15日、16—31日 | 76列一致，校验31日及上下半月边界 |
+| 中央厨房 | 4类报表 | 对应4类报表 | 结构基本一致，可进入预检 |
+| 采购货品 | 无同类月度输入 | 5月采购货品明细 | 新增采购事实，独立验收 |
+| 采购订货单 | 无同类月度输入 | ZIP内71个XLS | 解包后按业务日期过滤，不能整包归入5月 |
+| 正餐事业部补充 | 无同类月度输入 | 订单明细、品项销售明细 | 仅9店补充核验，禁止重复汇总 |
+
+---
+
+## 九、对5月发布范围的影响
+
+### 9.1 可以发布的基础经营分析
+
+- 营收、账单数、客单价、就餐人数
+- 菜品销量、销售额、品类结构、业务类型与时段表现
+- 库存倒挤成本、菜品BOM、配送和中央厨房基础分析
+- 经科目确认后的营业费用分析
+
+### 9.2 应限制或暂缓的分析
+
+- **会员、支付、营销、收银、账单状态、理论成本**：缺少与4月196列主账单同等的5月扩展字段
+- **全公司排班、人效、工时效率**：5月考勤仅10条，样本严重不足
+- **薪资与人工成本正式发布**：在按表头重做字段映射并完成敏感信息控制前暂缓
+- **总部费用分摊后利润**：管理费用是新数据域，分摊口径未确认前只展示原始总额，不下钻到门店利润
+- **采购订货趋势**：ZIP存在4月、5月和6月业务日期，完成逐单过滤前不得形成5月结论
+
+---
+
+## 十、5月导入前检查清单
+
+- [ ] 为所有文件登记源路径、文件大小、修改时间、SHA-256、数据域、业务期间和导入批次
+- [ ] 业务时间统一使用 `[2026-05-01 00:00:00, 2026-06-01 00:00:00)`，剔除跨月边界记录
+- [ ] 57个账单菜品分片完成表头一致性、空文件、重复账单号与重复明细检查
+- [ ] 账单汇总与菜品明细按门店、日期核对实收金额，但允许按取消、赠送、退菜等业务规则形成可解释差异
+- [ ] 营业费用按科目编码解析，并由财务确认新增、缺失科目及合计范围
+- [ ] 管理费用单独入域，确认是否及如何分摊至门店
+- [ ] 库存倒挤成本、菜品成本、中央厨房和配送完成列数、必填字段、金额平衡与环比异常检查
+- [ ] 配送上下半月确认无日期重叠、无缺日，并覆盖5月31日
+- [ ] 薪资改为按表头映射；姓名、身份证等敏感字段不进入普通分析层和日志
+- [ ] 收到完整考勤前，不刷新全公司人效相关物化结果
+- [ ] 采购订货单逐个成员文件解析业务日期，排除4月和6月单据，并登记成员哈希
+- [ ] 正餐事业部补充表使用独立来源标签，禁止与全公司账单重复累计
+- [ ] 所有预检通过后再刷新对应月份物化结果；失败时保留4月已发布版本
+
+---
+
+*本说明仅描述文件与数据口径差异，不包含代码修改、数据库导入或物化视图刷新。*