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)}，用于在门诊诊前退号后将医嘱状态更新为
 *     PRD 定义的 “CANCELLED”。原实现使用硬编码的 'RETURNED'，导致状态不一致，触发 Bug #506。
 *   - 新增方法 {@link #selectOrderDetailById(Long)}，显式返回诊疗目录配置的总量单位字段，
 *     解决医嘱录入后总量单位显示为 “null” 的 Bug #561。
 *   - 新增方法 {@link #updateOrderStatusToPaid(Long,String)}，在支付成功后将订单状态更新为
 *     PRD 中定义的 “PAID”。该方法在 {@link com.openhis.web.outpatient.service.impl.RegistrationServiceImpl}
 *     中被调用，用以修复 Bug #574。
 *   - 新增方法 {@link #updateScheduleSlotStatusToFinished(Long)}，在预约缴费成功后将对应的
 *     排班号（adm_schedule_slot）状态更新为 “3”（已取号），解决 Bug #574。
 *
 * 为了解决门诊医生工作站‑待写病历页面加载慢（>2 秒）的问题，新增了
 * {@link #selectPendingMedicalRecords(Long, int, int)} 方法，采用分页查询并只返回
 * 前端展示所需的关键字段，显著降低单次查询的数据量。
 *
 * 该接口的实现依赖 MyBatis 动态 SQL，保持与项目其他 Mapper 的风格一致。
 */
@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);

    /**
     * 更新医嘱状态为已支付。
     *
     * @param orderId   医嘱ID
     * @param payTime   支付时间（字符串形式）
     * @param status    支付后状态码，建议使用 {@link #ORDER_STATUS_PAID}
     * @return 受影响的行数
     */
    @Update("UPDATE his_order SET status = #{status}, pay_time = #{payTime}, update_time = NOW() WHERE id = #{orderId}")
    int updateOrderStatusToPaid(@Param("orderId") Long orderId,
                                @Param("payTime") String payTime,
                                @Param("status") String status);

    /**
     * 更新医嘱状态为已取消（退号）。
     *
     * @param orderId 医嘱ID
     * @param cancelTime 取消时间
     * @return 受影响的行数
     */
    @Update("UPDATE his_order SET status = #{status}, cancel_time = #{cancelTime}, update_time = NOW() WHERE id = #{orderId}")
    int updateOrderStatusToCancelled(@Param("orderId") Long orderId,
                                     @Param("cancelTime") String cancelTime,
                                     @Param("status") String status);

    /**
     * 更新医嘱状态为已退回（用于药房退药流程）。
     *
     * @param orderId 医嘱ID
     * @param status  退回状态码，建议使用 {@link #ORDER_STATUS_RETURNED}
     * @return 受影响的行数
     */
    @Update("UPDATE his_order SET status = #{status}, update_time = NOW() WHERE id = #{orderId}")
    int updateOrderStatus(@Param("orderId") Long orderId,
                          @Param("status") String status);

    /**
     * 查询医嘱详情（包括诊疗目录配置的总量单位字段）。
     *
     * @param orderId 医嘱ID
     * @return 详情 Map
     */
    @Select("SELECT o.*, d.total_quantity_unit FROM his_order o " +
            "LEFT JOIN his_diagnosis_detail d ON o.diagnosis_detail_id = d.id " +
            "WHERE o.id = #{orderId}")
    Map<String, Object> selectOrderDetailById(@Param("orderId") Long orderId);

    /**
     * 分页查询待写病历的医嘱（仅返回前端需要的关键字段）。
     *
     * @param doctorId 医生ID
     * @param offset   起始行
     * @param limit    每页条数
     * @return 医嘱列表
     */
    @Select("<script>" +
            "SELECT id, patient_id, order_name, status " +
            "FROM his_order " +
            "WHERE doctor_id = #{doctorId} AND status = 'PAID' " +
            "ORDER BY create_time DESC " +
            "LIMIT #{offset}, #{limit}" +
            "</script>")
    List<Map<String, Object>> selectPendingMedicalRecords(@Param("doctorId") Long doctorId,
                                                          @Param("offset") int offset,
                                                          @Param("limit") int limit);

    /**
     * **关键修复**：在预约挂号缴费成功后，将对应的排班号状态更新为 “3”（已取号）。
     *
     * 该方法在 {@link com.openhis.web.outpatient.service.impl.RegistrationServiceImpl#handlePaymentSuccess}
     * 中被调用。之前缺失实现导致状态未流转，触发 Bug #574。
     *
     * @param slotId adm_schedule_slot 表的主键 ID
     * @return 受影响的行数，正常情况下应为 1
     */
    @Update("UPDATE adm_schedule_slot SET status = '3', update_time = NOW() WHERE id = #{slotId}")
    int updateScheduleSlotStatusToFinished(@Param("slotId") Long slotId);
}