docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_ÃÜÔ¿Íⲿ»¯Óë´ò°üÈ¥ÃÜ_2026-09-26.md
@@ -72,3 +72,34 @@
| TC-12 | `traffic-audit-server/config/application.yml` | æ— æ˜Žæ–‡ | ä»…注释说明(值走环境变量) | é€šè¿‡ |
> è¯´æ˜Žï¼šçŽ¯å¢ƒå˜é‡æœ¬èº«ä»æ˜¯æœ¬æœºæ˜Žæ–‡ï¼ˆå­˜åœ¨æ³¨å†Œè¡¨ `HKCU\Environment`),适合单机开发;协作/生产请用部署机外部配置或密钥管理工具。轮换 key ä»æ˜¯æ ¹æ²»æ³„露的唯一手段。
## ä¸ƒã€ç¬¬ä¸‰è½®ï¼ˆ2026-09-27):模板入库 + ä¸€é”®æ‰“包 + æ¸…理旧包
1. **打包模板入库**:原先打包用的模板件(外部 `application.yml`、`start-backend.cmd/.sh`、`nginx.conf.example`、`README-部署说明.txt`、`db` çš„ 4 ä¸ªå»ºè¡¨è„šæœ¬ï¼‰åªå­˜åœ¨æœªè·Ÿè¸ªçš„æ—§éƒ¨ç½²åŒ…ç›®å½•é‡Œï¼Œåˆ åŒ…å³ä¸¢ã€ä¸”ä¸åœ¨ç‰ˆæœ¬åº“ã€‚
   çŽ°ç»Ÿä¸€æ¬åˆ° **`deploy-templates/`**(可提交、已入库),`pack-deploy.ps1` æ”¹ä¸ºä»Žè¯¥ç›®å½•组装。
2. **一键打包脚本 `pack-deploy.ps1`**:构建 jar â†’ **解压自检(占位符校验,命中真实密钥或明文口令即中止)** â†’ é‡å»ºå‰ç«¯ â†’ ç»„装完整部署包到 `E:\试验\traffic-audit-deploy-<yyyyMMdd>`。
3. **密钥更新脚本 `set-secrets.ps1`**:交互式更新 `DEEPSEEK_API_KEY` / `TRAFFIC_DB_PASSWORD` ç”¨æˆ·çŽ¯å¢ƒå˜é‡ï¼ˆå€¼ä¸è½æ–‡ä»¶ï¼‰ã€‚
4. **清理旧包**(用户确认后执行):
| åˆ é™¤å¯¹è±¡ | è¯´æ˜Ž |
| --- | --- |
| `E:\试验\traffic-audit-deploy-20260913`(246 æ–‡ä»¶ / 81.5 MB) | æ—§éƒ¨ç½²åŒ…目录(含带密钥 jar) |
| `E:\试验\traffic-audit-deploy-20260913.zip`(69.9 MB) | æ—§åŒ…压缩件(含带密钥 jar) |
| `deploy\traffic-audit-deploy-20260913`(245 æ–‡ä»¶ / 81.5 MB) | ä»“库内旧包副本 |
| `_deploytest`(201 æ–‡ä»¶ / 78.1 MB) | æ—§çš„部署测试目录 |
| `out`(空目录)、`deploy`(清空后的空目录) | æ— ç”¨ç©ºç›®å½• |
| `traffic-audit-server\target\*.jar`(旧) | è¢« `mvn clean` è¦†ç›–为新构建 |
> æ³¨ï¼šè¿™äº›ç›®å½•里的文件带只读属性,`Remove-Item -Force` è¢«çŽ¯å¢ƒç­–ç•¥æ‹¦æˆªï¼Œæ”¹ä¸º**先清属性再 `Remove-Item -Recurse`**。
### ç¬¬ä¸‰è½®éªŒè¯
| ç¼–号 | æ£€æŸ¥ | ç»“æžœ |
| --- | --- | --- |
| TC-13 | æ–°åŒ… `E:\试验\traffic-audit-deploy-20260927` | 336 æ–‡ä»¶ / 95.95 MB,含 backend(fresh jar+模板+docs)、frontend(dist+nginx ç¤ºä¾‹)、db、README |
| TC-14 | æ–° jar å†…置配置 | å…¨ä¸º `${...}` å ä½ç¬¦ï¼Œ`含 sk- æ˜Žæ–‡: False` |
| TC-15 | æ–°å‰ç«¯ dist | å«æœ€æ–°åŠŸèƒ½ï¼ˆ`rollupTypes` / ã€ŒæŒ‰å¸‚州汇总」) |
| TC-16 | å…¨ç›˜å¤æŸ¥ï¼ˆä»“库 + `E:\试验`) | å†…置配置带 key çš„ jar:**无**;压缩包含 key:**无**;文本含 key:**无** |
| TC-17 | ä¸€é”®æ‰“包脚本实跑 | è¾“出"[2/5] åŽ»å¯†è‡ªæ£€â€¦é€šè¿‡"并成功产出新包 |
> å”¯ä¸€ä»å¸¦æ˜Žæ–‡ key çš„地方是**用户环境变量**(设计如此,供本机开发用)与**已带出去/服务器上那份旧 jar**——后者需按第 4 èŠ‚è½®æ¢ key æ‰ç®—彻底。