fix(货运月报): 订正持续在规企业累计运距同比基期口径（v2）

zhizhijie

2026-09-18 b14fec1599277629e10b2bc686f02fd0c2e0bec1

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

@@ -60,6 +60,23 @@
那是控制台中文乱码造成的误读；母版/模板真实公式是正确的 `=[1]出租!C13-[1]出租!C15` / `=[1]网约车!C13-[1]网约车!C15`，
台账页「总量−城市内」Σ17 å¸‚å·ž = 535.83 / 333.39，与母版定稿全省行完全一致。**母版公式不需要修，之前"待修母版"的结论作废。**

### 5. ç½‘约车订单报告：Word 2003 XML（WordML）兼容导入（15:00）

**用户报障**：《湖北网络预约出租汽车2025年09月分析报告.docx》放在桌面导不进去。

**定位**：该文件根本不是 docx â€”— æ˜¯ **Word 2003 XML（WordML å¹³é“º XML）** è¢«æ”¹åæˆ `.docx`（文件头 `<?mso-application progid="Word.Document"?><w:wordDocument xmlns:w=".../word/2003/wordml">`，3.1MB çº¯ XML、不是 zip åŒ…），POI çš„ `XWPFDocument` åªèƒ½è¯» OPC(zip) åŒ… â†’ æŠ› `File is not a zip file`。监管平台/同事间流转的报告常是这种格式，会反复出现。

**改动（`DataImportService.java`）**：
- `importWycOrderReport()` å…¥å£æŒ‰æ–‡ä»¶å¤´å—…探格式分派：zip→docx；`<w:wordDocument`+`wordml`→**新增 WordML DOM è§£æžè·¯å¾„**；`D0CF11E0`→明确提示「.doc è¯·å¦å­˜ä¸º docx」；其它→「无法识别」；
- æ–°å¢ž `isWordPackage()`：zip ä½†æ—  `word/document.xml`（xlsx æ”¹åï¼‰â†’ ä¸­æ–‡æç¤ºï¼Œä¸å†æŠ› XMLBeans è‹±æ–‡å †æ ˆï¼›
- æ–°å¢ž `parseXmlSafely()`：DOM è§£æžå…³é—­å¤–部实体/DTD（防 XXE）；
- è¡¨æ ¼åŒ¹é…æŠ½æˆä¸Žæ ¼å¼æ— å…³çš„ `matchWycOrderTable()`，docx ä¸Ž WordML ä¸¤æ¡è·¯å¾„**共用同一套表头识别/17 å¸‚州取值/合计行逻辑**，不会口径分叉；
- æŠ¥è¡¨æœŸè¯†åˆ«æŠ½æˆ `periodOfParagraphs()`，两种格式共用。

**验证**：8 æ¡ç”¨ä¾‹å…¨éƒ¨é€šè¿‡ï¼ˆè§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_网约车订单报告WordML兼容导入_2026-09-18》）。2025-09 å…¥åº“：订单合计 17,652,159；武汉 8,076,610 / é»„石 676,644 / åå ° 1,048,593 / æ©æ–½ 804,736 / æž—区 1,424，与报告附件1 é€é¡¹ä¸€è‡´ï¼›pin ä»Ž `wyc_total_monthly` åŒæœŸå¤åˆ¶ã€‚真 docx（2026-08）重导幂等无变化；`.doc`、xlsx æ”¹åã€éžæœ¬æŠ¥å‘Š docx ä¸‰ç§è´Ÿå‘均给出中文可操作提示。

**数据缺口已补齐（重要）**：用户在 14:21~14:49 ä¹‹é—´è‡ªè¡Œå¯¼å…¥ 2026-01~06（6 ä»½ï¼‰ã€2025-01、2025-10~12；2025-09 ç”±æœ¬æ¬¡ä¿®å¤åŽè¡¥å…¥ã€‚现在 **2025-01~12 + 2026-01~08 çš„订单与 pin å…¨éƒ¨é½å…¨**。直接效果：中口径维度 4 çš„ 1~6 æœˆä»Žã€Œæ— æºã€å˜ä¸ºã€Œå¯ç®—」，**中口径排名件与中口径明细件的累计口径自动归一**（两者 1-8 æœˆç´¯è®¡å‡ä¸º 31528.0606，此前差 2063.45）。

