package com.ruoyi.task.api;

import com.ruoyi.task.config.TaskSwitch;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

/**
 * 任务模块对外门面（<b>常驻 Bean</b>）。
 *
 * <h3>为什么必须"常驻"</h3>
 * 本门面<b>永远</b>是 Spring Bean，不随开关状态增删。这样调用方的
 * {@code @Autowired TaskFacade} 在任何开关状态下都<b>不会启动失败</b>
 * —— 这与满意度模块的 {@code SatisfactionFacade} 是同一条设计约束
 * （历史教训：用 {@code @ConditionalOnProperty} 摘 Bean 会让调用方启动即失败，
 * 且只在启动时求值一次，做不到"改完参数 10 秒生效"）。
 *
 * <h3>⚠️ 与满意度门面的一个差别：本类不实现自己的查询方法</h3>
 * {@code SatisfactionFacade} 同时实现 {@code SatisfactionApi} 并需
 * {@code filter(api -> api != this)} 防自引用递归 —— 因为它要转发到模块内实现。
 * 本门面只回答"是否启用"，<b>不转发任何查询</b>（查询走 4 个 ruoyi-common 契约），
 * 因此不存在自引用问题，也就不需要 {@code ObjectProvider} 自过滤那一套。
 * 将来若给 {@link TaskApi} 增加需要转发的查询方法，<b>必须补上自引用过滤</b>。
 *
 * @see TaskApi
 */
@Slf4j
@Component
public class TaskFacade implements TaskApi {

    private final TaskSwitch taskSwitch;

    /**
     * Spring 使用的构造器。
     * <p>
     * ⚠️ <b>必须显式标注 {@code @Autowired}</b>：本类有<b>两个</b>公开构造器
     * （另一个给测试/非 Spring 环境用），且<b>没有无参构造器</b>。
     * 不标注的话，Spring 找不到"唯一的非默认构造器"，会退回查找无参构造器，
     * 启动即报 {@code No default constructor found}。
     * <p>
     * 这与满意度模块 {@code SatisfactionFacade} / {@code SatisfactionSwitch} 是同一个坑，
     * 该规则由 {@code sql/_probe/verify_spring_beans.py} 静态把关
     * （**本类已登记进该脚本的扫描范围**，见脚本 MODULE 配置）。
     */
    @Autowired
    public TaskFacade(TaskSwitch taskSwitch) {
        this.taskSwitch = taskSwitch;
    }

    /**
     * 供<b>测试/非 Spring 环境</b>直接构造：{@code sysConfigValue} 就是
     * {@code sys_config} 里的 {@code task.enabled} 值，{@code null} 表示"参数行不存在"。
     */
    public TaskFacade(com.ruoyi.task.config.TaskProperties properties, String sysConfigValue) {
        this(new TaskSwitch(properties, sysConfigValue));
    }

    @Override
    public boolean isEnabled() {
        return taskSwitch.isEnabled();
    }

    /**
     * 取运行时开关（供拦截器复用同一实例、也供测试断言）
     */
    public TaskSwitch getTaskSwitch() {
        return taskSwitch;
    }
}