| | |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | > **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。 |
|---|
| | | |
|---|
| | | ### 10-12（3）：修「9 月产物丢 8 月列 / 累计漏月」——扩列改为**以当期产物为底**【待验收】 |
|---|
| | | |
|---|
| | | - **现象（用户报告）**：生成的 9 月汇总大表里 **8 月列全空**，累计漏掉 8 月（规上货运量累计显示 31309.58，正确应为 1-7月 27734.46 + 8月 3665.36 + 9月 3575.12 = **34974.95**）。 |
|---|
| | | - **根因（逐层证实）**：① 母版**不带"当期列"的值与公式**——`fillFreightSheet` 明确"只回填目标期当月，1..目标月-1 以母版为准"，全省行公式由生成时按当期补；② 8 月的数据只落在**8 月产物**里、未回写母版；③ 9 月母版是**从 8 月母版扩列**来的 → 继承"8 月列空" → 生成时又只补 9 月 → 8 月永久空缺、累计 `=C+E+…+Q(空)+S` 漏月。 |
|---|
| | | - **修复**：扩列器**优先以「当期产物」为底**（产物含当期列的值与公式）——取该期**最新产物**（导出落盘缓存 `_cache/summaryWorkbook_<period>_month__v*.xlsx`，多根目录定位），取不到才回退母版并打 WARN；另修体检规则误报（②全口径缺失时不再报"规下为负"，改报"缺②全口径 → 规下无法计算"，否则 9 月只有规上时会对每个市州刷屏）。 |
|---|
| | | - **关键实现点**：产物缓存定位必须用 3 候选根目录（`summaryTemplateDir` → `user.dir/…` → `user.dir/../…`）——首版用单相对路径，因 `spring-boot:run` 的工作目录是**模块目录**而找不到，静默回退到了母版（表现为"改了但还是空"）。 |
|---|
| | | - **验证**：`docs/生成汇总大表/输出/_扩列_2026年9月_待确认_v3.xlsx`（日志确认 base=**产物** `summaryWorkbook_2026-08_month__v37…xlsx`）： |
|---|
| | | - 8 月列有值：货运 全口径 **16888.7615** / 规上 **3665.3638** / 规下 **13223.3977**；公交全省 **12315.37**； |
|---|
| | | - 累计公式 **含 8 月与 9 月**：`=C5+E5+…+Q5+S5`；累计同比分母 `SUM(X5,Z5,…,AL5,AN5)`（2025-01~09）； |
|---|
| | | - 9 月列留空（无 9 月源数据）；7 个标题页标题 **1-9月 / 9月** 正确。 |
|---|
| | | - **口径结论（写进设计）**：**新母版一律从"当期产物"派生**（产物带当期数据与公式），不再从旧母版派生——否则每月都会丢"当期列"，累计逐月漏数。 |
|---|
| | | - **遗留**：① 待用户确认是否把 v3 落盘为正式 9 月母版（会先备份手工版）；② 扩列产物中被重写的公式暂无缓存值（只写公式 + `fullCalcOnLoad`，Excel/WPS 打开自动算）——建议补"整本重算写缓存"；③ `中口径明细` 表头行识别返回 `[2,4]`，需核查。 |
|---|
| | | - **报告（本地、不入库）**：`docs/功能测试报告/功能测试报告_扩列以当期产物为底_2026-10-12.md`。状态：**【待验收】**。 |
|---|
| | | ## 最新（2026-10-12，zyj 线） |
|---|
| | | |
|---|
| | | ### 10-12：扩列器补「标题按母版期次重写」+ 修正 8 月母版标题【待验收】 |
|---|
| | |
|---|
| | | - **报告（本地、不入库）**：`docs/功能测试报告/功能测试报告_汇总大表扩列器标题修正_2026-10-12.md`；日结 `docs/工作日结/工作日结_2026-10-12.md`。 |
|---|
| | | - **待用户验收/确认**：① 标题口径按"**标题期次=母版期次**"（8月→1-8月/8月、9月→1-9月/9月）是否正确；② `_扩列_2026年9月_待确认_v2.xlsx` 是否改名为正式名（原名那份是旧内容、被 WPS 存过，未经同意不动）；③ 累计/累计同比"是否扩到 9 月"（产出=已扩、手工版未扩）。 |
|---|
| | | - **状态**：**【待验收】**。 |
|---|
| | | ### 10-12（2）：货运口径「导出前基数体检」（B4）6 条规则落地【待验收】 |
|---|
| | | |
|---|
| | | - **背景**：规下 = ②《货运量周转量表》全口径 − ①H203-2 规上÷10000，是**倒减**——①漏报会让规下虚高、极端还会算出负数。用户 2026-10-12 同意把这组规则加进 B4。 |
|---|
| | | - **实现**：新增 `reportexport/calc/FreightReadinessCheck.java`（只读）；接入 `exportSummaryWorkbook` 的缺数收集 `dbProblems`（随导出日志输出）；新增只读接口 `GET /api/report/summaryWorkbook/freightCheck?period=YYYY-MM`。 |
|---|
| | | - **规则**：① 某市州规下为负；② ②有全口径、①无规上记录（疑漏报→规下=全口径）；③ ②全口径 < ①规上；④ Σ17 市州 ≠ ②"湖北省"行（容差 0.01）；⑤ **本月与上月完全相同**（疑重复导入，两侧 ≥50 万吨/万吨公里）；⑥ **同比异常**（|去年同月→本月| > 50%，两侧 ≥50）；⑥' 累计勾稽（①周转量 1..M 求和 ÷10000 vs ③拆分表 CUMULATIVE）。 |
|---|
| | | - **阈值修正（实测驱动，重要）**：首版用"规下环比 > 30%" → 2026-02 命中 22 条、2026-03 命中 32 条，复核确认**全是春节季节性**（各市州 2 月 −30~−40%、3 月 +30~+60%），非数据错误 → 改为"重复导入特征 + 同比>50%"；并给判据加**绝对门槛 50 万吨/万吨公里**，避免神农架林区（20~46 万吨）这类小基数噪声长期报警。 |
|---|
| | | - **实测**：2026-01~08 **全期 0 命中**（无误报）；②表 `last_freight_m08`/`last_turnover_m08` **18/18 行有值** → 同比规则确实参与计算（非空跑）。 |
|---|
| | | - **报告（本地、不入库）**：`docs/功能测试报告/功能测试报告_货运基数体检B4六条规则_2026-10-12.md`；日结同日两条。 |
|---|
| | | - **待用户验收/确认**：① 阈值（绝对门槛 50、同比 50%）是否合适；② 是否现在做 B4 剩余部分——导出前弹窗 + 生成件《数据缺失清单》页（P0-3 剩余）。 |
|---|
| | | - **状态**：**【待验收】**。只读功能，未改动业务数据。 |
|---|
| | | ### 10-12（3）：生成数据「验证方法」成文（五段链条 + 反同源盲区） |
|---|
| | | |
|---|
| | | - **成文**：`docs/汇总大表生成数据验证方法_2026-10-12.md`（回答"如何验证程序生成的数据是否正确"）。 |
|---|
| | | - **口径**：把问题拆成 4 问（源数据 / 算法 / 版式 / 与定稿一致），每段配一个**独立于该段的参照**；链条五段 L0 源文件→库、L1 库→口径值、L2 口径值→单元格、L3 单元格→整本、L4 跨页合成页勾稽；**通过标准 L0~L4 已写死**（任一层未覆盖，结论不得写"已验证"）。 |
|---|
| | | - **对既有"四层验证法"（10-08/10-12 会话）的三处补强**：① 补 L0 源数据层与**反同源盲区**——"生成件 vs 定稿"在母版与定稿同源时查不出源数据问题（今日 2025-11 两处即例）；② **体检通过 ≠ 数据齐全**，异常清单与缺数清单分开输出（今日 2026-08 体检 0 命中，但 9 月件 8 月列仍空）；③ 必须专门做一次「库内值 vs 母版缓存」全量 diff（10-09 待办）——**出表口径不切库**与**验证必须比一次**并不矛盾。 |
|---|
| | | - **佐证**：2026-08 vs 9/13 定稿（1020 条 → 11 条关注，算法层通过）；库内 2025 vs 母版 2025（公交/出租/轨道轮渡 100% 一致，3 处需业务确认，报告见 `docs/功能测试报告/功能测试报告_库内2025与母版2025逐格核对_2026-10-12.md`）。 |
|---|
| | | - **状态**：文档类，无需验收。 |
|---|
| | | - **B4 关联（已核）**：10-12 上午的货运基数体检 B4 已由另一会话提交（`91f6583`，报告 `docs/功能测试报告/功能测试报告_货运基数体检B4六条规则_2026-10-12.md`）；本次 2026-08 核对实际调用了它的 `GET /api/report/summaryWorkbook/freightCheck`（2026-01~08 全期 0 命中）。 |
|---|
| | | ### 10-12（4）：汇总大表「缺数清单」落地（只读接口 + 接入导出日志）【待验收】 |
|---|
| | | |
|---|
| | | - **动因**：用户要求把「缺数」显式摆到台面上——当日两个真实问题（9 月生成件 8 月列为空、9 月周转量全 0）都属"该有的数没有"，而 `freightCheck` 体检当时 **0 命中**，两者必须分开。 |
|---|
| | | - **实现**：新增 `reportexport/calc/SummaryMissingDataCheck.java`（只读）；接口 `GET /api/report/summaryWorkbook/missing?period=YYYY-MM`；接入 `exportSummaryWorkbook` 的 `dbProblems`（随导出日志输出）。 |
|---|
| | | - **口径**：① 逐月回填页（班线包车/公交/出租/轨道轮渡）查 1..目标月 来源是否有数、17 市州是否齐全；② 货运/网约车只回填目标月，查目标月各项来源（货运①+②+③、网约车订单+全省 pin+出租平均运距）；③ 这两页的历史月由母版承担——**母版与同期备份母版（donor）都没有数**才算缺口（否则会误报 7 月那种"骨架母版 + donor 还原"）。 |
|---|
| | | - **实测**（独立 8099 实例，未打扰 8090，测完已关；`mvn -o compile` exit=0）：2026-08 **0 条**、2026-07 **0 条**、2026-09 **11 条**（班线包车/公交/轨道轮渡/出租 无源 4 条 + 货运②③ 2 条 + 网约车 3 条 + 母版 8 月列空 2 条）——命中的正是当日两个真实问题。 |
|---|
| | | - **修正**：首版只比母版 → 误报 2026-07 两条；已按生成链实现补上 donor 比对，复测 0 条。 |
|---|
| | | - **报告（本地、不入库）**：`docs/功能测试报告/功能测试报告_汇总大表缺数清单_2026-10-12.md`。 |
|---|
| | | - **待办**：导出前弹窗 + 生成件《数据缺失清单》页（与 B4 的 P0-3 合并）。 |
|---|
| | | - **状态**：**【待验收】**（只读功能；未落盘、未改业务数据）。 |
|---|
| | | ## 最新（2026-10-10，zyj 线） |
|---|
| | | |
|---|
| | | ### 10-10：Step 1 扩列器落地 + 8→9 月版式首轮产出【待验收】 |
|---|
