feat: add assessment workbench and September reconciliation

Preserve August hydrogen revision and September audit evidence; calculate interrupted vehicle history across all prior months. Record remaining carry-policy and layout-baseline discrepancies.
2026-10-09 18:21:45 +08:00
parent 3ed3548b9d
commit 65904c8270
108 changed files with 1368801 additions and 3 deletions
@@ -0,0 +1,89 @@
+# 项目背景与时间机器备份核对
+
+核对日期：2026-09-10。本文件记录本次读取备份、历史项目记忆和工作簿得到的事实，供后续继续核算时定位背景。
+
+## 备份来源与迁移状态
+
+- 本项目原工作目录为 `/Users/kkfluous/Downloads`，电脑重置后迁至当前仓库。
+- 8 月最新 Time Machine 存档为 `2026-08-25-132718.backup`。
+- 本次实际读取的原用户目录为：
+
+```text
+/Volumes/.timemachine/4F163928-1D0C-4E0E-B0DF-C3A7ECC330AF/2026-08-25-132718.backup/2026-08-25-132718.backup/Macintosh HD - Data/Users/kkfluous
+```
+
+- 本次核对时，当前仓库全部 144 个 Git 已跟踪文件，都能在备份 `Downloads` 的相同相对路径下找到，SHA-256 全部一致。
+- 这证明迁移后的这些文件与存档一致，不代表全部原始输入都已迁入仓库。
+- 本次未覆盖代码、工作簿或全局记忆，未运行核算或数据库查询。
+
+## 项目用途与架构
+
+车辆租赁考核源表经里程修正后，按销售经理计算当月、结转、历史补发和累计补发奖金，输出可追溯的 Excel 对账文件。
+
+- `calc_engine.py`：规则、源表读取、按车牌和销售分组、跨月状态及奖金计算。
+- `excel_writer.py`：明细、计算过程、车辆追踪、发放记录、汇总和个人对账页。
+- `main.py`：读取 1—7 月源数据，逐月重算历史，目前仅输出 7 月核算。
+- 多源里程脚本：汇总纯氢、TBOX、GPS 数据，识别测试日，再将确认后的核算里程回填源表。
+- 干预说明、离职明细和历史方案测算由独立脚本补充。
+
+## 最新已核实的 7 月结果
+
+截至本次找到的历史记忆，最新完成的是 2026-08-17 多源考核里程重算，目录为 `7月绩效重算_多源考核里程_20260817/`。
+
+| 项目 | 旧版 `7月核算结果/` | 8 月 17 日重算版 |
+| --- | ---: | ---: |
+| 考核源表记录数 | 396 | 396 |
+| 达标记录数 | 161 | 129 |
+| 最终发放金额 | 74,864.62 元 | 62,616.73 元 |
+
+减少 12,247.89 元，约 16.36%。记录数是考核区间记录数，不能直接称为车辆数。
+
+本次只读核对位置：
+
+- 旧版核算文件 `7月汇总!C83`（考核应发合计）、`B124`（最终发放）均为 74,864.62。
+- 新版核算文件 `7月汇总!C78`（考核应发合计）、`B119`（最终发放）均为 62,616.73。
+- 备份 `Downloads/7月考核车辆多源里程汇总_用户确认版.xlsx` 的 `7月考核车辆里程汇总` 页，有 396 条记录和 396 个唯一的车牌＋开始日期＋结束日期键。
+- 上述确认版与当前新版源表全部 396 条匹配，`核算里程(km)` 与 `实际行驶里程(km)` 全部一致（比较容差 0.005 km）。
+
+这是文件与历史记录核对，尚未重新运行奖金引擎，亦未独立审计每条奖金。
+
+## 规则演变与现行代码口径
+
+1. 每条记录独立达标，奖金按考核天数折算；累计与结转按车牌＋销售经理核算，换销售后分别计算。
+2. 结转占用当月奖励名额；累计整体达标后补发历史未发月份。
+3. Claude 早期六月流程曾记录 18T 的达标 800、未达标 300、结转 800、补发 500 方案。后续用户明确改为达标 1000、未达标 0、结转整月 1000、补发 1000 按天折算；当前引擎与后续记忆一致。旧方案仍保留为测算资料。
+4. 7 月四辆 18T（粤AGR0772、粤AGQ0178、粤AGP6675、粤AGP9757）使用 5000 km、150 元政策，其余 18T 当前仍为 6000 km、1000 元。
+5. 本次 7 月重算不做亏损拦截。旧 `project_rules.md` 的亏损拦截描述是历史口径，不能直接覆盖当前主流程。
+6. 离职人员仅当月奖金转给接任销售，其他结转和补发不发；转接主要体现在汇总层，原归属明细保留用于审计。7 月钱婧单独全部不发，不能把六月保留钱婧明细的旧讨论直接套用到七月。
+7. 普通车辆取考核区间纯氢里程；测试候选车辆逐日比较 TBOX 与 GPS，差值大于 50 km 的日期判为测试日，剔除当日纯氢里程。
+8. 无纯氢数据时的补充口径是普通车辆取 TBOX，测试候选车辆取 GPS。历史说明强调无纯氢数据的 4.5T 普货场景；当前日规则代码的回退分支没有显式车型限制。未来若改此处，应区分文字场景与实际分支范围。
+
+## 恢复后可定位的补充输入
+
+以下均已在上述备份的 Downloads 中确认存在，但本次没有复制到仓库：
+
+- `7月考核车辆多源里程汇总_用户确认版.xlsx`：已验证与重算源表一致。
+- `广州新能源平台_纯氢纯电里程_2026年7月_按日.zip`：压缩包存在，本次未展开验证完整性。
+- `里程统计[天][2026-07-01至2026-07-31].xlsx`。
+- `智能管车_车辆里程日报-140106360.xlsx`。
+- `gps里程汇总2026年1-6月 3/`。
+
+脚本引用的 `车辆里程查询_20260701-20260731_1024辆.xlsx` 和第二份 `里程统计[天][2026-07-01至2026-07-31] (1).xlsx` 未在该存档 Downloads 的预期位置找到。尚未检索其他存档或微信附件目录，不能据此判断文件已经彻底丢失。
+
+## 记忆与会话来源索引
+
+以下路径相对于上面的备份原用户目录：
+
+- `.claude/projects/-Users-kkfluous-Downloads/memory/`：原始项目架构、规则、输出偏好、关键车辆及六月流程；其中部分条目早于后续规则调整。
+- `.codex/memories/MEMORY.md`：车辆绩效核算相关任务组，包含新版结果、历史去重、离职处理和用户偏好。
+- `.codex/memories/rollout_summaries/2026-07-16T08-28-44-2IEz-july_performance_recalculation_person_level_difference.md`：更新时间为 2026-08-17，记录此次重算和逐人差额。文件名中的 7 月日期不是最终更新时间。
+- `.codex/memories/rollout_summaries/2026-07-16T08-28-43-155y-june_18t_recalc_gps_pipeline_refresh.md`：记录改回 1000/0 方案，以及仅当月转接的用户明确要求。
+- `.codex/sessions/2026/07/16/rollout-2026-07-16T16-28-44-019f6a0a-dae0-79e3-a775-3bfe1288bdc3.jsonl`：本次读取了末段用户消息，确认纯氢考核、无纯氢回退、按确认表重算及逐人对比的请求。
+
+## 后续工作的注意事项
+
+- 默认入口仍指向旧 `7月核算结果/`；要复现新版必须选择新版源表及独立输出目录，不能仅直接运行默认入口。
+- 原路径 `/Users/kkfluous/Downloads` 需要做可移植配置后才能在当前环境运行。
+- 每次更新里程后应同步生成相关派生文件，避免核算表、干预说明与离职明细混用版本。
+- 汇报重算变化应列出每位销售原金额、新金额和差额，并核对差额合计；车辆计数用“辆”，考核记录用“条”。
+- 本次没有修复上一轮代码阅读发现的潜在问题，例如 12 期上限是否在引擎中实际限制；这些仍需专项验证。