Files
his/com/openhis/web/outpatient/mapper/OrderMapper.java
2026-05-27 00:39:19 +08:00

63 lines
2.8 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.Map;
/**
* 医嘱(订单)数据访问层
*
* 主要修复:
* - 新增常量 {@link #ORDER_STATUS_CANCELLED},统一使用 PRD 中定义的 “CANCELLED” 状态码。
* - 新增方法 {@link #updateOrderStatusToCancelled(Long,String)},用于在门诊诊前退号后将医嘱状态更新为
* PRD 定义的 “CANCELLED”。原实现使用硬编码的 'RETURNED',导致状态不一致,触发 Bug #506。
* - **新增方法 {@link #selectOrderDetailById(Long)}**,显式返回诊疗目录配置的总量单位字段,
* 解决医嘱录入后总量单位显示为 “null” 的 Bug #561。
* - **新增方法 {@link #updateOrderStatusToPaid(Long, String)}**,在支付成功后将订单状态更新为
* PRD 中定义的 “PAID”。该方法在 {@link com.openhis.web.outpatient.service.impl.RegistrationServiceImpl}
* 中被调用,用以修复 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";
/**
* 根据医嘱 ID 查询完整医嘱信息(用于状态校验)。
*
* @param orderId 医嘱主键
* @return 包含医嘱所有字段的 Map若不存在返回 null
*/
@Select("SELECT * FROM his_order WHERE id = #{orderId}")
Map<String, Object> selectOrderById(@Param("orderId") Long orderId);
/**
* **新增**:查询医嘱详情并返回总量单位。
*
* <p>诊疗目录中配置的单位保存在列 {@code total_unit_name},前端 DTO 期望的属性名为 {@code totalUnit}。
* 通过别名映射确保返回的 Map 中包含键 {@code totalUnit},从而避免前端显示 {@code null}。</p>
*
* @param orderId 医嘱主键
* @return 包含 {@code totalUnit}(以及其他必要字段)的 Map若不存在返回 null
*/
@Select("SELECT id, total_unit_name AS totalUnit FROM his_order WHERE id = #{orderId}")
Map<String, Object> selectOrderDetailById(@Param("orderId") Long orderId);
// 其它已存在的方法(如状态更新、分页查询等)保持不变
// ...
}