package com.ruoyi.datacollection.config;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

/**
 * 数据采集模块的 yml 配置（<b>仅作兜底，不是主开关</b>）。
 *
 * <h3>⚠️ 主开关不在这里</h3>
 * 主开关是 {@code sys_config} 参数配置表里的 {@code datacollection.enabled}，
 * 由 {@link DataCollectionSwitch} <b>运行时热读</b>（进程内 10 秒缓存，改完最多 10 秒生效）。
 * 本类只在「sys_config 里没有那一行」或「非 Spring 环境取不到配置服务」时兜底。
 *
 * <h3>为什么默认 true</h3>
 * 与任务/电话/模板模块同款口径：<b>参数行缺失时按启用处理</b>。
 * HIS 采集是"数据进不来"的链路，若因为库里少一行配置就默认停采，
 * 出问题时是<b>静默少数据</b>，比多采一轮难查得多。要停采请到
 * 「系统管理 → 参数设置」显式把 {@code datacollection.enabled} 设为 false。
 *
 * <h3>yml 兜底写法（一般不必要）</h3>
 * <pre>
 * datacollection:
 *   enabled: false
 * </pre>
 */
@Data
@Component
@ConfigurationProperties(prefix = "datacollection")
public class DataCollectionProperties {

    /**
     * 是否启用数据采集模块（默认启用）。
     * <p>
     * 仅当 {@code sys_config} 中没有 {@code datacollection.enabled} 时生效，见 {@link DataCollectionSwitch}。
     */
    private boolean enabled = true;
}