From d25bfde3f5ebc9fd8402cc60a3e798f627d3f587 Mon Sep 17 00:00:00 2001
From: xyc <jc_xiong@hotmail.com>
Date: 星期四, 27 八月 2026 16:26:01 +0800
Subject: [PATCH] docs: 新增打包与部署说明（md + word 版，共享同事）

---
 docs/打包部署说明.docx |    0 
 docs/打包部署说明.md   |  157 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 157 insertions(+), 0 deletions(-)

diff --git "a/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.docx" "b/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.docx"
new file mode 100644
index 0000000..2f1ffbc
--- /dev/null
+++ "b/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.docx"
Binary files differ
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"
new file mode 100644
index 0000000..1c86f4f
--- /dev/null
+++ "b/docs/\346\211\223\345\214\205\351\203\250\347\275\262\350\257\264\346\230\216.md"
@@ -0,0 +1,157 @@
+# 浜ら�氱粺璁℃姤琛ㄥ鏍哥郴缁� 鈥� 鎵撳寘涓庨儴缃茶鏄�
+
+> 閫傜敤锛氬悎骞跺悗 main 鍒嗘敮锛�2026-08-27 璧凤級銆傚悗绔� Spring Boot 2.7锛圝ava 8锛夛紝鍓嶇 Vue 2 + Element UI銆�
+> 鏈枃妗ｉ潰鍚戝紑鍙戜笌閮ㄧ讲鍚屼簨锛屽懡浠ゅ潎鍦� Windows 涓嬮獙璇併��
+
+## 涓�銆侀」鐩粨鏋�
+
+| 鐩綍 | 璇存槑 |
+|------|------|
+| `traffic-audit-server` | 鍚庣锛圫pring Boot锛孞ava 8锛岀鍙� 8090锛屾帴鍙ｅ叏閮ㄥ湪 `/api/**`锛� |
+| `traffic-audit-web` | 鍓嶇锛圴ue 2 + Element UI锛屽紑鍙戠鍙� 8080锛宍/api` 浠ｇ悊鍒� 8090锛� |
+| `docs` | 杩愯鏁版嵁鐩綍锛堟姤琛� Word/Excel 妯℃澘 + 鐩綍瀵煎叆鏁版嵁锛夛紝**鍙戝竷蹇呴』甯︿笂** |
+| `docs/init.sql` | 鏁版嵁搴撳垵濮嬪寲鑴氭湰锛堝缓搴撳缓琛� + 鍒濆璐﹀彿锛� |
+
+## 浜屻�佺幆澧冭姹�
+
+| 缁勪欢 | 鐗堟湰 | 鐢ㄩ�� |
+|------|------|------|
+| JDK | 1.8 | 鍚庣缂栬瘧涓庤繍琛� |
+| Maven | 3.x | 鍚庣鎵撳寘 |
+| Node.js | 14+ | 鍓嶇鎵撳寘锛坴ue-cli 4.5锛� |
+| MySQL | 8.0 | 鏁版嵁搴擄紙搴撳悕 `traffic_audit`锛� |
+
+## 涓夈�佹暟鎹簱鍒濆鍖�
+
+鍏堟墽琛屽缓搴撳缓琛ㄨ剼鏈紝鍐嶆寜闇�瀵煎叆鍩庡競瀹㈣繍鏁版嵁锛�
+
+```bash
+mysql --default-character-set=utf8mb4 -h <涓绘満> -P 3306 -u root -p < docs/init.sql
+mysql --default-character-set=utf8mb4 -h <涓绘満> -P 3306 -u root -p traffic_audit < docs/sql_city_bus.sql
+mysql --default-character-set=utf8mb4 -h <涓绘満> -P 3306 -u root -p traffic_audit < docs/sql_city_taxi.sql
+```
+
+- `init.sql` 浼氶噸寤� `traffic_audit` 搴撳苟棰勭疆鍒濆璐﹀彿锛歚admin / admin123`锛堢敓浜х幆澧冭鐧诲綍鍚庢敼瀵嗙爜锛�
+- `sql_city_bus.sql`銆乣sql_city_taxi.sql` 涓哄煄甯傚杩愶紙鍏氦/鍑虹锛夌ず渚嬫暟鎹紝鎸夐渶瀵煎叆
+
+## 鍥涖�佹墦鍖�
+
+### 4.1 鍚庣锛堥」鐩牴鐩綍鎵ц锛�
+
+```powershell
+cmd /c "mvn -q clean package -DskipTests -f traffic-audit-server\pom.xml"
+```
+
+浜х墿锛歚traffic-audit-server\target\traffic-audit-server-1.0.0-SNAPSHOT.jar`锛堝彲鎵ц fat jar锛岀害 57MB锛夈��
+
+### 4.2 鍓嶇锛坄traffic-audit-web` 鐩綍鎵ц锛�
+
+```powershell
+cd traffic-audit-web
+npm run build
+```
+
+浜х墿锛歚traffic-audit-web\dist\`锛坄index.html` + `css/js/fonts`锛岀函闈欐�佹枃浠讹級銆�
+
+## 浜斻�侀儴缃茬洰褰曠粨鏋勶紙鎺ㄨ崘锛�
+
+```
+deploy\
+鈹溾攢 app.jar                    # 鍚庣 jar锛堝彲鏀瑰悕锛�
+鈹溾攢 docs\                      # 蹇呴』锛氭ā鏉夸笌鐩綍瀵煎叆鏁版嵁鐩綍
+鈹�  鈹溾攢 鍩庡競瀹㈣繍\
+鈹�  鈹溾攢 鍏矾鏃呭\
+鈹�  鈹溾攢 璐ц繍\
+鈹�  鈹溾攢 鑳借�梊
+鈹�  鈹溾攢 鎶曡祫\
+鈹�  鈹�  鈹斺攢 妯℃澘\
+鈹�  鈹斺攢 (6鏈圽 7鏈圽 绛夊鍏ユ暟鎹洰褰曪紝鎸夐渶)
+鈹斺攢 web\                       # 鍓嶇 dist 鐨勫唴瀹�
+   鈹溾攢 index.html
+   鈹溾攢 css\  js\  fonts\
+```
+
+鍏抽敭鐐癸細
+
+- **`docs` 蹇呴』鏀惧湪 jar 鍚岀骇**銆傚悗绔繍琛屾椂鎸夊惎鍔ㄧ洰褰曞悜涓婃煡鎵� `docs`锛堟姤琛ㄥ鍑虹殑 Word 妯℃澘銆佸鍏ラ〉銆屼笅杞芥ā鏉裤�嶃�佺洰褰曞鍏ユ暟鎹兘浠庤繖閲岃锛夛紝鎵句笉鍒颁細鎶ャ�屾湭鎵惧埌鏁版嵁鐩綍 docs銆嶆垨銆屾湭鎵惧埌妯℃澘鏂囦欢 xxx銆嶃��
+- 棣栨閮ㄧ讲鐩存帴鎶婇」鐩噷鐨勬暣涓� `docs` 鎷疯繃鍘绘渶绋冲Ε锛涘悗缁彲绮剧畝锛堝彧鐣欐ā鏉垮瓙鐩綍锛夛紝璇﹁銆屽父瑙侀棶棰樸�嶃��
+- `application.yml` 鎵撳寘鍦� jar 鍐咃紱閮ㄧ讲鏈洪渶瑕佹敼閰嶇疆鏃讹紝鍙湪 jar 鍚岀骇鏀句竴涓缃� `application.yml`锛堝缃紭鍏堢骇楂樹簬鍐呯疆锛夛紝鎴栨敼瀹屽啀鎵撳寘銆�
+
+## 鍏�佸叧閿厤缃紙application.yml锛�
+
+| 閰嶇疆椤� | 璇存槑 |
+|--------|------|
+| `spring.datasource.url/username/password` | 鏁版嵁搴撹繛鎺ワ紙妯℃澘榛樿 `localhost:3305/root/root`锛岄儴缃叉満**蹇呴』鏀�**锛涚敓浜у缓璁敤鐜鍙橀噺 `MYSQL_PASSWORD` 娉ㄥ叆锛� |
+| `deepseek.api-key` | AI 鍒嗘瀽鎺ュ彛瀵嗛挜锛堢幆澧冨彉閲� `DEEPSEEK_API_KEY`锛屼笉浣跨敤 AI 鍒嗘瀽鍙暀绌猴級 |
+| `jwt.secret` | 鐧诲綍浠ょ墝瀵嗛挜锛堢敓浜у繀椤绘敼锛岀幆澧冨彉閲� `JWT_SECRET`锛� |
+| `docs.template-root` | 瀵煎叆妯℃澘涓嬭浇鏍圭洰褰曪紙榛樿 `docs`锛� |
+| `city-passenger.template-dir` | 鍩庡競瀹㈣繍鎶ヨ〃妯℃澘鐩綍锛堥粯璁� `docs/鍩庡競瀹㈣繍`锛� |
+| `passenger.template-dir` | 鍏矾鏃呭鎶ヨ〃妯℃澘鐩綍锛堥粯璁� `docs/鍏矾鏃呭`锛� |
+| `freight.template-dir` | 璐ц繍鎶ヨ〃妯℃澘鐩綍锛堥粯璁� `docs/璐ц繍`锛� |
+| `energy.template-dir` | 鑳借�楁姤琛ㄦā鏉跨洰褰曪紙榛樿 `docs/鑳借�梎锛� |
+| `investment.template-dir` | 鎶曡祫鎶ヨ〃妯℃澘鐩綍锛堥粯璁� `docs/鎶曡祫/妯℃澘`锛� |
+
+> 娉ㄦ剰锛氫粨搴撳彧鎻愪氦鍗犱綅妯℃澘 `application.yml.example`锛岀湡瀹� `application.yml` 涓嶅叆搴撱��
+
+## 涓冦�佸惎鍔ㄥ悗绔�
+
+```powershell
+cd deploy
+java -jar app.jar
+```
+
+- 鎴愬姛鏍囧織锛氭棩蹇楀嚭鐜� `Started TrafficAuditApplication` 鍜� `Tomcat started on port(s): 8090`銆�
+- 鍦� `deploy` 鐩綍涓嬪惎鍔ㄥ嵆鍙懡涓悓绾х殑 `docs`銆�
+
+## 鍏�佸墠绔儴缃诧紙nginx 绀轰緥锛�
+
+`dist` 鏄函闈欐�佹枃浠讹紝闇�瑕� Web 鏈嶅姟鍣ㄦ墭绠★紱鍓嶇鎺ュ彛璧扮浉瀵硅矾寰� `/api`锛�**蹇呴』鍙嶄唬鍒板悗绔� 8090**锛�
+
+```nginx
+server {
+    listen 80;
+    server_name _;
+    root D:/deploy/web;            # 鍓嶇 dist 鐩綍
+    index index.html;
+
+    location / {
+        try_files $uri $uri/ /index.html;   # 璺敱涓� hash 妯″紡锛屾琛屼繚鐣欎互闃插悗缁敼 history
+    }
+
+    location /api {
+        proxy_pass http://127.0.0.1:8090;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+
+    client_max_body_size 100m;     # 涓婁紶 Excel 闇�瑕侊紝涓庡悗绔� multipart 100MB 瀵归綈
+}
+```
+
+## 涔濄�侀儴缃插悗楠岃瘉
+
+1. 娴忚鍣ㄦ墦寮� `http://<鏈嶅姟鍣�>/`锛�
+2. 鐢� `admin / admin123` 鐧诲綍锛堢敓浜ф敼瀵嗗悗浣跨敤鏂板瘑鐮侊級锛�
+3. 鏁版嵁瀵煎叆锛氫笅杞芥ā鏉� 鈫� 涓婁紶 Excel锛堟垨鐩綍瀵煎叆锛夛紱
+4. 鎶ヨ〃锛氭煡璇� 鈫� 棰勮/瀵煎嚭锛堜緷璧� `docs` 妯℃澘鏂囦欢锛夛紱
+5. AI 鍒嗘瀽锛氶渶閰嶇疆 `deepseek.api-key` 鍚庡彲鐢ㄣ��
+
+## 鍗併�佸父瑙侀棶棰�
+
+| 鐜拌薄 | 鍘熷洜 / 澶勭悊 |
+|------|------------|
+| 鍚姩鎶ャ�屾湭鎵惧埌鏁版嵁鐩綍 docs銆� | 褰撳墠杩愯鐩綍涓嶅锛涙妸 `docs` 鏀惧埌 jar 鍚岀骇鍐嶅惎鍔� |
+| 瀵煎嚭鎶ャ�屾湭鎵惧埌妯℃澘鏂囦欢 xxx銆� | `docs` 瀵瑰簲瀛愮洰褰曠己妯℃澘鏂囦欢锛涢娆￠儴缃叉嫹鏁翠釜 `docs` |
+| 椤甸潰鑳藉紑浣嗘帴鍙� 502/404 | nginx 娌￠厤 `/api` 鍙嶄唬锛屾垨鍚庣娌″惎鍔ㄦ垚鍔� |
+| 鏁版嵁搴撹繛鎺ュけ璐� | 妫�鏌� `application.yml` 鍦板潃/璐﹀彿/瀵嗙爜锛涘厛鎵ц `init.sql` |
+| 涓婁紶澶ф枃浠跺け璐� | 妫�鏌� nginx `client_max_body_size` 涓庡悗绔� multipart 闄愬埗 |
+| 绔彛鍗犵敤 | 鍚庣 8090銆佸墠绔� 80/8080 |
+
+## 鍗佷竴銆佸紑鍙戠幆澧冩棩甯稿惎鍔�
+
+椤圭洰鏍圭洰褰曡繍琛屼竴閿剼鏈紙鑷姩鎷夎捣鍚庣 8090 + 鍓嶇 8080锛夛細
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1
+```
\ No newline at end of file

--
Gitblit v1.9.1