xst
acdb441507
系统修复: - fleet_runner.py: Windows UTF-8 编码兼容（reconfigure stdout/stderr） - fleet_runner.py: run 命令自动生成合并清单供导出使用 - fleet_manifest.py: 新增 save_merged_manifest() 保存统一清单 - fleet_config.yml: 修复 YAML keywords 格式（block sequence → flow sequence） - 恢复被误删的知识库文件(payment_flow_cases, marketing_activity_cases) QE Fleet 产物 (安徽运八需求): - 153个测试点 + 53条可执行测试用例 - 需求分析/风险评估/测试策略/质量裁决（PASS） - Excel 导出 + 版本快照 v2 - 确认结论文件已归档
4.9 KiB
4.9 KiB
安徽运八需求 分析报告
生成时间: 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 | 上报接口超时或不可用影响业务流程，需重试+告警兜底 |