docs: 2026-09-04 交接文档（进度/口径/待确认/环境要点），供新会话继续

zhizhijie

2026-09-04 a31a0d858845ab7b04df7260b0566d255703e19c

docs: 2026-09-04 交接文档（进度/口径/待确认/环境要点），供新会话继续

 docs/½»½ÓÎĵµ_2026-09-04.md

New file
@@ -0,0 +1,97 @@
# äº¤æŽ¥æ–‡æ¡£ï¼ˆ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. æ¯å®Œæˆä¸€ä¸ªåŠŸèƒ½ï¼šæµ‹è¯•â†’功能测试报告→（下班）工作日结→提交推送。