Files
his/com/openhis/web/outpatient/mapper/OrderMapper.java
2026-05-27 01:26:30 +08:00

108 lines
4.5 KiB
Java
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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);
/**
* 将医嘱状态更新为 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);
// 其他已有方法(如分页查询、统计等)保持不变
}