From e9f1ee7341bcf55904f6c0d31aa91ff52aa441dc Mon Sep 17 00:00:00 2001
From: zhizhijie <zhizhijie@users.noreply.gitee.com>
Date: 星期二, 22 九月 2026 11:28:40 +0800
Subject: [PATCH] feat(数据查看): 按市州汇总(任意起止月/自动上年同期/时点列不参与/排名可选) + 导出 Excel，新增 CityRollupService 与 3 个接口
---
docs/功能测试报告/功能测试报告_中口径四维口径统一_2026-09-18.md | 36 +++++++++++++++++++++++++++++-------
1 files changed, 29 insertions(+), 7 deletions(-)
diff --git "a/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\344\270\255\345\217\243\345\276\204\345\233\233\347\273\264\345\217\243\345\276\204\347\273\237\344\270\200_2026-09-18.md" "b/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\344\270\255\345\217\243\345\276\204\345\233\233\347\273\264\345\217\243\345\276\204\347\273\237\344\270\200_2026-09-18.md"
index 7d82b1e..19ac168 100644
--- "a/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\344\270\255\345\217\243\345\276\204\345\233\233\347\273\264\345\217\243\345\276\204\347\273\237\344\270\200_2026-09-18.md"
+++ "b/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\344\270\255\345\217\243\345\276\204\345\233\233\347\273\264\345\217\243\345\276\204\347\273\237\344\270\200_2026-09-18.md"
@@ -16,19 +16,27 @@
- 鎬诲杩愰噺/鎬诲懆杞噺 = 缁村害 1+2+3+4锛坄loadMidClassMap` 鐨勭淮搴� 0锛夛紱
- **鍏ㄧ渷琛屼竴寰� = 危17 甯傚窞**锛堜笉閲囩敤搴撳唴 `region_code='420000'` 鐨勫叏鐪佽锛岃鍙ｅ緞 1-8 鏈堟瘮 危甯傚窞澶� 3042.75锛屽睘涓氬姟寰呮牳椤癸級锛�
- 鍚屾瘮 = (鏈湡 鈭� 鍘诲勾鍚屾湡) / 鍘诲勾鍚屾湡锛涙棤鍘诲勾鏁版嵁鐣欑┖銆�
+- **缂烘暟鎹鐞嗚鍒欙紙鏈鏂板锛岄噸瑕侊級**锛氬簱鍐呰鏈堣缁存病鏈夋簮鏁版嵁鏃讹紝**淇濈暀姣嶇増/妯℃澘鍘熷��**锛岀粷涓嶅啓绌恒�佷篃涓嶅啓 0銆�
+ 涓彛寰勬槑缁嗙殑鍩庡競绾с�屽煄闄呭煄涔″贰娓稿嚭绉�/缃戠害杞︺�嶈鏈潵灏辨槸銆屽彴璐﹂〉 鎬婚噺 鈭� 鍩庡競鍐呫�嶇殑寮曠敤骞跺凡涓氬姟瀹氱锛�
+ 鐢ㄥ簱鍐呯己澶卞�艰鐩栵紝浼氭妸瀹氱鏁版竻鎺夛紙2026-01~06 缃戠害杞﹁鍗曠己澶辨椂锛屽叏鐪� 333.39 涓庡悇甯傚窞鍊艰娓呯┖杩囷級銆�
**鏈鏀瑰姩鏂囦欢**锛歚traffic-audit-server/src/main/java/com/trafficaudit/reportexport/service/ReportExportService.java`
- `loadMidClassMap()`锛氳ˉ缁村害 3锛堝贰娓稿嚭绉熷煄涔★級銆佺淮搴� 4锛堢綉绾﹁溅鍩庝埂锛夛紝鏂板 `midPeriodKey()`锛�
- `fillMidCell()`锛氬幓鎺夈�屽嚭绉�/缃戠害杞﹀啓姝� 0銆嶆梺璺紝鍥涚淮缁熶竴鍙栧簱鍐呭�硷紱
- `fillMidYoyCell()` / `fillMidCumYoyColumn()`锛氬悓姣旂敱銆屽彧绠楀墠涓ょ淮銆嶆敼涓哄洓缁撮綈鍏紱
-- `exportPassengerMidDetail()`锛氱敱銆屽彧澶勭悊鍏紡鏍笺�嶆敼涓恒�屾寜鍒楅亶鍘嗐�嶏紝鎵╁垪鍑烘潵鐨� 7~12 鏈堢┖鏍兼墠濉緱涓婏紱鎵╁垪鏈堜唤鐨勬�昏鍊煎垪鐢卞簱鍐呭洓缁村悎璁＄洿鎺ュ啓鍏ワ紱閲嶇畻鏀圭敤閫愭牸瀹归敊鐨� `recalcWorkbookFormulas()`锛堝師 `evaluateAll()` 浼氬湪璺ㄧ翱鍏紡澶勬暣鏈腑鏂紝绱鍒楁嬁涓嶅埌鏂扮紦瀛樺�硷級銆�
+- `exportPassengerMidDetail()`锛氱敱銆屽彧澶勭悊鍏紡鏍笺�嶆敼涓恒�屾寜鍒楅亶鍘嗐�嶏紝鎵╁垪鍑烘潵鐨� 7~12 鏈堢┖鏍兼墠濉緱涓婏紱
+- 鎬昏鍊煎垪**涓�寰嬩繚鐣欐ā鏉垮叕寮�**锛�1~6 鏈堝師鍏紡 + 鎵╁垪鍏嬮殕鍑烘潵鐨勫叕寮忥級锛岀敱鏀跺熬閲嶇畻濉�硷紙涓嶅啀 `keepCached` 娓呭叕寮忋�佷篃涓嶅啀鎵嬪啓鍚堣锛夛紱
+- `fillMidCell()`锛氬簱鍐呭彇鍊间负 0锛堣鏈堣缁存棤婧愶級鏃剁洿鎺ヨ繑鍥烇紝淇濈暀姣嶇増/瀹氱鍘熷�硷紱
+- 閲嶇畻鏀圭敤閫愭牸瀹归敊鐨� `recalcWorkbookFormulas()`锛屽苟 `setIgnoreMissingWorkbooks(true)`锛氳法绨垮叕寮忥紙`[1]鍑虹!C13`锛夊湪澶栭儴宸ヤ綔绨跨己澶辨椂鏀圭敤璇ユ牸鑷韩缂撳瓨鍊煎弬涓庤绠楋紝鍚﹀垯寮曠敤瀹冪殑鎬昏/绱浼氳繛閿佸け璐ワ紙琛ㄧ幇涓�"鍏紡鍦ㄣ�佷絾娌℃湁缂撳瓨鍊�"锛夛紱
+- 鏂板 `blankFutureMonthColumns()`锛氭姤琛ㄦ湡涔嬪悗鐨勬湀浠藉垪锛堝 8 鏈堟姤琛ㄩ噷鐨� 9~12 鏈堬級娓呯┖鏁版嵁鏍笺�佷繚鐣欒〃澶达紝閬垮厤鍑虹幇"9~12 鏈堝叏鏄� 0"鐨勫亣鏁版嵁銆�
## 浜屻�佹祴璇曠幆澧�
-- 鍚庣 8090锛坄start-dev.ps1` 閲嶅惎锛孭ID 11772锛夈�佸墠绔� 8080锛堝鐢ㄥ凡鍦ㄨ繍琛屽疄渚嬶級锛涙暟鎹簱 `traffic_audit`锛�127.0.0.1:3308锛夛紱鎶ヨ〃鏈� 2026-08锛宮ode=month銆�
+- 鍚庣 8090锛坄start-dev.ps1` 閲嶅惎锛岀浜岃疆 PID 18516锛夈�佸墠绔� 8080锛堝鐢ㄥ凡鍦ㄨ繍琛屽疄渚嬶級锛涙暟鎹簱 `traffic_audit`锛�127.0.0.1:3308锛夛紱鎶ヨ〃鏈� 2026-08锛宮ode=month銆�
- 瀵煎嚭鎺ュ彛锛歚/api/report/export/summaryWorkbook`銆乣/api/report/export/passengerMidDetail`銆乣/api/report/export/passengerMidRank`銆�
-- 璇佹嵁鏂囦欢锛歚_tmp/_qa_out/step3c_summary.xlsx`銆乣step3c_midDetail.xlsx`銆乣step3c_midRank.xlsx`銆乣chk_step3c2.txt`銆乣chk_step3c3.txt`銆乣cmp_step3bc.txt`锛堟湰杞級锛沗step3b_*.xlsx`锛堟敼鍔ㄥ墠鍩虹嚎锛夈��
+- 璇佹嵁鏂囦欢锛堢涓�杞級锛歚_tmp/_qa_out/step3c_summary.xlsx`銆乣step3c_midDetail.xlsx`銆乣step3c_midRank.xlsx`銆乣chk_step3c2.txt`銆乣chk_step3c3.txt`銆乣cmp_step3bc.txt`锛沗step3b_*.xlsx`锛堟敼鍔ㄥ墠鍩虹嚎锛夈��
+- 璇佹嵁鏂囦欢锛堢浜岃疆/鏈�缁堬級锛歚_tmp/_qa_out/step3g_summary.xlsx`銆乣step3g_midDetail.xlsx`銆乣step3g_midRank.xlsx`銆乣export_step3g.txt`銆乣chk_step3g.txt`銆乣cmp_md_vs_summary.txt`锛涘鍑鸿剼鏈� `export_step3g.py`銆�
## 涓夈�佺敤渚嬭〃
@@ -46,6 +54,11 @@
| 10 | 璐熷悜/杈圭晫 | `wyc_order_monthly` 2026-01~06 璁㈠崟鍒楀叏涓� NULL銆佹ā鏉裤�婄綉绾﹁溅璁㈠崟鍙婂叏鐪佹�婚噺.xlsx銆嬪彧鏈� 2026-07 涓�琛屾湁鏁版嵁 | 缁村害 4 璇ユ湀鏃犳簮 鈫� 琛岀暀绌猴紙涓嶇紪閫狅級 | 鐙珛浠躲�屽煄闄呭煄涔＄綉绾﹁溅銆�1-6 鏈堜负绌猴紱姹囨�昏〃璇ュ彛寰勭敱姣嶇増瀹氱鎵胯浇 | 閫氳繃锛堟寜棰勬湡鐣欑┖骞惰褰曪級 |
| 11 | 璐熷悜/杈圭晫 | 鍘诲勾鍚屾湡鏃犳暟鎹紙濡� 2025-01 缃戠害杞﹁鍗曠己澶憋級 | 鍚屾瘮鐣欑┖ | 鐣欑┖锛屾湭鍐� 0 / #DIV/0! | 閫氳繃 |
| 12 | 璐熷悜/杈圭晫 | 缂烘ā鏉挎枃浠� | 鎶涖�屾湭鎵惧埌妯℃澘鏂囦欢銆嶅苟鍐欏叆鍚庣鏃ュ織 | 鏈Е鍙戯紙妯℃澘榻愬叏锛� | 涓嶉�傜敤 |
+| 13 | 姝ｅ悜 | 鐙珛浠跺煄甯傜骇銆屽煄闄呭煄涔＄綉绾﹁溅銆嶏紙R14 姝︽眽 / R19 榛勭煶 鈥︼級1~6 鏈� | 鏈夊�硷紙娌跨敤瀹氱锛�0 / 13.5998 / 10.668 / 鈥︼級锛屼笉琚竻绌� | 0 / 13.599765541547697 / 10.668042925780014 鈥� | 閫氳繃 |
+| 14 | 姝ｅ悜 | 鐙珛浠� 18 鍦板尯 脳 12 涓湀锛氭�昏 = 危 璇ュ潡 4 缁磋銆佺疮璁� = 危1-8 鏈� | 鍏ㄩ儴鐩哥瓑 | 涓嶄竴鑷存暟 0 | 閫氳繃 |
+| 15 | 姝ｅ悜 | 鐙珛浠朵笌姹囨�诲ぇ琛ㄣ�屼腑鍙ｅ緞鏄庣粏銆嶉〉 1~8 鏈堥�愭牸瀵圭収锛�18 鍦板尯 脳 5 琛� 脳 8 鏈堬級 | 瀹屽叏涓�鑷� | 704 瀵规牸 0 宸紓 | 閫氳繃 |
+| 16 | 璐熷悜/杈圭晫 | 鎶ヨ〃鏈熶箣鍚庣殑鏈堜唤鍒楋紙9~12 鏈堬級 | 鏁版嵁鏍间负绌恒�佽〃澶翠繚鐣� | 鏁版嵁鏍煎叏绌恒�佽〃澶� `2026骞�9鏈堚��12鏈坄 淇濈暀 | 閫氳繃 |
+| 17 | 鍥炲綊 | 鏈疆鏀瑰姩鍓嶅悗锛氭眹鎬诲ぇ琛� 17 椤点�佺嫭绔嬨�婄敓鎴恄涓彛寰勬帓鍚嶃�� | 0 宸紓 | 鍧� 0 宸紓锛涚嫭绔嬨�婄敓鎴恄涓彛寰勬槑缁嗐�嬪樊寮備粎钀藉湪 鎬昏/鍑虹鍩庝埂/缃戠害杞﹀煄涔� 涓夌被琛岀殑鏈堜唤鍒椾笌绱鍒� | 閫氳繃 |
**鍏ュ簱鎶芥煡**锛堟姤琛ㄦ湡 2026-08锛屼笌婧愯〃閫愰」瀵归綈锛�
@@ -64,9 +77,14 @@
- 鐜拌薄锛氭帓鍚嶄欢鍏ㄧ渷绱 = 29464.6108銆佺疮璁″悓姣� = 0.638锛涗腑鍙ｅ緞鏄庣粏鍏ㄧ渷绱 = 31528.0607銆佺疮璁″悓姣� = 0.0581锛屽樊鍊� 2063.45 = 2026 骞� 1-6 鏈堢淮搴� 4锛�333.39+294.49+347.23+335.39+369.27+383.68锛夈��
- 鏍瑰洜锛氭帓鍚嶄欢鐢� Java 鐢� `loadMidClassMap()` 鐜扮畻锛�1-6 鏈堢綉绾﹁溅鏃犳簮 鈫� 灏戜竴鍧楋紝涓� 2025 骞村熀绾夸篃鍙湁搴撳唴鍙ｅ緞锛夛紱涓彛寰勬槑缁嗛〉璧扮殑鏄瘝鐗堝叕寮忛摼 + 瀹氱缂撳瓨鍊笺��
- 寤鸿锛氳銆婃眹鎬昏〃涓夋潯涓荤嚎淇鏂规_2026-09-18銆嬬 3 姝モ�斺�旂粺涓�鐢便�屾瘝鐗堝叕寮忛摼 + 鍙拌处椤点�嶅嚭鏁帮紝Java 涓嶅啀鍙︾畻涓�濂楋紙璇﹁鏈疆绛斿锛夈��
-3. **锛堝睘姣嶇増缂洪櫡锛変腑鍙ｅ緞鏄庣粏鍩庡競绾с�屽煄闄呭煄涔″贰娓稿嚭绉�/缃戠害杞︺�嶈鍏紡寮曢敊椤�**
- - 鐜拌薄锛氭姹� R13/R14 鍏紡涓� `=鍏氦!C13-鍏氦!C15`锛堝簲鍒嗗埆鎸囧悜 `鍑虹!`銆乣缃戠害杞�!`锛夛紝鍩庡競绾ф亽涓� 0锛涜�屽叏鐪佽 R8/R9 闈犳瘝鐗堢紦瀛樺�肩粰鍑虹湡瀹炴暟锛�535.83 / 333.39锛夛紝浜岃�呬笉鑷唇銆�
- - 澶勭疆锛氶渶淇瘝鐗堣繖涓よ鐨勫叕寮忓紩鐢紙涓�娆℃�э級锛屼箣鍚庣敱閲嶇畻鑷姩鍑哄�笺�傛湰娆℃湭鏀规瘝鐗堛��
+3. **锛堝凡绾犳鐨勮鍒わ級"姣嶇増鍏紡寮曢敊椤�"涓嶆垚绔�**
+ - 涓婁竴杞粨璁鸿鍒ょ殑缁忚繃锛氭帶鍒跺彴閲屼腑鏂囦贡鐮侊紙`锟斤拷锟斤拷!`锛夛紝鎶� `=鍑虹!C13-鍑虹!C15` 褰撴垚 `=鍏氦!C13-鍏氦!C15`銆�
+ - 澶嶆牳缁撹锛堝啓鍏ユ枃浠跺悗鎸夊垪璇诲彇锛岄伩寮�涔辩爜锛夛細姣嶇増銆婁腑鍙ｅ緞鏄庣粏銆嬩笌鐙珛妯℃澘閮芥槸**姝ｇ‘鐨勫叕寮忛摼**鈥斺��
+ 鍩庡競绾у煄涔¤ = `=[1]鍑虹!C13-[1]鍑虹!C15` / `=[1]缃戠害杞�!C13-[1]缃戠害杞�!C15`锛堝彴璐﹂〉 鎬婚噺 鈭� 鍩庡競鍐咃級锛�
+ 鍏ㄧ渷琛� = `=C13+C18+鈥锛埼�17 甯傚窞锛夛紝鎬昏 = `=C6+C7+C8+C9`銆�
+ - 鍙嶅悜楠岃瘉锛氬彴璐﹂〉銆屾�婚噺 鈭� 鍩庡競鍐呫�嶆寜 17 甯傚窞姹傚拰 = **535.83 / 333.39**锛屼笌姣嶇増鍏ㄧ渷琛屽畾绋垮�煎畬鍏ㄤ竴鑷达紱
+ 姝︽眽 鍑虹/缃戠害杞﹀煄涔� = 0锛堣甯傚叏閮ㄤ负鍩庡競鍐咃級锛岄粍鐭� = 26.01 / 13.5998锛屼笌姣嶇増閫愰」涓�鑷淬��
+ - 鐪熸鐨勬牴鍥犲湪鎴戜滑鑷繁鐨勪唬鐮侊細搴撳唴鏃犳簮鏃舵妸妯℃澘鍏紡/缂撳瓨鍊兼竻绌猴紙瑙侀棶棰� 1 涓�"缂烘暟鎹鐞嗚鍒�"锛夈��
4. **锛堟暟鎹己鍙ｏ級2026 骞� 1-6 鏈堢綉绾﹁溅璁㈠崟鏈叆搴�**
- `wyc_order_monthly` 2026-01~06 浠呮湁 `pin_*`锛宍order_*` 鍏� NULL锛涙ā鏉挎枃浠朵篃鍙湁 2026-07 涓�琛屾湁鏁版嵁 鈫� 缁村害 4 鐨� 1-6 鏈堟棤婧愩��
@@ -74,4 +92,8 @@
鏈鏀瑰姩鎶娿�屼腑鍙ｅ緞銆嶄粠 2 缁达紙鐝嚎+鍏氦锛夌粺涓�涓� 4 缁达紝骞朵慨鎺変簡鐙珛銆婄敓鎴恄涓彛寰勬槑缁嗐�嬫墿鍒楁湀浠芥�昏涓虹┖銆佺疮璁″仠鍦ㄤ笂涓�鏈熺殑闂锛涘凡楠岃瘉 12 鏉＄敤渚嬶紙6 姝ｅ悜 / 3 鍥炲綊 / 3 璐熷悜杈圭晫锛夊叏閮ㄩ�氳繃锛屾眹鎬诲ぇ琛� 17 椤典笌銆婄敓鎴恄涓彛寰勬帓鍚嶃�嬮浂鍥炲綊銆�
-浠嶅緟澶勭悊锛氭帓鍚嶄欢涓庢槑缁嗕欢鐨勫彛寰勫綊涓�锛堥棶棰� 2锛岄渶涓氬姟/鏂规纭锛夈�佹瘝鐗堜腑鍙ｅ緞鏄庣粏鍩庡競绾у叕寮忓紩閿欓〉锛堥棶棰� 3锛夈�佺綉绾﹁溅 1-6 鏈堣鍗曟暟鎹己鍙ｏ紙闂 4锛夈��
+浠嶅緟澶勭悊锛氭帓鍚嶄欢涓庢槑缁嗕欢鐨勫彛寰勫綊涓�锛堥棶棰� 2锛岄渶涓氬姟/鏂规纭锛夈�佺綉绾﹁溅 2026-01~06 涓� 2025-01/09/10 璁㈠崟鏁版嵁缂哄彛锛堥棶棰� 4锛夈��
+
+**琛ヨ锛堝悓鏃ョ浜岃疆锛�**锛氭湰杞妸"缂烘暟鎹繚鐣欏畾绋垮�� + 鎬昏淇濈暀鍏紡 + 璺ㄧ翱瀹归敊閲嶇畻 + 鎶ヨ〃鏈熶箣鍚庢湀浠芥竻绌�"鍥涙潯骞惰繘锛�
+鐙珛銆婄敓鎴恄涓彛寰勬槑缁嗐�嬬幇鍦�**鏁磋〃鑷唇**锛�18 鍦板尯 脳 12 涓湀锛氭�昏 = 危4 缁淬�佺疮璁� = 危1-8 鏈堬紝涓嶄竴鑷存暟 0锛夛紝
+涓斾笌姹囨�诲ぇ琛ㄣ�屼腑鍙ｅ緞鏄庣粏銆嶉〉 1~8 鏈堥�愭牸涓�鑷达紙704 鏍� 0 宸紓锛夛紱姹囨�诲ぇ琛� 17 椤典笌鎺掑悕浠堕浂鍥炲綊銆�
--
Gitblit v1.9.1