| 项目 | 内容 |
|---|---|
| 文档名称 | 货主端 — 按运价标签查询运单 |
| 需求名称 | 【客户成功专项】货主端支持按运价查询 |
| 需求编号 | RR20260727315746 |
| 需求提出人 | 王贵睿【管家】 |
| 优先级 | P0 |
| 所属端 | 货主端APP |
| 版本号 | V1.0 |
| 编写人 | 刘宁宁 |
| 编写日期 | 2026-08-04 |
| 版本 | 日期 | 修订内容 | 修订人 |
|---|---|---|---|
| V1.0 | 2026-08-04 | 初稿 | 刘宁宁 |
客户在实际业务中，一个订单的运价经常会因为市场运力变化、线路调整等原因进行多次调整。每次调价后发运的运单对应不同的运价。货主希望了解每次调价后分别拉运了多少车，以便评估调价策略效果。
目前货主只能通过PC端导出该订单的运单明细到Excel，手动按运价分组统计。操作繁琐、效率低下。
货主端APP，在订单的运单列表中，以运价标签的方式展示该订单历史调整过的运价。货主点击不同运价标签，即可查看该价格对应的运单，直观了解每次调价后的运单数量。
| 包含 | 不包含 |
|---|---|
| 货主APP端订单运单列表增加运价标签 | PC端的运价查询功能（已有导出方式） |
| 运价标签基于订单历史调价记录自动生成 | 运价标签的手动设置或区间自定义 |
| 点击标签筛选对应运价的运单，标签显示运单数量 | 运价数据的统计图表 |
| 角色 | 说明 | 使用端 |
|---|---|---|
| 货主 | 发起运输需求、管理运单的企业用户 | APP |
场景：按历史调整运价查看对应运单
货主张总有一个长期运输订单（DD20260727001），因市场运力变化，订单运价经历了3次调整：最初定价45元/吨，第二批发运时降至38元/吨，近期因运力紧张又涨至52元/吨。张总希望了解每次调价后分别拉运了多少车，以便评估调价策略效果。
过去，张总需要在PC端导出该订单的所有运单明细到Excel，手动按运价分组统计各价格对应的运单数量。现在，他在货主APP打开该订单的运单列表，通过页面上的运价标签（45元/吨、38元/吨、52元/吨），点击即可快速查看每个历史价格对应的运单数量，无需导出加工。
| 术语 | 说明 |
|---|---|
| 运价标签 | 基于订单历史运价调整记录生成的标签，每个标签代表该订单实际使用过的一个运价，用于快速筛选对应的运单 |
| 运单 | 一笔运输任务执行凭证，包含司机、车辆、货物、路线、运价等信息 |
| 运价 | 货物运输的单价，单位为元/吨 |
| 序号 | 功能模块 | 功能点 | 优先级 | 说明 |
|---|---|---|---|---|
| 1 | 运单列表页 | 运单列表展示 | P0 | 展示运单号、状态、司机、车牌、路线、运价 |
| 2 | 运单列表页 | 筛选入口 | P0 | 右上角"筛选"按钮，点击弹出筛选页面 |
| 3 | 筛选页面 | 运价标签筛选 | P0 | 预定义运价区间标签，单选 |
| 4 | 筛选页面 | 运单状态筛选 | P0 | 按运单状态标签筛选 |
| 5 | 筛选页面 | 时间范围筛选 | P0 | 开始时间至截止时间 |
| 6 | 筛选页面 | 预警类型筛选 | P1 | 按预警状态筛选 |
| 7 | 筛选页面 | 重置功能 | P0 | 一键恢复默认筛选条件 |
| 8 | 运单卡片 | 运价字段展示 | P0 | 每张运单卡片展示运价信息及对应标签颜色 |
优先级说明：P0=必须有（MVP），P1=重要（本期），P2=后续迭代
运单列表页位于货主APP内，通过订单详情页 → 底部功能区"运单列表"进入。页面包含：
| 序号 | 字段名称 | 字段类型 | 说明 |
|---|---|---|---|
| 1 | 运单编号 | 文本 | 唯一标识，格式 YD+数字 |
| 2 | 运单状态 | 标签 | 运输中/待装货/已完成/待结算等 |
| 3 | 司机姓名 | 文本 | 承运司机 |
| 4 | 车牌号 | 文本 | 车辆牌照 |
| 5 | 磅单号 | 文本 | 关联磅单编号 |
| 6 | 路线 | 文本 | 起止地点 |
| 7 | 运价 | 数值+标签 | 运价数值及对应区间标签颜色 |
运价标签来源于订单的历史运价调整记录，而非预定义的固定区间。每个标签代表该订单历史上实际使用过的一个运价，标签上标注运价金额及该价格对应的运单数量。
| 标签名称 | 来源 | 说明 |
|---|---|---|
| 全部 | 默认 | 显示该订单下所有运单 |
| XX元/吨 | 订单历史调整运价 | 每次调价产生一个运价标签，标签显示运价金额 + 对应运单数量 |
筛选页面从顶部向下滑入，包含：
| 触发条件 | 用户操作 | 系统响应 |
|---|---|---|
| 运单列表页 | 点击右上角"筛选" | 筛选页面从顶部向下滑入，覆盖运单列表 |
| 筛选页面 | 点击运价标签 | 单选切换，选中标签高亮为品牌色，其余恢复默认 |
| 筛选页面 | 点击日期区域 | 底部弹出年月日三列滚动选择器 |
| 日期选择器 | 滚动/点击年月日 | 选中项居中高亮，点击"确定"回填日期 |
| 筛选页面 | 点击"重置" | 所有筛选条件恢复默认（全部/当天/全部） |
| 筛选页面 | 点击"确定" | 筛选页面关闭，运单列表按条件刷新 |
| 运单卡片 | 点击运单卡片 | 进入该运单详情页 |
| 异常场景 | 处理方式 |
|---|---|
| 筛选后无匹配运单 | 列表显示空状态："该筛选条件下暂无运单" |
| 运价字段为空 | 不纳入任何运价标签统计，仅在"全部"中展示 |
| 网络异常 | 提示"网络异常，请重试"，保留已填筛选条件 |