## äºŒã€æµ‹è¯•ç»“果摘要

见 `docs/功能测试报告/功能测试报告_汇总表公式扩页与重算_2026-09-18.md`：8 æ¡æ­£å‘ + 4 æ¡è´Ÿå‘/边界 + 4 é¡¹å…¥åº“抽查，全部通过。
@@ -88,15 +105,18 @@
- å›žå½’：汇总大表 17 é¡µ **0 æ ¼å·®å¼‚**、《生成_中口径排名》**0 æ ¼å·®å¼‚**；
  æ˜Žç»†ä»¶å·®å¼‚仅落在 æ€»è¡Œ / å‡ºç§ŸåŸŽä¹¡ / ç½‘约车城乡 è¡Œçš„月份列与 AA ç´¯è®¡åˆ—（属预期）。

### ç½‘约车订单报告 WordML å¯¼å…¥ï¼ˆ15:00）验证

- 8 æ¡ç”¨ä¾‹ï¼ˆ4 æ­£å‘ / 3 è´Ÿå‘ / 1 è¾¹ç•Œï¼‰å…¨éƒ¨é€šè¿‡ï¼šWordML 2025-09 å¯¼å…¥æˆåŠŸã€æŠ¥è¡¨æœŸç•™ç©ºæ—¶é æ ‡é¢˜è‡ªåŠ¨è¯†åˆ«ã€çœŸ docx å¹‚等无变化、`.doc`/xlsx æ”¹å/非本报告 docx å‡ç»™å‡ºä¸­æ–‡æç¤ºã€‚
- æ•°æ®è¡¥é½åŽé‡è·‘ 8 æœˆå¯¼å‡ºå›žå½’：独立《生成_中口径明细》报表期内不一致 0、报表期后仍有值 0；与汇总大表「中口径明细」页 **704 å¯¹æ ¼ 0 å·®å¼‚**；全省 1-8 æœˆæ€»å®¢è¿é‡ 3733.79…4003.57，网约车城乡 333.39…426.56，累计 AA5=31528.0607、AA9=2911.47。
- æŽ’名件与明细件累计口径一致（均 31528.0606），差值 2063.45 æ¶ˆå¤±ã€‚

## ä¸‰ã€é—留问题与待办

1. ~~中口径排名同比仍是写死值~~ â†’ **已按新口径取值**（M3=0.638 / Q3=0.2247），但仍与中口径明细的 0.0581 ä¸è‡ªæ´½ï¼Œå·®å€¼ 2063.45 = ç½‘约车 1-6 æœˆæ— æºï¼›**收口办法见下方"第 3 æ­¥æ”¶å£å»ºè®®"**。
2. ~~`loadMidClassMap()` ç¼ºå·¡æ¸¸å‡ºç§Ÿ + ç½‘约车两维~~ â†’ **已补**（维度 3、4），独立中口径明细四维齐全。
3. ~~**母版缺陷待修**：中口径明细城市级公式引错页~~ â†’ **误判，已作废**：真实公式是正确的跨簿引用，母版无需修改；当时的"引错页"是控制台中文乱码误读。
4. **数据缺口（已核实，属源头就没有）**：2026-01~06 ç½‘约车订单在**源文件**《模板_网约车订单及全省总量.xlsx》里就是空的（只有全省 pin、无订单列），
   ä¸æ˜¯å¯¼å…¥å¤±è´¥â€”—`wyc_order_monthly` è¯¥ 6 æœŸ `order_*` å…¨ NULL ä¸Žä¹‹å»åˆï¼ˆå¯¼å…¥æ‰¹æ¬¡ `WYC_ORDER`，09-04）。
   å½±å“é¢åªæœ‰ä¸€ä¸ªï¼š`WycSplitCalc.calc()` å›  `orderSum<=0` ç®—不出网约车拆分 â†’ ç»´åº¦ 4 è¯¥ 6 ä¸ªæœˆæ— æºï¼ˆçŽ°å·²ç”±ç¬¬ 4 æ¡æ”¹åŠ¨ä¿ç•™æ¯ç‰ˆå®šç¨¿å€¼å…œä½ï¼‰ã€‚
   **建议**：给网约车订单导入加一条「订单列全空」的显式提示（现在会静默成功），并请业务确认这 6 ä¸ªæœˆè®¢å•æ˜¯å¦å¯è¡¥ã€‚
