|
@@ -4,30 +4,33 @@
|
|
|
|
|
|
|
|
**创建日期**：2026-08-31
|
|
**创建日期**：2026-08-31
|
|
|
|
|
|
|
|
-**状态**：平台前端与外卖同规则时段运价调整已验证；App 订单列表与详情精简已提交，定向测试与模块构建通过
|
|
|
|
|
|
|
+**状态**：既有功能已验证；2026-09-07 设计稿费用与物品信息对齐增量已确认，待实施
|
|
|
|
|
|
|
|
-**输入**：基于蓝湖“闪送”分组 7 个设计页面、2026-08-24 用户端/骑手端补充原型及 2026-09-03 更新的 19 张用户端设计稿，实现帮送、帮取、加急送的完整非支付业务闭环，包括共享地址簿、路线报价、包裹信息、立即/预约配送、可选 PIN 交付、创建订单、寄件人/收件人订单查询、骑手主动抢单、1 对 1 急送独占、取件、送达、用户签收、平台配置与介入。
|
|
|
|
|
|
|
+**输入**：基于蓝湖“闪送”分组 7 个设计页面、2026-08-24 用户端/骑手端补充原型及 2026-09-03 更新的 19 张用户端设计稿，实现帮送/帮取业务场景、普通/1 对 1 加急配送、共享地址簿、路线报价、完整物品信息、立即/预约配送、费用明细与报价校验、可选 PIN 交付、创建订单、寄件人/收件人订单查询、骑手主动抢单、急送独占、取件、送达、用户签收、平台配置与介入的非支付业务闭环。
|
|
|
|
|
|
|
|
## 用户场景与测试
|
|
## 用户场景与测试
|
|
|
|
|
|
|
|
### 用户故事 1：用户获取报价并发布闪送订单（优先级：P1）
|
|
### 用户故事 1：用户获取报价并发布闪送订单（优先级：P1）
|
|
|
|
|
|
|
|
-用户选择帮送、帮取或加急送，填写取件与收件地址后获取服务端报价，并发布一笔等待骑手接单的闪送订单。
|
|
|
|
|
|
|
+用户选择帮送或帮取、普通或 1 对 1 加急配送，填写取送地址、物品信息和可选骑手小费后获取服务端报价，并回传报价明细发布一笔等待骑手接单的闪送订单。
|
|
|
|
|
|
|
|
**优先级原因**：报价与发布订单是闪送服务成立的基础，没有该能力就无法形成可配送任务。
|
|
**优先级原因**：报价与发布订单是闪送服务成立的基础，没有该能力就无法形成可配送任务。
|
|
|
|
|
|
|
|
-**独立测试**：为同一组取件和收件坐标分别选择三种服务，验证系统按服务类型和当前时间匹配运价时段，使用与外卖订单一致的起送与里程规则返回整数新台币报价，并在创建订单时重新计算价格、保存地址与计价快照且进入待接单状态。
|
|
|
|
|
|
|
+**独立测试**：为同一组取件和收件坐标分别选择帮送/帮取及普通/加急配送，验证两种业务场景共享运价，立即订单按当前时刻、预约订单按预约开始时刻匹配唯一运价时段；系统使用起送与里程规则计算普通配送费，以当前时段的加急比例和最低加急费计算加急费，再加入用户小费返回整数新台币明细；创建订单时前端回传报价，后端复算并逐项校验后保存物品、地址、路线和计价快照。
|
|
|
|
|
|
|
|
**验收场景**：
|
|
**验收场景**：
|
|
|
|
|
|
|
|
-1. **假如** 当前时间命中所选服务类型的运价时段，**当** 用户请求报价，**那么** 系统使用该时段的起送距离、起送价格、计价距离和计价金额计算报价。
|
|
|
|
|
|
|
+1. **假如** 立即订单的当前时刻或预约订单的预约开始时刻命中唯一运价时段，**当** 用户请求报价，**那么** 帮送与帮取均使用该时段的起送距离、起送价格、计价距离、计价金额、加急比例和最低加急费计算报价。
|
|
|
2. **假如** 路线距离超过起送距离不足 0.5 公里、达到 0.5 公里但不足 1 公里或超过 1 公里，**当** 用户请求报价，**那么** 系统分别按 0、1 公里或实际超出距离计算里程费用，并将新台币金额四舍五入为整数元。
|
|
2. **假如** 路线距离超过起送距离不足 0.5 公里、达到 0.5 公里但不足 1 公里或超过 1 公里，**当** 用户请求报价，**那么** 系统分别按 0、1 公里或实际超出距离计算里程费用，并将新台币金额四舍五入为整数元。
|
|
|
3. **假如** 地图路线服务正常，**当** 用户请求报价，**那么** 系统使用路线距离并标记距离来源为路线服务。
|
|
3. **假如** 地图路线服务正常，**当** 用户请求报价，**那么** 系统使用路线距离并标记距离来源为路线服务。
|
|
|
4. **假如** 地图路线服务超时或失败，**当** 用户请求报价，**那么** 系统使用经纬度直线距离降级报价并明确标记距离来源。
|
|
4. **假如** 地图路线服务超时或失败，**当** 用户请求报价，**那么** 系统使用经纬度直线距离降级报价并明确标记距离来源。
|
|
|
-5. **假如** 客户端提交伪造金额或距离，**当** 用户创建订单，**那么** 系统忽略客户端金额与距离并在服务端重新报价。
|
|
|
|
|
|
|
+5. **假如** 客户端创建订单时回传的配置版本、基础配送费、距离费、加急费或总金额与服务端最新复算结果不一致，**当** 系统校验报价，**那么** 系统不得创建订单，并返回报价已变化的业务结果及最新报价。
|
|
|
6. **假如** 同一用户以相同客户端请求号重复创建订单，**当** 请求被重复处理，**那么** 系统返回同一订单且不产生重复订单。
|
|
6. **假如** 同一用户以相同客户端请求号重复创建订单，**当** 请求被重复处理，**那么** 系统返回同一订单且不产生重复订单。
|
|
|
7. **假如** 用户选择预约配送，**当** 创建订单，**那么** 系统保存 30 分钟取件时段，预约开始前订单不进入骑手可抢列表。
|
|
7. **假如** 用户选择预约配送，**当** 创建订单，**那么** 系统保存 30 分钟取件时段，预约开始前订单不进入骑手可抢列表。
|
|
|
8. **假如** 路线距离超过 40 公里，**当** 用户报价或创建订单，**那么** 系统拒绝请求。
|
|
8. **假如** 路线距离超过 40 公里，**当** 用户报价或创建订单，**那么** 系统拒绝请求。
|
|
|
|
|
+9. **假如** 用户选择普通配送，**当** 系统报价，**那么** 加急费必须为 0；用户选择加急配送时，加急费必须为普通配送费乘当前时段加急比例并与最低加急费取较大值。
|
|
|
|
|
+10. **假如** 用户填写物品类别、数量、总重量和规格，**当** 报价或创建订单，**那么** 系统校验数量为正整数、总重量大于 0 且不超过 20kg，并由总重量生成内部重量档。
|
|
|
|
|
+11. **假如** 用户填写骑手小费，**当** 系统报价或创建订单，**那么** 小费作为独立非负整数 TWD 明细参与总金额，但不改变基础配送费或加急费。
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
@@ -97,16 +100,16 @@
|
|
|
|
|
|
|
|
### 用户故事 5：平台管理时段运价并介入异常订单（优先级：P2）
|
|
### 用户故事 5：平台管理时段运价并介入异常订单（优先级：P2）
|
|
|
|
|
|
|
|
-平台管理员为三种闪送服务分别维护多个运价时段，查询全部闪送订单，并在取件后的异常场景中取消或完成订单。
|
|
|
|
|
|
|
+平台管理员维护一套供帮送和帮取共享的分时段运价，查询全部闪送订单，并在取件后的异常场景中取消或完成订单。
|
|
|
|
|
|
|
|
**优先级原因**：价格必须可运营调整，取件后的订单又必须具备受控的人工处置入口。
|
|
**优先级原因**：价格必须可运营调整，取件后的订单又必须具备受控的人工处置入口。
|
|
|
|
|
|
|
|
-**独立测试**：管理员新增、修改和删除加急送运价时段，验证重叠时段被拒绝、保存后立即生效、新报价使用当前时段及最新版本；随后对已取件订单执行平台取消并检查状态日志。
|
|
|
|
|
|
|
+**独立测试**：管理员新增、修改和删除统一运价时段，验证重叠时段被拒绝、保存后立即生效，普通报价使用基础配送规则，加急报价额外使用该时段的加急比例和最低加急费；随后对已取件订单执行平台取消并检查状态日志。
|
|
|
|
|
|
|
|
**验收场景**：
|
|
**验收场景**：
|
|
|
|
|
|
|
|
-1. **假如** 管理员新增或修改某一服务类型的运价时段，**当** 新请求在该时段内报价，**那么** 新报价立即使用新配置且已创建订单价格不变。
|
|
|
|
|
-2. **假如** 时间范围重叠、起止时间非法、距离或金额不是正数、金额不是整数或服务类型非法，**当** 管理员提交配置，**那么** 系统拒绝保存。
|
|
|
|
|
|
|
+1. **假如** 管理员新增或修改统一运价时段，**当** 帮送或帮取的新请求命中该时段，**那么** 新报价立即使用新配置且已创建订单价格不变。
|
|
|
|
|
+2. **假如** 时间范围重叠、起止时间非法、距离或金额不是正数、金额不是整数、加急比例为负数或最低加急费为负数，**当** 管理员提交配置，**那么** 系统拒绝保存。
|
|
|
3. **假如** 普通用户或骑手调用平台配置或介入接口，**当** 权限校验执行，**那么** 系统拒绝操作。
|
|
3. **假如** 普通用户或骑手调用平台配置或介入接口，**当** 权限校验执行，**那么** 系统拒绝操作。
|
|
|
4. **假如** 订单已取件但发生异常，**当** 有权限的管理员取消订单，**那么** 系统允许取消并记录管理员、原因和时间。
|
|
4. **假如** 订单已取件但发生异常，**当** 有权限的管理员取消订单，**那么** 系统允许取消并记录管理员、原因和时间。
|
|
|
5. **假如** 订单已送达但用户无法确认，**当** 有权限的管理员确认完成，**那么** 系统完成订单并记录平台操作日志。
|
|
5. **假如** 订单已送达但用户无法确认，**当** 有权限的管理员确认完成，**那么** 系统完成订单并记录平台操作日志。
|
|
@@ -115,15 +118,15 @@
|
|
|
|
|
|
|
|
### 用户故事 6：平台在管理后台配置价格并处理闪送订单（优先级：P2）
|
|
### 用户故事 6：平台在管理后台配置价格并处理闪送订单（优先级：P2）
|
|
|
|
|
|
|
|
-平台管理员从“闪送管理”菜单进入价格配置或订单管理页面，无需直接调用接口即可维护三种服务价格、筛选订单、查看完整履约资料并执行受权限控制的平台介入。
|
|
|
|
|
|
|
+平台管理员从“闪送管理”菜单进入价格配置或订单管理页面，无需直接调用接口即可维护统一分时段运价、筛选订单、查看完整履约资料并执行受权限控制的平台介入。
|
|
|
|
|
|
|
|
**优先级原因**：后端接口已具备，但缺少平台可操作入口会导致计价只能通过接口工具维护，异常订单也无法进入日常运营流程。
|
|
**优先级原因**：后端接口已具备，但缺少平台可操作入口会导致计价只能通过接口工具维护，异常订单也无法进入日常运营流程。
|
|
|
|
|
|
|
|
-**独立测试**：以拥有完整闪送权限的管理员登录后台，分别完成三种服务价格读取与修改、订单组合筛选、详情查看、异常取消和已送达订单完成；再以缺少对应权限的账号验证菜单与操作按钮不可用。
|
|
|
|
|
|
|
+**独立测试**：以拥有完整闪送权限的管理员登录后台，完成统一分时段运价读取与修改、订单组合筛选、详情查看、异常取消和已送达订单完成；再以缺少对应权限的账号验证菜单与操作按钮不可用。
|
|
|
|
|
|
|
|
**验收场景**：
|
|
**验收场景**：
|
|
|
|
|
|
|
|
-1. **假如** 管理员进入价格配置页面，**当** 页面加载，**那么** 系统按帮送、帮取和加急送展示全部运价时段、起送规则、计价规则及配置版本。
|
|
|
|
|
|
|
+1. **假如** 管理员进入价格配置页面，**当** 页面加载，**那么** 系统按开始时间展示全部统一运价时段、起送规则、普通超距规则、加急比例、最低加急费及配置版本。
|
|
|
2. **假如** 管理员新增、修改或删除合法时段，**当** 操作成功，**那么** 页面刷新服务端配置；非法值、重叠时段或并发冲突必须保留编辑内容并展示错误。
|
|
2. **假如** 管理员新增、修改或删除合法时段，**当** 操作成功，**那么** 页面刷新服务端配置；非法值、重叠时段或并发冲突必须保留编辑内容并展示错误。
|
|
|
3. **假如** 管理员进入订单页面，**当** 按状态、服务类型、订单号、用户 ID 或骑手 ID 查询，**那么** 表格按服务端分页结果展示并可重置条件。
|
|
3. **假如** 管理员进入订单页面，**当** 按状态、服务类型、订单号、用户 ID 或骑手 ID 查询，**那么** 表格按服务端分页结果展示并可重置条件。
|
|
|
4. **假如** 管理员查看订单详情，**当** 详情加载，**那么** 页面分区展示订单概况、取送地址、费用明细、预约与 PIN、骑手、图片凭证和状态日志。
|
|
4. **假如** 管理员查看订单详情，**当** 详情加载，**那么** 页面分区展示订单概况、取送地址、费用明细、预约与 PIN、骑手、图片凭证和状态日志。
|
|
@@ -134,7 +137,7 @@
|
|
|
|
|
|
|
|
### 用户故事 7：收件人查看订单且急送骑手保持独占（优先级：P1）
|
|
### 用户故事 7：收件人查看订单且急送骑手保持独占（优先级：P1）
|
|
|
|
|
|
|
|
-已注册普通用户在他人创建订单时通过收件手机号被安全绑定为收件人，可在“我收的”查看订单详情和配送进度；骑手承接 1 对 1 急送后，在订单送达或取消前不得承接其他外卖或闪送任务。
|
|
|
|
|
|
|
+已注册普通用户在他人创建订单时通过收件手机号被安全绑定为收件人，可在“我收的”查看订单详情和配送进度；骑手承接 `deliveryType=URGENT` 的 1 对 1 急送后，在订单送达或取消前不得承接其他外卖或闪送任务。
|
|
|
|
|
|
|
|
**独立测试**：使用已注册、未注册、重复手机号和换绑手机号创建订单，验证收件账号只在创建时唯一匹配并固化；并发发起急送与其他任务抢单，验证同一骑手只能进入一个互斥的有效接单结果。
|
|
**独立测试**：使用已注册、未注册、重复手机号和换绑手机号创建订单，验证收件账号只在创建时唯一匹配并固化；并发发起急送与其他任务抢单，验证同一骑手只能进入一个互斥的有效接单结果。
|
|
|
|
|
|
|
@@ -152,9 +155,9 @@
|
|
|
- 取件地址和收件地址相同或坐标相同，不允许创建订单。
|
|
- 取件地址和收件地址相同或坐标相同，不允许创建订单。
|
|
|
- 地址缺少联系人、联系电话、完整地址或有效经纬度时，不允许用于报价和创建订单。
|
|
- 地址缺少联系人、联系电话、完整地址或有效经纬度时，不允许用于报价和创建订单。
|
|
|
- 经纬度超出合法范围时拒绝请求，不调用地图服务。
|
|
- 经纬度超出合法范围时拒绝请求，不调用地图服务。
|
|
|
-- 对应服务类型在当前时间没有匹配的运价时段时，不允许报价或创建订单，并返回“当前时段暂无可用运价”。
|
|
|
|
|
|
|
+- 立即订单在当前时刻、预约订单在预约开始时刻没有匹配的运价时段时，不允许报价或创建订单，并返回“对应取件时段暂无可用运价”。
|
|
|
- 地图路线结果缺少有效距离时按路线失败处理并降级为直线距离。
|
|
- 地图路线结果缺少有效距离时按路线失败处理并降级为直线距离。
|
|
|
-- 创建订单时当前配置与先前报价时不同，以创建时服务端重新计算结果为准。
|
|
|
|
|
|
|
+- 创建订单时当前配置或路线结果与先前报价不同，拒绝创建并返回最新报价，不得静默使用新金额创建订单。
|
|
|
- 待接单列表仅返回待接单订单；已取消或已被抢走的订单不得继续出现在新查询结果中。
|
|
- 待接单列表仅返回待接单订单；已取消或已被抢走的订单不得继续出现在新查询结果中。
|
|
|
- 待抢订单列表按原型显示完整取送文字地址，但隐藏联系人、电话、实际 PIN、精确坐标和内部字段；抢单成功后订单骑手才能读取履约所需的完整联系方式与坐标。
|
|
- 待抢订单列表按原型显示完整取送文字地址，但隐藏联系人、电话、实际 PIN、精确坐标和内部字段；抢单成功后订单骑手才能读取履约所需的完整联系方式与坐标。
|
|
|
- 骑手第一版不能自行放弃已抢订单，需要平台介入处理。
|
|
- 骑手第一版不能自行放弃已抢订单，需要平台介入处理。
|
|
@@ -168,18 +171,18 @@
|
|
|
|
|
|
|
|
### 功能需求
|
|
### 功能需求
|
|
|
|
|
|
|
|
-- **FR-001**：系统必须提供帮送、帮取和加急送三种服务类型。
|
|
|
|
|
|
|
+- **FR-001**：系统必须将业务场景与配送等级分离：`serviceType` 只接受 `HELP_SEND`（帮送）和 `HELP_PICKUP`（帮取），`deliveryType` 只接受 `NORMAL`（普通配送）和 `URGENT`（1 对 1 加急配送）。
|
|
|
- **FR-002**：帮取只承担取件配送，不包含代购、垫付或商品金额。
|
|
- **FR-002**：帮取只承担取件配送，不包含代购、垫付或商品金额。
|
|
|
-- **FR-003**：三种服务必须使用同一订单履约状态机；加急送仅在排序和计价上体现优先级。
|
|
|
|
|
-- **FR-004**：系统必须按服务类型维护多个运价时段，每个时段保存开始时间、结束时间、起送距离、起送价格、计价距离、计价金额、配置版本与修改记录；配置保存即生效，不设置启停状态。
|
|
|
|
|
-- **FR-005**：报价必须先按服务类型和当前时间匹配唯一运价时段；同一服务类型的时间段不得重叠，没有匹配时段时必须拒绝报价和创建订单。
|
|
|
|
|
|
|
+- **FR-003**：帮送、帮取、普通配送和加急配送必须使用同一订单履约状态机；`deliveryType=URGENT` 额外启用骑手独占规则和加急计价。
|
|
|
|
|
+- **FR-004**：系统必须维护一套供帮送和帮取共享的多个运价时段；每个时段保存开始时间、结束时间、起送距离、起送价格、计价距离、计价金额、加急比例、最低加急费、配置版本与修改记录，配置保存即生效且不设置启停状态。
|
|
|
|
|
+- **FR-005**：立即订单必须按报价时刻匹配唯一运价时段，预约订单必须按 `scheduledPickupStartAt` 匹配唯一运价时段；全部时间段之间不得重叠，没有匹配时段时必须拒绝报价和创建订单。
|
|
|
- **FR-006**：计价必须与现有外卖订单一致：起送距离内只收起送价格；超出不足 0.5 公里不加价，超出 0.5 公里但不足 1 公里按 1 公里计，超出至少 1 公里按实际超出距离计；里程费用四舍五入到整数元后与起送价格相加，所有 TWD 金额均为整数且不再按百位或千位特殊取整。
|
|
- **FR-006**：计价必须与现有外卖订单一致：起送距离内只收起送价格；超出不足 0.5 公里不加价，超出 0.5 公里但不足 1 公里按 1 公里计，超出至少 1 公里按实际超出距离计；里程费用四舍五入到整数元后与起送价格相加，所有 TWD 金额均为整数且不再按百位或千位特殊取整。
|
|
|
- **FR-007**：系统必须优先使用地图路线距离，地图失败时使用经纬度直线距离并向客户端返回距离来源。
|
|
- **FR-007**：系统必须优先使用地图路线距离，地图失败时使用经纬度直线距离并向客户端返回距离来源。
|
|
|
- **FR-008**：地图密钥必须从服务端配置读取，不得返回客户端或写入业务日志。
|
|
- **FR-008**：地图密钥必须从服务端配置读取，不得返回客户端或写入业务日志。
|
|
|
-- **FR-009**：创建订单时必须由服务端重新计算距离和价格，并保存地址、路线、金额和计价配置快照。
|
|
|
|
|
|
|
+- **FR-009**：创建订单时前端必须回传报价配置 ID、版本、基础配送费、距离费、加急费和总金额；服务端必须重新计算距离和价格并逐项精确校验，一致后才能保存地址、路线、金额和计价配置快照，不一致时不得创建订单并必须返回最新报价。
|
|
|
- **FR-010**：系统必须使用客户端请求号保证同一用户的订单创建幂等。
|
|
- **FR-010**：系统必须使用客户端请求号保证同一用户的订单创建幂等。
|
|
|
- **FR-011**：闪送订单不得复用餐饮订单或打车订单数据模型。
|
|
- **FR-011**：闪送订单不得复用餐饮订单或打车订单数据模型。
|
|
|
-- **FR-012**：订单必须保存包裹类别和机车可载重量档，重量档为 `SMALL`（不超过 5kg）、`MEDIUM`（不超过 12kg）或 `LARGE`（不超过 20kg）；不保存精确重量或件数。
|
|
|
|
|
|
|
+- **FR-012**：订单必须保存包裹类别、正整数数量、大于 0 且不超过 20kg 的总重量及可选体积/规格说明；内部重量档由总重量生成：不超过 5kg 为 `SMALL`，超过 5kg 且不超过 12kg 为 `MEDIUM`，超过 12kg 且不超过 20kg 为 `LARGE`，不得由客户端直接指定。
|
|
|
- **FR-013**：订单必须支持用户备注，但备注不参与计价。
|
|
- **FR-013**：订单必须支持用户备注，但备注不参与计价。
|
|
|
- **FR-014**：骑手必须通过统一闪送订单列表的 `newTask` 页签主动抢单，第一阶段不实现自动派单。
|
|
- **FR-014**：骑手必须通过统一闪送订单列表的 `newTask` 页签主动抢单，第一阶段不实现自动派单。
|
|
|
- **FR-015**：骑手闪送列表必须复用骑手外卖订单列表的查询参数名称和分页习惯：`page`、`size`、`tab`、`longitude`、`latitude`；不得再拆分为 `available`、`mine` 或叠加 `scene`、`status`、`serviceType` 筛选。
|
|
- **FR-015**：骑手闪送列表必须复用骑手外卖订单列表的查询参数名称和分页习惯：`page`、`size`、`tab`、`longitude`、`latitude`；不得再拆分为 `available`、`mine` 或叠加 `scene`、`status`、`serviceType` 筛选。
|
|
@@ -218,37 +221,40 @@
|
|
|
- **FR-048**：路线距离不得超过 40 公里；超过限制时报价和创建均拒绝。
|
|
- **FR-048**：路线距离不得超过 40 公里；超过限制时报价和创建均拒绝。
|
|
|
- **FR-049**：平台管理前端必须提供“闪送管理”父菜单，并提供“价格配置”和“闪送订单”两个子页面。
|
|
- **FR-049**：平台管理前端必须提供“闪送管理”父菜单，并提供“价格配置”和“闪送订单”两个子页面。
|
|
|
- **FR-050**：平台前端必须通过现有六个 `flash:*` 权限分别控制页面访问、价格修改、订单查看、取消和完成操作，不得仅依赖按钮隐藏代替后端鉴权。
|
|
- **FR-050**：平台前端必须通过现有六个 `flash:*` 权限分别控制页面访问、价格修改、订单查看、取消和完成操作，不得仅依赖按钮隐藏代替后端鉴权。
|
|
|
-- **FR-051**：价格配置页面必须按服务类型展示全部时段，并支持新增、修改和删除；表单字段为 `startTime`、`endTime`、`startingDistance`、`startingFare`、`distance` 和 `freight`，同时展示只读配置版本与更新时间。
|
|
|
|
|
-- **FR-052**：价格表单必须校验时间范围有效、同服务时间段不重叠、距离为正数、起送价格和计价金额为正整数；配置保存即生效，删除后立即不可用于报价，操作成功后必须重新读取服务端列表。
|
|
|
|
|
|
|
+- **FR-051**：价格配置页面必须按开始时间展示统一运价时段，并支持新增、修改和删除；表单字段为 `startTime`、`endTime`、`startingDistance`、`startingFare`、`distance`、`freight`、`urgentRate` 和 `minimumUrgentFee`，同时展示只读配置版本与更新时间。
|
|
|
|
|
+- **FR-052**：价格表单必须校验时间范围有效、全部时段互不重叠、距离为正数、起送价格和计价金额为正整数、加急比例和最低加急费为非负数；配置保存即生效，删除后立即不可用于报价，操作成功后必须重新读取服务端列表。
|
|
|
- **FR-053**：订单页面必须按服务端分页，并支持状态、服务类型、订单号、用户 ID 和骑手 ID 组合筛选及一键重置。
|
|
- **FR-053**：订单页面必须按服务端分页，并支持状态、服务类型、订单号、用户 ID 和骑手 ID 组合筛选及一键重置。
|
|
|
- **FR-054**：平台订单详情必须展示订单概况、取送地址、路线与费用、预约与 PIN、骑手 ID 与履约时间、三类图片凭证及状态日志；不得要求管理员从列表字段拼接详情。
|
|
- **FR-054**：平台订单详情必须展示订单概况、取送地址、路线与费用、预约与 PIN、骑手 ID 与履约时间、三类图片凭证及状态日志；不得要求管理员从列表字段拼接详情。
|
|
|
- **FR-055**：平台取消必须要求非空原因和二次确认；平台完成必须二次确认。操作成功后刷新服务端数据，操作失败时保留当前页面并显示后端错误。
|
|
- **FR-055**：平台取消必须要求非空原因和二次确认；平台完成必须二次确认。操作成功后刷新服务端数据，操作失败时保留当前页面并显示后端错误。
|
|
|
- **FR-056**：平台前端新增的全部用户可见文本必须通过 Vue i18n 提供简体中文、繁体中文、英文和越南文，不得硬编码单一语言文本。
|
|
- **FR-056**：平台前端新增的全部用户可见文本必须通过 Vue i18n 提供简体中文、繁体中文、英文和越南文，不得硬编码单一语言文本。
|
|
|
- **FR-057**：平台前端必须沿用现有 Vue 2、Element UI、若依请求封装、动态菜单和 `v-hasPermi` 体系，不新增重复的状态管理或 UI 框架。
|
|
- **FR-057**：平台前端必须沿用现有 Vue 2、Element UI、若依请求封装、动态菜单和 `v-hasPermi` 体系，不新增重复的状态管理或 UI 框架。
|
|
|
- **FR-058**：骑手列表 `tab` 只接受 `newTask`、`toPickup`、`delivering`、`completed` 和 `cancelled`，分别映射待接单、已接单、已取件、已送达/已完成和已取消；闪送不提供外卖退款页签。
|
|
- **FR-058**：骑手列表 `tab` 只接受 `newTask`、`toPickup`、`delivering`、`completed` 和 `cancelled`，分别映射待接单、已接单、已取件、已送达/已完成和已取消；闪送不提供外卖退款页签。
|
|
|
-- **FR-059**：骑手 `newTask` 列表必须返回取件点距离、路线距离、预计时长、订单金额、包裹类别、重量档、配送方式、预约时段、完整取送文字地址和是否需要 PIN，并返回附近任务总数与最高订单金额；不得返回已移除的尖峰倍率或尚未实现的骑手收入。
|
|
|
|
|
|
|
+- **FR-059**：骑手 `newTask` 列表必须返回取件点距离、路线距离、预计时长、基础配送费、加急费、小费、订单总金额、业务场景、配送等级、包裹类别、数量、总重量、规格、重量档、配送方式、预约时段、完整取送文字地址和是否需要 PIN，并返回附近任务总数与最高订单金额；不得返回内部加急比例、最低加急费或尚未实现的骑手收入。
|
|
|
- **FR-060**：用户创建订单、用户详情、骑手详情和骑手接单成功响应必须使用直接且稳定的 App 订单详情结构；权限差异只影响敏感字段是否返回，不得改变 `data` 的顶层形状，也不得要求 App 通过 `data.order` 是否存在判断响应类型。
|
|
- **FR-060**：用户创建订单、用户详情、骑手详情和骑手接单成功响应必须使用直接且稳定的 App 订单详情结构；权限差异只影响敏感字段是否返回，不得改变 `data` 的顶层形状，也不得要求 App 通过 `data.order` 是否存在判断响应类型。
|
|
|
- **FR-061**：订单新增可空 `receiver_user_id`；创建订单时将收件手机号去除首尾/内部空白、`+`、`-` 和圆括号但不改写国家码，再以剩余数字唯一匹配当时已注册且 `userType=0` 的普通用户并固化匹配结果，不执行历史订单追溯认领。
|
|
- **FR-061**：订单新增可空 `receiver_user_id`；创建订单时将收件手机号去除首尾/内部空白、`+`、`-` 和圆括号但不改写国家码，再以剩余数字唯一匹配当时已注册且 `userType=0` 的普通用户并固化匹配结果，不执行历史订单追溯认领。
|
|
|
- **FR-062**：手机号无匹配或存在多个普通用户匹配时不得绑定收件账号；订单仍可创建，且不得选择任意一名用户作为收件人。
|
|
- **FR-062**：手机号无匹配或存在多个普通用户匹配时不得绑定收件账号；订单仍可创建，且不得选择任意一名用户作为收件人。
|
|
|
- **FR-063**：用户订单列表新增 `role` 参数，只接受 `sender` 和 `receiver`，省略时兼容为 `sender`；筛选必须在数据库分页前完成。
|
|
- **FR-063**：用户订单列表新增 `role` 参数，只接受 `sender` 和 `receiver`，省略时兼容为 `sender`；筛选必须在数据库分页前完成。
|
|
|
- **FR-064**：订单创建人和已绑定收件人均可查询订单详情并确认签收；只有订单创建人可以主动取消订单。交付 PIN 对两类参与者可见。
|
|
- **FR-064**：订单创建人和已绑定收件人均可查询订单详情并确认签收；只有订单创建人可以主动取消订单。交付 PIN 对两类参与者可见。
|
|
|
-- **FR-065**：`URGENT` 表示 1 对 1 独占配送。骑手已有未送达外卖、`ACCEPTED` 或 `PICKED_UP` 闪送时不得接急送；骑手存在 `ACCEPTED` 或 `PICKED_UP` 急送时不得再接任何外卖或闪送。
|
|
|
|
|
|
|
+- **FR-065**：`deliveryType=URGENT` 表示 1 对 1 独占配送。骑手已有未送达外卖、`ACCEPTED` 或 `PICKED_UP` 闪送时不得接急送；骑手存在 `ACCEPTED` 或 `PICKED_UP` 急送时不得再接任何外卖或闪送。
|
|
|
- **FR-066**：所有有效骑手接单入口必须使用同一 Redisson 锁键 `lock:delivery:rider:{riderId}`，在持锁期间检查跨外卖和闪送订单的独占条件并执行接单；锁必须在数据库事务完成后释放，获取超时或 Redis 异常时按失败关闭原则拒绝接单。
|
|
- **FR-066**：所有有效骑手接单入口必须使用同一 Redisson 锁键 `lock:delivery:rider:{riderId}`，在持锁期间检查跨外卖和闪送订单的独占条件并执行接单；锁必须在数据库事务完成后释放，获取超时或 Redis 异常时按失败关闭原则拒绝接单。
|
|
|
- **FR-067**：闪送继续保持非支付业务，创建成功直接进入 `WAITING_ACCEPTANCE`，不增加待支付状态、支付倒计时、支付接口或退款流程。
|
|
- **FR-067**：闪送继续保持非支付业务，创建成功直接进入 `WAITING_ACCEPTANCE`，不增加待支付状态、支付倒计时、支付接口或退款流程。
|
|
|
- **FR-068**：所有闪送金额继续使用整数 TWD；蓝湖稿中的小数金额仅为视觉占位，不改变接口和数据库金额类型。
|
|
- **FR-068**：所有闪送金额继续使用整数 TWD；蓝湖稿中的小数金额仅为视觉占位，不改变接口和数据库金额类型。
|
|
|
- **FR-069**：用户端不得展示固定或伪造的附近骑手人数及预计接单分钟数，统一使用“发布后等待附近骑手接单”；本期不增加实时骑手数量或接单预测接口。
|
|
- **FR-069**：用户端不得展示固定或伪造的附近骑手人数及预计接单分钟数，统一使用“发布后等待附近骑手接单”；本期不增加实时骑手数量或接单预测接口。
|
|
|
|
|
+- **FR-070**：普通配送费等于起送价格与距离费之和；普通配送的加急费为 0，加急配送的加急费等于“普通配送费 × 当前时段加急比例”四舍五入到整数 TWD 后与最低加急费取较大值。
|
|
|
|
|
+- **FR-071**：骑手小费由用户提交，为独立的非负整数 TWD；订单总金额等于普通配送费、加急费和骑手小费之和，小费不得参与加急费计算。
|
|
|
|
|
+- **FR-072**：报价和订单响应必须分别返回 `baseDeliveryFee`、`distanceFee`、`urgentFee`、`tipAmount` 和 `amount`；加急报价还必须返回命中的 `urgentRate` 和 `minimumUrgentFee`，费用名称不得混用。
|
|
|
|
|
|
|
|
### 关键实体
|
|
### 关键实体
|
|
|
|
|
|
|
|
-- **闪送订单**：用户发布的取件配送任务，持有地址、路线、价格、服务类型、履约状态和关键时间快照。
|
|
|
|
|
-- **计价配置**：某一服务类型在一个时间范围内立即生效的起送距离、起送价格、计价距离、计价金额及版本信息。
|
|
|
|
|
|
|
+- **闪送订单**：用户发布的取件配送任务，持有业务场景、配送等级、物品、地址、路线、费用、履约状态和关键时间快照。
|
|
|
|
|
+- **计价配置**：供帮送和帮取共享、在一个时间范围内立即生效的起送距离、起送价格、计价距离、计价金额、加急比例、最低加急费及版本信息。
|
|
|
- **配送凭证**：用户下单时的可选寄件图片，以及骑手取件或送达时提交的必填图片记录。
|
|
- **配送凭证**：用户下单时的可选寄件图片，以及骑手取件或送达时提交的必填图片记录。
|
|
|
- **订单状态日志**：记录订单每次有效状态变化的操作审计信息。
|
|
- **订单状态日志**：记录订单每次有效状态变化的操作审计信息。
|
|
|
- **共享地址**：属于单一用户、可供闪送和现有收货业务共同使用的联系人与地点信息。
|
|
- **共享地址**：属于单一用户、可供闪送和现有收货业务共同使用的联系人与地点信息。
|
|
|
|
|
|
|
|
## 成功标准
|
|
## 成功标准
|
|
|
|
|
|
|
|
-- **SC-001**：三种服务的当前时段匹配、起送距离、0.5 公里边界、实际超出距离、整数新台币取整和加急配置报价测试全部通过。
|
|
|
|
|
|
|
+- **SC-001**：帮送/帮取共享运价、立即/预约时段匹配、起送距离、0.5 公里边界、实际超出距离、整数新台币取整、比例加急费、最低加急费和小费报价测试全部通过。
|
|
|
- **SC-002**：地图路线成功和失败降级场景均能在一次请求内返回可用报价，并准确标记距离来源。
|
|
- **SC-002**：地图路线成功和失败降级场景均能在一次请求内返回可用报价，并准确标记距离来源。
|
|
|
- **SC-003**：至少 20 个并发抢单请求针对同一订单时，数据库中恰好只有一名骑手成功绑定。
|
|
- **SC-003**：至少 20 个并发抢单请求针对同一订单时，数据库中恰好只有一名骑手成功绑定。
|
|
|
- **SC-004**：跨用户地址和订单的详情、修改、删除、置顶、取消及签收测试拦截率达到 100%。
|
|
- **SC-004**：跨用户地址和订单的详情、修改、删除、置顶、取消及签收测试拦截率达到 100%。
|
|
@@ -257,7 +263,7 @@
|
|
|
- **SC-007**：送达超过 24 小时的订单能够自动完成，且并发确认不会产生重复状态日志或重复副作用。
|
|
- **SC-007**：送达超过 24 小时的订单能够自动完成，且并发确认不会产生重复状态日志或重复副作用。
|
|
|
- **SC-008**：修改计价配置后，新订单使用新版本，历史订单保存的价格与配置快照保持不变。
|
|
- **SC-008**：修改计价配置后，新订单使用新版本，历史订单保存的价格与配置快照保持不变。
|
|
|
- **SC-009**：所有新增用户可见业务错误均能通过项目支持的语言资源解析，不出现硬编码单一语言结果。
|
|
- **SC-009**：所有新增用户可见业务错误均能通过项目支持的语言资源解析，不出现硬编码单一语言结果。
|
|
|
-- **SC-010**：拥有对应权限的管理员能够只通过平台页面完成三种服务价格维护和订单查询、详情、取消及完成操作，核心流程无需 Postman 或数据库操作。
|
|
|
|
|
|
|
+- **SC-010**：拥有对应权限的管理员能够只通过平台页面完成统一分时段运价维护和订单查询、详情、取消及完成操作，核心流程无需 Postman 或数据库操作。
|
|
|
- **SC-011**：价格和订单页面的接口路径、请求方法、查询参数及权限字符串契约测试全部通过，四个前端语言文件的 `flashDelivery` key 集合完全一致。
|
|
- **SC-011**：价格和订单页面的接口路径、请求方法、查询参数及权限字符串契约测试全部通过，四个前端语言文件的 `flashDelivery` key 集合完全一致。
|
|
|
- **SC-012**：平台前端生产构建通过，新增页面在 1280px 及以上后台常用宽度无横向页面溢出，表格窄屏时仅在表格区域滚动。
|
|
- **SC-012**：平台前端生产构建通过，新增页面在 1280px 及以上后台常用宽度无横向页面溢出，表格窄屏时仅在表格区域滚动。
|
|
|
|
|
|
|
@@ -273,7 +279,7 @@
|
|
|
## 非目标
|
|
## 非目标
|
|
|
|
|
|
|
|
- 不接入支付网关、付款、退款、取消费、退回费、结算或骑手收入分账。
|
|
- 不接入支付网关、付款、退款、取消费、退回费、结算或骑手收入分账。
|
|
|
-- 不实现代购、垫付款、商品金额、精确重量、件数或禁寄品电子确认；禁运品、货值和尺寸限制由前端展示规则说明，后端只校验本期明确的重量档和最大路线距离。
|
|
|
|
|
|
|
+- 不实现代购、垫付款、商品金额或禁寄品电子确认；禁运品和货值限制由前端展示规则说明，后端校验本期明确的物品数量、总重量、规格长度和最大路线距离。
|
|
|
- 不实现自动派单、抢单推送筛选、骑手在线状态计算或接单时间预测。
|
|
- 不实现自动派单、抢单推送筛选、骑手在线状态计算或接单时间预测。
|
|
|
- 不修改餐饮订单 `pos_order` 或打车订单 `taxi_order` 的业务语义。
|
|
- 不修改餐饮订单 `pos_order` 或打车订单 `taxi_order` 的业务语义。
|
|
|
- 不在本功能中实现用户端、骑手端或商家端页面；本轮前端增量仅实现平台管理端。
|
|
- 不在本功能中实现用户端、骑手端或商家端页面；本轮前端增量仅实现平台管理端。
|
qmj