foodie-server/specs/024-flash-delivery/tasks.md

任务：闪送配送服务

Phase 1：测试红灯与数据层

• T001 编写计价、状态机、路线测试并确认因实现缺失而失败
• T002 编写 MyBatis XML 契约测试，覆盖映射、原子抢单和自动完成条件并确认失败
• T003 在 updatesql/sql.md 记录四张新表、地址字段、索引、计价种子和后台权限 SQL
• T004 新增闪送实体、Mapper、XML 与地址置顶/安全条件方法，使数据层测试转绿

Phase 2：US1 报价与订单创建

• T005 [US1] 先写报价边界、路线降级、配置停用、无效地址、重算和幂等测试并确认红灯
• T006 [US1] 实现 Routes 客户端、Haversine 降级、计价器和配置读取
• T007 [US1] 实现 home/quote/create DTO、服务与 Controller，保存快照和创建日志
• T008 [US1] 运行 US1 定向测试转绿

Phase 3：US2 骑手抢单和配送

• T009 [US2] 先写骑手角色、脱敏、排序、原子抢单、越权、图片必填测试并确认红灯
• T010 [US2] 实现骑手 available/mine/detail/accept/pickup/deliver
• T011 [US2] 同事务保存图片和状态日志，运行 US2 测试转绿

Phase 4：US3 安全共享地址簿

• T012 [US3] 先写跨用户拒绝、userId 忽略和搜索排序测试并确认红灯
• T013 [US3] 新增地址 DTO，修复匿名删除/详情和实体直绑，提供 DELETE/top
• T014 [US3] 更新地址 Mapper/XML 并运行地址安全测试转绿

Phase 5：US4 用户跟踪、取消和签收

• T015 [US4] 先写本人查询、越权、取消、签收、终态和自动完成并发测试并确认红灯
• T016 [US4] 实现用户列表/详情/cancel/confirmReceipt
• T017 [US4] 实现 24 小时自动完成任务，运行 US4 测试转绿

Phase 6：US5 平台配置和介入

• T018 [US5] 先写权限注解、计价版本、查询、异常取消和平台完成测试并确认红灯
• T019 [US5] 实现平台 pricing 和 orders API
• T020 [US5] 运行 US5 测试转绿

Phase 7：交付

• T021 为五个 i18n 文件添加一致的闪送/地址错误 key 与一致性测试
• T022 核对 API 契约、实现、权限和 SQL，更新任务状态
• T023 JDK 21 运行定向测试、模块构建和 git diff --check
• T024 核对暂存范围并准备中文提交

Phase 8：补充用户端/骑手端原型

• T025 更新包裹、预约、PIN、寄件凭证、费用明细和角色脱敏规格/API/SQL
• T026 先写计价明细、预约抢单条件、PIN、寄件凭证、状态分组和安全响应测试并确认红灯
• T027 扩展订单/计价/凭证实体、Mapper XML 和数据库迁移记录
• T028 实现包裹信息、预约配送、40 公里限制和服务端费用明细
• T029 实现 PIN 送达与 SENDER/PICKUP/DELIVERY 三类凭证
• T030 实现用户/骑手状态分组分页、角色业务视图和骑手公开摘要
• T031 更新 API 契约与 i18n，并运行 JDK 21 定向测试、模块构建和差异检查

Phase 9：US6 平台管理前端

• T032 [US6] 在 foodie-admin-vue/tests/flash-delivery.test.cjs 和 package.json 增加闪送定向测试，直接执行请求配置、分页归一化、价格校验、状态操作和四语言对象，并确认因目标模块缺失而红灯
• T033 [US6] 新增 src/api/flashDelivery/contracts.js、index.js 和 src/views/flashDelivery/shared.js，封装六个平台请求及纯函数，使请求、分页、价格校验和状态规则测试转绿
• T034 [US6] 新增 src/views/flashDelivery/pricing/index.vue，实现三类价格读取、编辑校验、启停、版本展示和保存后服务端回填
• T035 [US6] 新增 src/views/flashDelivery/orders/index.vue 与 OrderDetail.vue，实现服务端分页筛选、详情分区、图片预览、取消原因和已送达完成操作
• T036 [US6] 在四个 src/api/language/language.*.js 文件增加一致的 flashDelivery 文案，并使语言与页面契约测试转绿
• T037 [US6] 在 updatesql/sql.md 追加幂等的“闪送管理/价格配置/闪送订单”动态菜单 SQL，将现有六项权限归入对应页面
• T038 [US6] 运行 npm run test:flash-delivery、新增文件 ESLint、npm run build:prod 和两个仓库 git diff --check，核对暂存范围后分别使用中文提交

