TrafficAudit 交通货运统计审核系统 —— 部署包（{stamp}）
========================================================

【目录结构】
  backend/
    traffic-audit-server-1.0.0-SNAPSHOT.jar  后端程序（含全部依赖，**已内嵌前端**）
    docs/                                    报表模板与运行数据目录（必需，勿删）
    application.yml                          外部配置（改这里即可，无需重新打包）
    start-backend.cmd / start-backend.sh     启动脚本
  frontend/
    dist/                                    前端构建产物（备用：想用 nginx 托管时用）
    nginx.conf.example                       nginx 配置示例
  db/
    init.sql                                 建库建表 + 预置账号（必须执行）
    sql_city_bus.sql                         城市客运-公交月度表（必须执行）
    sql_city_taxi.sql                        城市客运-出租月度表/出租授权表（必须执行）
    sql_wyc.sql                              网约车全省总量表/订单分市州表（必须执行）
  README-部署说明.txt

【部署机环境要求】
  JDK 8（必需）
  MySQL 5.7 / 8.0（必需）
  **不需要 Redis**（代码未使用；旧版说明里的 Redis 是遗留配置，可忽略）
  **不需要 nginx**（前端已内嵌进 jar，访问 8090 即可；nginx 仅为备选方案）

【部署步骤】
  1. 初始化数据库（4 个脚本都要执行，顺序如下）
       mysql --default-character-set=utf8mb4 -u root -p < db/init.sql
       mysql --default-character-set=utf8mb4 -u root -p traffic_audit < db/sql_city_bus.sql
       mysql --default-character-set=utf8mb4 -u root -p traffic_audit < db/sql_city_taxi.sql
       mysql --default-character-set=utf8mb4 -u root -p traffic_audit < db/sql_wyc.sql
     预置账号：admin / admin123（首次登录后请改密码）

  2. 改配置 backend/application.yml
     - spring.datasource.url / username / password ：改成部署机的 MySQL（默认端口 3306）
     - jwt.secret ：改成一串随机字符串（**必须是 Base64 合法字符且长度是 4 的倍数**，如 32 位十六进制；填中文会登录失败）
     - deepseek.api-key ：需要 AI 分析时填，不需要可留空
     注：application.yml 与 jar 同级即生效，不用重新打包。

  3. 启动后端（在 backend 目录下）
     Windows：双击 start-backend.cmd
     Linux：  sh start-backend.sh
     成功标志：出现 "Started TrafficAuditApplication" 与 "Tomcat started on port(s): 8090"

  4. 访问系统
     浏览器打开 http://<部署机IP>:8090  （前端已内嵌，页面与接口同源）
     账号：admin / admin123

【数据迁移（可选）】
  想把本机数据一并搬到新机器，用 mysqldump（本机 MySQL 若不在 3306，按实际端口改）：
     mysqldump -h 127.0.0.1 -P 3306 -u root -p --databases traffic_audit > traffic_audit_full.sql
  再在新机器执行：
     mysql -u root -p < traffic_audit_full.sql
  注意：全量 dump 会带上本机的账号密码，覆盖 init.sql 预置的 admin 账号。

【常见问题】
  1. 启动报「未找到数据目录 docs」/ 导出报「未找到模板文件」：
     必须在 backend 目录下启动（jar 与 docs 同级），不要只拷 jar。
  2. 报表导出报「未找到汇总表母版《YYYY年M月道路运输量汇总表.xlsx》」：
     docs/生成汇总大表 下缺少该月份母版；把源机器的该文件拷过去。
  3. 8090 端口被占用：改 application.yml 的 server.port 后重启。
  4. 页面打开是空白：确认访问的是 http://<IP>:8090 根路径，且浏览器强制刷新（Ctrl+F5）。
  5. 上传大文件失败：后端限制 100MB，已配置；如前面还挂了 nginx，需同步放大 client_max_body_size。

【停止服务】
  Windows：关闭 start-backend.cmd 窗口
  Linux：  Ctrl+C，或 kill 对应 java 进程（ps -ef | grep java）