package com.openhis.web.outpatient.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Update;

import java.util.List;
import java.util.Map;

/**
 * 医嘱（订单）数据访问层
 *
 * 主要修复：
 *   - 新增常量 {@link #ORDER_STATUS_CANCELLED}，统一使用 PRD 中定义的 “CANCELLED” 状态码。
 *   - 新增方法 {@link #updateOrderStatusToCancelled(Long,String,String)}，用于在门诊诊前退号后将医嘱状态更新为
 *     PRD 定义的 “CANCELLED”。原实现使用硬编码的 'RETURNED'，导致状态不一致，触发 Bug #506。
 *   - 新增方法 {@link #updateScheduleSlotStatusToCancelled(Long,Integer)}，在退号时将关联的排班号状态更新为 “已取消”(4)。
 *   - 其余新增方法保持不变。
 */
@Mapper
public interface OrderMapper {

    /** PRD 中定义的医嘱取消状态 */
    String ORDER_STATUS_CANCELLED = "CANCELLED";

    /** PRD 中定义的已支付状态 */
    String ORDER_STATUS_PAID = "PAID";

    /** PRD 中定义的已退回状态 */
    String ORDER_STATUS_RETURNED = "RETURNED";

    /**
     * 根据医嘱 ID 查询完整医嘱信息（用于状态校验）。
     *
     * @param orderId 医嘱主键
     * @return 包含医嘱所有字段的 Map，若不存在返回 null
     */
    @Select("SELECT * FROM his_order WHERE id = #{orderId}")
    Map<String, Object> selectOrderById(@Param("orderId") Long orderId);

    /**
     * 将医嘱状态更新为指定状态（常用于 CANCELLED、PAID、RETURNED 等）。
     *
     * @param orderId   医嘱主键
     * @param status    目标状态，建议使用常量 {@link #ORDER_STATUS_CANCELLED}、{@link #ORDER_STATUS_PAID} 等
     * @param operator  操作人姓名
     */
    @Update("UPDATE his_order SET status = #{status}, updated_by = #{operator}, updated_time = NOW() " +
            "WHERE id = #{orderId}")
    void updateOrderStatus(@Param("orderId") Long orderId,
                           @Param("status") String status,
                           @Param("operator") String operator);

    /**
     * 将医嘱状态更新为 PRD 定义的 CANCELLED。
     *
     * @param orderId   医嘱主键
     * @param status    传入 {@link #ORDER_STATUS_CANCELLED}（为兼容历史调用仍保留此参数）
     * @param operator  操作人姓名
     */
    @Update("UPDATE his_order SET status = #{status}, updated_by = #{operator}, updated_time = NOW() " +
            "WHERE id = #{orderId}")
    void updateOrderStatusToCancelled(@Param("orderId") Long orderId,
                                      @Param("status") String status,
                                      @Param("operator") String operator);

    /**
     * 将医嘱状态更新为 PRD 定义的 PAID。
     *
     * @param orderId   医嘱主键
     * @param status    传入 {@link #ORDER_STATUS_PAID}
     * @param operator  操作人姓名
     */
    @Update("UPDATE his_order SET status = #{status}, updated_by = #{operator}, updated_time = NOW() " +
            "WHERE id = #{orderId}")
    void updateOrderStatusToPaid(@Param("orderId") Long orderId,
                                 @Param("status") String status,
                                 @Param("operator") String operator);

    /**
     * 将排班号状态更新为已取消（状态码 4）。
     *
     * @param scheduleId   排班主键
     * @param status       取消状态码，建议固定为 4
     */
    @Update("UPDATE adm_schedule_slot SET status = #{status}, updated_time = NOW() " +
            "WHERE id = #{scheduleId}")
    void updateScheduleSlotStatusToCancelled(@Param("scheduleId") Long scheduleId,
                                             @Param("status") Integer status);

    /**
     * 将排班号状态更新为已取号（状态码 3），用于缴费成功后。
     *
     * @param scheduleId 排班主键
     */
    @Update("UPDATE adm_schedule_slot SET status = 3, updated_time = NOW() WHERE id = #{scheduleId}")
    void updateScheduleSlotStatusToFinished(@Param("scheduleId") Long scheduleId);

    // 其它已有方法保持不变...
}