4. ~~**数据缺口**：2026-01~06 ç½‘约车订单未入库~~ â†’ **已补齐**（用户 14:21~14:49 å¯¼å…¥ 2026-01~06 + 2025-01 + 2025-10~12；2025-09 ç» WordML ä¿®å¤åŽè¡¥å…¥ï¼‰ã€‚现在 2025-01~12 + 2026-01~08 è®¢å•é½å…¨ï¼Œç»´åº¦ 4 å…¨æœŸå¯ç®—，排名件/明细件口径归一。仍建议补一条「导入时订单列全空」的显式提示（《模板_网约车订单及全省总量.xlsx》那类文件现在会静默成功）。
5. åº“内 h2031「全省」行 â‰  Î£17 å¸‚州（1-8 æœˆ 27524.49 vs 24481.74，差 3042.75）：业务口径问题，建议业务侧核对。
6. æŠ•èµ„：模板里没有的新项目不会自动插行；明细表资金渠道分组行未入库（需加 `fund_channel`）；同名不同项目未弹窗。
7. æŠ•èµ„两张明细表（`X月客运站投资明细表` / `X月物流站场投资明细`）生成器未做。
@@ -116,6 +136,70 @@
## å››ã€æ˜Žå¤©è®¡åˆ’

1. ç¬¬ 3 æ­¥æ”¶å£ï¼šæŽ’名件与明细件口径归一（差值 2063.45 = 2026 å¹´ 1-6 æœˆç½‘约车城乡）→ æŽ’名件改取汇总表同源值 â†’ å›ºåŒ–"生成件 vs æ¯ç‰ˆé‡ç®—"逐格回归脚本。
2. ç½‘约车订单导入空列提示（页面明确提示"该期订单列为空，未写入订单数"）+ å‘用户确认 2026-01~06 æ˜¯å¦è¡¥æ•°ã€‚
2. ç½‘约车订单导入空列提示（页面明确提示"该期订单列为空，未写入订单数"）——数据虽已补齐，但静默成功仍是隐患。
3. æŠ•èµ„"新增项目插行 + åˆ†ç»„行入库（`fund_channel`）"方案落地（等用户对"模块"口径的最后确认）。
4. æŠ•èµ„两张明细表生成器（`X月客运站投资明细表` / `X月物流站场投资明细`）。

---

## äº”、傍晚追加：货运月报「持续在规企业」分市州 1-8 æœˆç´¯è®¡è¿è·åŠåŒæ¯”（桌面交付）

### 5.1 éœ€æ±‚与口径

用户要求：把货运月报「持续在规企业」分市州 1-8 æœˆç´¯è®¡è¿è·åŠåŒæ¯”情况整理成 Excel，生成到桌面。

- **持续在规企业** = 2026 å¹´ 1-8 æœˆè¿žç»­ 8 ä¸ªæœˆå‡ä¸ŠæŠ¥ H203-2 æœˆæŠ¥çš„企业，**636 å®¶**（2026 å¹´å„月上报企业数均为 636，全期一致）。
- **累计平均运距** = 1-8 æœˆç´¯è®¡è´§ç‰©å‘¨è½¬é‡ Ã· ç´¯è®¡è´§è¿é‡ï¼ˆåŠ æƒå¹³å‡ï¼‰ã€‚
- **同比** = 2026 å¹´ 1-8 æœˆç´¯è®¡è¿è· Ã· 2025 å¹´ 1-8 æœˆç´¯è®¡è¿è· âˆ’ 1，只在**两年均持续在规的 545 å®¶**上计算（可比口径）。

### 5.2 æ•°æ®ä¸Žäº§å‡º

