package com.ruoyi.outpatientvisit.api;

import com.ruoyi.outpatientvisit.domain.PatMedOuthosp;
import com.ruoyi.outpatientvisit.service.OuthospDataService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.ObjectProvider;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import java.util.Collection;
import java.util.Set;

/**
 * 门急诊随访模块的<b>业务能力门面</b>（常驻 Bean）。
 *
 * <h3>它补的是什么</h3>
 * {@link OuthospVisitFacade} 负责"模块开关 + 分表维护 + 随访编排"；
 * 本类负责"<b>门诊记录的基础读写</b>"（新增/修改/查重），
 * 供其它模块（{@code RyTask}、{@code CollectHISServiceImpl}、档案汇聚等）经模块调用。
 *
 * <h3>为什么要单独一个门面而不是塞进 OuthospVisitFacade</h3>
 * {@code OuthospVisitFacade} 已经承担了"开关判断 + 持久组件装配"，
 * 而本类的方法<b>绝大多数是纯数据访问、不受开关管辖</b>（与出入院模块对数据端点的处理一致）：
 * 关掉随访生成不该让 HIS 采集写不进门诊记录。
 * 两者职责不同，分开更清楚。
 * <p>
 * ⚠️ <b>唯一的例外是 {@link #dealOutpatientInfo()}</b>：它是"生成随访"的编排动作，
 * 必须受开关管辖，故转发给带守卫的 {@code OuthospVisitFacade}。
 * 这个例外曾经是"漏网"：本类注释说不受管辖、实现也真的没有守卫，
 * 于是 {@code outpatientvisit.enabled=false} 经此路径完全失效 —— 详见该方法的注释。
 *
 * <h3>⚠️ 与 smartor 的 {@code IPatMedOuthospService} 的关系</h3>
 * 那个接口的 10 个方法已全部迁入本模块（见 {@link OuthospDataService} /
 * {@link OuthospVisitTaskService}）。为让既有 10 个调用方零改动，
 * smartor 侧保留该接口并由一个委托实现转发到本门面 ——
 * 与宣教单跨模块收口（{@code ServiceSubtaskPreachformMapperBridge}）同一手法。
 * 新代码请直接依赖本门面或 {@link OuthospDataService}。
 */
@Slf4j
@Component
public class OuthospDataFacade {

    @Autowired
    private OuthospDataService dataService;

    /**
     * 带开关守卫的编排门面，供 {@link #dealOutpatientInfo()} 转发。
     * <p>
     * ⚠️ 用 {@code ObjectProvider} <b>惰性</b>取，而不是直接 {@code @Autowired} 字段：
     * {@code OuthospVisitFacade} 与本类是同一模块内的两个常驻 Bean，
     * 直接用硬依赖会引入 Bean 之间的初始化顺序耦合；
     * 惰性取还顺带保证"装配缺失也不会让本门面启动失败"（与本模块既有写法一致）。
     */
    @Autowired
    private ObjectProvider<OuthospVisitFacade> outhospVisitFacadeProvider;

    /**
     * 新增门诊记录（按就诊时间路由到分表）。
     * <p>对应原 {@code IPatMedOuthospService#insertPatMedOuthosp}。
     */
    public int insert(PatMedOuthosp row) {
        return dataService.insert(row);
    }

    /**
     * 修改门诊记录。
     * <p>对应原 {@code IPatMedOuthospService#updatePatMedOuthosp}。
     */
    public int update(PatMedOuthosp row) {
        return dataService.update(row);
    }

    /**
     * 批量查已入库的 serialnum。
     * <p>对应原 {@code IPatMedOuthospService#selectExistingSerialnums}。
     */
    public Set<String> selectExistingSerialnums(String admitDateStr, Collection<String> serialnums) {
        return dataService.selectExistingSerialnums(admitDateStr, serialnums);
    }

    /**
     * 门诊记录列表查询。
     * <p>
     * 供 smartor 侧【未迁】的单患者按需随访链路内部使用（它需要按条件取历史门诊记录）。
     * <p>
     * ⚠️ <b>展示富化只在 {@code query.pageNum != null} 时发生</b>（原实现如此）——
     * 内部链路不设 pageNum，因此拿到的是未富化的原始行，与原实现一致。
     */
    public java.util.List<PatMedOuthosp> selectList(PatMedOuthosp query) {
        return dataService.selectList(query);
    }

    /**
     * 门诊随访主扫描。
     * <p>对应原 {@code IPatMedOuthospService#dealOutpatientInfo}。
     *
     * <h3>⚠️ 本方法受 {@code outpatientvisit.enabled} 管辖</h3>
     * 它是本类里<b>唯一</b>的"业务动作"（其余方法都是纯数据访问，刻意不受开关管）——
     * 所以它必须转发到带守卫的 {@link OuthospVisitFacade#dealOutpatientInfo()}，
     * 而不是直接调 {@code taskService}。
     * <p>
     * <b>为什么专门写这段注释</b>：本类类注释写的是"本类的方法都是纯数据访问、不受开关管辖"，
     * 而本方法是个编排动作 —— 这两句话曾经矛盾，且方法实现确实<b>没有</b>守卫。
     * 后果是 {@code outpatientvisit.enabled=false} 经此路径调用时完全失效
     * （定时任务当时正是走这条路）。保留此方法是为了让既有调用方零改动，
     * 但守卫只应有一处，就是被转发的那个门面方法。
     */
    public Integer dealOutpatientInfo() {
        OuthospVisitFacade facade = outhospVisitFacadeProvider == null
                ? null : outhospVisitFacadeProvider.getIfAvailable();
        if (facade == null) {
            log.warn("【门急诊随访】OuthospVisitFacade 不可用（装配缺失），dealOutpatientInfo 跳过。");
            return 0;
        }
        // 开关判断由被转发方统一负责，此处不再重复判一次（避免两处判断漂移）
        return facade.dealOutpatientInfo();
    }

    /**
     * 按条件走存储过程查门诊记录（原 {@code PatMedOuthospMapper#callSpQueryOuthosp}）。
     * <p>
     * 供 smartor 侧「随访答复/明细」类服务按条件取门诊记录用。
     * 加它的原因：那几个服务原先直接注入 {@code PatMedOuthospMapper}，
     * 而该 Mapper 已独占搬入本模块 —— 跨模块直连 Mapper 是架构探针明确禁止的
     * （{@code verify_inhospvisit_api_boundary} 的 mapper 归零约束）。
     * 这里只是纯转发，SQL 一行未改。
     *
     * @param req 存储过程入参（调用方按最小必要字段构造，不要用 DtoConversionUtils 全量带字段，
     *            否则可能改变存储过程的 WHERE 分支）
     * @return 门诊记录列表；无数据返回空列表
     */
    public java.util.List<PatMedOuthosp> callSpQueryOuthosp(
            com.ruoyi.outpatientvisit.domain.PatMedOuthospQueryReq req) {
        return dataService.callSpQueryOuthosp(req);
    }

    /**
     * 按条件走存储过程查门诊记录<b>条数</b>（原 {@code PatMedOuthospMapper#callSpQueryOuthospCount}）。
     * <p>
     * 与 {@link #callSpQueryOuthosp} 同一口径，只是一次取 count。
     * 同样是纯转发，供 smartor 侧跨模块调用。
     */
    public Long callSpQueryOuthospCount(
            com.ruoyi.outpatientvisit.domain.PatMedOuthospQueryReq req) {
        return dataService.callSpQueryOuthospCount(req);
    }
}