| | |
|---|
| | | - **遗留的是口径问题，不是缺数据**：中口径排名/明细的 2025 列仍以母版静态定稿值为准（`readMidDetailLastYearCumulative`，`ReportExportService.java:2745` 起），注释（2686-2689 行）说明原因是"排名页原先查库现算，两者在 2025-03/04 网约车拆分上不同"。→ 需先做「库内 2025 vs 母版 2025」逐项 diff，交业务确认基准后再决定是否切换读库（切换必须过 diff=0 回归）。 |
|---|
| | | - **规格更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` 新增第十二节（三层职责 / 一表一粒度 / 调整值覆盖层 / 2025 实测核验 / 结果层可选 / 「母版不留数据」红线 / 与 M0 的依赖顺序）。 |
|---|
| | | - **状态**：本节与规格第十二节均为【待验收】；未改动代码、未导入数据。 |
|---|
| | | |
|---|
| | | ### 10-09（2）：查证既有拍板——同比基准以母版缓存为准；扩列按月按需 |
|---|
| | | |
|---|
| | | - **同比基准（用户指出，已查证；先前判断修正）**：2026 与 2025 的同比**以母版缓存为准**，库只做校验、不直接替代。出处：`docs/要求与验收基线清单.md` F8（✅ 口径确认）、`docs/确认回执汇总与剩余疑问_汇总大表数据驱动改造_2026-09-07.md` Q1、`docs/汇总大表数据驱动改造方案_2026-09-07.md` 第九节、`docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md` A1、`docs/问题汇总/汇总大表问题交接_2026-09-21.md` 方案 A（已实施）。切换唯一前提 = 人工核对并重导一致。 |
|---|
| | | - **修正**：本日上一条"中口径 2025 遗留口径待定"的说法作废；库内 2025 现算值不得直接替代母版静态定稿值。 |
|---|
| | | - **扩列方式（既有拍板，与 M0 规格冲突）**：`docs/要求与验收基线清单.md` F10 = **按月按需扩列，不预做 12 月满版**（✅ M0 v4）；改造方案 v1.1（09-08 用户拍板）同口径，正文"12 月满版列版式"建议已作废。M0 规格第九/十一节的"满版式"建议**待用户裁定**。 |
|---|
| | | - **已有 09-29 扩列产物（本地未入库）**：`docs/问题汇总/_扩列规格表_2026-09-29.md/.csv`（19 页逐页规格）、`_扩列配置初稿_20260929.md/.csv`、`_扩列计划_v3..v10.json`、`_扩列进度_20260929.md`；试做件 `docs/生成汇总大表/2026年9月道路运输量汇总表_试做_20260929.xlsx`（数值未修完，勿用于出表）。 |
|---|
| | | - **规格更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` 新增第十三节（既有拍板核验，优先级最高）；并修正 12.4 的处置结论。 |
|---|
| | | - **状态**：【待验收】；未改动代码、未导入数据。 |
|---|
| | | |
|---|
| | | ### 10-09（3）：已确认口径全量核验 + 09-29 扩列规格转正入库 + M0 规格改写 |
|---|
| | | |
|---|
| | | - **口径核验范围**：`docs/要求与验收基线清单.md`、`docs/确认回执汇总与剩余疑问_汇总大表数据驱动改造_2026-09-07.md`（唯一决策基线）、`docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md`、`docs/问题汇总/汇总大表问题交接_2026-09-21.md`、`docs/问题汇总/中口径排名同比与城市客运列错位_根因与长效方案_2026-09-18.md`、`docs/问题汇总/数据查看汇总与汇总大表口径对应关系_2026-09-23.md`。 |
|---|
| | | - **关键已确认项**：F1（全精度存储+显示两位小数）、F8（母版缓存优先作同比基准，库仅校验）、F10（扩列按月按需、不预做 12 月满版、新增列为两行纵向合并标题）、A1（只覆盖 2026 动态块，2025 及以前不重算）、A3（备份还原验证通过前保留）、A4（母版只当版式模板）、D1-D5（D3 每年新开一本、2026 只到 12 月）、E1-E3、C1-C7（C5 中口径排名/分析只由中口径客运量页生成、C6 周转量系数固定、C7 城市汇总口径）、C3（累计同比分母按表头定位"去年 M 月"列）、C4（版式对齐按表头文字匹配列）、确认回执六.4/六.5（两行合并标题、母版文本数字归一）。 |
|---|
| | | - **撤回三处此前误述**：① "12 月满版式"（与 F10 / 六.1 冲突）；② "历史参照值入库、同比切库值"（与 F8 / Q1 冲突）；③ "停用 `_备份_` donor 还原"（与 A3 冲突，须验证通过后再做）。 |
|---|
| | | - **规格转正入库（2026-10-09）**：`docs/汇总大表母版扩列规格_2026-09-29.md` / `.csv`（19 页逐页规格）、`docs/汇总大表母版扩列配置初稿_2026-09-29.md`（逐页列位配置 + 硬前提）。原文件在 `docs/问题汇总/_*`（被 `.gitignore:118` 挡住、仅本机），本次按正式文件名入库，原 `_` 文件保留本地。 |
|---|
| | | - **新增关键硬前提**（来自配置初稿第五节）：`SM_CUR_COL0=2`（2026年1月=C）与 `SM_LAST_COL0=21`（2025年1月=V）是**写死的列位置**，插列后四张跨页合成页会读错 2025 基数 → **扩列前必须先改成按表头动态定位**。 |
|---|
| | | - **M0 规格改写**：第九/十一节"满版式"表述就地作废；新增第十四节《最终执行口径》（6 条动作 + 逐格 diff 验收 + 未决项）。 |
|---|
| | | - **未决**：扩列走"程序自动"（09-21 §5.3 方案 A）还是"本机 Excel 小工具"（方案 B）——09-21 交接 §11.2 未记录结论，09-29 产物为"程序生成计划 + 人工确认"混合路线，待用户确认。 |
|---|
| | | - **状态**：【待验收】；未改动代码、未导入数据。 |
|---|
| | | |
|---|
| | | ### 10-09（4）：扩列口径拍板——程序扩列、范围 8 页、4 个隐藏页保留隐藏 |
|---|
| | | |
|---|
| | | - **用户拍板（2026-10-09）**：① 扩列方式 = **程序扩列**（扩列器）；② 扩列范围 = **8 个可见台账页**（` 货运`、`班线包车`、`城市客运`、`公交`、`出租`、`网约车`、`轨道、轮渡`、`中口径明细`）；③ **4 个隐藏页保留并继续隐藏、不纳入数据加工**（`公路总客运`、`2025年城市客运量`、`中口径客运量`、`中口径计算过程`），不插列、不改公式。 |
|---|
| | | - **母版构成实测（openpyxl + xl/workbook.xml）**：**15 个可见页签 + 4 个隐藏页签**，隐藏状态为 `state="hidden"`（非 veryHidden，右键标签可取消隐藏）。`公路总客运` 40×274、`中口径客运量` 189×68、`中口径计算过程` 217×11、`2025年城市客运量` 16×13。 |
|---|
| | | - **消解两处矛盾**：09-29《扩列规格表》把 `中口径客运量`（页签 18）标为 A 类、且 09-29 进度里已插列的 8 页没有它；《配置初稿》又把它标成"无 2026 月份对"。按本次拍板统一为**不加工**；两份文档已就地追加《口径补充（2026-10-09）》。 |
|---|
| | | - **字母陷阱记档（避免再混）**：09-21 交接 §5.3「方案 A＝程序自动扩列 / 方案 B＝Excel 小工具」，与 09-28/09-29 工作日结「方案 A＝人工做母版 / 方案 B＝扩列器」**字母相反**。后续统一写"**扩列器（程序）**"，不再用 A/B 字母。 |
|---|
| | | - **易混淆点记档**：`中口径明细` 页的 A1 标题本身就写作"中口径客运量"，与隐藏页签 `中口径客运量` 同名——文档与口头沟通务必带页签位置（第 13 位 vs 第 18 位）。 |
|---|
| | | - **仍待确认（仅一项）**：扩列产物是自动落盘为下期母版，还是每次人工确认后再落盘（建议后者，与 A3/A4 一致）。 |
|---|
| | | - **文档更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` 第十四节已定项替换"未决项"；规格表与配置初稿各追加口径补充。 |
|---|
| | | - **状态**：【待验收】；未改动代码、未导入数据。 |
|---|
| | | |
|---|
| | | ### 10-09（5）：Step 0 落地——四张跨页合成页取数改为**按表头动态定位**月份列【待验收】 |
|---|
| | | |
|---|
| | | - **改动**：`ReportExportService` 中 `SM_CUR_COL0 = 2`（2026年1月=C）/ `SM_LAST_COL0 = 21`（2025年1月=V）**废弃**，改由新增的 `smMonthCols(sheet, year)` + `smYearMonthOf(cell)` 按表头定位；`smSumMonths` 改吃「月份→列号」映射。**只换取数方式，不改版式与数值口径、不做扩列**。 |
|---|
| | | - **为什么必须先做**：该写死列位是 09-29《配置初稿》第五节标明的"硬前提"——一插列，2025 块右移，四页会读错去年基数（对应已确认口径 C3/C4）。 |
|---|
| | | - **表头三形式兼容**（实测 8 月母版确为三种混用）：文本 `'2026年3月'`、裸日期序列号（`46082`，General，出租页几乎整行）、真日期 + `yyyy"年"m"月"`（` 货运`）。排除含「累计/同比/环比」的表头与非当月 1 号的数值；年份不匹配（2024/2023 块）不认。 |
|---|
| | | - **验证（关键，重做过一次）**：旧代码实例（java PID 5716）生成 2026-08 作基线 → 新代码实例（java PID 32368，10:07:58 启动）生成 2026-08 → **逐格 diff = 0**（公式/文本 0、缓存值 0，覆盖 19 页）；无"未识别到月份表头列"告警；2026-07 亦正常出表。 |
|---|
| | | - **踩坑（务必记住）**：首次对比的"0 差异"是**假的**——旧后端仍占 8090，`start-dev.ps1` 因端口已监听而跳过启动，且其报出的 PID 与真实监听 PID 不一致，导致误判"已换新进程"。**判断是否换了进程，必须看 `netstat -ano` 的真实监听 PID + 日志里的启动时间/PID，不能只信启停脚本输出。** |
|---|
| | | - **其它确认**：后端日志中文为 **GBK**（`Select-String` 中文模式匹配不到，需用 PID/类名等 ASCII 锚点）；两次产物 sha256 不同但 29 个 zip 条目内容全同（差异仅在 zip 容器元数据）。 |
|---|
| | | - **报告**（本地、不入库）：`docs/功能测试报告/功能测试报告_汇总大表列位置表头动态定位_2026-10-09.md`；日结 `docs/工作日结/工作日结_2026-10-09.md`。 |
|---|
| | | - **状态**：**【待验收】**（取数方式属口径相关改动）。未导入任何业务数据。 |
|---|
| | | - **下一步**：Step 1 扩列器本体（配置驱动，8 个可见台账页；§5.2 三条必改点；产物先落 `输出/` 待人工确认后再落盘为下期母版）。 |
|---|
| | | ## 最新（2026-10-06，zyj 线） |
|---|
| | | |
|---|
| | | ### 10-06：拉取合并 + 验收门禁分级 + 汇总大表 M0 立项 |
|---|
