首頁 探索 說明
登入
fa88
/
foodie-server
1
0
複刻 0
檔案 問題管理 0 合併請求 0 Wiki
目錄樹: 6cf171034a
分支列表 標籤列表
foodie-server
/
specs
/
024-flash-delivery
/
tasks.md

tasks.md 23 KB
文件歷史 原始文件

任务：闪送配送服务

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 联调仍未执行。

    Phase 18：多取货点（多取一送）

本阶段按 2026-09-15 用户确认的方式 2 更新，以 FR-094 至 FR-098 替换原无条件自由取件规则。后端、平台 PC 和关联文档已实现并执行本地验证；T097 仅记录需求修订。T095、T099、T100 的真实 MySQL 并发/回滚及 App 联调部分仍待执行，不能用 Mock 测试替代，详细结果见 validation.md。

  • T087 记录多取货点规格、计划与任务：多取一送、通用站点表、整线距离计价、每站独立联系人及物品、原取件顺序设计（已由 T097 修订）、用户顺序用于报价展示、加急允许多点、点间无独立距离限制、双开关与数量上限走数据字典
  • T088 编写并运行多点定向测试确认旧实现缺失：独立物品、输入兼容/冲突、单点可省略及多点必传 stopId、默认按序及记录同意声明后调整、前往与取件分离、重试/并发幂等、取消与取件竞争、末站并发及事务回滚、字典 1..26/非法回退；数据库并发验证与模拟测试分开记录
  • T089 在 updatesql/sql.md 记录站点表（独立联系人、地址、物品、履约信息及索引）、订单 pickup_stop_count、站点凭证关联及三个字典项 SQL；上限初始值 1，只记录不执行，不做历史迁移/回退或测试数据清理
  • T090 新增 FlashDeliveryOrderStop 实体/Mapper/XML，扩展订单映射、首点地址/物品摘要及订单行锁查询；实现多经点请求和逐段直线降级，最多 26 取点/25 中途点及整线 40 公里校验
  • T091 实现逐站物品 pickups[] 报价/创建、旧 pickup 单点适配及冲突拒绝；统一开关/上限/地址/物品校验、站点写入和复算；地址编辑同步完整站点、物品、摘要及收件人绑定，同事务版本保护；小费仅增金额、不查路线
  • T092 实现原 pickup 与路径 stopId 接口：单点可省略、多点必传、两处 ID 一致性、按 FR-096 校验当前目标及必要的调整记录、每站凭证、重试无副作用、全部取完才推进 PICKED_UP；多点缺少 stopId 不得动态选择下一未取站，已确认站点重试不受当前目标变化影响
  • T093 实现取件与用户/平台取消共用订单行锁及事务，任意站已取禁止用户自助取消，取消后禁止新取件；补 stops 独立物品/凭证、列表首点摘要及 pickupStopCount、已取数量/总数量与取消条件、逐站脱敏、平台详情及首页有效 pickupStopLimit/双开关
  • T094 更新 contracts/api.md、data-model.md、quickstart.md、docs/flash-delivery-app-api.md 和现有全部后端语言资源，平台改动同步四语言；明确新旧输入、站点物品、地址编辑及顺序重报价、幂等及取消、默认下一站、调整记录/骑手声明和异常交接；导航到默认或沟通后调整的单站并使用 travelmode=two-wheeler，前往与取件分离，不将本项目方案写成 Lalamove 已核实流程
  • T095 JDK 21 运行闪送定向测试、模块构建、git diff --check，检查变更范围及编码换行；实际验证取消/取件与末站并发事务，明确未执行的数据库/地图/App 联调及回归，核对暂存范围后中文提交

  • [x] T096 按用户逐项确认修订本三件套：每站独立物品、单点可省略/多点必传 stopId、原自由取件规则（已由 T097 替换）、任意站取货后禁止用户取消及并发保护、不考虑历史订单、字典限制 1..26/非法回退 1；其余采用审核建议，保留旧单点输入、小费不重算和修正导航参数

  • [x] T097 按 2026-09-15 会话确认的方式 2 修订 spec.md、plan.md、tasks.md：用户可排序并确认报价、默认下一站、沟通同意后调整及记录原因/骑手/时间/声明、原顺序与金额保留、实际进度、前往与取件分离、不能漏取及异常交接边界；首期无用户 App 审批，骑手声明不等同用户同意证明

  • [x] T098 实现 FR-095、FR-096 当前目标及调整记录保存、DTO/实体/Mapper/视图/必要 SQL、原因与声明校验、订单权限和状态保护、重复请求与并发保护；取件校验有效目标及必要记录，目标完成后回到原顺序最早未取站，不修改原顺序/物品/金额

  • [ ] T099 落实用户端排序与提示、骑手端默认下一站/沟通后选择目标/前往与取件分离、各端实际取件进度及取消入口；平台可核对调整声明、异常处理结果和已取物品去向/交接凭证，用户可见文案国际化，聊天可作为沟通依据

  • [ ] T100 补充并执行顺序调整验收：有无原因/声明、直接取件绕过、导航不推进状态、B 取件后回 A、原顺序与金额不变、进度/取消按钮、声明展示、异常交接、调整重复及与取件/取消并发、已取站重试；配合 T095 记录实际测试与 App/数据库联调结果

