116 lines
5.0 KiB
Java
116 lines
5.0 KiB
Java
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 #selectOrderDetailById(Long)}，显式返回诊疗目录配置的总量单位字段，
|
||
* 解决医嘱录入后总量单位显示为 “null” 的 Bug #561。
|
||
* - 新增方法 {@link #updateOrderStatusToPaid(Long,String,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);
|
||
|
||
/**
|
||
* 根据医嘱 ID 查询医嘱明细，包括诊疗目录配置的总量单位（total_quantity_unit）。
|
||
* 该方法专门用于门诊医生站‑医嘱录入后展示总量单位，防止出现 null。
|
||
*
|
||
* @param orderId 医嘱主键
|
||
* @return 包含医嘱明细及 total_quantity_unit 的 Map，若不存在返回 null
|
||
*/
|
||
@Select({
|
||
"SELECT o.id,",
|
||
" o.patient_id,",
|
||
" o.doctor_id,",
|
||
" o.status,",
|
||
" od.item_id,",
|
||
" od.quantity,",
|
||
" od.total_quantity,",
|
||
" -- 诊疗目录表（his_item）中保存的总量单位字段",
|
||
" i.total_quantity_unit,",
|
||
" od.create_time",
|
||
"FROM his_order o",
|
||
" JOIN his_order_detail od ON o.id = od.order_id",
|
||
" JOIN his_item i ON od.item_id = i.id",
|
||
"WHERE o.id = #{orderId}"
|
||
})
|
||
Map<String, Object> selectOrderDetailById(@Param("orderId") Long orderId);
|
||
|
||
/**
|
||
* 将医嘱状态更新为已取消（CANCELLED）。
|
||
*
|
||
* @param orderId 医嘱主键
|
||
* @param operator 操作人姓名
|
||
* @param remark 备注
|
||
*/
|
||
@Update("UPDATE his_order SET status = #{status}, updated_by = #{operator}, remark = #{remark}, update_time = NOW() " +
|
||
"WHERE id = #{orderId}")
|
||
void updateOrderStatusToCancelled(@Param("orderId") Long orderId,
|
||
@Param("status") String status,
|
||
@Param("operator") String operator,
|
||
@Param("remark") String remark);
|
||
|
||
/**
|
||
* 将医嘱状态更新为已支付（PAID）。
|
||
*
|
||
* @param orderId 医嘱主键
|
||
* @param operator 操作人姓名
|
||
* @param remark 备注
|
||
*/
|
||
@Update("UPDATE his_order SET status = #{status}, updated_by = #{operator}, remark = #{remark}, update_time = NOW() " +
|
||
"WHERE id = #{orderId}")
|
||
void updateOrderStatusToPaid(@Param("orderId") Long orderId,
|
||
@Param("status") String status,
|
||
@Param("operator") String operator,
|
||
@Param("remark") String remark);
|
||
|
||
/**
|
||
* 将排班号状态更新为已取号（3）。
|
||
*
|
||
* @param scheduleSlotId 排班号主键
|
||
*/
|
||
@Update("UPDATE adm_schedule_slot SET status = 3, update_time = NOW() WHERE id = #{scheduleSlotId}")
|
||
void updateScheduleSlotStatusToFinished(@Param("scheduleSlotId") Long scheduleSlotId);
|
||
|
||
// 其它已有方法（如分页查询待写病历等）保持不变
|
||
}
|