feat: 打包部署支持（一键打包脚本 + jar 内嵌前端 + jwt.secret 部署陷阱修复）

zhizhijie

2026-09-13 3434d8c72af1c946dcf8b3d0aa8ef0fd41896c37

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

@@ -33,6 +33,22 @@
- ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_汇总大表四页数据驱动_2026-09-13.md》写入 `docs/功能测试报告/`。
- æœ¬ã€Šå·¥ä½œæ—¥ç»“》。


### 7. æäº¤ä¸Žå‘布
- æäº¤ `ea7cc07`（`ReportExportService.java` + ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_汇总大表四页数据驱动_2026-09-13.md》 + æœ¬ã€Šå·¥ä½œæ—¥ç»“》，3 æ–‡ä»¶ +689 âˆ’2）已推送双仓库：`git push gitea main`（`09e612a..ea7cc07`）、`git push origin main:master`（`09e612a..ea7cc07`），并 `git branch -f master main`。
- æŽ¨é€å‰ `git fetch gitea` / `git fetch origin` å‡æ— æ–°æäº¤ï¼ˆ`rev-list --left-right --count` = `0 0`），未覆盖同事代码。
- å‘布后复跑 2026-08 å¯¼å‡ºï¼ˆHTTP 200 / 950,783 å­—节 / 29.2 ç§’），对发布后产物 `_t4_2026-08.xlsx` å†åš 586 æ ¼ç‹¬ç«‹å¤æ ¸ = å·®å¼‚ 0 æ ¼ï¼›ä¸Žå‘布前产物逐 zip æ¡ç›®æ¯”对，内部条目字节完全一致（MD5 å·®å¼‚仅来自 zip å¤´æ—¶é—´æˆ³ï¼‰ã€‚


