docs: 归档《湖北省道路货物运输量分市州统计方法(2023)编制说明》学习笔记与原文(含45处公式还原、流程串联、符号表)，并更新工作日结

zhizhijie

2026-09-10 fdd408321c98b51bc4d6a6af2c16725c6968f67c

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-10.md

@@ -19,5 +19,40 @@
- å¾…用户实际浏览器验收“清空”按钮（建议先确认所选报表期与备份）；如需只清某一数据类型，可后续做“按类型清空”。
- æ²¿ç”¨æ˜¨æ—¥æœªåŠ¨å¾…办：汇总大表 M3（网约车台账取数、货运页 FreightCalc è§„上/规下、城市客运/中口径合成页）与“9 æœˆ+无母版自动扩列”；8 æœˆä»ç¼º 4 ç±»æºæ•°æ®è¡¨è¡Œï¼ˆfreight_turnover_import、scale_split_transport、passenger_individual_monthly、网约车拆分输入）。

## ä¸‹åˆï¼ˆ2026-09-10）清空功能增强：支持按类型清空 + æ¸…空按钮移出“刷新”防误触

### å®Œæˆå†…容
- ç”¨æˆ·åé¦ˆâ€œæ¸…空放在刷新旁边怕误触”，且需要能只清某一数据类型：把清空从侧栏标题行（刷新旁）移除，改到标题行下方独立红色危险操作区（浅红底 + è¾¹æ¡†ï¼Œâ€œæ¸…空数据…”按钮 + æç¤ºâ€œæŒ‰æŠ¥è¡¨æœŸæ¸…库，用于整月重导”），与刷新物理隔开。
- æ–°å¢žæ¸…空弹窗：单选“清空全部 / åªæ¸…空指定类型”，指定类型用多选下拉并按分组列出、标签带“（已导入 N è¡Œ/未导入）”；底部红色警示说明会同步删审核结果、已审核标记、导入批次（投资项目主档保留）且不可撤销；确认前再走一次二次确认。
- åŽç«¯ `POST /api/import/clear` å¢žåŠ å¯é€‰ `types`（逗号分隔）：空=整期全清（原行为不变），非空=只清指定类型，并同步清理关联 audit_result/audit_run/import_batch；返回值增加 `scope` ä¸Ž `types`。新增类型→表/审核类型/批次类型三张静态映射与 `clearTypeData` åˆ†æ´¾ï¼ŒæŠ•èµ„月度按项目类别过滤（主档保留）。

### æµ‹è¯•ç»“果摘要
- ç”¨ä¸€æ¬¡æ€§æµ‹è¯•æœŸ 2099-01/2099-02 éªŒè¯ï¼šæ¸… h2032 â†’ dataRows=636、auditRows=31、auditRunRows=1、batchRows=1，DB æ ¸å¯¹å››è¡¨å¯¹åº”记录全 0；同期的 cityBus ä¸šåŠ¡ 142 è¡Œã€CITY_BUS å®¡æ ¸ 53 è¡Œã€audit_run ä¸Žæ‰¹æ¬¡å‡ä¿ç•™ï¼›2099-02 æ•°æ®ä¸å—影响。
- è´Ÿå‘：`types=notAType` â†’ 500“未指定有效的数据类型”；有效+未知混合 â†’ å¿½ç•¥æœªçŸ¥æŒ‰æœ‰æ•ˆæ‰§è¡Œï¼›ä¸ä¼  types â†’ æ•´æœŸå…¨æ¸…。
- æŠ•èµ„类别：`types=investment` åªåˆ å®¢è¿ç«™åœºã€`types=investmentLogistics` åªåˆ ç‰©æµå›­åŒºï¼ŒæŠ•èµ„主档保留。
- UI å®žæµ‹ï¼ˆåº”用内浏览器，admin ç™»å½•ï¼‰ï¼šâ€œåˆ·æ–°â€æ—å·²æ— æ¸…空；新危险区按钮与弹窗文案正常；选中“道路货物运输月度生产情况（已导入 636 è¡Œï¼‰â€ç¡®è®¤åŽæç¤ºâ€œå·²æ¸…空 2099-01 æ•°æ®ï¼šä¸šåŠ¡æ•°æ® 636 è¡Œã€å®¡æ ¸ç»“æžœ 0 è¡Œã€å¯¼å…¥æ‰¹æ¬¡ 1 æ¡ï¼Œå¯ä»¥é‡æ–°å¯¼å…¥â€ï¼Œè¿›åº¦å›žâ€œæœªå¯¼å…¥â€ã€‚
- å›žå½’：测试期无残留，真实月份 2026-09=636、2026-07=636、2025-07=664 ä¸ŽçœŸå®žæ‰¹æ¬¡æ€»æ•° 239 å‡æœªå˜ã€‚
- åŽç«¯ `mvn -o -q compile` é€šè¿‡ï¼ŒæœåŠ¡å·²é‡å¯ï¼ˆPID 21884，08:54 å¯åŠ¨ï¼‰ï¼›å‰ç«¯ dev `Compiled successfully`。
- æµ‹è¯•æŠ¥å‘Šï¼šdocs/功能测试报告/功能测试报告_导入清空按类型与按钮防误触_2026-09-10.md。