数据源：`traffic_audit.h2032_enterprise_monthly`（2025-01 ~ 2026-08，13,056 æ¡ä¼ä¸šçº§è®°å½•ï¼‰ã€‚

产出：`C:\Users\郑玉洁\Desktop\货运月报_持续在规企业_分市州1-8月累计运距及同比_2026-09-18.xlsx`（5 é¡µç­¾ï¼šè¯´æ˜Žä¸Žå£å¾„ / åˆ†å¸‚州汇总 / åˆ†å¸‚州分月 / ä¼ä¸šæ˜Žç»† 636 è¡Œ / å£å¾„校验），生成脚本 `docs\工具\持续在规企业累计运距生成.py`。

### 5.3 å…³é”®ç»“æžœ

| å¸‚å·ž | æŒç»­åœ¨è§„(家) | 1-8月累计平均运距(公里) | åŒæ¯” | å¸‚å·ž | æŒç»­åœ¨è§„(家) | 1-8月累计平均运距(公里) | åŒæ¯” |
| --- | --- | --- | --- | --- | --- | --- | --- |
| æ­¦æ±‰å¸‚ | 199 | 162.11 | +13.5% | é»„冈市 | 71 | 135.14 | +1.1% |
| é»„石市 | 20 | 117.63 | +20.2% | å’¸å®å¸‚ | 17 | 113.33 | âˆ’24.1% |
| åå °å¸‚ | 13 | 321.13 | âˆ’2.9% | éšå·žå¸‚ | 26 | 187.28 | âˆ’17.1% |
| å®œæ˜Œå¸‚ | 65 | 88.55 | +2.6% | æ©æ–½å·ž | 4 | 130.11 | +10.3% |
| è¥„阳市 | 81 | 274.50 | +8.4% | ä»™æ¡ƒå¸‚ | 2 | 65.61 | ä¸é€‚用 |
| é„‚州市 | 6 | 38.15 | âˆ’59.0% | æ½œæ±Ÿå¸‚ | 13 | 394.20 | +10.9% |
| è†é—¨å¸‚ | 40 | 281.41 | âˆ’4.7% | å¤©é—¨å¸‚ | 4 | 61.02 | âˆ’54.6% |
| å­æ„Ÿå¸‚ | 21 | 164.00 | âˆ’7.4% | ç¥žå†œæž¶æž—区 | 2 | 57.68 | âˆ’49.1% |
| è†å·žå¸‚ | 52 | 324.47 | âˆ’4.7% | **全省** | **636** | **156.92** | **+2.9%** |

- å…¨çœç´¯è®¡è´§è¿é‡ 31399.82 ä¸‡å¨ã€ç´¯è®¡å‘¨è½¬é‡ 4927161.77 ä¸‡å¨å…¬é‡Œï¼Œä¸Žã€Š2026å¹´8月规上货物周转量与平均运距分析报告》**完全一致**；8 æœˆå½“月全省平均运距 155.51 å…¬é‡Œäº¦ä¸Žå‘布口径一致。
- ç´¯è®¡è¿è·æ˜Žæ˜¾æ‹‰é•¿çš„只有武汉（+13.5%）、黄石（+20.2%）；鄂州（−59.0%）、天门（−54.6%）、林区（−49.1%）、咸宁（−24.1%）、随州（−17.1%）为大幅缩短，建议业务侧关注。

### 5.4 æµ‹è¯•ä¸Žé—®é¢˜

《功能测试报告_货运月报持续在规企业分市州累计运距_2026-09-18.md》：14 æ¡ç”¨ä¾‹ï¼ˆ8 æ­£å‘ / 3 è¾¹ç•Œ / 3 è´Ÿå‘）全部通过；2026-01~07 é€æœˆè§„上货运量、周转量与汇总表「 è´§è¿ã€é¡µ 14 é¡¹æ¯”对 0 å·®å¼‚。

