| | |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | > **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。 |
|---|
| | | |
|---|
| | | ## 最新（2026-10-04） |
|---|
| | | ## 最新（2026-10-05） |
|---|
| | | |
|---|
| | | ### 10-05：版本管理采用方案 A（固定 jar 名，已完成并通过测试） |
|---|
| | | |
|---|
| | | - **用户决策**：采用方案 A。`traffic-audit-server/pom.xml` 为唯一版本源，当前对外版本 `1.0.0`。 |
|---|
| | | - **构建改造**：`<finalName>traffic-audit-server</finalName>`，产物固定为 `target/traffic-audit-server.jar`；Maven 资源过滤生成 `app-version.properties`（Spring Boot 父 POM 使用 `@project.version@` 分隔符），`maven-jar-plugin` 写入 `Implementation-Version`。 |
|---|
| | | - **页面显示**：新增免登录 `GET /api/version`；登录页和页头显示 `V1.0.0`。同时修复可执行 jar 下 `buildTime` 为 `null` 的嵌套 URI 解析问题。 |
|---|
| | | - **发布链路**：服务 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`（目录不入库）。 |
|---|
| | | - **状态**：已提交并推送 main（`21a5bf7`）；`v1.0.0` 已推送到公司 Gitblit（提交 `21a5bf7`）。正式发布包尚未重新生成。 |
|---|
| | | |
|---|
| | | ### 10-04 深夜：折线数值标签回到贴近本点（v35，待用户验收） |
|---|
| | | |
|---|
| | | - **用户反馈**：v31「避开折线」版本不如上一版 v27 —— 虽然标签不压线了，但很多标签离自己的数据点太远，一眼看不出标的是哪个点。要求回到贴近本点的效果。 |
|---|
| | |
|---|
| | | - **其余验证**：`mvn compile`/`mvn test` 通过（无编译告警遗留）；Word COM 8 页 15 图（1+2×7）；RapidOCR 复检 12 张折线图数值标签包围框重叠数 = 0；`label_affinity` 复检图 11 每个数据标签到本线 3~8px 且本线是最近线（无「CLOSER TO 其他色」）；放大 6× 复核图 11 左上标签确为 `630.99`（低分辨率 OCR 曾误读为 `1630.99`）。v27↔v35 像素差约 1%，集中在标签处，即白描边生效且未破坏折线。 |
|---|
| | | - **产物与状态**：`_tmp_holiday_verify/holiday_trend_2026-10-04_v35.docx`；下载副本 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-数字贴近折线-白边清晰）.docx`。未导入、覆盖或重导任何数据。待用户验收；验收前不提交、不推送；现有 `deploy/traffic-audit-deploy-20261004.zip` 仍是 v24 行为，验收后需重建。 |
|---|
| | | |
|---|
| | | ### 10-05：走势图 v35 验收通过 + 单端口发布包（-NoFrontendDist -SkipServiceWrapper） |
|---|
| | | |
|---|
| | | - **验收**：v35（折线数值标签回到贴近本点 + 白描边）2026-10-05 用户验收通过。 |
|---|
| | | - **打包需求（用户澄清）**：服务器单端口，只需要 `backend\web`，不要独立的 `frontend/dist`；为保证包完整，`backend\web` + jar + docs 都要。服务器非首次发布、服务已装，可加 `-SkipServiceWrapper` 去掉服务注册器。 |
|---|
| | | - **打包工具修正**：先前加的 `-NoFrontend` 语义错了（把 `backend\web` 也去掉了），现改为 `-NoFrontendDist`。它只跳过独立 `frontend\` 目录（不复制 dist / nginx 示例），**仍构建（或要求）dist 并同步 `backend\web`**（单端口必需，否则页面 404）。`-SkipFrontend` 仍为“不重建、复用现有 dist”。 |
|---|
| | | - **发布包**：`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-04 深夜：折线数值标签避开折线并贴近本线（v31，待用户验收） |
|---|
| | | |
|---|
| | | - **用户反馈（领导看后，两轮）**：① 各年份数字离本线有远有近，希望贴近各自色线且不错乱；② 仍有数字压在折线上看不清（第一轮只是“贴近”，标签会落在线上）。用户建议：调纵轴刻度拉开折线、或加左右避让让标签不压线。 |
|---|
