# 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月已发布版本

---

*本说明仅描述文件与数据口径差异，不包含代码修改、数据库导入或物化视图刷新。*
