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

102 lines
4.1 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);
/**
* 将医嘱状态更新为 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);
// 其它已有方法保持不变...
}