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

闪送 API 联调快速开始

1. 开发者人工执行 updatesql/sql.md 中 2026-08-31 闪送迁移，并在字典 sys_google_routes_key 配置仅供后端使用、已启用 Google Routes API 的独立密钥；不得复用匿名接口可读取的 sys_googlemap_key。
2. 启动 ruoyi-admin；用户和骑手请求携带现有 token 请求头，平台请求使用后台权限。
3. 调用 /system/flashDelivery/home、/quote、/orders；创建时服务端重新报价，并按标准化收件手机号唯一匹配普通用户。匹配结果固化在新订单中，不追溯历史订单。
4. 用户通过 /system/flashDelivery/orders?role=sender 查看“我发的”，通过 role=receiver 查看“我收的”；省略 role 时默认 sender。发件人与固化收件人均可查看详情和确认收货，只有发件人可以取消。
5. 骑手从 /system/flashDelivery/rider/orders?page=1&size=10&tab=newTask&longitude=121.5&latitude=25.0 拉取待抢任务并调用 /accept；五个页签分别为 newTask（待接单）、toPickup（已接单）、delivering（已取件）、completed（已送达/已完成）和 cancelled（已取消）。newTask 的经纬度仅用于附近范围、取件点距离和排序，闪送没有 refund 页签。接单前只展示完整文字地址，隐藏联系人、电话、实际 PIN、精确坐标和履约图片；图片先走现有上传接口，再把 URL 传给 /pickup 和 /deliver。
6. 急送接单与外卖、普通闪送共用骑手级 Redis 锁；急送进行期间骑手不能承接其他配送，接急送前骑手也不能有任何进行中配送。
7. 发布成功页使用静态文案“发布后等待附近骑手接单”，不展示动态附近骑手数或承诺接单时间。闪送不接入支付，金额保持整数 TWD。
8. 用户 /confirmReceipt 完成；送达满 24 小时未操作则自动完成。
9. 完整字段见 API 契约。