- ç”Ÿæˆè„šæœ¬è¡Œå·è‡ªå¢žé”™ä½å¯¼è‡´è¡¨å¤´/末行被覆盖 â†’ å·²ä¿®æ­£å¹¶é€è¡Œå¤æ ¸ï¼ˆè¡¨å¤´ + 17 å¸‚å·ž + åˆè®¡å…± 18 è¡Œï¼‰ã€‚
- æ¡Œé¢å‰¯æœ¬ç¬¬ä¸€ç‰ˆä¸ºä¿®æ­£å‰æ–‡ä»¶ â†’ å·²é‡æ–°åŒæ­¥ï¼ŒSHA256 ä¸€è‡´ã€‚

### 5.5 å¾…办

1. ~~请业务确认「持续在规企业」定义~~ â†’ **用户 2026-09-18 å·²ç¡®è®¤**：按「2026 å¹´ 1-8 æœˆè¿žç»­ 8 ä¸ªæœˆä¸ŠæŠ¥ã€= 636 å®¶ï¼›äº¤ä»˜ä»¶æ— éœ€è°ƒæ•´ã€‚
2. ä»™æ¡ƒå¸‚ 2026 å¹´ 2 å®¶æŒç»­åœ¨è§„企业 2025 å¹´ 1-8 æœˆæ— è¿žç»­ä¸ŠæŠ¥è®°å½•ï¼ŒåŒæ¯”留空，建议核对该市州历史上报。

### 5.6 è®¢æ­£ï¼šåŒæ¯”基期口径（v2，17:0x）

用户反馈「1-8 æœˆç´¯è®¡è¿è·åŒæ¯”不对」。核查后确认：**v1 çš„同比基期取错了**。

- æ±‡æ€»è¡¨ã€Œè´§è¿ã€é¡µ T åˆ—（累计同比）公式 = `=S7/SUM(V7,X7,Z7,AB7,AD7,AF7,AH7,AJ7)-1`，基期是 **2025 å¹´ 1-8 æœˆå…¨éƒ¨è§„上企业**（全省 664 å®¶ï¼‰ï¼›v1 ç”¨çš„是「两年均持续在规的 545 å®¶ã€ï¼Œå¯¼è‡´åŒæ¯”系统性偏小。
- è¯æ®ï¼šDB 2025 å¹´ 1-8 æœˆ = 33994.4483 ä¸‡å¨ / 5102518.9463 ä¸‡å¨å…¬é‡Œï¼Œä¸Žæ±‡æ€»è¡¨ V7..AJ7、V8..AJ8 ç¼“存值**逐项一致**。

| æŒ‡æ ‡ | v1（545 å®¶ï¼‰ | v2（官方全口径） | å‘布报告 |
| --- | --- | --- | --- |
| ç´¯è®¡è´§è¿é‡åŒæ¯” | âˆ’7.96% | **−7.63%** | âˆ’7.63% |
| ç´¯è®¡å‘¨è½¬é‡åŒæ¯” | âˆ’5.30% | **−3.44%** | âˆ’3.44% |
| å…¨çœ 1-8 æœˆç´¯è®¡å¹³å‡è¿è· | 158.18 / 153.73 = +2.90% | **156.92 / 150.10 = +4.54%** | â€” |

- é‡ç®—后 `分市州汇总` æ”¹ä¸ºã€Œ2026 å…¨å£å¾„ / 2025 å…¨å£å¾„ / åŒæ¯”」三段列；新增 `口径对比` é¡µå¹¶åˆ—两种口径，标出差异超 10 ä¸ªç™¾åˆ†ç‚¹çš„市州。
- ä¿®æ­£åŽå¸‚州同比：武汉 +17.0%、黄石 +35.3%、襄阳 +21.0%、宜昌 +7.4%、潜江 +5.6%、随州 +4.9%、恩施 +1.2%、荆州 âˆ’0.2%、黄冈 âˆ’0.3%、十堰 âˆ’1.9%、荆门 âˆ’6.6%、孝感 âˆ’13.3%、咸宁 âˆ’25.4%、林区 âˆ’49.1%、天门 âˆ’54.6%、鄂州 âˆ’63.1%、仙桃 âˆ’89.1%。
- å·²åŒæ­¥æ¡Œé¢äº¤ä»˜ä»¶ï¼ˆSHA256 ä¸€è‡´ï¼‰ã€‚