docs(api): 明确 5139 司机筛选按原型平铺 #17
@ -52,7 +52,7 @@ generated: "2026-07-22T13:25:00+08:00"
|
||||
| `requiredVehicleType` | String/null | 否 | 订单需求车型大类 key,只影响匹配标记,不限制选择 |
|
||||
| `vehiclePage` / `vehiclePageSize` | Integer | 是 | 车辆独立分页,页大小 1~100 |
|
||||
| `driverPage` / `driverPageSize` | Integer | 是 | 司机独立分页,页大小 1~100 |
|
||||
| `driverAvailability` | String | 否 | `ALL` / `AVAILABLE`,默认 `ALL` |
|
||||
| `driverAvailability` | String | 否 | `ALL` / `AVAILABLE`,接口默认 `ALL`;管理后台按原型首屏显式传 `AVAILABLE` |
|
||||
| `driverSort` | String | 否 | `SMART` / `RATING` / `YEARS` / `RECENT_ORDER`,默认 `SMART` |
|
||||
|
||||
雪花 ID 一律按字符串保存和提交,禁止 `Number()`、`parseInt()`。
|
||||
@ -138,6 +138,15 @@ generated: "2026-07-22T13:25:00+08:00"
|
||||
|
||||
`hasRating=false` 时显示“暂无评价”,不要展示星标和 `0.0/5.0`;不得再用固定 `5.0` 兜底。单量为司机历史累计,不按赛季清零。
|
||||
|
||||
### 原型一致性:司机筛选控件
|
||||
|
||||
司机筛选必须按原型平铺展示,不能用两个下拉框折叠选项。平铺按钮让车务一眼看到当前范围和全部排序方式,并可单击切换:
|
||||
|
||||
- 范围:`仅空闲`(`AVAILABLE`,首屏默认选中)、`全部`(`ALL`)。
|
||||
- 排序:`智能推荐`(`SMART`,首屏默认选中)、`评分`(`RATING`)、`驾龄`(`YEARS`)、`最近接单`(`RECENT_ORDER`)。
|
||||
- 切换范围或排序时只把 `driverPage` 重置为 1,不重置车辆筛选、车辆页码或已选车辆。
|
||||
- “全部司机/智能排序”两个 `NSelect` 不视为原型等价实现;验收以按钮全部可见、选中态明确为准。
|
||||
|
||||
## 最终派单规则
|
||||
|
||||
- 车型或座位不匹配:候选项仍可选,预检返回 warning,最终派单不阻断。
|
||||
@ -151,6 +160,7 @@ generated: "2026-07-22T13:25:00+08:00"
|
||||
- [ ] 车辆行展示车型、常驻司机、协议参考价;需求车型或座位不匹配只醒目标记,不禁选。
|
||||
- [ ] 支持再次点击已选车辆取消选择,并传 `selectedVehicleId: null`。
|
||||
- [ ] 支持先选司机,并展示/置顶 `selectedDriverResidentVehicle`。
|
||||
- [ ] 司机范围与排序按原型平铺为 2+4 个按钮,默认“仅空闲 + 智能推荐”,不得折叠成两个下拉框。
|
||||
- [ ] 司机无评价显示“暂无评价”,不伪造 `5.0` 或 `0.0`;完成单量读取 `completedOrderCount`。
|
||||
- [ ] 雪花 ID 全程按字符串处理。
|
||||
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户