交通统计审核
编辑 | blame | 历史 | 原始文档

交通统计报表审核系统 - Demo 说明

Demo 范围：交企统H203-2表（道路货物运输月度生产情况）
需求文档：货运简化.docx、database.md、architecture.md；数据库脚本：init.sql

一、环境要求

组件 要求
JDK 1.8
Maven 3.x
Node.js 14+（Vue CLI）
MySQL 5.7（本机 localhost:3305，账号 root/root）

二、初始化数据库

mysql --default-character-set=utf8mb4 -h localhost -P 3305 -u root -proot < docs/init.sql

init.sql 会重建 traffic_audit 库（含旧版表清理），并预置：
- 部门：湖北省交通运输厅
- 角色：三员 + 省厅业务员
- 账号：admin / admin123
- 6 条审核规则（RULE_001 ~ RULE_006）

三、启动后端

# 方式一：直接运行
mvn spring-boot:run -f traffic-audit-server/pom.xml

# 方式二：后台运行（日志写入 backend.log，已提供脚本）
run-backend.cmd
  • 端口：8090
  • 接口前缀：/api/**（当前为 permitAll，便于 Demo）

四、启动前端

cd traffic-audit-web
npm install
npm run serve
  • 端口：8080
  • 登录：admin / admin123（输入用户名密码后回车即可登录）

五、Demo 操作流程

  1. 登录系统，进入「数据导入」页，先选**报表期**（页面上选择的月份 N 决定模板左半读取 1-N 月），再按顺序导入 docs/ 下 5 个模板：
  • 模板_交企统H203-2表_道路货物运输月度生产情况.xlsx → 报表期 2026-06
  • 模板_运政车辆.xlsx → 无需报表期
  • 模板_轨迹里程.xlsx → 报表期 2026-06
  • 模板_规上规下拆分运输量.xlsx → 报表期 2026-06
  • 模板_货运量周转量.xlsx → 报表期 2026-06（左半 1-6 月今年、右半 1-12 月去年）
  1. 进入「数据审核」页，选择报表期，点「执行审核」，查看问题列表，可逐条「确认/忽略」。
  2. 进入「报表生成」页，选择报表期，下载 3 张报表：
  • 生成_货运量分市州明细.xlsx（1-N 月明细 + 同比 + 累计）
  • 生成_货运量排名.xlsx（规上/规下/合计累计排名）
  • 生成_周转量排名.xlsx（规上/规下/合计累计排名）

六、主要接口

接口 说明
POST /api/import/h2032 导入 H203-2 月报（file + period）
POST /api/import/transportAuth 导入运政车辆（file）
POST /api/import/trackMileage 导入轨迹里程（file + period）
POST /api/import/scaleSplit 导入规上规下拆分（file + period）
POST /api/import/freightTurnover 导入模板_货运量周转量（file + period）
POST /api/audit/execute?period= 执行审核
GET /api/audit/results?period= 查询审核结果
POST /api/audit/review 审核确认/忽略（id + status + comment）
GET /api/report/export/cityDetail?period= 生成_货运量分市州明细
GET /api/report/export/freightRank?period= 生成_货运量排名
GET /api/report/export/turnoverRank?period= 生成_周转量排名

七、数据与公式说明

  • 导入采用**幂等覆盖**：同报表期重新导入会先删除旧数据。
  • 模板_货运量周转量（每月导入）：
  • 左半 = 今年 1-N 月（N = 页面选择的报表期月份，不固定；以页面为准，不看 Excel 里月份文字）；
  • 右半 = 去年 1-12 月（固定，算同比用）；
  • 累计 = 1-N 月之和；同比 =（今年累计 − 去年 1-N 月累计）/ 去年 1-N 月累计。
  • 货运量口径：合计 = 模板（规上 + 规下）；规上 = H203-2 按 17 市州汇总（6 位区划代码映射见 各市州所属组织机构.xlsx）；规下 = 合计 − 规上。
  • 周转量口径：全部来自规上规下拆分表（用户手动上传，全省行忠实导入不求和）。
  • 6 条审核规则：
  1. RULE_001 车辆数运政对比（差距 > 5 台）
  2. RULE_002 吨位运政对比（差距 > 50 吨）
  3. RULE_003 周转量轨迹对比（上报 / 轨迹测算 > 1.3）
  4. RULE_004 货运类型环比（本月新增货类）
  5. RULE_005 集装箱异常（无集装箱车但有集装箱货运量）
  6. RULE_006 整车吨位范围（不在 4-40 吨之间）
  • 轨迹测算周转量 = 轨迹里程 / 轨迹车辆数 ×（牵引车数 × 31 + 整车吨位），其中整车吨位 = 运政其它车辆总吨位 / 其它车辆数。
  • 报表中部分月份为空属正常：当前演示数据只覆盖 2026-06（H2032/拆分表单月），按月补充数据后各月自动填充。

八、当前限制 / 后续规划

  • 规上货运量同比、规下货运量同比需去年同期的 H2032 数据，当前演示无去年数据时为空；合计同比由模板右半计算。
  • 后续按统计调查制度扩展其他表（表名按业务编号命名，如 h2032_enterprise_monthly、freight_turnover_import），可复用本框架的导入→审核→报表链路。