foodie-server/specs/024-flash-delivery/data-model.md

数据模型：闪送配送服务

flash_delivery_order

核心字段：id、唯一 order_no、与用户联合唯一的 client_request_id、user_id、rider_id、service_type、status；package_type、package_size；delivery_mode、预约开始/结束时间；pin_required、四位交付 PIN；取件/收件联系人、电话、市/区、交付方式、地址、详细地址和经纬度快照；distance_meters、distance_source、estimated_duration_seconds；整数 amount、currency、pricing_id、pricing_version、pricing_start_time、pricing_end_time、starting_distance、starting_fare、distance、freight、distance_fee 计价快照；user_note、version、关键状态时间、取消审计及创建/更新时间。

索引：订单号唯一、用户幂等号唯一、待抢排序、用户列表、骑手列表、自动完成扫描。

flash_delivery_pricing

每个服务类型可保存多个运价时段。字段为 service_type、start_time、end_time、starting_distance、整数 starting_fare、distance、整数 freight、config_version、updated_by 和创建/更新时间。配置保存即生效，不保存 enabled；同一服务类型的时间段不得重叠，索引支持按服务类型和时间匹配当前时段。有效修改后版本加一，历史订单不回写。当前时段查询不使用 LIMIT 1 隐藏异常数据；若匹配到多条则明确返回配置重叠错误。

flash_delivery_pricing_lock

以 service_type 为主键，固定保存 HELP_SEND、HELP_PICKUP、URGENT 三行。新增、修改和删除运价时，事务先通过 SELECT ... FOR UPDATE 锁定涉及的服务类型，再检查重叠并写入，避免并发请求同时通过“先查重、后写入”。修改跨服务类型时按服务类型字典序加锁，避免反向加锁造成死锁。

flash_delivery_order_image

保存 order_id、proof_type（SENDER/PICKUP/DELIVERY）、image_url、sort_order、operator_type、operator_id、create_time。

flash_delivery_order_log

保存 order_id、from_status、to_status、operator_type（USER/RIDER/ADMIN/SYSTEM）、operator_id、reason、create_time。

info_address 增量

新增 is_top tinyint(1) not null default 0 和 top_time datetime null。列表按 is_top desc, top_time desc, id desc。

状态转换

当前	操作/角色	下一状态
WAITING_ACCEPTANCE	抢单/RIDER	ACCEPTED
WAITING_ACCEPTANCE	取消/USER、ADMIN	CANCELLED
ACCEPTED	取件且含图片/指定 RIDER	PICKED_UP
ACCEPTED	取消/USER、ADMIN	CANCELLED
PICKED_UP	送达且含图片/指定 RIDER	DELIVERED
PICKED_UP	异常取消/ADMIN	CANCELLED
DELIVERED	签收或自动/USER、SYSTEM、ADMIN	COMPLETED
DELIVERED	异常取消/ADMIN	CANCELLED

COMPLETED、CANCELLED 是终态。