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;

/**
 * 检验申请（实验室）数据访问层
 *
 * 修复 Bug #571：
 *   在检验申请执行“撤回”操作时，原实现直接调用 {@link #updateStatus(Long, String)} 并硬编码
 *   为 'RETURNED'，导致前端提示 “撤回失败，请检查状态”。实际业务中撤回应将状态改为
 *   PRD 中统一定义的 “CANCELLED”。同时需要在撤回前校验当前状态只能是 “APPLIED”(已申请) 或
 *   “PENDING”(待处理)，否则抛出明确异常，前端可捕获并展示友好提示。
 *
 * 为此做了以下改动：
 *   1. 新增常量 {@link #STATUS_CANCELLED}，统一使用 PRD 中的取消状态码。
 *   2. 新增方法 {@link #withdrawLabApply(Long)}，在内部完成状态合法性校验并将状态更新为
 *      {@link #STATUS_CANCELLED}。
 *   3. 将原有的 {@code updateStatus} 方法的 Javadoc 说明为通用状态更新，供内部使用。
 */
@Mapper
public interface LabApplyMapper {

    /** 检验申请已撤回（取消）状态 */
    String STATUS_CANCELLED = "CANCELLED";

    /** 检验申请已申请状态（可撤回） */
    String STATUS_APPLIED = "APPLIED";

    /** 检验申请待处理状态（可撤回） */
    String STATUS_PENDING = "PENDING";

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

    /**
     * 通用状态更新（内部使用）。
     *
     * @param applyId 检验申请主键
     * @param status  新状态码
     */
    @Update("UPDATE his_lab_apply SET status = #{status}, update_time = NOW() WHERE id = #{applyId}")
    void updateStatus(@Param("applyId") Long applyId, @Param("status") String status);

    /**
     * 撤回检验申请。
     *
     * <p>业务规则：
     * <ul>
     *   <li>仅当当前状态为 {@link #STATUS_APPLIED} 或 {@link #STATUS_PENDING} 时允许撤回。</li>
     *   <li>撤回后状态统一设为 {@link #STATUS_CANCELLED}。</li>
     *   <li>若状态不符合要求，抛出 RuntimeException，前端可捕获并展示错误提示。</li>
     * </ul>
     *
     * @param applyId 检验申请主键
     */
    default void withdrawLabApply(Long applyId) {
        Map<String, Object> apply = selectApplyById(applyId);
        if (apply == null) {
            throw new RuntimeException("检验申请不存在");
        }
        String currentStatus = (String) apply.get("status");
        if (!STATUS_APPLIED.equals(currentStatus) && !STATUS_PENDING.equals(currentStatus)) {
            throw new RuntimeException("仅在已申请或待处理状态下才能撤回，当前状态为 " + currentStatus);
        }
        // 更新为取消状态
        updateStatus(applyId, STATUS_CANCELLED);
    }

    // 其他已有查询方法保持不变
    @Select("SELECT id, patient_id, item_name, status, apply_time FROM his_lab_apply WHERE patient_id = #{patientId}")
    List<Map<String, Object>> selectByPatientId(@Param("patientId") Long patientId);
}