package cn.lihu.jh.module.ecg.service.room; import java.util.*; import javax.validation.Valid; import cn.lihu.jh.framework.common.pojo.PageResult; import cn.lihu.jh.module.ecg.controller.admin.room.vo.MonitorInfoVO; import cn.lihu.jh.module.ecg.controller.admin.room.vo.RoomPageReqVO; import cn.lihu.jh.module.ecg.controller.admin.room.vo.RoomSaveReqVO; import cn.lihu.jh.module.ecg.controller.admin.room.vo.RoomSeatRespVO; import cn.lihu.jh.module.ecg.controller.admin.room.vo.RoomSelectBedRespVO; import cn.lihu.jh.module.ecg.dal.dataobject.room.RoomDO; import cn.lihu.jh.module.ecg.dal.dataobject.room.RoomProfile; /** * 诊室和诊疗床 Service 接口 * * @author 芋道源码 */ public interface RoomService { /** * 创建诊室和诊疗床 * * @param createReqVO 创建信息 * @return 编号 */ Integer createRoom(@Valid RoomSaveReqVO createReqVO); /** * 更新诊室和诊疗床 * * @param updateReqVO 更新信息 */ void updateRoom(@Valid RoomSaveReqVO updateReqVO); /** * 删除诊室和诊疗床 * * @param id 编号 */ void deleteRoom(Integer id); /** * 获得诊室和诊疗床 * * @param id 编号 * @return 诊室和诊疗床 */ RoomDO getRoom(Integer id); RoomProfile getRoomByIP(String ip, Long roomId); /** * 「选择工位模式」- 按本机IP匹配工位:返回该IP下的候选工位(本人已占用 → 空闲 → 被他人占用)。 *
仅查询、不改变任何状态;自动入座由前端拿到结果后沿用原有的 bedDoctorOn 流程完成。
* * @param ip 来访IP * @param docId 当前登录人ID(可能为空) */ List为什么要有这个接口:前端原来把「{@code get-ip-bed} 匹配 → {@code bind-ip} 写 IP → * {@code bed-doctor-on} 入座」拆成三个请求自己拼,任一步失败都只能回落到"手选工位", * 现场表现就是"登录后没有自动入座"且看不出原因。这里收敛成一次调用,并返回**识别到的 IP** * 与**未入座原因**(ip_invalid / nomatch / multi / occupied / error)。 * *
策略与原有前端逻辑保持一致: * ① 已是我的工位 → 幂等恢复;② **恰好一个**空闲工位 → 占用;③ 多个空闲 → 不擅自入座(multi); * ④ 全被他人占用 → 不挤掉(occupied + 占用人姓名)。 * * @param ip 来访 IP(调用方已用 {@code IpUtils.normalize} 规范化) * @param docId 当前登录人 * @param docName 当前登录人姓名 */ RoomSeatRespVO autoSeatByIp(String ip, Long docId, String docName); /** * 查询当前登录人**已入座**的工位(给系统顶栏显示"当前工位"用)。 * * @param docId 当前登录人 * @return 未入座时返回 {@code seated=false} 的空结果 */ RoomSeatRespVO getMySeat(Long docId); /** * 【本需求·一人多工位】查询当前登录人**占据的全部工位**(节假日值班多岗位)。 * *
返回「医生在座 / 医生暂停」状态的工位,按 roomId + bedNo 升序;
* 未占任何工位时返回空列表(前端据此显示"未入座")。
*
* @param docId 当前登录人
*/
List 使用场景:上一班医生下班未点「离座」,下一班医生在同一台电脑/同一工位接班。
* 行为:
* 用于"主/围观"模型的写操作鉴权:围观人只能看,不能改数据。
* {@code @RequireBedOwner} 切面会调用它;只带 rentId 之类的接口需要自行调用。
*
* @param roomId 诊室编号
* @param bedNo 工位号
*/
void assertBedOwner(Long roomId, String bedNo);
/**
* 同上,但**按患者反查工位**:用于只带患者信息、没有 roomId/bedNo 的写接口
* (放弃检查 / 放弃领用 / 放弃装机)。
*
* 反查依据:{@code queue} 表当前该患者 + 检查项目的那一行上的 room_id / bed_no。
* 查不到工位时**拒绝**(宁可拒绝也不放行)。
*/
void assertBedOwnerByPatient(String patId, Integer checkType);
/**
* 同上,但查不到工位时**记警告放行**。
*
* 用于确费/取消确费:这两步常在流程末端调用,患者可能已经不在工位队列上;
* 一律拒绝会把正常业务挡掉,故这里只记警告(前端在围观模式下已禁用按钮)。
*/
void assertBedOwnerByPatientSoft(String patId, Integer checkType);
/**
* 校验「该工位当前的主人就是 ownerDocId」。
*
* 用于围观人查看**工位主人的已完成检查记录**:不要求调用者入座(围观本来就是不入座也能看),
* 但必须确认这个 docId 确实是该工位现在的主人,避免被当成"任意查别人记录"的入口。
*
* @param roomId 诊室编号
* @param bedNo 工位号
* @param ownerDocId 期望的工位主人
*/
void assertBedOwnerIs(Long roomId, String bedNo, Long ownerDocId);
/**
* 工位状态诊断(排查"入座报状态异常/找不到工位")。
*
* 把库里的**原始行**摊开:`id / room_id / bed_no(含长度与 HEX,用于发现结尾空格/全角) /
* status / doc_id / doc_name / deleted / update_time`,并给出一句结论。
*
* @param id 工位主键(优先,含已删除行)
* @param roomId 诊室编号(id 为空时用)
* @param bedNo 工位号(id 为空时用,按 TRIM 宽松匹配)
*/
Map
*
*
* @param roomId 诊室编号
* @param bedNo 工位编号
*/
void takeOverBed(Long roomId, String bedNo);
/**
* 校验「当前登录人必须是该工位的主人」,否则抛
* {@link cn.lihu.jh.module.ecg.enums.ErrorCodeConstants#ROOM_NOT_OWNER}。
*
*