liusheng
4 天以前 0bbbd746e8c39d91ad7b47a4e36e29ab972dc98c
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
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() {
    }
}