| | |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | > **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。 |
|---|
| | | |
|---|
| | | ## 最新（2026-09-22） |
|---|
| | | |
|---|
| | | - **已同步**：本地 `main` 已合并公司 `origin/main` 最新 `db0ee92`（含投资明细取数/导入修复）；合并后 `mvn -q -DskipTests compile` 通过。 |
|---|
| | | - **Codex 输入卡顿复核（已完成）**：电脑与 Codex 于 09-22 12:54 重启后，`Codex++` 修复脚本仍启用；主渲染进程空闲 CPU 约 13.3%（单核），调试守卫 `installed=true`、本次会话 `dropped=16`。对比修复前约 115%，卡顿问题已解决。 |
|---|
| | | - **今日已完成（远端提交）**：数据查看补齐网约车/个体客运、按市州汇总与导出 Excel、汇总大表进度弹窗与结果落盘缓存。 |
|---|
| | | - **汇总大表差异复核（2026-09-22）**：软件输出与手工定稿经 Excel 全量重算后逐格比对，930 条差异中实质数值差异 314 条；其中 304 条为 2025 累计列少加 7、8 月（业务已确认可清空），10 条 ` 货运` 历史同比业务已确认软件正确。报告见 `docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md`，明细见同名目录 CSV。 |
|---|
| | | - **未完成重点不变**：P0-2《亿元投资项目》按 Q7 追列、P0-3 导出前基数体检、P0-4 2026-09 母版；其余见 `docs/交接文档_2026-09-21.md` 第 4 章。 |
|---|
| | | - **关机交接快照（2026-09-22 17:20）**： |
|---|
| | | - **git**：`main` 已同步 `origin/main`；本快照提交后会再次推送，当前无未提交业务代码。 |
|---|
| | | - **运行状态**：dev 后端 `8090`、前端 `8080` 均未运行，也未发现对应 Java/Node 进程；`backend.log` 最后写入 09-21 17:29，`frontend.log` 最后写入 09-21 17:36。MySQL80(`3305`)、MySQL57(`3306`) 仍为 Running，关机后随系统停止，按惯例无需手工处理。 |
|---|
| | | - **下次启动**：在项目根目录执行 `powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`；数据库数据均已持久化，无需重建。 |
|---|
| | | - **保留产物**：汇总大表 930 条差异报告/CSV、投资 156→129 格比对报告、`_tmp*_0922.*` 和 `_tmp/gen_new_0922/` 等测试产物均保留，未经确认不删除。 |
|---|
| | | - **下次优先**：P0-2《亿元投资项目》按 Q7 追列、P0-3 导出前基数体检、P0-4 2026-09 母版；投资遗留还需处理武汉物流/黄冈客运 8 月源数据、潜江 6/7 月历史错值重导和未覆盖清单落文件。 |
|---|
| | | |
|---|
| | | ### 补充（2026-09-22 下午，投资取数修复第一轮） |
|---|
| | | |
|---|
| | | - **已修（代码 + 重导 + 回归）**：① 导出去标点归一化匹配（荆州）；② 同名双档优先取当月有数据的档（十堰快递产业园二期）；③ 未覆盖行逐行 WARN 留痕；④ 导入表头去换行（天门 H/J/K 不再丢）；⑤ 导入按表内报表期选 sheet（**潜江不再把 2018 年数据当 2026-08**）。 |
|---|
| | | - **结果**：2026-08 物流/客运明细逐格差异 **156 → 129**，无新增差异；未覆盖清单已能自动列出（物流武汉 6 行；客运黄石1/黄冈9/恩施1/仙桃1）。 |
|---|
| | | - **遗留（下一轮）**：L/D/E/F 覆盖口径（需《建设阶段归一表》）、武汉物流与黄冈客运 8 月源数据、潜江 2026-06/07 历史错值重导、未覆盖清单出文件/页面提示（P1-9）。 |
|---|
| | | - **报告**：`docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`。 |
|---|
| | | |
|---|
| | | ### 补充（2026-09-22 下午，投资明细表比对） |
|---|
| | | |
|---|
| | | - **已完成**：软件《客运站投资明细表》《物流站场投资明细》与人工版逐格比对（156 格差异），报告 `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`。 |
|---|
| | | - **捞出 3 类「会静默出数」的问题**（都指向取数而非算术）： |
|---|
| | | 1. 导出用底稿模板 + **按项目名匹配**库内当月数，匹配不上/库内无当月数就沿用上期值 —— 武汉物流（库内 0 条月度记录）整段保留 7 月值；荆州「中国供销公安商贸物流园」因库内名多一个点未覆盖。 |
|---|
| | | 2. 库内**同名双档**：十堰「快递物流产业园二期」`id=154`(竣工2026)/`id=181`(竣工2029) 并存，导出取到旧档。 |
|---|
| | | 3. **导入丢数**：天门「天门市物流中心建设项目」库内 2026-08 累计/自年初/本月全为 0，源文件是 16677.7/16677.7/500（**P1-5 原记录「源文件 H/J/K 列为空」与现文件不符，需更正**）。 |
|---|
| | | - **另**：导出不覆盖 L（建设阶段）列、单渠道市州的分组小计行填法、0/空白写法差异，均已在报告第五节给出处置建议。 |
|---|
| | | |
|---|
| | | ### 补充（2026-09-22 下午，另一会话收尾） |
|---|
| | | |
|---|
| | | - **本会话已完成**（已推送）：汇总大表进度弹窗优化（完成后不再出现重复下载按钮）；导出结果**落盘缓存**（`docs/生成汇总大表/_cache/`，已 gitignore）； |
|---|
| | | 缓存守卫升级为**数据指纹**（依赖源表 `CHECKSUM TABLE` + 母版等文件身份，排除投资/能耗/审核/系统/导入日志）——无关导入不再失效、**换母版必定失效**，失效时进度弹窗给出说明。 |
|---|
| | | - **当前环境**：后端 8090、前端 8080 运行中；导出缓存对 2026-08 有效（文件名带指纹）；最新提交 `06b1cb7`。 |
|---|
| | | - **剩余待办（已逐条核查，同事未触碰）**：P0-2 亿元表按 Q7 追列（`ReportExportService.java:6251` 仍写同一格）、P0-3 基数体检（`getLastMidIssues()` 无调用方）、 |
|---|
| | | P0-4 2026-06/09 母版缺失、P1-7 投资资金渠道字段、P1-9 投资导出按月分目录 + 运行日志、P2-1 D 组增速排名措辞。 |
|---|
| | | - **待核实**：`docs/交接文档_2026-09-21.md` 的 P2-2「城市客运页表头仍是日期序列号」可能过时——代码已有 `fixCityMonthHeaderText()`（09-03 加入）， |
|---|
| | | 建议跑一次 2026-08 导出核对后再改文档。 |
|---|
| | | - **入口**：`HANDOFF.md`（本文件）→ `AGENTS.md` → `docs/交接文档_2026-09-21.md` 第 4 章（P0/P1/P2 全量遗留）。 |
|---|
| | | |
|---|
| | | ### 关机交接快照（2026-09-22 晚） |
|---|
| | | |
|---|
| | | - **今日交付（两项，均已推送）**： |
|---|
| | | 1. 《投资明细表 软件生成 vs 人工版》逐格比对（156 格差异）+ 根因定位 —— `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`； |
|---|
| | | 2. 第一轮取数修复（导出 3 处 + 导入 2 处，含新发现的"潜江导入 2018 年历史 sheet"）—— `docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`；回归后逐格差异 **156 → 129**，无新增差异。 |
|---|
| | | - **git**：`main` = `db0ee92`，已同步公司 `origin/main`（已合并同事 `13c2d36` 汇总大表差异复核）。工作区干净；仅本地未跟踪的临时产物（`_tmp_diff_tables_0922.md`、`_tmp/gen_new_0922/`、`_tmp_*_0922.*`）和用户自己的 `docs/确认.docx` 未入库。 |
|---|
| | | - **运行状态**：dev 后端 8090、前端 8080 均在运行（本次代码改动已编译生效）；关机自然停止、不需处理。MySQL 3305/3306/3308 按惯例保留。 |
|---|
| | | - **本轮数据变更**：仅重导修正 `investment_monthly` 天门、潜江 2026-08 两处数值，未删除任何项目主档、未动其他市州/期间。 |
|---|
| | | - **接手优先（明日）**： |
|---|
| | | 1. L/D/E/F 列覆盖口径（需先确认《建设阶段归一表》：源表 主体施工/竣工收尾/未开工/本年正式施工/暂停施工/前期 → 输出用词）； |
|---|
| | | 2. 补源数据：武汉物流 8 月无单表、黄冈客运 8 月无源文件（导出已能自动告警，共 15 行受影响）； |
|---|
| | | 3. 潜江 2026-06 / 2026-07 月度仍是 2018 历史 sheet 错值，**用 6/7 月源表**重导（不要用 8 月文件重导）； |
|---|
| | | 4. 「未覆盖行清单」目前只进 `backend.log`，按 P1-9 可再做成《校验报错_<年月>.xlsx》或页面提示； |
|---|
| | | 5. 既有 P0/P1 不变（亿元表按 Q7 追列、导出前基数体检、2026-09 母版等，见 `docs/交接文档_2026-09-21.md` 第 4 章）。 |
|---|
| | | |
|---|
| | | ## 最新（2026-09-21） |
|---|
| | | |
|---|
| | | - **最新总入口**：`docs/交接文档_2026-09-21.md`（系统现状、P0/P1/P2 遗留、操作手册）；汇总大表专项见 `docs/问题汇总/汇总大表问题交接_2026-09-21.md`。 |
|---|