Phase 18 本地交付记录（2026-09-15）

  • T088：已完成单元、契约及 Mapper 检查；Mock 只验证锁调用顺序、异常传播和事务边界，真实数据库并发与回滚归入 T095 未验收部分。
  • T095：后端定向 131 项通过、JDK 21 模块打包通过；原有支付测试冲突保留且单列，尚未执行真实 MySQL、Google 地图及 App 联调，未跑全仓回归。
  • T099：平台站点、进度、目标声明和异常交接页面已实现并通过浏览器模拟接口检查；当前工作区没有用户/骑手闪送页面源码，客户端部分保留待办，商家 PC 未新增入口。
  • T100：默认目标、同意声明、目标调整重试、逐站取件幂等、取完 B 回 A、金额不变、取消限制和平台异常交接已覆盖本地测试；真实并发、数据库回滚与 App 操作链路未验收。
  • 地图计价继续使用现有 Google provider，扩展有序多经点和整线直线降级；Foodie_HCM_Map 部署与后端切换不在本次交付内。

Phase 19：骑手接单资格与容量限制

  • T101 记录 FR-099 至 FR-104：外卖/闪送共用锁内资格与容量检查，三个字典上限 1..20、缺失或非法回退 1，急送继续跨类型独占；待抢列表和位置规则不在本阶段实施
  • T102 先补策略及应用服务测试确认旧实现缺少普通闪送容量、跨类型总容量和锁内统一资格校验，再实现 RiderDeliveryAcceptanceService 并迁移两个当前有效接单入口
  • T103 同步六套后端国际化文案、App 接口文档、契约及 updatesql/sql.md，三个字典初始值均为 1，SQL 只记录不执行
  • T104 使用 JDK 21 运行策略、外卖/闪送接单及国际化定向测试和模块构建，执行差异检查；单列与本次无关的仓库基线失败及未执行的真实数据库/App 联调

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

  • JDK 21 定向运行 RiderDeliveryAcceptanceServiceTest、FlashDeliveryI18nContractTest、OrderLifecycleServiceTest 及闪送抢单的 3 个应用服务用例，共 30 项通过，0 失败/错误/跳过。
  • JDK 21 执行 mvn -pl ruoyi-admin -am -DskipTests package，全部参与模块 BUILD SUCCESS；git diff --check 通过。
  • 扩大运行完整 FlashDeliveryApplicationServiceTest 时发现仓库基线既有矛盾：normalizePayType 当前允许任意非空支付类型，而 createRejectsUnsupportedPayType 仍要求拒绝 2；本次未修改该逻辑，也未为接单容量需求顺带修复。
  • 三个字典 SQL 仅记录、未执行；未进行真实 MySQL 并发、Redis 多实例或骑手 App 联调，待抢列表和位置/距离规则按 FR-104 保持未实施。

Phase 20：合并车型路线、计价与多取货点

  • T105 将 test 的车型运价、Google 路线车型、直线降级预计时长和骑手车型匹配合入 test-202609v1，保留多取一送的完整站点序列、骑手容量限制及其 SQL。
  • T106 统一基础配送费语义：baseDeliveryFee 仅为起步价，距离附加费独立使用 distanceFee，订单金额由各费用相加；地址改动仍按订单快照计算。
  • T107 重申重量区间和规格为选填：未填写不阻断报价；填写重量时仍校验四档枚举，规格最长 255 字符。
  • T108 使用 JDK 21 运行闪送相关定向测试（127 项），并记录车型迁移 SQL；真实 MySQL 迁移、Google 地图及 App 联调未执行。