# 安徽运八需求 分析报告

> 生成时间: 2026-07-13
> 文档角色: 需求分析
> 原始来源: `source_docs/requirements_raw/安徽运八需求.docx`

## 1. 需求概述

根据国家税务总局及交通运输部对网络货运平台合规的监管要求，平台需将运单相关数据分阶段上报至省级网络货运信息监测系统（安徽运八）。上报分为三个阶段：装货完成上报、打款完成上报、开票完成上报，以及ETC发票上传。

### 核心目标
- 实现上报流程的自动化管理（自动触发 + 重试 + 通知）
- 提供异常监控与核验结果展示
- 提供向监管平台发起申诉的完整闭环能力
- ETC发票上传作为税务抵扣凭证

### 涉及角色
- 运营人员：看板监控、手动上传、发起申诉
- 系统：自动触发上报、自动重试、自动更新字段
- 监管平台（安徽运八）：核验上报数据、返回核验结果
- 司机/财务：触发装货完成/打款完成/开票完成（间接触发上报）

## 2. 功能模块分析

| 模块 | 功能 | 触发方式 | 依赖 | 关键风险 |
| :--- | :--- | :--- | :--- | :--- |
| 上报运单看板 | 汇总展示、筛选查询、导出 | 手动访问 | 无 | 数据量大时性能 |
| 第一次上报 | 装货完成后上报基础运单数据 | 自动触发 | 运单装货完成 | 失败阻断后续上报 |
| 第二次上报 | 打款完成后上报资金流水+轨迹 | 自动触发 | 第一次上报通过 | 7类核验，异常最多 |
| 第三次上报 | 开票完成后上报发票数据 | 自动触发 | 第二次上报通过 | 发票验证失败 |
| ETC发票上传 | 税务抵扣后上传ETC发票 | 手动触发 | 税务抵扣完成 | 税额计算精度 |
| 异常申诉 | 核验异常→申诉→监管复核→结果 | 手动触发 | 核验异常 | 申诉闭环完整性 |
| 上报日志 | 接口调用记录、请求/响应查看 | 手动访问 | 无 | 日志完整性 |

## 3. 关键业务规则

### 3.1 上报阶段依赖链
```
装货完成 → 第一次上报 → 核验通过 → 自动更新字段
    ↓
打款完成 → 第二次上报 → 7类核验（车辆资质/司机资质/资金流水/集中支付/合同/轨迹合规/运单重复）
    ↓
开票完成 → 第三次上报 → 发票验证
    ↓
税务抵扣 → ETC发票上传
```

### 3.2 重试策略
- 所有上报阶段：失败后自动重试，最多3次
- 3次全部失败：通知运营人员（站内信/其他方式）
- 重试期间幂等保护：不产生重复上报

### 3.3 状态机
```
上传中(蓝) ──成功→ 已上传(绿)
上传中(蓝) ──超时→ 上传失败(红) → 手动上传 → 上传中
上传中(蓝) ──校验失败→ 异常(橙) → 查看详情
```

### 3.4 申诉状态机
```
未申诉 → 申诉中 → 申诉通过(绿) / 申诉驳回 → 重新申诉 → 申诉中
```

## 4. 数据量预估

| 对象 | 预估量级 | 说明 |
| :--- | :--- | :--- |
| 日上报运单数 | 1000-5000 | 根据平台运单量 |
| 每运单轨迹点数 | 2-2000 | 取决于运输距离 |
| 申诉并发量 | < 100/天 | 异常率较低 |
| 日志保留期 | 建议≥90天 | 审计和排查需要 |

## 5. 歧义标注

> ⚠️ 待确认：重试间隔时间未在需求中明确，建议确认（如30s/60s/120s递增）
> 影响范围: 所有上报阶段的重试行为
> 建议确认方向: 与产品和安徽运八平台确认合理的重试间隔

> ⚠️ 待确认：站内信通知的具体内容模板未定义
> 影响范围: 运营人员通知体验
> 建议确认方向: 确认通知应包含哪些字段（运单号/失败原因/重试次数/建议操作）

> ⚠️ 待确认：上报数据中"省份代码"字段默认值（当前项目属云南省=28，但本需求为安徽=34？）
> 影响范围: 第一次上报司机信息省份代码
> 建议确认方向: 确认安徽运八上报的省份代码应使用哪个值

> ⚠️ 待确认：导出Excel的数据量上限未定义
> 影响范围: 看板导出功能
> 建议确认方向: 确认是否需要限制单次导出条数（如最多10000条）

## 6. 与项目画像的差异化分析

| 维度 | 项目画像（云南省） | 安徽运八需求 | 差异 |
| :--- | :--- | :--- | :--- |
| 上报省份 | 云南省(reportProvince=28) | 安徽省 | 省份代码需切换 |
| 支付方式 | arpa_2 + 网商银行(浦发/快钱/光大) | 同平台支付体系 | 资金流水需关联现有支付渠道 |
| 目标角色 | 运营/货主/车队长/司机/财务 | 主要面向运营人员 | 权限模型可复用 |
| 测试环境 | ybxcx.ynyun8.com:8000 | 同环境 | 测试环境可复用 |

## 7. 风险总结

| 风险ID | 类别 | 等级 | 说明 |
| :--- | :--- | :---: | :--- |
| RISK-FINANCIAL | 资损 | P1 | 资金流水金额不匹配、流水号重复可能导致财务数据错误 |
| RISK-AVAILABILITY | 可用性 | P2 | 上报接口超时或不可用影响业务流程，需重试+告警兜底 |