docs(version): record v1.0.0 release package rebuild

xyc

2 天以前 93b36c8fb52102d72b3c56cfec7d274c1378dbcf

docs(version): record v1.0.0 release package rebuild

 HANDOFF.md

@@ -6,6 +6,15 @@

## 最新（2026-10-05）

### 10-05 上午：正式发布包按新版本管理重新生成（v1.0.0，单端口瘦包）

- **背景**：`8b71049` 已把打包脚本改为固定 jar 名 + 版本自检（`traffic-audit-server.jar`、包名带 `v{version}`），但正式发布包还没按新脚本重新生成；版本改造前产出的 `deploy/traffic-audit-deploy-20261005-2/` 仍是旧 jar 名 `traffic-audit-server-1.0.0-SNAPSHOT.jar`。
- **重新生成**：`powershell -NoProfile -ExecutionPolicy Bypass -File pack-deploy.ps1 -NoFrontendDist -SkipServiceWrapper`（后端 clean package 重建、前端 `npm run build` 重建）。
- **产物**：`deploy/traffic-audit-deploy-20261005-v1.0.0/`（351 文件 / 94.58 MB），zip **77.78 MB**。
- **校验**：去密自检 + 版本自检通过（pom / `app-version.properties` / `MANIFEST.MF` 三者均 `1.0.0`）；包内 `backend\traffic-audit-server.jar` 为固定名；无 `frontend/`、无 `trafficAudit.exe/.xml/install-service*`；`backend\web` 44 文件与 `frontend\dist` 逐文件 SHA-256 一致；`README-部署说明.txt` 头部为「20261005，版本 v1.0.0」并含旧服务器一次性升级说明。
- **启动冒烟（真实包、只读）**：用本地开发库配置在 8095 端口启动包内 jar，`GET /api/version` 返回 `{"version":"1.0.0",...}`，`GET /` 返回登录页 200；验证后已按 PID 58652 精确停止冒烟进程。
- **状态**：待用户上传服务器。`deploy/traffic-audit-deploy-20261005-2/`（及更早的 `20261005/`）作废勿用。旧服务器首次升级按 README：先改 `trafficAudit.xml` 的 `<arguments>` 为 `-Dfile.encoding=UTF-8 -jar "%BASE%\traffic-audit-server.jar"` 再换 jar，以后只替换 jar。

### 10-05：版本管理采用方案 A（固定 jar 名，用户验收通过）

- **用户决策**：采用方案 A。`traffic-audit-server/pom.xml` 为唯一版本源，当前对外版本 `1.0.0`。
@@ -14,7 +23,7 @@
- **发布链路**：服务 XML、启动脚本、打包脚本全部改用固定 jar 名；`pack-deploy.ps1` 会校验 pom / `app-version.properties` / `MANIFEST.MF` 三者版本一致，发布包名为 `traffic-audit-deploy-YYYYMMDD-v1.0.0(.zip)`，并输出带 `{version}` 的部署 README。
- **旧服务器首次升级（仅一次）**：停止服务后，把 `trafficAudit.xml` 的 `<arguments>` 改为 `-Dfile.encoding=UTF-8 -jar "%BASE%\traffic-audit-server.jar"`，替换 jar 后启动。以后发版只替换 jar 并重启，不再改 XML。
- **验证**：`mvn -o test`、`mvn -o clean package -DskipTests`、固定名 jar 实际启动并访问 `/api/version`、前端 `npm run build`、本地浏览器登录页显示 `V1.0.0`、`pack-deploy.ps1 -SkipFrontend -NoFrontendDist -SkipServiceWrapper` 组装/去密/版本自检全部通过；负向验证确认版本不匹配和 `SNAPSHOT` 都会在打包前中止。测试报告：本地 `docs/功能测试报告/功能测试报告_版本管理方案A_2026-10-05.md`（目录不入库）。
- **状态**：版本管理代码提交为 `8b71049`，`main` 已同步；`v1.0.0` 已推送到公司 Gitblit并指向 `21a5bf7`。2026-10-05 用户确认本地登录页及所有登录后页面均正确显示 `V1.0.0`。正式发布包尚未重新生成。
- **状态**：版本管理代码提交为 `8b71049`，`main` 已同步；`v1.0.0` 已推送到公司 Gitblit并指向 `21a5bf7`。2026-10-05 用户确认本地登录页及所有登录后页面均正确显示 `V1.0.0`。正式发布包已于 10-05 上午用新版打包脚本重新生成（见上方 10-05 上午一节）。

### 10-04 深夜：折线数值标签回到贴近本点（v35，待用户验收）

@@ -36,7 +45,7 @@
- **发布包**：`deploy/traffic-audit-deploy-20261005-2/`（351 文件 / 94.55 MB；zip **77.78 MB**）。已核对：无 `frontend/`、无 `trafficAudit.exe/.xml/install-service*`（服务包装器已排除）；`backend\web` 44 文件与 `frontend\dist` 逐文件哈希一致；jar 内置配置全占位符（去密自检通过）；包内 `HolidayTrendChartService.class` 与 `target/classes` 一致（含 v35 代码）。较上一完整包（110.49 MB / zip 83.77 MB）省约 16 MB 解压 / 6 MB 压缩。
- **作废**：`deploy/traffic-audit-deploy-20261005/`（错误语义下的产物，缺 `backend\web`）已被 `-2` 取代，勿用。
- **部署注意**：覆盖 jar（及按需 `application.yml`）即可；`backend\web` 已随包提供。服务已装，无需重新注册。
- **状态**：已打包，待用户上传到服务器。
- **状态**：已打包，待用户上传到服务器；该包为版本改造前产物，已由 10-05 上午的 `traffic-audit-deploy-20261005-v1.0.0` 取代（勿用）。

### 10-04 深夜：折线数值标签避开折线并贴近本线（v31，待用户验收）