package com.smartor.service;

import com.ruoyi.common.core.domain.entity.PatArchive;
import com.ruoyi.outpatientvisit.domain.PatMedOuthosp;

/**
 * 专科档案生成Service接口。
 *
 * <p>根据门诊接诊完成记录和 {@code pat_specific_archive_generate_config}
 * 配置生成妇科档案或儿科档案。</p>
 */
public interface IPatSpecificArchiveGenerateService {

    /**
     * 根据门诊记录生成专科档案。
     *
     * @param patMedOuthosp 门诊接诊完成记录
     * @param patArchive    患者档案，可为空；为空时按门诊记录中的患者信息回查
     * @return 本次生成/更新的档案数量
     */
    int generateByOuthosp(PatMedOuthosp patMedOuthosp, PatArchive patArchive);

    /**
     * 根据住院随访子任务生成专科档案。
     *
     * <p>仅处理已完成的住院随访（hosp_type 2/6 + service_type 白名单），
     * 且仅对丽水市妇幼保健院生效。生成前按“患者 + 专科 + 档案类型”判断是否已有档案。</p>
     *
     * @param subId 随访子任务ID
     * @return 本次生成数量
     */
    int generateByInhospFollowup(Long subId);

    /**
     * 补偿扫描：查询近 7 天已完成但尚未处理的住院随访并尝试生成档案。
     *
     * @return 本次生成数量
     */
    int compensateInhospFollowups();
}