### 8. æ‰“包部署支持（用户新需求：部署到另一台机器）
- æ–°å¢žä¸€é”®æ‰“包脚本 `package-deploy.py`：前端 `npm run build` â†’ `dist` å†…嵌进后端 jar（拷入 `resources/static`）→ `mvn clean package` â†’ æ¸…空 static â†’ ç»„装 `deploy/traffic-audit-deploy-YYYYMMDD/` â†’ åŽ‹ç¼© `traffic-audit-deploy-YYYYMMDD.zip`（本次 69.9 MB / 246 æ–‡ä»¶ï¼Œjar 55.5 MB）。
- éƒ¨ç½²åŒ…结构：`backend/`（jar + docs + application.yml + start-backend.cmd/.sh）、`frontend/`（dist + nginx ç¤ºä¾‹ï¼‰ã€`db/`（init.sql + sql_city_bus/taxi/wyc.sql）、README。
- **修复部署陷阱**：`jwt.secret` å¡«æˆéžæ³• Base64（如中文）会让登录接口 500（jjwt 0.9.1 æŒ‰ Base64 è§£ç  secret）→ `JwtUtils` æ–°å¢ž `secretKeyBytes()` å…œåº•ï¼ˆBase64 ä¼˜å…ˆã€å¦åˆ™ UTF-8 å­—节 + WARN）。
- æ›´æ­£ `docs/打包部署说明.md` ä¸‰å¤„不实：① ä¸éœ€è¦ Redis（pom æ— ä¾èµ–、代码未用）；② å‰ç«¯æ”¹ä¸ºå†…嵌进 jar（旧说明称「已内置 file:./web/」，实际 jar å†…无静态文件）；③ è¡¥ `sql_wyc.sql` ä¸Ž `summary.template-dir`。
- ç‹¬ç«‹éªŒè¯ï¼šæŠŠéƒ¨ç½²åŒ… backend æ‹·åˆ° `_deploytest/` ç”¨ 8091 ç«¯å£ç‹¬ç«‹å¯åŠ¨ â†’ å¯åŠ¨æˆåŠŸã€`GET /` 200 æœ‰ `#app`、静态 js 200、登录 200 æ‹¿åˆ° token、导出汇总大表 200 / 950,783 å­—节（与开发机产物同尺寸）；另测中文 secret å…œåº•è·¯å¾„同样 200。
- å¼€å‘机后端已按新代码重启（旧 PID 27840 å·²åœï¼‰ï¼Œé‡å¯åŽç™»å½• 200、导出 950,783 å­—节，无回归。
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_部署包打包与独立启动_2026-09-13.md`。

## äºŒã€æµ‹è¯•ç»“果摘要（详见《功能测试报告》）

| é¡¹ | ç»“æžœ |
@@ -47,8 +63,8 @@
## ä¸‰ã€é—留问题与待办

1. **中口径排名页「同比增速」列仍是母版旧值**：库中只有 2026 å¹´æ•°æ®ã€æ²¡æœ‰ 2025 å¹´ä¸­å£å¾„定稿数据，算不出 8 æœˆåŒæ¯”；等 2025 æ•°æ®å…¥åº“后自动刷新。
2. **网约车 8 æœˆè®¢å•æ•°ç–‘似未更新**：库中 `wyc_order_monthly` çš„ 2026-07 ä¸Ž 2026-08 `order_sum` éƒ½æ˜¯ 29,730,791（7、8 æœˆç›¸åŒï¼‰ï¼Œè¯·ç”¨æˆ·æ ¸å¯¹æ˜¯å¦é‡ä¼ è¿‡çœŸå®ž 8 æœˆè¿è¡Œç›‘测报告。
3. **根目录临时文件**：`_*.py` / `_*.sql` / `_*.xlsx` / `_*.txt` / `_bak_*.java` ç­‰ 100+ ä¸ªæœªè·Ÿè¸ªæ–‡ä»¶ï¼ˆç”¨æˆ·æœªåŒæ„å‰ä¸æ¸…理、不提交）。
2. **网约车 8 æœˆè®¢å•æ•°ä»æ˜¯ 7 æœˆå‰¯æœ¬**（已查证）：`wyc_order_monthly` çš„ 2026-08 è¡Œ `created_at=2026-09-11 16:35:10`，对应 `import_batch` **#317**、文件名 `_t_wyc_aug.docx`（09-11 è‡ªæµ‹æ—¶ç”¨ 7 æœˆæŠ¥å‘Šæ”¹æ ‡é¢˜çš„临时副本）；你真实的 `模板_网约车订单.docx` åªå¯¼å…¥è¿‡ 2026-07 æœŸï¼ˆ#314/#318/#319）。该行只有 4 ä¸ªå…¨çœ pin æ˜¯çœŸå®ž 8 æœˆæ•°æ®ï¼ˆæ¥è‡ªã€Šç½‘约车总数》#306），17 å¸‚州订单数与 7 æœˆå®Œå…¨ç›¸åŒã€‚**待用户重传真实 8 æœˆè¿è¡Œç›‘测报告（报表期 2026-08）覆盖。**
3. **根目录临时文件**（本次经用户同意删除自测副本 `_t_wyc_aug.docx`；其余 100+ ä¸ª `_*` ä¸´æ—¶æ–‡ä»¶æœªåŠ¨ï¼‰ï¼š`_*.py` / `_*.sql` / `_*.xlsx` / `_*.txt` / `_bak_*.java` ç­‰ 100+ ä¸ªæœªè·Ÿè¸ªæ–‡ä»¶ï¼ˆç”¨æˆ·æœªåŒæ„å‰ä¸æ¸…理、不提交）。
4. `docs/生成汇总大表/生成_道路运输量汇总表.xlsx`（版式参照件）与 `docs/生成汇总大表/输出/` ä¸‹çš„历史产物均为未跟踪文件，暂按惯例不纳入提交。
5. 2026-08 å¯¼å‡ºçš„「未找到同期备份母版」告警属无害提示，是否消除待用户定。