Phase 10：外卖同规则时段运价

• T039 [US1] 先重写 FlashDeliveryPricingCalculatorTest，覆盖起送内、0.49/0.50/0.99/1.20 公里边界、非 1 公里计价距离、整数 HALF_UP 和非法配置，并确认旧计价实现红灯
• T040 [US1] 重写 FlashDeliveryPricing、FlashDeliveryOrder、费用 DTO、订单 XML 和计价器，删除最低价、分钟价、尖峰与启停字段，实现整数 TWD 的外卖同规则距离计价
• T041 [US5] 先扩展 FlashDeliveryApplicationServiceTest 与 FlashDeliveryControllerContractTest，覆盖当前时段、无时段、重叠、新增、按 ID 修改、版本冲突、删除和新订单快照，并确认旧服务接口红灯
• T042 [US5] 实现 FlashDeliveryPricingMapper 当前时段/重叠查询、服务类型行锁、时段 CRUD、home/quote/create 当前时段唯一性检查、完整快照及四语言业务错误，使后端定向测试转绿
• T043 [US6] 先更新 tests/flash-delivery.test.cjs，覆盖价格 GET/POST/PUT/DELETE、六字段载荷、时段与整数校验、页面权限和四语言 key，并确认旧前端红灯
• T044 [US6] 更新前端 API、shared.js、价格时段新增/编辑/删除页面、订单费用详情和四语言，删除启停、最低价、分钟价与尖峰展示，使定向测试转绿
• T045 在 updatesql/sql.md 追加开发阶段重建脚本：删除旧闪送测试表并创建运价锁、时段配置、新订单快照与索引的最终结构；只记录不执行
• T046 使用 JDK 21 运行后端定向测试和模块构建，运行前端定向测试、强制 ESLint、生产构建、CRLF 与两个仓库差异检查
• T047 核对两个仓库暂存范围，分别使用中文提交并推送当前 test 分支，不包含后端仓库原有脏文件

Phase 11：App 订单列表与详情精简

• T048 先改 Controller 反射、列表字段白名单和详情直接响应测试，确认旧 /available、/mine、多筛选参数及 {order,images,logs} 契约红灯
• T049 新增用户列表、骑手列表、骑手分页 DTO，将 App 详情 DTO 改为直接订单字段和三类明确照片 URL 数组，删除旧待抢/图片/日志 App DTO
• T050 先改应用服务测试，覆盖用户轻量列表、五个骑手页签、外卖同规则附近范围/排序、摘要、预约条件、本人边界、接单前地址权限和固定详情结构并确认红灯
• T051 将用户列表收敛为 page,size，将骑手 /orders 收敛为 page,size,tab,longitude,latitude，在数据库分页前完成条件与距离排序
• T052 重写 App 详情映射，直接返回订单字段并按类型聚合照片 URL，不查询或返回原始状态日志；补齐五语言参数错误
• T053 更新 docs/flash-delivery-app-api.md 与 quickstart，删除旧列表路由、筛选、近似坐标及 App 包装响应说明
• T054 使用 JDK 21 运行闪送定向测试、i18n 契约、模块构建和差异检查，核对暂存范围后使用中文提交并推送 test

2026-09-01 中断点（已于 2026-09-02 收口）

