package com.ruoyi.common.core.service;

import com.ruoyi.common.core.service.dto.VisitArchiveRow;

/**
 * 患者档案（{@code pat_archive}）<b>只读</b>契约。
 *
 * <h3>为什么需要它</h3>
 * {@code pat_archive} 是全院共享表，多个随访模块都要读它：
 * <ul>
 *   <li>出入院随访（{@code ruoyi-inhospvisit}）—— 组装出院/入院随访子任务；</li>
 *   <li>门急诊随访（{@code ruoyi-outpatientvisit}）—— 组装门诊随访子任务；</li>
 *   <li>其他随访（{@code ruoyi-othervisit}）—— 组装手术随访子任务。</li>
 * </ul>
 * 各模块都只读随访组装真正用到的那几列（{@link VisitArchiveRow} 的 10 个字段）。
 * 若每个模块各写一份只读 Mapper，就会出现"同表多份查询、字段一漂移就静默丢字段"的问题。
 *
 * <h3>⚠️ 只读，且不含业务判断</h3>
 * 不提供写入方法 —— 档案的写属档案域。查询条件与原实现逐字一致：
 * {@code where id = #{patid} and del_flag = 0}
 * （<b>已删除的档案会被判为"查不到"</b>，调用方据此走"患者基本信息为空"分支）。
 *
 * @see VisitArchiveRow
 */
public interface ArchiveReadApi {

    /**
     * 按患者档案ID查询。
     * <p>
     * 原实现：{@code PatArchiveMapper.selectPatArchiveByPatid}（{@code id = #{id} and del_flag = 0}）。
     *
     * @param patid 患者档案ID
     * @return 档案行；不存在（或已删除）返回 {@code null}
     */
    VisitArchiveRow findByPatid(Long patid);
}