交通统计审核
编辑 | blame | 历史 | 原始文档

交接文档（2026-09-04 下午）

用途：给“另一个会话”继续工作用。新会话请先读本文 + docs/生成汇总大表/输入输出与逻辑关系总表_2026-09-03.md，再按文末《下一步与待确认》推进。

1 项目与日常规范（AGENTS.md 摘要）

  • 项目：交通统计审核系统。后端 Spring Boot（traffic-audit-server，端口 8090）；前端 Vue2+Element（traffic-audit-web，端口 8080，/api 代理 8090）。
  • 启动：根目录 powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1（须在沙箱外执行）；成功标志看 backend.log / frontend.log。
  • 重启：按 PID 精确停旧进程再启动；不要杀 node_repl（MCP 内核）和用户自己开的 cmd 窗口。
  • 数据库：MySQL 127.0.0.1:3308，库 traffic_audit，root/123456。
  • 规范（2026-09-02 起）：每完成一个功能→测试→写 docs/功能测试报告/功能测试报告_<功能名>_<日期>.md；每天下班写 docs/工作日结/工作日结_<日期>.md。
  • git（2026-09-03 用户授权，无需再问是否推送）：改完→测试/写报告→git fetch gitea 对比合并（禁强推）→commit→push 公司 gitea（账号 zyj，凭据走本机）。
  • 注意：当前工作区很脏，**存在其他会话正在改的代码/文档**（docs/城市客运 的删除与新增、outputs/、_test_tmp/、*.bak、*.zip 等未提交）。提交时只 git add 自己改的文件，不要整包提交。

2 环境踩坑记录

  1. Codex 子进程 PowerShell 同时有 Path 与 PATH 两个环境变量，Start-Process/Get-Item env:Path 会报错；启动一律用 cmd.exe /c ... > log 2>&1 方式。
  2. node 在沙箱内访问 C:\Users\jcxiong 会被拒；启动脚本必须沙箱外执行。
  3. apply_patch 命令在本会话不可用（报 Invalid patch）。改文件用 PowerShell [System.IO.File]::WriteAllText/WriteAllLines 或 python 写（UTF-8）。
  4. bundled python 可能中途丢 pymysql，用 python -m pip install pymysql 装回即可；mysql 命令行引号易踩坑，优先 python+pymysql。
  5. 用户临时脚本/文件未经同意不删；导入失败要在页面显示行号。

3 今天已完成（2026-09-04）

  • 核实《汇总表母版》5 个成品页“7月当月块=1-7累计块”问题（docs/生成汇总大表/汇总表母版数据体检与待决策清单_2026-09-04.md），方案 A/B 待用户拍板。
  • 核实货运“规下”口径（业务确认）：规下 = 《货运量周转量表》全口径 − 《道路货物运输月度生产情况表》(H203-2) 规上合计；周转量同式；h2032 单位是 吨/吨公里，要先 ÷10000。
  • 2026-07 全量对账通过：全省规上 3754.78、全口径 16285.71、规下 12530.93，与母版 O7/O5/O9 全等；17 市州逐项一致；周转量同式验证也通过（武汉规下周转量 462751.81=母版 O16）。
  • 落地 SQL：docs/生成汇总大表/规下货运量口径_2026-09-04.sql（查询1 分市州、查询2 全省校验、查询3 可选回填=默认注释）。已在库里跑通。
  • 文档中文名改造（用户看不懂英文库表名）：总表 md §5-§8、页签逻辑关系说明.md、落地方案.md、上午交付工作清单.md，均把程序表名改为《中文业务名》，文首加“表名阅读约定”。
  • git 已推送（本会话只动文档，未动代码）：b5146d2 → d36f112 → 26f2700。

4 关键口径速记

4.1 表名对照（详细版见 总表 §5）

业务叫法 程序库表名
《道路货物运输月度生产情况表》(H203-2 企业月报，吨/吨公里) h2032_enterprise_monthly
《货运量周转量表》(全口径总量月报，万吨/万吨公里，含湖北省行、去年列 last_*) freight_turnover_import
《规上规下拆分表》(拆分结果表，现只有周转量、只有 CUMULATIVE 行) scale_split_transport
《公路旅客运输月度生产情况表》(H203-1)/《个体客运月报表》 h2031_enterprise_monthly / passenger_individual_monthly
《城市公共交通月度运营情况表》(公交月报，含轨道轮渡列)/《巡游出租汽车运营服务情况月报》 city_bus_monthly / city_taxi_monthly
《轨迹里程表》/ 各类《运政车辆表》 vehicle_track_mileage / transport_auth_vehicle / passenger_auth_vehicle / city_taxi_auth / h204_auth_vehicle
《道路货运车辆能源消耗情况表》(H204 季报) h204_vehicle_quarterly
《投资月报表/项目表/投资系统导出表》 investment_monthly / investment_project / investment_system
《审核规则/执行/结果/说明表》 audit_rule / audit_run / audit_result / audit_explanation
《导入批次表》 import_batch

4.2 公式

  • 规上货运量(万吨) = SUM(h2032.freight_total) ÷ 10000
  • 全口径货运量(万吨) = freight_turnover_import.freight_m{MM}
  • 规下货运量 = 全口径 − 规上；周转量同式（freight_turnover_import.turnover_m{MM} − SUM(h2032.turnover_total)÷10000）
  • 全省校验：17 市州求和 = “湖北省”行 = 母版“ 货运”页 O5/O6（总量）、O7/O8（规上）、O9/O10（规下）
  • 2025 基准：全口径去年 = freight_turnover_import.last_*；规上/规下拆分 2025 = 母版 T..AP 缓存列（12 个月全齐，已核实）→ 按“保留母版缓存值”处理

