package cn.iocoder.yudao.module.mes.framework.qrexport;

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

/**
 * MES 二维码导出配置项
 * <p>
 * 批量导出二维码是 CPU 密集型操作（逐张生成二维码 + 合成 PNG），且单批次可达成千上万张，
 * 因此导出被拆成两条路径：
 * <ul>
 *     <li>小批量（不超过 {@link #syncThreshold}）走同步流式下载，秒级返回，不受任何闸门限制；</li>
 *     <li>大批量转后台任务，受并发闸门与 CPU 闸门管控，避免把同机部署的业务页面拖垮。</li>
 * </ul>
 */
@Data
@Component
@ConfigurationProperties(prefix = "mes.qr-export")
public class MesProQrExportProperties {

    /**
     * 同步/后台的分界线（张）
     * <p>
     * 不超过该数量直接同步流式下载，超过则转后台导出任务。同步路径不排队、不校验 CPU，
     * 保证「导几百张」永远是秒出，不会被正在跑的大批量任务挡住。
     */
    private int syncThreshold = 2000;

    /**
     * 提交后台导出任务时的系统 CPU 使用率拒绝阈值（0~1）
     * <p>
     * 达到该值即拒绝新建任务（提示服务器繁忙），避免在服务器已经很忙时再叠加导出负载。
     */
    private double cpuRejectThreshold = 0.80D;

    /**
     * 生成过程中的系统 CPU 节流阈值（0~1）
     * <p>
     * 任务一旦开始就必须跑完，仅靠提交时拒绝无法覆盖「提交时 CPU 低、跑起来把业务拖卡」的情况，
     * 因此生成过程中持续采样，超过该水位即让出 CPU（降速但不中断）。
     */
    private double cpuThrottleThreshold = 0.85D;

    /**
     * CPU 高于节流阈值时，每次让出 CPU 的毫秒数
     */
    private long cpuThrottleSleepMillis = 300L;

    /**
     * 生成过程中检查取消、采样 CPU 的间隔（每多少张一次）
     */
    private int progressCheckInterval = 200;

    /**
     * 同时允许运行的后台导出任务数
     * <p>
     * 仅约束大批量任务，小批量同步导出不受此限制。
     */
    private int maxConcurrentTasks = 1;

    /**
     * 单个后台任务的最长运行时间（分钟），超时自动取消并清理，避免异常任务长期占用
     */
    private int maxRuntimeMinutes = 30;

    /**
     * 临时 ZIP 存放目录，为空时使用 {@code ${java.io.tmpdir}/mes-qr-export}
     */
    private String tempDir = "";

    /**
     * 临时 ZIP 的保留时间（分钟）
     * <p>
     * 正常下载完成后立即删除；仅在「下载中断」或「生成完成后始终未下载」时保留一小段时间，
     * 到期由清理任务删除。否则每次中断都要重新生成上万张标签，或者上 GB 的临时文件一直占着磁盘。
     */
    private int tempFileRetentionMinutes = 10;

    /**
     * 解析临时目录，未配置时回退到系统临时目录
     */
    public String resolveTempDir() {
        if (tempDir == null || tempDir.isBlank()) {
            return System.getProperty("java.io.tmpdir") + java.io.File.separator + "mes-qr-export";
        }
        return tempDir;
    }

}