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/打包部署说明.md |   68 ++++++++++++++++++++++++++++++----
 1 files changed, 60 insertions(+), 8 deletions(-)

diff --git "a/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.md" "b/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.md"
index 656d801..5d98f70 100644
--- "a/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.md"
+++ "b/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.md"
@@ -17,7 +17,7 @@
 | 缁勪欢 | 鐗堟湰 | 璇存槑 |
 |------|------|------|
 | JDK | 1.8 | 閮ㄧ讲鏈哄繀椤伙紱鍚庣缂栬瘧/杩愯 |
-| MySQL | 5.7 / 8.0 | 閮ㄧ讲鏈哄繀椤伙紝搴撳悕 `traffic_audit` |
+| MySQL | **8.0** | 閮ㄧ讲鏈哄繀椤伙紝搴撳悕 `traffic_audit`锛涚幇缃�/寮�鍙戞満涓� 8.0.29锛岃〃鎺掑簭瑙勫垯鏄� `utf8mb4_0900_ai_ci`锛�**鐩爣鏈鸿 5.7 浼氬鍏ュけ璐�** |
 | Maven 3.x / Node.js 14+ | 鈥� | **鍙湁銆屽湪閮ㄧ讲鏈轰笂鎵撳寘銆嶆墠闇�瑕�**锛涚敤涓�閿剼鏈骇鍑虹殑鍖呴儴缃插垯涓嶉渶瑕� |
 | Redis | **涓嶉渶瑕�** | 浠g爜鏈娇鐢� Redis锛堟棫璇存槑涓殑 Redis 閰嶇疆鏄仐鐣欓」锛屽彲蹇界暐锛� |
 | nginx / IIS | **涓嶉渶瑕�** | 鍓嶇宸插唴宓岃繘 jar锛岃闂� 8090 鍗冲彲锛涜鍓嶅悗绔垎绂绘椂鎵嶆槸澶囬�� |
@@ -69,17 +69,69 @@
 
 ## 浜斻�佺洰鏍囨満鍣ㄩ儴缃叉楠�
 
-### 5.1 鍒濆鍖栨暟鎹簱锛�4 涓剼鏈兘瑕佹墽琛岋級
+### 5.1 鍑嗗鏁版嵁搴擄紙涓ゆ潯璺嚎浜岄�変竴锛�**涓嶈娣风潃鍋�**锛�
+
+#### 璺嚎 A锛氬叏鏂扮┖搴擄紙瑕佽窇 4 涓剼鏈級
+
+`init.sql` 鑷甫 `CREATE DATABASE` 涓� `USE traffic_audit`锛屽彲鐙珛鎵ц锛涘彟澶� 3 涓剼鏈病鏈� `USE` 璇彞锛屽繀椤荤敤 `-D traffic_audit`锛堟垨 `mysql ... traffic_audit < 鏂囦欢`锛夋寚瀹氬簱锛�
 
 ```bash
-mysql --default-character-set=utf8mb4 -u root -p < db/init.sql
-mysql --default-character-set=utf8mb4 -u root -p traffic_audit < db/sql_city_bus.sql
-mysql --default-character-set=utf8mb4 -u root -p traffic_audit < db/sql_city_taxi.sql
-mysql --default-character-set=utf8mb4 -u root -p traffic_audit < db/sql_wyc.sql
+cd db
+mysql --default-character-set=utf8mb4 -u root -p            < init.sql          # 寤哄簱 + 24 寮犲熀纭�琛� + 棰勭疆璐﹀彿
+mysql --default-character-set=utf8mb4 -u root -p -D traffic_audit < sql_city_bus.sql
+mysql --default-character-set=utf8mb4 -u root -p -D traffic_audit < sql_city_taxi.sql
+mysql --default-character-set=utf8mb4 -u root -p -D traffic_audit < sql_wyc.sql
 ```
 
