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-17.md |   60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 60 insertions(+), 0 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_\346\212\225\350\265\204\346\234\210\346\212\245\346\240\274\345\274\217\346\216\242\346\265\213\344\270\216\345\255\227\346\256\265\346\230\240\345\260\204\350\241\250_2026-09-17.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_\346\212\225\350\265\204\346\234\210\346\212\245\346\240\274\345\274\217\346\216\242\346\265\213\344\270\216\345\255\227\346\256\265\346\230\240\345\260\204\350\241\250_2026-09-17.md"
index 9549ba4..bf06472 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_\346\212\225\350\265\204\346\234\210\346\212\245\346\240\274\345\274\217\346\216\242\346\265\213\344\270\216\345\255\227\346\256\265\346\230\240\345\260\204\350\241\250_2026-09-17.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_\346\212\225\350\265\204\346\234\210\346\212\245\346\240\274\345\274\217\346\216\242\346\265\213\344\270\216\345\255\227\346\256\265\346\230\240\345\260\204\350\241\250_2026-09-17.md"
@@ -47,3 +47,63 @@
 - 鎺㈡祴缁撹锛�27 涓簮鏂囦欢涓� 20 涓笌鐩爣鏄庣粏琛ㄥ垪浣嶅畬鍏ㄤ竴鑷达紝瑙f瀽椋庨櫓闆嗕腑鍦� 4 绫伙紙澶氬競宸炴贩鎺掋�佸伐浣滆〃鍚嶄笌瀹為檯鏈堜唤涓嶇銆佸垪浣嶅彸绉� 1 鍒椼�佸缓璁鹃樁娈�/褰㈣薄杩涘害鏈垎鍒楋級锛屽凡鍦ㄦ姤鍛婄鍥涜妭鎸夐珮/涓�/浣庡垎绾у苟缁欏嚭澶勭疆寤鸿銆�
 - 浠嶆湭闂幆锛堥渶涓氬姟纭锛岃鏄犲皠琛� Sheet6锛夛細姹囨�昏〃涓庝嚎鍏冩姇璧勯」鐩殑鏇存柊鍒椾笌闇�姹傛枃妗e垪鍑虹殑鎸囨爣瀵逛笉涓婏紱鎭╂柦/榛勭煶鐗╂祦銆屽缓璁鹃樁娈�/褰㈣薄杩涘害銆嶅悎骞跺垪鍙e緞锛�1 鏈堜笂骞村熀鏁板彇鍝竴鍒楋紱瀹㈣繍缂� 7 涓競宸炴枃浠剁殑澶勭悊鏂瑰紡銆�
 - 鏈疆鏈敼鍔ㄤ换浣曚笟鍔$▼搴忎唬鐮侊紙绗﹀悎鐢ㄦ埛銆屽厛涓嶆敼绋嬪簭銆嶇殑瑕佹眰锛夈��
