package com.ruoyi.inhospvisit.mapper;

import com.ruoyi.common.core.service.dto.VisitArchiveRow;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 患者档案只读 Mapper（{@code pat_archive}）—— 出入院随访模块自带。
 *
 * <h3>⚠️ 与 smartor 的 {@code PatArchiveMapper} 是两套查询</h3>
 * 本模块只依赖 ruoyi-common（不依赖 smartor，否则循环依赖），所以自己查。
 * <b>纪律</b>：本接口的 SQL 只需覆盖"随访组装真正读到的列"，
 * 并由 {@code sql/_probe/verify_inhospvisit_mapper.py} 与
 * {@code verify_inhospvisit_sql_expansion.py} 把关；改任一边必须同步另一边。
 *
 * <h3>对应的原实现（@ b25c3b51）</h3>
 * {@code PatMedInhospServiceImpl} 里 10 处
 * {@code patArchiveMapper.selectPatArchiveByPatid(patMedInhosp.getPatid())}
 * （L338/382/436/536/573/948/1447/1546/1614/1694）。
 */
@Mapper
public interface VisitArchiveMapper {

    /**
     * 按患者档案ID查（原 {@code PatArchiveMapper#selectPatArchiveByPatid}）。
     * <p>
     * ⚠️ 原实现是 {@code select ... from pat_archive where id = #{patid}}（单表、无 del_flag 条件），
     * 这里<b>逐字照搬</b>，不加过滤条件 —— 加了就会改变"查得到/查不到"的判断，
     * 进而改变 {@code "患者基本信息为空"} 分支的走向。
     *
     * @param patid 患者档案ID
     * @return 档案行；不存在返回 {@code null}
     */
    VisitArchiveRow selectByPatid(@Param("patid") Long patid);
}