package com.ruoyi.task;

/**
 * 任务模块包根。
 * <p>
 * 目录约定：
 * <ul>
 *   <li>{@code com.ruoyi.task.api} —— <b>唯一对外包</b>，其它模块只能依赖这个包；</li>
 *   <li>{@code controller} / {@code service} / {@code mapper} / {@code domain} —— 模块内部实现，
 *       其它模块不应直接引用。</li>
 * </ul>
 * 本模块是 {@code service_task}（任务）与 {@code service_subtask}（子任务）两张表的<b>唯一实现处</b>。
 * <p>
 * 模块可通过 {@code sys_config} 参数表的 {@code task.enabled} 整体关闭
 * （运行时读取，改完最多 10 秒生效）；关闭后 {@code com.ruoyi.task.api.TaskFacade} 仍存在，
 * 但所有调用降级为空值；直接访问任务端点的请求会被拦截器拦下并返回明确的"未启用"业务错误。
 * <p>
 * ⚠️ <b>依赖红线</b>：本模块只依赖 {@code ruoyi-common}。
 * 绝不依赖 {@code smartor} / {@code smartor-suifang} / {@code ruoyi-system} /
 * {@code ruoyi-framework} / {@code ruoyi-admin} —— 否则形成
 * {@code smartor -> ruoyi-task -> smartor} 的循环依赖，Maven 直接构建失败。
 * 需要其它模块的能力时，一律在 {@code ruoyi-common} 定义端口、由对方提供实现。
 */
public final class TaskModule {

    /**
     * 模块配置前缀（仅作为 yml 兜底配置的键前缀；主开关在 {@code sys_config} 参数表里）
     */
    public static final String PROPERTIES_PREFIX = "task";

    private TaskModule() {
    }
}