+
+---
+
+## 鍏�佽ˉ鍏呬笌鏇存锛�2026-09-17 涓嬪崍 路 鐢ㄦ埛鏍稿婧愭枃浠跺悗锛�
+
+### 6.1 鑳屾櫙
+
+鐢ㄦ埛鎵撳紑婧愭枃浠堕�愯〃鏍稿鍚庡弽棣堛�屾垜鎶婅緭鍏ョ殑瀹㈣繍绔欏拰鐗╂祦鍥尯閮界湅浜嗭紝**娌℃湁浣犺鐨勬儏鍐�**銆嶃�傚鏍哥粨璁猴細**鐢ㄦ埛娌℃湁鐪嬮敊**鈥斺�旈偅浜涘唴瀹规槸琚�**闅愯棌**浜嗭紙闅愯棌琛� / 闅愯棌宸ヤ綔琛級锛孍xcel 榛樿涓嶆樉绀猴紝浣嗙▼搴忚鍗曞厓鏍兼椂璇诲緱鍒般�備负姝ゆ柊澧炲彧璇绘帰娴嬪伐鍏蜂笌娓呭崟锛屽苟璁㈡鏈姤鍛婄殑鎺緸銆�
+
+### 6.2 璁㈡锛堜繚鐣欏師璁板綍锛屽彧鏇存缁撹锛�
+
+| # | 鍘熸枃锛堜笉鍑嗙‘锛� | 鏇存鍚庯紙鍑嗙‘锛� |
+| --- | --- | --- |
+| 1 | 鍗佸牥鐗╂祦銆屽悓涓�宸ヤ綔琛ㄦ贩鍏ャ�庢姹夈�忓巻鍙插尯鍧椼�� | 鍗佸牥鐗╂祦绗� **11鈥�63 琛屾槸闅愯棌琛�**锛屽唴瀹规槸銆屾姹夈�嶅巻鍙插尯鍧楋紙2013鈥�2016 骞撮」鐩� + 灏忚/鍚堣锛夛紱绗� 64 琛屾墠鏄競宸炶銆屽崄鍫般�� |
+| 2 | 娼滄睙 / 鏋楀尯銆屽伐浣滆〃鍚嶄笌瀹為檯鏈堜唤涓嶇銆� | 娼滄睙 26/27 寮犺〃銆佹灄鍖� 26/45 寮犺〃琚�**闅愯棌**锛涘彲瑙佽〃鍙墿 1 寮狅紙娼滄睙锛�/ 19 寮狅紙鏋楀尯锛� |
+| 3 | 瑗勯槼瀹㈣繍銆屾暣琛ㄥ彸绉� 1 鍒椼�� | 鐢ㄦ埛鍙e緞锛�**涓嶅仛澶勭悊**锛涚▼搴忔寜琛ㄥご鏂囧瓧瀹氫綅鍒楋紝鍙彇鏈瑕佹洿鏂扮殑瀛楁 |
+| 4 | 鎭╂柦 / 榛勭煶鐗╂祦銆屽缓璁鹃樁娈典笌褰㈣薄杩涘害鏈垎鍒椼�� | 鐢ㄦ埛鍙e緞锛�**鍏跺疄宸插垎鍒楋紝鍙槸琛ㄥご娌″啓**锛涗笖鎴戞柟**涓嶆洿鏂般�屽缓璁鹃樁娈点�嶅垪** 鈫� 闂鍏抽棴 |
+| 5 | 榛勭煶鐗╂祦銆�8 涓」鐩涓湁 1 琛屾病鏈夊簭鍙凤紙閲戝北鍙g墿娴佸洯椤圭洰锛夈�� | 璇ヨ鏄�**闅愯棌琛� R10**锛屾纭悕绉颁负銆�**闃虫柊鍘跨劍灞辩墿娴佷粨鍌ㄤ腑蹇�**銆嶏紝涓�**蹇呴』鍙�**锛堝凡璁″叆榛勭煶甯傚窞鍚堣锛� |
+| 6 | **TC06 瀹為檯缁撴灉**銆屽崄鍫扮墿娴佷粎缁熻鍑� 38 琛岋紙鍚姹夊巻鍙插尯鍧楋級銆� | 杩欐槸**缂洪櫡涓嶆槸棰勬湡**锛氭湭鎸夊競宸炲垎娈碉紝浼氭妸 31 鏉℃姹夊巻鍙查」鐩畻杩涘崄鍫般�傚凡鍦ㄦ湰杞慨澶嶏紙瑙� TC13锛夛紝淇鍚庝负 **7 琛�** |
+
+### 6.3 鏈疆鏂板鐢ㄤ緥
+
+| 缂栧彿 | 鐢ㄤ緥锛堣緭鍏ワ級 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- |
+| TC12 | 鏂板鍙宸ュ叿 `闅愯棌椤规帰娴�.py --month 2026-07`锛屾壂鎻� 26 涓彲璇绘簮鏂囦欢锛堣闃冲杩� `.et` 璇讳笉浜嗭級 | 閫愭枃浠惰緭鍑猴細宸ヤ綔琛ㄦ�绘暟/鍙鏁�/闅愯棌鏁般�侀殣钘忚〃鍚嶄笌鍐呭銆侀殣钘忚鍖洪棿涓庡唴瀹广�侀殣钘忓垪 | 26/26 鏂囦欢杈撳嚭瀹屾暣锛涘懡涓� **15 涓枃浠跺惈闅愯棌椤�**锛涘崄鍫扮墿娴� R11鈥揜63锛�53 琛岋級銆侀粍鐭崇墿娴� R10銆佽崋宸炵墿娴� R10銆佸崄鍫板杩� R5 鍏ㄩ儴姝g‘鍒楀嚭 | 鉁� 閫氳繃 |
+| TC13 | `鏍煎紡鎺㈡祴.py` 鍔犲叆**甯傚窞鍒嗘**锛坄CITIES` + `city_segments()`锛夊悗鍏ㄩ噺澶嶈窇 | 鍗佸牥鐗╂祦鍙彇鍗佸牥娈� 7 涓」鐩锛涘叾浣欐枃浠剁粨鏋滀笉鍙� | 鍗佸牥鐗╂祦 `13~76(38琛�)` 鈫� **`70~76(7琛�)`**锛涗笌鏃х粨鏋滈�愭枃浠� diff锛屽叾浣� 26 涓枃浠� **闆跺彉鍖�**锛堟棤鍥炲綊锛� | 鉁� 閫氳繃 |
+| TC14 | 闅愯棌琛岃竟鐣岋紙"闅愯棌琛屼笉鑳藉綋杩囨护鏉′欢"锛夛細榛勭煶鐗╂祦 | 闅愯棌琛� R10 蹇呴』琚彇鍒帮紝椤圭洰琛屾暟 = 8 | 椤圭洰琛� 8锛堝惈 R10锛夛紱绗� 5 琛屻�岄粍鐭炽�嶅競宸炲悎璁� 璁″垝鎬绘姇璧� 564,991.69 / 鑷紑濮嬪缓璁剧疮璁� 59,500.20 / 鑷勾鍒濈疮璁� 34,978.15 / 鏈湀瀹屾垚 7,088.90 涓� 8 琛岄」鐩箣鍜�**閫愰」鐩哥瓑** | 鉁� 閫氳繃 |
+| TC15 | 闅愯棌椤规竻鍗曞彲琚汉宸ュ鐜� | 娓呭崟閲屾瘡鏉¢殣钘忛」锛岀敤鎴峰湪 Excel 閲屻�屽彇娑堥殣钘忋�嶅悗閮借兘鐪嬪埌 | 鍗佸牥鐗╂祦鍙栨秷闅愯棌 R11鈥揜63 鈫� 鍑虹幇 53 琛屾姹夊巻鍙查」鐩紱娼滄睙鍙栨秷闅愯棌 鈫� 鍑虹幇 26 寮� 2018鈥�2022 鍘嗗彶鏈堣〃 | 鉁� 閫氳繃锛堟搷浣滄楠よ娓呭崟绗簩鑺傦紝鐢ㄦ埛鍙嚜琛屽鐜帮級 |
+
+### 6.4 鏈疆浜у嚭
+
+- 鏂板 `docs\鎶曡祫\宸ュ叿\闅愯棌椤规帰娴�.py`锛堝彧璇伙紝涓嶄慨鏀规簮鏂囦欢锛�
+- 鏂板 `docs\鎶曡祫\杈撳嚭\闅愯棌鏁版嵁鏍稿疄娓呭崟_2026-07.md`銆乣闅愯棌椤规帰娴媉2026-07.md` / `.txt`
+- 淇敼 `docs\鎶曡祫\宸ュ叿\鏍煎紡鎺㈡祴.py`锛�+甯傚窞鍒嗘锛夛紱`鏍煎紡鎺㈡祴_2026-07.md` / `.tsv` 鍚屾鏇存柊
+- 淇敼 `docs\鎶曡祫\杈撳嚭\甯傚窞鏈堟姤鏍煎紡宸紓鎶ュ憡_2026-07.md`锛堣姝f帾杈炪�佹柊澧� H5 椋庨櫓椤广�佹柊澧炪�屼竷銆佹洿姝h褰曘�嶏級
+
+### 6.5 缁撹
+
+- TC01鈥揟C15 **鍏ㄩ儴閫氳繃**锛涙湰杞彂鐜� **1 涓彇鏁扮己闄�**锛堝崄鍫扮墿娴佹湭鎸夊競宸炲垎娈碉級骞跺凡淇锛屼慨澶嶅悗鏃犲洖褰掋��
+- 浠嶆湭闂幆锛�**鏄犲皠琛� xlsx 鐨勫悓姝ヨ姝e緟琛�**锛堟枃浠跺綋鏃惰 WPS 鍗犵敤锛屽瓨鍦� `~$` 閿佹枃浠讹紱璁㈡鑴氭湰 `_qa_out\patch_map.py` 宸插濂斤紝鍏抽棴鏂囦欢鍚庨噸璺戝嵆鍙級銆�
+- 鏈疆浠�**鏈敼鍔ㄤ换浣曚笟鍔$▼搴忎唬鐮�**銆�**鏈敼鍔ㄤ换浣曟簮鏂囦欢**銆�
+
+---
+
+## 涓冦�佽ˉ鍏咃紙2026-09-17 鍌嶆櫄 路 `.et` 鍙鎬� + 宸ヤ綔鍖烘枃浠舵牳瀵癸級
+
+| 缂栧彿 | 鐢ㄤ緥锛堣緭鍏ワ級 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- |
+| TC16 | `.et` 鍒板簳鑳戒笉鑳藉彧璇昏锛燂紙鍘熷垽鏂細xlrd/openpyxl 閮借涓嶄簡锛屽繀椤� Excel COM锛� | 缁撹鍙鐜� | 瀹炴祴鏂囦欢澶� = `D0CF11E0A1B11AE1`锛�**OLE2 澶嶅悎鏂囨。 / BIFF8**锛屽嵆 WPS 瀛樻垚鐨� BIFF8锛夛紝**`xlrd` 鑳芥甯告墦寮�**锛氳鍑� 7 寮犲垎鏈堣〃 `2026骞�1鏈坄鈥擿2026骞�7鏈� `锛屽昂瀵� 24脳20 / 26脳18銆傗啋 **鍘熷垽鏂槸閿欑殑**锛屽凡璁㈡ | 鉁� 閫氳繃锛堣姝o級 |
+| TC17 | 鍔犱笂 `.et` 鍚庯紝闅愯棌椤规帰娴嬬殑瑕嗙洊闈� | 27/27 涓簮鏂囦欢鍏ㄨ鐩� | `.et` 缁撴灉锛�7 寮犺〃**鍏ㄩ儴鍙**銆佹棤闅愯棌琛�/鍒楋紱闅愯棌椤规帰娴嬬敱 26 涓枃浠舵墿鍒� **27/27** | 鉁� 閫氳繃 |
+| TC18 | 宸ヤ綔鍖洪噷 4 涓樉绀恒�屽凡淇敼鏈彁浜ゃ�嶇殑鏂囦欢锛屾槸鍚︽湁鏁版嵁琚敼鍔� | 閫愬崟鍏冩牸姣斿鏃э紙HEAD锛変笌鏂� | **4 涓枃浠跺叏閮� 0 澶勫樊寮�**锛�<br>路 `2026骞�7鏈堢珯鍦哄浐鎶曪紙鍗楀北銆佹眽鍙g珯锛�.xlsx` 10脳15 鈫� 10脳15锛屽樊寮� 0<br>路 `瑗勯槼甯傗�︽姇璧� (1).et` 7 寮犺〃 閫愬紶宸紓 0<br>路 `妯℃澘_鍏ㄧ渷棰勫畨鎺掕鍒掕繘搴︽儏鍐垫眹鎬�.xls` 272脳28 鈫� 272脳28锛屽樊寮� 0<br>路 `妯℃澘_缁忔祹寮哄幙鎶曡祫缁熻鎶ヨ〃.xls` 45脳17 鈫� 45脳17锛屽樊寮� 0<br>瀛楄妭宸紓浠呮潵鑷� Excel/WPS 閲嶆柊淇濆瓨鐨勬牸寮忛噸鍐� | 鉁� 閫氳繃锛堟暟鎹棤椋庨櫓锛� |
+
+### 7.1 鏈疆浜у嚭澧為噺
+
+- 淇敼 `docs\鎶曡祫\宸ュ叿\鏍煎紡鎺㈡祴.py`锛堣姝� `.et` 鎽樿璇存槑锛夈�乣docs\鎶曡祫\宸ュ叿\闅愯棌椤规帰娴�.py`锛坄.et` 璧� xlrd锛�
+- 淇敼 `docs\鎶曡祫\杈撳嚭\甯傚窞鏈堟姤鏍煎紡宸紓鎶ュ憡_2026-07.md`锛堣闃� `.et` 璁㈡ + 鏇存璁板綍绗� 7 鏉★級
+- 淇敼 `docs\鎶曡祫\杈撳嚭\闅愯棌鏁版嵁鏍稿疄娓呭崟_2026-07.md`锛堣鐩� 27/27銆�3.4 鑺傛敼鍐欙級
+- 淇敼 `docs\鎶曡祫\杈撳嚭\瀛楁鏄犲皠琛╛鑽夋_2026-07.xlsx`锛圫heet1 A17銆丼heet3 O13/P13銆丼heet6 D6/E6锛�
+- 鏂板 `docs\鎶曡祫\杈撳嚭\寰呯‘璁ゆ竻鍗昣2026-09-17.md`锛堝嬀閫夌増锛�13 鏉★級
+

--
Gitblit v1.9.1