foodie-server/ruoyi-system/src/main/resources/mapper/flash/FlashDeliveryOrderMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ruoyi.system.mapper.flash.FlashDeliveryOrderMapper">
    <resultMap id="FlashDeliveryOrderResult" type="FlashDeliveryOrder">
        <id property="id" column="id"/>
        <result property="orderNo" column="order_no"/>
        <result property="clientRequestId" column="client_request_id"/>
        <result property="userId" column="user_id"/>
        <result property="receiverUserId" column="receiver_user_id"/>
        <result property="riderId" column="rider_id"/>
        <result property="serviceType" column="service_type"/>
        <result property="deliveryType" column="delivery_type"/>
        <result property="status" column="status"/>
        <result property="packageType" column="package_type"/>
        <result property="quantity" column="quantity"/>
        <result property="weightRange" column="weight_range"/>
        <result property="specification" column="specification"/>
        <result property="deliveryMode" column="delivery_mode"/>
        <result property="scheduledPickupStartAt" column="scheduled_pickup_start_at"/>
        <result property="scheduledPickupEndAt" column="scheduled_pickup_end_at"/>
        <result property="pinRequired" column="pin_required"/>
        <result property="deliveryPinCode" column="delivery_pin_code"/>
        <result property="pickupName" column="pickup_name"/>
        <result property="pickupPhone" column="pickup_phone"/>
        <result property="pickupAddress" column="pickup_address"/>
        <result property="pickupAddressDetail" column="pickup_address_detail"/>
        <result property="pickupCity" column="pickup_city"/>
        <result property="pickupArea" column="pickup_area"/>
        <result property="pickupHandoffMethod" column="pickup_handoff_method"/>
        <result property="pickupLongitude" column="pickup_longitude"/>
        <result property="pickupLatitude" column="pickup_latitude"/>
        <result property="deliveryName" column="delivery_name"/>
        <result property="deliveryPhone" column="delivery_phone"/>
        <result property="deliveryAddress" column="delivery_address"/>
        <result property="deliveryAddressDetail" column="delivery_address_detail"/>
        <result property="deliveryCity" column="delivery_city"/>
        <result property="deliveryArea" column="delivery_area"/>
        <result property="deliveryHandoffMethod" column="delivery_handoff_method"/>
        <result property="deliveryLongitude" column="delivery_longitude"/>
        <result property="deliveryLatitude" column="delivery_latitude"/>
        <result property="distanceMeters" column="distance_meters"/>
        <result property="distanceSource" column="distance_source"/>
        <result property="estimatedDurationSeconds" column="estimated_duration_seconds"/>
        <result property="amount" column="amount"/>
        <result property="currency" column="currency"/>
        <result property="payType" column="pay_type"/>
        <result property="paymentStatus" column="payment_status"/>
        <result property="pricingId" column="pricing_id"/>
        <result property="pricingVersion" column="pricing_version"/>
        <result property="pricingStartTime" column="pricing_start_time"/>
        <result property="pricingEndTime" column="pricing_end_time"/>
        <result property="startingDistance" column="starting_distance"/>
        <result property="startingFare" column="starting_fare"/>
        <result property="distance" column="distance"/>
        <result property="freight" column="freight"/>
        <result property="distanceFee" column="distance_fee"/>
        <result property="baseDeliveryFee" column="base_delivery_fee"/>
        <result property="urgentRate" column="urgent_rate"/>
        <result property="minimumUrgentFee" column="minimum_urgent_fee"/>
        <result property="urgentFee" column="urgent_fee"/>
        <result property="tipAmount" column="tip_amount"/>
        <result property="userNote" column="user_note"/>
        <result property="version" column="version"/>
        <result property="acceptedAt" column="accepted_at"/>
        <result property="pickedUpAt" column="picked_up_at"/>
        <result property="deliveredAt" column="delivered_at"/>
        <result property="completedAt" column="completed_at"/>
        <result property="cancelledAt" column="cancelled_at"/>
        <result property="cancelReason" column="cancel_reason"/>
        <result property="cancelOperatorType" column="cancel_operator_type"/>
        <result property="cancelOperatorId" column="cancel_operator_id"/>
        <result property="createTime" column="create_time"/>
        <result property="updateTime" column="update_time"/>
    </resultMap>

    <select id="selectByUserRequestId" resultMap="FlashDeliveryOrderResult">
        select * from flash_delivery_order where user_id = #{userId} and client_request_id = #{clientRequestId} limit 1
    </select>

    <!-- 抢单必须在单条 SQL 中同时校验状态和骑手为空，避免并发查询后重复绑定。 -->
    <update id="accept">
        update flash_delivery_order
        set rider_id=#{riderId}, status='ACCEPTED', accepted_at=#{now}, update_time=#{now}, version = version + 1
        where id=#{id} and status = 'WAITING_ACCEPTANCE' and rider_id is null
          and (delivery_mode = 'NOW' or scheduled_pickup_start_at &lt;= #{now})
    </update>

    <!-- 编辑与抢单竞争时，由同一订单行的原子条件更新决定谁先成功。 -->
    <update id="updateWaitingAddress">
        update flash_delivery_order
        set pickup_name = #{order.pickupName}, pickup_phone = #{order.pickupPhone},
            pickup_address = #{order.pickupAddress}, pickup_address_detail = #{order.pickupAddressDetail},
            pickup_city = #{order.pickupCity}, pickup_area = #{order.pickupArea},
            pickup_handoff_method = #{order.pickupHandoffMethod},
            pickup_longitude = #{order.pickupLongitude}, pickup_latitude = #{order.pickupLatitude},
            delivery_name = #{order.deliveryName}, delivery_phone = #{order.deliveryPhone},
            delivery_address = #{order.deliveryAddress}, delivery_address_detail = #{order.deliveryAddressDetail},
            delivery_city = #{order.deliveryCity}, delivery_area = #{order.deliveryArea},
            delivery_handoff_method = #{order.deliveryHandoffMethod},
            delivery_longitude = #{order.deliveryLongitude}, delivery_latitude = #{order.deliveryLatitude},
            receiver_user_id = #{order.receiverUserId},
            distance_meters = #{order.distanceMeters}, distance_source = #{order.distanceSource},
            estimated_duration_seconds = #{order.estimatedDurationSeconds},
            pricing_id = #{order.pricingId}, pricing_version = #{order.pricingVersion},
            pricing_start_time = #{order.pricingStartTime}, pricing_end_time = #{order.pricingEndTime},
            starting_distance = #{order.startingDistance}, starting_fare = #{order.startingFare},
            distance = #{order.distance}, freight = #{order.freight},
            urgent_rate = #{order.urgentRate}, minimum_urgent_fee = #{order.minimumUrgentFee},
            distance_fee = #{order.distanceFee}, base_delivery_fee = #{order.baseDeliveryFee},
            urgent_fee = #{order.urgentFee}, amount = #{order.amount},
            update_time = #{order.updateTime}, version = version + 1
        where id = #{order.id} and user_id = #{order.userId}
          and status = 'WAITING_ACCEPTANCE' and rider_id is null and version = #{expectedVersion}
    </update>

    <update id="updateWaitingTip">
        update flash_delivery_order
        set tip_amount = #{order.tipAmount}, amount = #{order.amount},
            update_time = #{order.updateTime}, version = version + 1
        where id = #{order.id} and user_id = #{order.userId}
          and status = 'WAITING_ACCEPTANCE' and rider_id is null and version = #{expectedVersion}
    </update>

    <!-- 骑手履约同时校验订单归属和预期状态，只有中单骑手能按顺序推进。 -->
    <update id="transitionByRider">
        update flash_delivery_order
        set status=#{nextStatus},
            <choose><when test="timeColumn == 'picked_up_at'">picked_up_at=#{now},</when><otherwise>delivered_at=#{now},</otherwise></choose>
            update_time=#{now}, version = version + 1
        where id=#{id} and rider_id=#{riderId} and status=#{expectedStatus}
    </update>

    <!-- 用户确认收货必须同时满足订单归属和已送达状态。 -->
    <update id="transitionByParticipant">
        update flash_delivery_order
        set status=#{nextStatus}, completed_at=#{now}, update_time=#{now}, version = version + 1
        where id=#{id} and (user_id=#{userId} or receiver_user_id = #{userId}) and status=#{expectedStatus}
    </update>

    <!-- 平台/系统完成同样使用预期状态条件，防止与用户确认并发重复成功。 -->
    <update id="transitionByStatus">
        update flash_delivery_order
        set status=#{nextStatus}, completed_at=#{now}, update_time=#{now}, version = version + 1
        where id=#{id} and status=#{expectedStatus}
    </update>

    <!-- 取消时保存完整审计字段，并以调用前读取的状态作为并发条件。 -->
    <update id="cancel">
        update flash_delivery_order
        set status='CANCELLED', cancelled_at=#{now}, cancel_reason=#{reason},
            cancel_operator_type=#{operatorType}, cancel_operator_id=#{operatorId},
            update_time=#{now}, version = version + 1
        where id=#{id} and status=#{expectedStatus}
    </update>

    <!-- 定时任务只扫描达到 24 小时阈值且仍处于已送达状态的订单。 -->
    <select id="selectAutoCompletable" resultMap="FlashDeliveryOrderResult">
        select * from flash_delivery_order
        where status='DELIVERED' and delivered_at &lt;= #{deadline}
        order by delivered_at asc limit #{limit}
    </select>
</mapper>