### é—留问题与待办
- å¾…用户在自己浏览器验收新按钮位置与弹窗文案；如仍觉得危险区太显眼可再收进“更多操作”折叠。
- æ²¿ç”¨æœªåŠ¨å¾…办：汇总大表 M3（网约车台账取数、货运页 FreightCalc è§„上/规下、城市客运/中口径合成页）与“9 æœˆ+无母版自动扩列”；8 æœˆä»ç¼º 4 ç±»æºæ•°æ®è¡¨è¡Œï¼ˆfreight_turnover_import、scale_split_transport、passenger_individual_monthly、网约车拆分输入）。

## é™„：提交
- æœ¬æ¬¡æ”¹åŠ¨ 3 ä¸ªä»£ç æ–‡ä»¶ + æœ¬æŠ¥å‘Šä¸Žæ—¥ç»“，按规范先 `git fetch gitea/origin` å¯¹æ¯”合并，再 commit å¹¶åŒç«¯æŽ¨é€ï¼ˆgitea main、个人 gitee master）。
- æœ¬æ¬¡æ”¹åŠ¨ 3 ä¸ªä»£ç æ–‡ä»¶ + åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šä¸Žæ—¥ç»“，按规范先 `git fetch gitea/origin` å¯¹æ¯”合并，再 commit å¹¶åŒç«¯æŽ¨é€ï¼ˆgitea main、个人 gitee master）。

## æ™šé—´ï¼ˆ2026-09-10）业务学习：分市州货运量统计方法编制说明归档

### å®Œæˆå†…容
- è§£æžç”¨æˆ·æä¾›çš„ `【20230531】湖北省道路货物运输量统计方法（2023年）编制说明.docx`（2023å¹´5月编制，正文约 3494 å­— + 45 å¤„ OMML å…¬å¼ï¼‰ï¼Œæ•´ç†ä¸ºå¯ç›´æŽ¥æŸ¥é˜…的学习文档：
  `docs/货运/学习笔记_分市州道路货物运输量统计方法_2026-09-10.md`
- åŽŸæ–‡ docx ä¸€å¹¶å½’档到 `docs/货运/`，便于团队后续对照。
- ç¬”记内容：规上/规下界定、基月（2021å¹´9月，逐年滚动）确定方法、高速/国省道/运力三类波动系数与 0.5/0.3/0.2 åŠ æƒã€è§„上规下名单年度切换的基月基数调整、与省级数据衔接缩放、市州间增速协调性调整（1.5σ å†…、排名不变）、按新增速反推绝对量并二次衔接，另附完整流程串联、符号对照表、常见疑问与 45 å¤„公式清单。

### æŠ€æœ¯å¤‡æ³¨
- åŽŸæ–‡å…¬å¼æ˜¯ Word å…¬å¼å¯¹è±¡ï¼ˆOMML），在 Word ä¸­æ­£æ–‡å¯¹åº”位置为空白，直接看容易漏；已用脚本把 `m:oMath` è¿˜åŽŸæˆå¯è¯»å…¬å¼ï¼ˆå«åˆ†å¼ã€ä¸Šä¸‹æ ‡ã€æ±‚和符号），确认末式为 `H_i''' = H_i'' Ã— H / âˆ‘H_i''`。

### é—留问题与待办
- æ ¹ç›®å½•ç•™ä¸‹çš„解析临时文件 `doc_extract.txt`、`doc_extract2.txt`、`tmp_extract.py` æœªç»ç”¨æˆ·åŒæ„ä¸åˆ é™¤ï¼Œå¾…确认后清理。
- æ²¿ç”¨æœªåŠ¨å¾…办：汇总大表 M3（网约车台账取数、货运页 FreightCalc è§„上/规下、城市客运/中口径合成页）与「9 æœˆ+无母版自动扩列」；8 æœˆä»ç¼º 4 ç±»æºæ•°æ®è¡¨è¡Œã€‚