-- 棰勭疆璐﹀彿锛歚admin / admin123`锛堢櫥褰曞悗璇风珛鍗虫敼瀵嗙爜锛夈��
-- 鎯宠繛鏁版嵁涓�璧锋惉锛氬湪婧愭満鍣� `mysqldump -u root -p --databases traffic_audit > traffic_audit_full.sql`锛屽湪鐩爣鏈哄櫒 `mysql -u root -p < traffic_audit_full.sql`锛堜細瑕嗙洊棰勭疆璐﹀彿锛夈��
+> 鈿狅笍 **`init.sql` 鏄牬鍧忔�х殑**锛氶噷闈㈢殑鍩虹琛ㄩ兘甯� `DROP TABLE IF EXISTS`銆�**宸叉湁鏁版嵁鐨勫簱涓婂崈涓囦笉瑕佸啀璺� init.sql**锛屽惁鍒欒〃鏁版嵁浼氳娓呯┖閲嶅缓銆�
+> 4 涓剼鏈叡瑕嗙洊 29 寮犺〃锛坕nit.sql 24 寮� + 鍩庡競瀹㈣繍 3 寮� + 缃戠害杞� 2 寮狅級銆�
+
+#### 璺嚎 B锛氭妸鐜扮綉/寮�鍙戞満鐨勬暟鎹暣濂楁惉杩囧幓锛堟帹鑽愶紝涓嶇敤璺戣剼鏈級
+
+鍏堢‘璁や袱绔� MySQL 閮芥槸 **8.0**锛堟湰搴撹〃鎺掑簭瑙勫垯涓� `utf8mb4_0900_ai_ci`锛�5.7 涓嶈瘑鍒細瀵艰嚧瀵煎叆澶辫触锛夛紝骞朵笖**鐢ㄤ笌鏈嶅姟绔悓鐗堟湰鐨� mysqldump**锛堜笉瑕佺敤 5.7 鐨勫鎴风鍘诲 8.0 鏈嶅姟绔級銆�
+
+鍦ㄦ簮鏈哄櫒锛堟湰鏈� MySQL 绔彛绀轰緥 3308锛屾寜瀹為檯鏀癸級锛�
+
+```bash
+"C:\Program Files\MySQL\MySQL Server 8.0\bin\mysqldump.exe" ^
+  --host=127.0.0.1 --port=3308 --user=root --password=浣犵殑瀵嗙爜 ^
+  --default-character-set=utf8mb4 --single-transaction --routines --triggers --events ^
+  --databases traffic_audit > traffic_audit_full_YYYYMMDD.sql
+```
+
+鍦ㄧ洰鏍囨満鍣細
+
+```bash
+mysql --default-character-set=utf8mb4 -u root -p < traffic_audit_full_YYYYMMDD.sql
+```
+
+- `--databases` 浼氭妸 `CREATE DATABASE` + `USE` 涓�璧峰啓杩涘浠斤紝鎵�浠ョ洰鏍囨満鍣�**涓嶇敤鍏堝缓搴撱�佷篃涓嶇敤璺戦偅 4 涓剼鏈�**銆�
+- 澶囦唤閲屽寘鍚� `sys_user`锛岃处鍙峰瘑鐮佷笌婧愭満鍣ㄥ畬鍏ㄤ竴鑷达紙鏈満鏄� `admin / 123456`锛夛紝涓嶄細琚噸缃垚 `admin/admin123`銆�
+- 鈿狅笍 澶囦唤閲屾瘡寮犺〃閮藉甫 `DROP TABLE IF EXISTS`锛堝叡 29 寮狅級锛�**鐩爣搴撹鏄凡鏈夋暟鎹紝浼氳鐩存帴瑕嗙洊**銆傝杩樺師鍒扮┖搴擄紝鎴栧厛鑷繁澶囦唤鐩爣搴撱��
+- 鏈宸茬敓鎴愬苟**楠岃瘉杩�**澶囦唤锛歚traffic_audit_full_20260913.sql`锛�45.5 MB锛�8.0.29 瀹㈡埛绔鍑猴級銆�
+  楠岃瘉鏂瑰紡锛氭妸澶囦唤搴撳悕鏀规垚涓存椂搴撳鍏ワ紝閫愯〃姣斿 `SHOW CREATE TABLE`锛堣〃缁撴瀯锛変笌 `COUNT(*)`锛堣鏁帮級鈥斺��**29 寮犺〃缁撴瀯涓庤鏁板潎 0 宸紓**锛屾娊鏌� `wyc_order_monthly` 2026-08 鏁版嵁涓�鑷达紝楠岃瘉鍚庡凡鍒犻櫎涓存椂搴撱��
+
+#### 璺嚎 B2锛氱敤 Navicat 鐨勩�屽浠� / 杩樺師澶囦唤銆嶏紙.nb3锛屾渶璐磋繎鏃ュ父涔犳儻锛�
+
+`.nb3` 鏄� Navicat 绉佹湁澶囦唤鏍煎紡锛坱ar 瀹瑰櫒锛氭瘡寮犺〃涓�浠� meta.json + gz 鍘嬬缉鐨勬暟鎹垎鐗� + SHA1 鏍¢獙 + 鎬� meta.json锛夛紝
+鍙兘鐢� Navicat 鑷繁鐢熸垚銆佷篃鍙兘鍦� Navicat 閲岀敤銆岃繕鍘熷浠姐�嶈繕鍘熲�斺��**鐢� `.sql` 鐐广�岃繕鍘熷浠姐�嶄竴瀹氬け璐�**锛堥偅涓叆鍙e彧璁� .nb3锛夈��
+
+鍦ㄦ簮鏈哄櫒锛�30 绉掞級锛�
+
+1. Navicat 鈫� 杩炴帴 `mysql80` 鈫� 閫変腑 `traffic_audit` 鈫� 鍙抽敭 鈫掋�屽浠解�︺�嶁啋 璧蜂釜鍚嶅瓧 鈫� 纭畾锛岀瓑瀹冭窇瀹岋紱
+2. 鐢熸垚鐨勫浠芥枃浠跺湪 Navicat 鐨� profile 鐩綍锛歚D:\鏂囨。\Navicat\MySQL\Servers\mysql80\traffic_audit\<鏃堕棿鎴�>.nb3`
+   锛堟湰鏈� 8/27 閭d唤灏卞湪杩欓噷锛屼絾瀹�**宸茶繃鏈�**锛氬彧鏈� 27 寮犺〃銆佺己缃戠害杞︿袱寮犺〃銆佹暟鎹槸 8/27 鐨勶紝涓嶈鐢級銆�
+
+鍦ㄧ洰鏍囨満鍣細
+
+3. 鍏堝湪 Navicat 閲屽缓涓�涓繛鍒版湰鏈� MySQL 8.0 鐨勮繛鎺ワ紙**杩炴帴鍚嶅缓璁笌婧愭満鍣ㄤ竴鑷达紝姣斿 `mysql80`**锛夛紝骞舵柊寤虹┖搴� `traffic_audit`锛堝瓧绗﹂泦 utf8mb4锛夛紱
+4. 鎶� `.nb3` 鏀惧埌鐩爣鏈哄櫒鐨勫搴旂洰褰� `<Navicat profile>\MySQL\Servers\<杩炴帴鍚�>\traffic_audit\`锛堟病鏈夊氨鐓х潃寤虹洰褰曪級锛�
+5. 鍙抽敭璇ュ簱 鈫掋�岃繕鍘熷浠姐�嶁啋 鍦ㄩ�夋嫨鍒楄〃閲屽嬀閫夎繖浠藉浠� 鈫� 寮�濮嬶紙鍒楄〃閲岀湅涓嶅埌灏遍噸鍚竴娆� Navicat锛夈��
+
+> 涓夌鏂瑰紡锛堣矾绾� A 绌哄簱 4 鑴氭湰 / 璺嚎 B 鍛戒护琛岃繕鍘� .sql / 璺嚎 B2 Navicat .nb3锛�**浠婚�夊叾涓�**鍗冲彲锛�
+> 浣�**涓嶈鍙犲姞**锛氳繕鍘熷畬澶囦唤鍚庡啀璺� `init.sql` 浼氭妸鏁版嵁娓呯┖閲嶅缓銆�
+
+> 娉ㄦ剰锛歚docs/` 鐩綍锛堟姤琛ㄦā鏉裤�佹眹鎬诲ぇ琛ㄦ瘝鐗堬級**涓庢暟鎹簱鏃犲叧锛屾棤璁哄摢鏉¤矾绾块兘蹇呴』涓�骞舵嫹璐�**銆�
 
 ### 5.2 鏀归厤缃� `backend/application.yml`
 

--
Gitblit v1.9.1