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 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); /** * 将医嘱状态更新为 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); /** * 将医嘱状态更新为 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); /** * 将医嘱状态更新为 RETURNED(已退回)。 * * @param orderId 医嘱主键 * @param status 目标状态,建议使用 {@link #ORDER_STATUS_RETURNED} * @param operator 操作人姓名 */ @Update("UPDATE his_order SET status = #{status}, updated_by = #{operator}, updated_time = NOW() " + "WHERE id = #{orderId}") void updateOrderStatusToReturned(@Param("orderId") Long orderId, @Param("status") String status, @Param("operator") String operator); /** * 退号后,将关联的排班号状态更新为 “已取消”(4)。 * * @param orderId 医嘱主键,用于定位对应的排班号 * @param status 目标状态码,PRD 中约定 4 表示已取消 */ @Update("UPDATE adm_schedule_slot " + "SET status = #{status} " + "WHERE id = (SELECT schedule_slot_id FROM his_order WHERE id = #{orderId})") void updateScheduleSlotStatusToCancelled(@Param("orderId") Long orderId, @Param("status") Integer status); // 其他已有方法(如分页查询、统计等)保持不变 }