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）
|
