# 交通统计报表审核系统 - 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`） |

## 二、初始化数据库

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

## 三、启动后端

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

# 方式二：后台运行（日志写入 backend.log，已提供脚本）
run-backend.cmd
```

- 端口：`8090`
- 接口前缀：`/api/**`（当前为 permitAll，便于 Demo）

## 四、启动前端

```bash
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 月去年）
2. 进入「数据审核」页，选择报表期，点「执行审核」，查看问题列表，可逐条「确认/忽略」。
3. 进入「报表生成」页，选择报表期，下载 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`），可复用本框架的导入→审核→报表链路。