• T048–T053 的生产代码、测试源码、五语言文案和接口文档已在 2026-09-01 写入工作区；2026-09-02 完成修复、验证并提交。
• 收口时修复两处阻塞：FlashDeliveryApplicationService.riderOrders 改用 effectiveLongitude/effectiveLatitude 有效坐标变量解决 lambda 捕获编译错误；FlashDeliveryApplicationServiceTest.assertRiderTab 改为先渲染 getSqlSegment() 再断言参数表（MyBatis-Plus 条件参数为惰性写入，原断言在渲染前读取恒为空）。
• 验证结果：JDK 21 定向测试 40 项全部通过（0 失败、0 错误）；mvn -pl ruoyi-admin -am -DskipTests package 成功；git diff --check 清洁。
• 另按审核结论补记 sys_job 闪送自动完成调度 SQL（见 updatesql/sql.md 2026-09-02 节），并在 plan.md 修订并发描述与实现一致。
• 已有规格提交：17888f8（明确闪送 App 订单列表与详情契约）、8a3ea64（制定闪送 App 订单接口精简计划）。

Phase 12：新版蓝湖稿的收件人订单与急送独占

• T055 更新规格、设计、数据模型和 API 契约，固定非支付、整数 TWD、静态等待接单文案、创建时收件账号匹配及急送独占规则
• T056 先扩展 Mapper、应用服务和 Controller 测试，覆盖收件账号唯一匹配、无匹配、重复匹配、历史不追溯、role 列表、参与者详情/签收、收件人禁止取消，并确认旧实现红灯
• T057 新增 receiver_user_id 实体/XML/索引和普通用户手机号精确匹配查询，实现创建时固化、寄件人/收件人数据库分页及参与者权限
• T058 先补跨外卖/闪送接单测试，覆盖骑手级 Redisson 锁、忙碌骑手拒绝急送、急送阻止其他接单、终态释放和并发串行检查，并确认旧实现红灯
• T059 以共享锁键 lock:delivery:rider:{riderId} 实现 URGENT 跨订单独占，事务完成后释放锁，并在当前有效外卖与闪送接单入口返回一致的国际化业务错误
• T060 在 updatesql/sql.md 追加 receiver_user_id 字段和索引迁移，仅记录不执行；同步 App 接口文档和五语言错误文案
• T061 使用 JDK 21 运行闪送、外卖接单和 i18n 定向测试、模块构建与差异检查，核对暂存范围后使用中文提交

Phase 13：设计稿费用与物品信息对齐

• T062 修正规格、设计、数据模型和 API 契约，确认帮送/帮取与普通/加急正交、统一分时段运价、比例加急费、最低加急费、小费、预约计价时刻、报价回传校验及完整物品字段
• T063 扩展计价器、运价 Mapper 和订单 XML 测试，覆盖比例加急费、最低值、小费、全局时段与新增快照字段；按用户要求集中实现后统一验证，未单独执行旧实现红灯
• T064 修改运价/订单实体、Mapper、XML 和计价器，移除按服务类型分价并使数据层与计价测试转绿
• T065 扩展应用服务、Controller、DTO 和独占测试，覆盖完整请求响应、立即/预约计价、前端报价逐项校验、最新报价错误、物品校验及 deliveryType=URGENT；按用户要求未单独执行旧实现红灯
• T066 实现报价、创建、列表、详情和独占逻辑，保存业务场景、配送等级、物品与完整费用快照，使 App 定向测试转绿
• T067 更新平台后端契约和 foodie-admin-vue 闪送测试，实现统一时段配置、加急比例、最低加急费、订单明细及四语言；按用户要求未单独执行旧页面红灯
• T068 在 updatesql/sql.md 追加迁移 SQL，不执行数据库；同步五语言后端错误、App 接入文档和 quickstart
• T069 使用 JDK 21 完成后端 69 项定向测试和模块构建、平台前端 8 项定向测试及两个仓库差异检查；用户要求立即提交后，不再执行平台 ESLint 与生产构建
• T070 核对后端与平台前端暂存范围，分别使用中文提交；SHA 与未执行项记录在最终交付中

Phase 14：移除运价专用锁表

