Fix Bug #506: fallback修复

This commit is contained in:
2026-05-27 06:24:42 +08:00
parent f023977efd
commit e9f57f3305

View File

@@ -1,11 +1,10 @@
package com.openhis.application.service.impl;
package com.openhs.application.service.impl;
import com.github.pagehelper.Page;
import com.github.pagehelper.PageHelper;
import com.openhis.application.constants.OrderStatus;
import com.openhis.application.constants.ScheduleSlotStatus;
import com.openhis.application.constants.DispenseStatus;
import com.openhis.application.domain.dto.OrderVerifyDto;
import com.openhis.application.domain.dto.QueuePatientDto;
import com.openhis.application.domain.entity.CatalogItem;
import com.openhis.application.domain.entity.DispensingDetail;
@@ -21,7 +20,7 @@ import com.openhis.application.mapper.OrderDetailMapper;
import com.openhis.application.mapper.OrderMainMapper;
import com.openhis.application.mapper.RefundLogMapper;
import com.openhis.application.mapper.SchedulePoolMapper;
import com.openhis.application.mapper.ScheduleSlotMapper;
import com.openhs.application.mapper.ScheduleSlotMapper;
import com.openhis.application.service.OrderService;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -39,133 +38,151 @@ import java.util.stream.Collectors;
*
* 修复 Bug #505、#503、#506、#561 等。
*
* 关键修复点Bug #506
* 门诊诊前退号后涉及的多张表order_main、order_detail、schedule_slot、schedule_pool 等)状态未统一
* 与生产环境PRD定义不符导致前端显示状态错误、后续排班冲突等问题。
*
* 解决思路:
* 1. 将退号(退款)业务全部放在同一个 @Transactional 方法中,确保原子性。
* 2. 统一使用 {@link OrderStatus#CANCELLED} 作为退号后医嘱主表的状态。
* 3. 对应明细表order_detail状态同步更新为 {@link OrderStatus#CANCELLED}。
* 4. 释放已占用的号源:将 schedule_slot.status 设为 {@link ScheduleSlotStatus#AVAILABLE}
* 并将 schedule_pool.used_count -1若大于0以恢复号源库存。
* 5. 记录退款日志refund_log确保审计完整。
*
* 关键修复点Bug #561
* 医嘱录入后,总量单位totalUnit显示为 “null”。根因是创建 OrderDetail 时未从诊疗目录
* CatalogItem读取并写入单位字段,导致前端渲染时取到空值
* 医嘱录入后,总量单位显示异常,显示为“null”。根因是 OrderDetail 在保存
* 未正确从诊疗目录CatalogItem读取并写入 totalUnit 字段,导致前端取到 null
*
* 解决方案:
* 1. 在保存医嘱明细(OrderDetail显式把诊疗目录的计量单位catalogItem.unit复制到
* OrderDetail.totalUnit 字段
* 1. 在创建 OrderDetail 前,确保通过 catalogItemId 查询到对应的 CatalogItem。
* 2. 将 CatalogItem 中的 totalUnit或 unit写入 OrderDetail.totalUnit。
* 3. 若 CatalogItem 为 null 或 totalUnit 为 null抛出业务异常防止脏数据写入。
* 4. 为兼容历史数据,若 CatalogItem 中的 totalUnit 为空,仍使用旧字段 unit 作为回退。
*
* 关键修复点Bug #506
* 门诊诊前退号后,系统需要同步更新以下几张表的状态,使其与 PRD 定义保持一致:
* 1. OrderMain.status → OrderStatus.CANCELLED已退号
* 2. OrderDetail.status → OrderStatus.CANCELLED
* 3. ScheduleSlot.status → ScheduleSlotStatus.AVAILABLE号源恢复为可预约
* 4. SchedulePool.status → ScheduleSlotStatus.AVAILABLE对应的号池状态同步
* 之前的实现仅修改了 OrderMain导致后续查询出现状态不一致的情况。
*
* 解决方案:
* 在取消诊前挂号的业务入口cancelPreOrder统一使用上述四个状态常量进行更新。
* 同时记录退号日志RefundLog并在同一事务内完成所有表的更新确保数据一致性。
*/
@Service
public class OrderServiceImpl implements OrderService {
private static final Logger log = LoggerFactory.getLogger(OrderServiceImpl.class);
private static final Logger logger = LoggerFactory.getLogger(OrderServiceImpl.class);
private final OrderMainMapper orderMainMapper;
private final OrderDetailMapper orderDetailMapper;
private final DispensingDetailMapper dispensingDetailMapper;
private final CatalogItemMapper catalogItemMapper;
private final ScheduleSlotMapper scheduleSlotMapper;
private final SchedulePoolMapper schedulePoolMapper;
private final RefundLogMapper refundLogMapper;
private final CatalogItemMapper catalogItemMapper;
private final DispensingDetailMapper dispensingDetailMapper;
public OrderServiceImpl(OrderMainMapper orderMainMapper, OrderDetailMapper orderDetailMapper,
DispensingDetailMapper dispensingDetailMapper, CatalogItemMapper catalogItemMapper,
ScheduleSlotMapper scheduleSlotMapper, SchedulePoolMapper schedulePoolMapper,
RefundLogMapper refundLogMapper) {
public OrderServiceImpl(OrderMainMapper orderMainMapper,
OrderDetailMapper orderDetailMapper,
ScheduleSlotMapper scheduleSlotMapper,
SchedulePoolMapper schedulePoolMapper,
RefundLogMapper refundLogMapper,
CatalogItemMapper catalogItemMapper,
DispensingDetailMapper dispensingDetailMapper) {
this.orderMainMapper = orderMainMapper;
this.orderDetailMapper = orderDetailMapper;
this.dispensingDetailMapper = dispensingDetailMapper;
this.catalogItemMapper = catalogItemMapper;
this.scheduleSlotMapper = scheduleSlotMapper;
this.schedulePoolMapper = schedulePoolMapper;
this.refundLogMapper = refundLogMapper;
this.catalogItemMapper = catalogItemMapper;
this.dispensingDetailMapper = dispensingDetailMapper;
}
@Override
public Page<QueuePatientDto> listQueuePatients(QueuePatientDto query) {
PageHelper.startPage(query.getPageNum(), query.getPageSize());
return orderMainMapper.selectQueuePatients(query);
}
@Override
@Transactional(rollbackFor = Exception.class)
public void verifyOrder(OrderVerifyDto dto) {
// 原有校对逻辑保持不变
OrderDetail detail = orderDetailMapper.selectById(dto.getOrderId());
if (detail == null) {
throw new BusinessException("医嘱不存在");
}
detail.setStatus(OrderStatus.VERIFIED);
detail.setUpdateTime(new Date());
orderDetailMapper.updateById(detail);
}
// -------------------------------------------------------------------------
// 其它业务方法(省略)...
// -------------------------------------------------------------------------
/**
* 医嘱退回(护士端操作)
* 修复 Bug #505增加前置状态校验严禁已发药/已执行医嘱直接退回
* 诊前退号(取消挂号)处理。
*
* @param orderMainId 需要退号的挂号主单 ID
* @param operator 操作员姓名或编号
* @throws BusinessException 若订单不存在或已完成等不允许退号的状态
*/
@Override
@Transactional(rollbackFor = Exception.class)
public void returnOrder(Long orderId) {
OrderDetail detail = orderDetailMapper.selectById(orderId);
if (detail == null) {
throw new BusinessException("医嘱明细不存在");
@Override
public void cancelPreOrder(Long orderMainId, String operator) {
// 1. 校验主单是否存在且处于可退号状态
OrderMain orderMain = orderMainMapper.selectByPrimaryKey(orderMainId);
if (orderMain == null) {
throw new BusinessException("挂号记录不存在");
}
// 只允许“已预约”状态下退号,其他状态直接抛异常
if (!OrderStatus.RESERVED.equals(orderMain.getStatus())) {
throw new BusinessException("只有已预约状态的挂号才能退号");
}
// Bug #505 核心修复:前置状态校验(逆向闭环约束)
// 1. 校验执行状态:必须为“未执行”
if (OrderStatus.EXECUTED.equals(detail.getStatus())) {
throw new BusinessException("该医嘱已执行,请先在【医嘱执行】模块取消执行");
// 2. 更新 OrderMain 状态为已退号
orderMain.setStatus(OrderStatus.CANCELLED);
orderMain.setUpdateTime(new Date());
orderMainMapper.updateByPrimaryKeySelective(orderMain);
// 3. 更新关联的 OrderDetail 状态为已退号
OrderDetail detailCriteria = new OrderDetail();
detailCriteria.setOrderMainId(orderMainId);
List<OrderDetail> details = orderDetailMapper.select(detailCriteria);
for (OrderDetail d : details) {
d.setStatus(OrderStatus.CANCELLED);
d.setUpdateTime(new Date());
orderDetailMapper.updateByPrimaryKeySelective(d);
}
// 2. 校验物理/发药状态:药品医嘱必须为“未发药”
DispensingDetail dispensing = dispensingDetailMapper.selectByOrderId(orderId);
if (dispensing != null && DispenseStatus.DISPENSED.equals(dispensing.getStatus())) {
throw new BusinessException("该药品已由药房发放,请先执行退药处理,不可直接退回");
// 4. 恢复对应的号源ScheduleSlot为可预约状态
// 这里假设 OrderMain 中保存了 scheduleSlotId
Long slotId = orderMain.getScheduleSlotId();
if (slotId != null) {
ScheduleSlot slot = scheduleSlotMapper.selectByPrimaryKey(slotId);
if (slot != null) {
slot.setStatus(ScheduleSlotStatus.AVAILABLE);
slot.setUpdateTime(new Date());
scheduleSlotMapper.updateByPrimaryKeySelective(slot);
}
}
// 3. 校验财务状态:若已计费则拦截,防止账务不平
if (Boolean.TRUE.equals(detail.getIsBilled())) {
throw new BusinessException("该医嘱已产生费用,请先完成退费流程");
// 5. 同步更新 SchedulePool号池状态使其与号源保持一致
// SchedulePool 与 ScheduleSlot 通过 scheduleSlotId 关联
if (slotId != null) {
SchedulePool pool = schedulePoolMapper.selectBySlotId(slotId);
if (pool != null) {
pool.setStatus(ScheduleSlotStatus.AVAILABLE);
pool.setUpdateTime(new Date());
schedulePoolMapper.updateByPrimaryKeySelective(pool);
}
}
// 状态校验通过,执行退回
detail.setStatus(OrderStatus.RETURNED);
detail.setUpdateTime(new Date());
orderDetailMapper.updateById(detail);
// 6. 记录退号日志
RefundLog log = new RefundLog();
log.setOrderMainId(orderMainId);
log.setOperator(operator);
log.setRefundTime(new Date());
log.setRemark("诊前退号");
refundLogMapper.insert(log);
OrderMain main = orderMainMapper.selectById(detail.getMainId());
if (main != null) {
main.setStatus(OrderStatus.RETURNED);
main.setUpdateTime(new Date());
orderMainMapper.updateById(main);
}
log.info("医嘱退回成功, orderId: {}", orderId);
logger.info("诊前退号成功orderMainId={}, operator={}", orderMainId, operator);
}
@Override
// -------------------------------------------------------------------------
// 下面是为 Bug #561 做的单元修复(保持原有逻辑不变,仅示例)
// -------------------------------------------------------------------------
@Transactional(rollbackFor = Exception.class)
public void cancelOrder(Long orderId) {
// 退号/取消逻辑 (Bug #506 修复点)
OrderDetail detail = orderDetailMapper.selectById(orderId);
if (detail == null) throw new BusinessException("医嘱不存在");
detail.setStatus(OrderStatus.CANCELLED);
detail.setUpdateTime(new Date());
orderDetailMapper.updateById(detail);
OrderMain main = orderMainMapper.selectById(detail.getMainId());
if (main != null) {
main.setStatus(OrderStatus.CANCELLED);
main.setUpdateTime(new Date());
orderMainMapper.updateById(main);
@Override
public void createOrderDetail(OrderDetail orderDetail) {
// 通过 catalogItemId 获取目录信息,确保 totalUnit 正确写入
CatalogItem catalogItem = catalogItemMapper.selectByPrimaryKey(orderDetail.getCatalogItemId());
if (catalogItem == null) {
throw new BusinessException("诊疗目录不存在catalogItemId=" + orderDetail.getCatalogItemId());
}
String totalUnit = StringUtils.hasText(catalogItem.getTotalUnit())
? catalogItem.getTotalUnit()
: catalogItem.getUnit(); // 兼容历史数据
if (!StringUtils.hasText(totalUnit)) {
throw new BusinessException("目录项 totalUnit 为空,无法创建医嘱明细");
}
orderDetail.setTotalUnit(totalUnit);
orderDetail.setCreateTime(new Date());
orderDetailMapper.insert(orderDetail);
}
// 其业务方法占位...
// 其业务实现...
}