docs: 关机前交接——运行状态、待验证项、外置配置要点

xyc

5 天以前 664cae654867b528ea339f187ebe290cb04d6fcf

 HANDOFF.md

@@ -3,11 +3,26 @@
> **用法**：新对话开始后，先读本文件 + 项目根目录 `AGENTS.md`，即可无缝接力。
> **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。

## 〇、关机交接（2026-08-27 深夜，用户关机前）
- **当前运行状态**：前后端应用服务全部已停止（开发服务、打包版均未运行）；仅数据库在跑
  （MySQL80 服务=3305，本项目用；MySQL57=3306 勿动）；8080 上 IIS 站点仍在但本项目已不再依赖 IIS。
- **进行中/待验证（用户负责）**：用户在**打包环境**验证数据库合并结果——用 `admin/admin123` 登录
  （行为验证码需人工点击，无法自动化验证）；若登录及各业务模块数据正常，则全流程闭环。
- **部署知识（本轮确认）**：外置 `application.yml` 与 jar 内置是**属性级合并**（外置只需写要覆盖的项，其余自动沿用内置），
  不是文件级替换；Spring Boot 按**启动工作目录**找配置（`file:./config/` > `classpath:/config/` > `file:./` > `classpath:/`），
  在 jar 同级执行 `java -jar app.jar` 即可命中外部配置；推荐放 `config\` 子目录。
- **待办（下次）**：`docs/打包部署说明.docx` 第六节"外置 application.yml 需包含完整配置"表述不准确，
  应改为"属性级合并，只需写要覆盖的项"；改后重新导出 docx 并推送。

## 一、当前状态（2026-08-27 合并后，打包部署已完成）
- **开发服务已停止**（前后端均未运行），打包版测试**验收通过**。
- **打包部署方案（已定稿）**：Spring Boot 直接托管前端静态文件，单端口 8090，**不需要 IIS/nginx**。
  部署结构 = jar 同级 `web\`（前端 dist 内容）+ `docs\`（模板目录）；`java -jar app.jar` 启动后访问 `http://<服务器>:8090`。
  说明文档：`docs/打包部署说明.md` / `.docx`（含 nginx 备选方案、IIS 反代示例 `docs/iis-web.config.example`）。
- **数据库已合并（2026-08-27 晚）**：同事 Navicat 全表导出 `traffic_audit.sql`（27 表、约 6 万行，来自其 mysql80:3308）已全量导入本机库（MySQL 8.0.29，localhost:3305，root/root）。
  导入前已备份本机库 → `D:\03_公司\02_项目\27_湖北省道路运输事业发展中心\05_开发测试\00_开发\_db_backup_20260827.sql`。
  `sys_user` 现有 4 账号（admin + zhangsan/lisi/wangwu，均带 modules）；admin 密码已恢复为 BCrypt（admin/admin123），其余账号密码为同事原 hash。
  ⚠️ **MySQL 客户端用 8.0**（`C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe`），不要用 5.7 客户端（`D:\mysql\mysql-5.7.41-winx64`）。
- 本次配套改动：`SecurityConfig` 放行静态资源（`/`、`/js/**` 等）+ `application.yml` 加
  `spring.web.resources.static-locations: file:./web/`（application.yml 不入库，重打包时需保留该配置）。
- **2026-08-27 完成双方开发结果合并**：以对方（郑玉洁，另一开发人员）的代码为基础，并入我方三样改动