货主端运单日志/运费明细展示司机装车预支明细
成丰货运平台 · 货主端PC + 货主端APP · 运单管理迭代
目录
1. 文档信息
2. 需求背景与目标
2.1 需求背景
2.2 需求详情
2.3 需求目标
2.4 需求范围
3. 用户角色与使用场景
4. 名词解释
5. 业务流程图
6. 功能清单
7. 详细功能说明
7.1 PC端 — 运单日志
7.2 PC端 — 费用明细
7.3 APP端 — 运单日志
7.4 APP端 — 费用明细（本次新增装车预支/油气预支字段）
7.5 业务规则
7.6 交互说明
8. 附录
1. 文档信息
| 项目 | 内容 |
|---|
| 文档名称 | 货主端 — 运单日志/运费明细展示司机装车预支明细 |
| 需求名称 | 货主端运单日志/运费明细展示司机装车预支明细 |
| 需求编号 | RR20260528249835 |
| 需求提出人 | 赵岩【管家】 |
| 优先级 | P0 |
| 所属端 | 货主端PC + 货主端APP |
| 版本号 | V1.0 |
| 编写人 | 刘宁宁 |
| 编写日期 | 2026-06-30 |
| 更新日期 | 2026-06-30 |
修订记录
| 版本 | 日期 | 修订内容 | 修订人 |
|---|
| V1.0 | 2026-06-30 | 需求初稿完成 | 刘宁宁 |
2. 需求背景与目标
2.1 需求背景
拉运过程中个别车辆出现纠纷，货主需要确认是否已向司机支付预支款项。当前运单费用明细只展示总金额，未区分预支部分与剩余待付部分，导致货主产生疑问：明明已经预付了，为什么还显示总金额？
需求来源：赵岩【管家】（RR20260528249835）
重要说明：经产品内部沟通确认，平台预支部分属于平台与司机之间的资金关系，暂不向货主展示。本期仅展示货主侧的装车预支明细。
2.2 需求详情
货主端在运单日志和费用明细中，新增司机装车预支的明细展示，让货主清楚看到已预付多少、还需付多少。
2.3 需求目标
- 业务目标：消除货主对预支款项的疑问，提升运费透明度，减少纠纷
- 产品目标：在运单日志中展示装车预支全流程时间线节点；在费用明细中展示装车预支/油气预支金额明细
2.4 需求范围
| 端 | 涉及页面 | 本次迭代内容 |
|---|
| 货主PC | 运单详情 — 运单信息Tab | 费用明细卡片新增装车预支/油气预支明细 |
| 货主PC | 运单详情 — 运单日志Tab | 时间线新增装车预支全流程节点 |
| 货主APP | 运单列表 — 运单详情 — 费用明细 | 系统已有页面，本次新增装车预支金额、油气预支金额两个字段 |
| 货主APP | 运单列表 — 运单详情 — 运单日志 | 运单日志中展示装车预支明细 |
⚠️ 重要说明：装车预支信息仅展示货主预支的相关明细（装车预支 + 油气预支），平台预支信息暂不展示。平台预支属于平台与司机之间的资金关系，本期不向货主展示。
3. 用户角色与使用场景
3.1 用户角色
| 角色 | 说明 | 使用端 |
|---|
| 货主 | 查看运单日志中的装车预支流转记录，以及费用明细中的预支金额明细 | PC / APP |
| 司机 | 提交装车预支申请，触发运单日志中的预支节点（间接使用者） | APP |
3.2 核心使用场景
场景1：货主A向司机预付了2000元装车预支，运单详情中费用明细总额显示5000元，货主质疑"明明只付了3000，为什么显示5000？"。查看费用明细后发现"装车预支 ¥2,000.00"已列出，实际待付金额为3000元，疑问消除。
场景2：货主B在运单日志中查看装车预支全流程，确认司机已提交申请→货主已审核通过→预支费用已发放→司机已提现，全流程透明可查。
4. 名词解释
| 术语 | 说明 |
|---|
| 装车预支 | 货主向司机预付的现金金额，用于司机装车期间的费用支出 |
| 油气预支 | 货主向司机预付的油气额度，用于司机装车期间的加油/加气支出 |
| 货主预支 | 由货主承担的预支款项（装车预支 + 油气预支），本期向货主展示 |
| 平台预支 | 由平台承担的预支款项，属于平台与司机之间的资金关系，本期不向货主展示 |
5. 业务流程图
以泳道图形式展示装车预支业务全流程，以及货主端各节点的展示时机。
5.1 流程说明
- 司机端：司机在APP提交装车预支申请，触发货主端预支流程
- 货主端：货主在PC或APP中审核预支申请（通过/驳回）
- 运单日志：预支全流程节点在时间线中展示，包括申请提交、审核通过、费用发放、提现/使用、剩余退回
- 费用明细：预支费用发放后，费用明细卡片中展示装车预支/油气预支金额
- 适用范围：仅平台单运单展示装车预支明细
6. 功能清单
| 序号 | 功能模块 | 功能点 | 适用端 | 优先级 | 说明 |
|---|
| 1 | 运单日志 | 装车预支全流程时间线节点 | PC + APP | P0 | 新增6个预支节点，时间倒序排列 |
| 2 | 运单日志 | 预支金额明细展开 | PC + APP | P0 | 「预支费用已发放」节点展开显示金额 |
| 3 | 费用明细 | 装车预支费用项 | PC | P0 | 司机运费模块末尾新增「装车预支」 |
| 4 | 费用明细 | 油气预支费用项 | PC | P0 | 司机运费模块末尾新增「油气预支」 |
| 5 | 费用明细 | APP端装车预支金额 | APP | P0 | 费用明细页司机运费明细区域新增，橙色字体 |
| 6 | 费用明细 | APP端油气预支金额 | APP | P0 | 费用明细页司机运费明细区域新增，橙色字体 |
优先级说明：P0=必须有（MVP），P1=重要（本期），P2=锦上添花（后续迭代）
7. 详细功能说明
7.1 PC端 — 运单日志（运单详情页-运单日志Tab）
在运单详情页「运单日志」Tab 的时间线中，新增装车预支全流程节点。
节点顺序（时间倒序排列）：
| 节点 | 说明 | 状态样式（参考） |
|---|
| 装车预支申请已提交 | 司机提交装车预支申请 | 绿色高亮（已完成）/ 蓝色（当前节点）/ 灰色（待办） |
| 装车预支申请已通过 | 货主审核通过 | 绿色高亮 |
| 预支费用已发放 | 预支费用发放，展示预支类型及金额明细 | 绿色高亮 |
| 装车预支运费已提现 | 司机提现运费预支 | 橙色高亮 |
| 装车预支油气已使用 | 司机使用油气额度 | 橙色高亮 |
| 剩余预支已退回 | 货主收货确认后，未使用预支自动退回 | 橙色高亮 |
明细展示规则：
- 「预支费用已发放」节点展开显示：运费预支金额 ¥XX.XX、油气预支金额 ¥XX.XX
- 「剩余预支已退回」节点展开显示：运费预支退回金额 ¥XX.XX、油气预支退回金额 ¥XX.XX
- 运单无预支时，不展示任何预支相关节点
7.2 PC端 — 费用明细（运单详情页-运单信息Tab）
在运单信息 Tab 的「费用明细」卡片中，于「司机运费」模块内新增两项费用明细。
新增费用项：
| 费用项 | 展示位置 | 金额规则 |
|---|
| 装车预支 | 司机运费模块末尾 | 显示预付的现金金额（正值） |
| 油气预支 | 司机运费模块末尾 | 显示预付的油气额度（正值） |
展示规则：
- 「装车预支」和「油气预支」作为司机运费的子项展示
- 运单有预支时显示对应项，无预支时不显示
- 司机运费总额不变（预支为已付部分的明细展示）
运单数据示例：
| 运单 | 装车预支 | 油气预支 |
|---|
| YD20260624001 | ¥2,000.00 | ¥500.00 |
| YD20260624002 | — | ¥1,500.00 |
| YD20260624003 | ¥2,500.00 | ¥800.00 |
| YD20260624004 | ¥1,800.00 | — |
| YD20260624005 | — | — |
7.3 APP端 — 运单日志
在系统已有的运单日志页面中，新增展示装车预支全流程节点。
- 新增6个预支节点，与PC端运单日志一致
- 节点顺序、状态样式、明细展示规则与 PC 端保持一致
7.4 APP端 — 费用明细（本次新增：装车预支/油气预支字段）
7.4.1 新增字段
在系统已有的费用明细页面中，于「司机运费金额」明细区域内新增以下两个字段：
| 新增字段 | 展示位置 | 展示样式 | 说明 |
|---|
| 装车预支金额 | 司机运费明细末尾（补贴司机之后） | 橙色 #E6A23C，加粗 500 | 仅展示货主预支，不展示平台预支 |
| 油气预支金额 | 装车预支金额之后 | 橙色 #E6A23C，加粗 500 | 仅展示货主预支，不展示平台预支 |
7.5 业务规则
| 规则 | 说明 |
|---|
| 适用范围 | 仅平台单运单展示装车预支明细 |
| 预支类型 | 运费预支（现金）+ 油气预支（油气额度） |
| 展示范围 | 仅展示货主侧预支，不展示平台预支 |
7.6 交互说明
7.6.1 APP端
| 触发条件 | 用户操作 | 系统响应 |
|---|
| 进入运单日志 | 运单列表点击运单卡片 → 运单详情 → 运单日志 | 运单日志中已有预支流程节点，与PC端一致 |
| 进入费用明细 | 运单详情页进入费用明细页面（已有入口） | 司机运费明细区域展示装车预支金额、油气预支金额 |
说明：本PRD覆盖货主端PC和货主端APP的装车预支明细展示。本期需求无新增入口、无新增页面，仅在两端的现有页面中新增装车预支金额和油气预支金额的展示。