package com.ruoyi.task.api;

/**
 * 任务模块<b>对外接口</b>（其它模块可依赖的稳定入口）。
 *
 * <h3>⚠️ 真正的跨模块数据面是 ruoyi-common 的 4 个契约，不是本接口</h3>
 * 任务/子任务被其它模块使用的能力，已经按"接口在 ruoyi-common、实现在归属模块"的既有手法
 * 下沉成 4 个契约，并由本模块实现：
 * <ul>
 *   <li>{@code com.ruoyi.common.core.service.VisitTaskCreateApi} —— 查已发布长期任务、落库子任务、回写待执行子任务；</li>
 *   <li>{@code com.ruoyi.common.core.service.ServiceTaskMatchApi} —— 按科室/诊断/手术编码匹配长期任务；</li>
 *   <li>{@code com.ruoyi.common.core.service.SubtaskStatApi} —— 门诊随访统计取"随访人次/人数"；</li>
 *   <li>{@code com.ruoyi.common.core.service.SubtaskOptionMatchApi} —— AI 选项匹配。</li>
 * </ul>
 * 调用方<b>直接注入那 4 个接口</b>即可，不必经过本接口。
 *
 * <h3>那本接口做什么</h3>
 * 只暴露"模块是否可用"这一个稳定判断，让调用方能在调任务能力前先行降级，
 * 而不必知道 {@code TaskSwitch} / {@code sys_config} 的内部细节。
 *
 * <h3>关闭时的行为</h3>
 * 本模块的端点会被 {@code TaskAvailabilityInterceptor} 拦下并返回明确业务错误；
 * 而 {@code isEnabled()} 供其它模块在<b>调用前</b>判断，避免"拿到 500 才知道关了"。
 */
public interface TaskApi {

    /**
     * 任务模块是否已启用（运行时读 {@code sys_config} 的 {@code task.enabled}，最多 10 秒延迟）
     */
    boolean isEnabled();
}