• T071 记录简化设计和实施计划，确认接受低频后台并发新增的极低概率重叠风险，保留事务、重叠校验、版本校验和读取侧异常保护
• T072 先移除应用服务测试夹具对固定锁行的模拟，运行新增运价测试并确认旧实现因依赖锁行红灯
• T073 删除 Mapper 锁方法、运价增删改锁调用及内部锁断言，同步规格和删表 SQL
• T074 使用 JDK 21 运行闪送运价定向测试、模块构建和差异检查，核对暂存范围后中文提交并推送

Phase 15：物品重量改为设计稿四档范围

• T075 记录四档 weightRange 的接口、数据迁移和验收设计，并制定实施计划
• T076 修改服务、DTO 和 Mapper 契约测试，确认旧实现缺少 weightRange 映射的预期红灯
• T077 将请求、订单实体、MyBatis 映射和用户/骑手/详情响应统一改为 weightRange，删除精确重量和三档尺寸派生逻辑
• T078 更新人工迁移 SQL、现有规格和 App 接入文档，完整说明报价与创建订单入参
• T079 使用 JDK 21 运行定向测试（50 项）、模块编译、完整回归（401 项）和差异检查，全部通过；迁移 SQL 未执行

Phase 16：待接单订单修改地址与追加小费

• T080 记录已确认范围、接口和原子保存方案，沿用订单计价快照
• T081 补端点及条件更新测试并确认旧实现红灯
• T082 实现地址报价/确认保存、追加小费、订单版本及六语言错误
• T083 补归属、收件人绑定、费用确认、并发接单/修改/重复请求和金额边界测试
• T084 更新 App 接口契约，执行 JDK 21 定向测试、模块编译、后端回归和差异检查

Phase 16 验证记录（2026-09-09）

• 首轮契约红灯：新增 Controller 和 Mapper 断言均因缺失接口/条件更新而失败；为一次收集两模块预期失败，红灯命令使用 maven.test.failure.ignore=true，已核对实际失败报告。
• 定向测试：JDK 21 运行 FlashDeliveryApplicationServiceTest、FlashDeliveryControllerContractTest、FlashDeliveryMapperXmlTest、FlashDeliveryI18nContractTest、FlashDeliveryOrderViewTest，75 项通过。
• 金额审查修复：新增 JSON additionalTipAmount=1.9 测试，确认 Long 绑定曾被截断且写入成功；改用 BigDecimal + longValueExact 后拒绝小数及 1e100，均覆盖不写库断言。
• 最终回归：JDK 21 执行 mvn -B -pl ruoyi-admin -am test，ruoyi-system 54 项、ruoyi-admin 420 项，共 474 项通过，0 失败/错误/跳过，所有参与模块 BUILD SUCCESS。
• 只读代码审查通过；git diff --check 通过，未发现无关修改或整文件换行重写。
• 未执行真实数据库、地图及 App 接口联调；本次无需数据库迁移，未执行 SQL。提交范围为本功能代码、测试及文档。

Phase 17：编辑操作订单 ID 改为 JSON 入参

• T085 将确认修改地址和追加小费改为固定 URL + 请求体 orderId，更新契约/边界测试并确认旧路径红灯
• T086 同步 App 文档、规格、接口示例，执行 JDK 21 定向测试与差异检查

Phase 17 验证记录（2026-09-09）

• 新端点契约测试先确认旧路径红灯；随后固定 URL 和 JSON orderId 绑定、无效 ID 拦截测试通过。
• JDK 21 执行 mvn -B -pl ruoyi-admin -am -Dtest=FlashDeliveryControllerContractTest,FlashDeliveryApplicationServiceTest -Dsurefire.failIfNoSpecifiedTests=false test：72 项通过，所有参与模块编译成功。
• docs/flash-delivery-app-api.md 已同步，JSON 示例解析及差异检查通过，保留 CRLF。
• 本轮 URL/入参调整后未重跑完整回归，前一阶段完整回归为 474 项通过；真实地图、数据库及 App 联调仍未执行。