---
name: 项目架构和文件结构
description: 代码架构、输入输出文件、Excel sheet结构
type: project
---

## 代码架构（V3.2.0）
- `calc_engine.py` - 计算引擎：规则/读取/分组/结转/补发/累计/亏损读取
- `excel_writer.py` - Excel输出：所有sheet生成函数
- `main.py` - 入口：按月循环生成独立Excel文件
- `generate_q1_summary.py` - 旧版单文件脚本（已被拆分，保留）

## 输入文件
- `租赁任务考核_2026年{1,2,3}月.xlsx` - 月度考核源数据
- `{1,2}月.xlsx` - 客户盈亏表（3月待补充）
- `里程任务考核_Q1汇总.xlsx` - 全量492辆车辆台账来源

## 输出文件
每月一个独立Excel（18 sheets）：
1. 考核奖励规则
2. 里程明细X月
3. X月计算过程
4. 车辆考核追踪（全量492辆，多人拆行+合并单元格+交替色）
5. X月奖金发放记录（逐条明细+亏损筛选）
6. X月汇总（从发放记录生成：考核应发→亏损筛选→最终发放）
7-18. 业务员sheets × 12（对账单风格+发放说明）

## 数据流
```
源数据 → 里程明细(逐条达标) → 计算过程(分组+判断链)
→ 车辆考核追踪(考核维度) → 奖金发放记录(+亏损筛选)
→ 月汇总(从发放记录SUM) → 业务员sheets
```

**Why:** 从单文件重构为模块化，支持按月独立核算和多维度展示。

**How to apply:** 新功能加在对应模块中。计算逻辑改calc_engine，展示改excel_writer，流程改main。