4.3 汇总工作簿（19 页三层）

  • 台账页：班线包车（含个体）、公交、出租、网约车、轨道轮渡（轨道=武汉+黄石；轮渡仅武汉；黄石无轮渡）
  • 口径合成页：城市客运 = 公交城市内+出租城市内+网约车城市内+轨道轮渡；中口径明细 = 班线全量+公交城乡差+出租城乡差+网约车城乡差
  • 成品页：城市汇总/城市分市州/货运/货运量排名/货运周转量排名/中口径排名/中口径分析/道路运输周转量（B=G+L/2+Q/10：G=货运周转量万吨公里、L=城市客运量万人次、Q=中口径旅客周转量万人公里）
  • 口径修订（已确认）：出租/网约车 全量≠城市内（仅武汉相等）；2026-07 出租全省城乡差 509.00、网约车 421.46

  • 2026 值列 C/E/G/I/K/M/O（偶数列同比），Q=1-7 累计；2025 列 T..AP；右侧 2024/更早参考列多为 #REF! 残留（待清）

    4.4 展示规则

  • 所有生成报表出口“显示两位小数、保留全精度”；整数不显示 .00；导出列宽按内容自适应（2026-09-03 已实现并测试）

5 现状数据缺口（影响“程序自动生成”）

  • 库内 H203-1 企业月报只有 2026-03、2026-07；城市公交/巡游出租只有 2026-06、2026-07；个体客运只有 2026-07；轨道轮渡只有 6/7 月（1-5 月待补文件）；网约车月度拆分输入《网约车订单及全省总量.xlsx》只有 2026-07 一行。
  • 《规上规下拆分表》只有 CUMULATIVE（累计）行：2026-07 126 行、2026-06 108 行，无当月(MONTHLY)行；货运量三列全空。
  • 汇总母版“ 货运”页：分市州“规上+规下货运量”“规下货运量”两行空白（全省行有值），原因见 §6.1 待确认 3。

6 下一步与待确认（新会话主任务）

6.1 等用户拍板（先复述并等回复，别自行假设）

  1. 《规上规下拆分表》回填货运量拆分按“当月”还是“1-累计”口径？（现表只有 CUMULATIVE 行，公式给的是当月值）——对应 SQL 查询 3。
  2. 规下货运量取数方式：实时现算（推荐）还是回填落表取数。
  3. 汇总表“ 货运”页分市州“规下货运量 / 规上+规下货运量”两行是否由程序补填（现母版留空）。
  4. 2025 同期列：确认“保留母版缓存值”（本会话已按此写文档，程序未动）。
  5. 方案 A/B（体检清单 2026-09-04）：5 个成品页“7月当月块错用累计值”，是否现在按 A 修正（短平快）再排期 B（根治：导出时自动重算当月块）。

  6. 上午清单 Q1/Q2/Q4/Q6/Q7/Q8/Q11：行列边界与月份扩到 12 月、2025/2024 列处理、轨道轮渡 1-5 月数据、公交“同比/环比 0%”是否立审核规则、城市客运成品页网约车列本期填值、出租城市内口径与 U402、每月生成流程（程序扩列 vs 每月人工母版）。

    6.2 未完成开发任务（按优先级，参考落地方案 P0-P7）

  • P0 母版定稿：清 #REF!、定行列边界映射、确认 2025/2024 列策略（见 6.1）。
  • P1 汇总工作簿骨架整本生成（复制母版→隐藏页→空数据导出可用）；历史 commit 6b0ae27/8b26ddc 已有整本复制+两位小数+列宽自适应，先确认最新母版生成_道路运输量汇总表.xlsx 状态。
  • P2 台账页填充：班线包车/公交/出租/网约车/轨道轮渡（先填 2026-07 班线、出租对库值）。
  • P3 口径合成页填充：城市客运、中口径明细（城乡差公式，校验 Q1≈0）。
  • P4 成品页填充：城市汇总/分市州/货运/排名/中口径排名/分析（货运页用 §4.2 公式填规上/规下）。
  • P5 道路运输周转量合成页。
  • P6 前端接入“汇总工作簿”与“网约车拆分表”生成选项。
  • P7 回归对照与《功能测试报告_汇总工作簿生成_…》+《工作日结_2026-09-04.md》。

  • 独立项：导入大文件“已处理 N/M 行”实时进度；公路旅客中口径明细 7-12 月扩列（依赖 Q1）；出租导入修正（另一会话负责，勿动）；运政/轨迹/能耗导入回归；投资四表 .xls 解析（Q9）。

    6.3 可能的文档收尾

  • 若用户要求“全改”：database.md、architecture.md、README、功能测试报告等仍含程序表名的技术文档，统一加“中文表名对照指引”（本会话只改了业务/逻辑类文档）。

7 最近 git 提交（本次会话内）

  • b5146d2 docs: 增补库表关系/单位换算/货运规上规下口径 + 落地口径 SQL
  • d36f112 docs: 汇总表/SQL 库表名改写为业务中文表名
  • 26f2700 docs: 页签逻辑/落地方案/上午清单 程序表名统一改业务中文名
  • 更早：6b0ae27（网约车拆分+汇总整本生成+两小数）、8b26ddc（整数无.00+列宽自适应+09-04 体检清单）
  • 注意：远程可能已有同事新提交，开工前先 git fetch gitea 检查 main...gitea/main。

8 给新会话的开工口令

  1. 先读本文件 §6，把“待用户拍板”6 组问题向用户复述并等回复。
  2. 同步：git fetch gitea；远端有新提交先合并，禁止强推。
  3. 涉及跨表口径一律先看 docs/生成汇总大表/输入输出与逻辑关系总表_2026-09-03.md §5-§7。
  4. 每完成一个功能：测试→功能测试报告→（下班）工作日结→提交推送。