package com.ruoyi.task.api.spi;

/**
 * FTP 下载能力 —— <b>ruoyi-task 的对外 SPI，由 smartor 侧实现</b>。
 *
 * <h3>用途</h3>
 * 子任务统计里有一段"把当天的录音目录从 FTP 拉到本地"的动作
 * （原 {@code ServiceSubtaskServiceImpl} L2859：
 * {@code ftpService.downloadFolder("/" + LocalDate.now(), profile + "/upload/vadio/voice/" + LocalDate.now())}）。
 * {@code FtpService} 是 smartor 的通用工具，不属任务域，因此经本端口取用。
 *
 * <h3>为什么端口在 ruoyi-task 而不在 ruoyi-common</h3>
 * 本端口只被 ruoyi-task 使用、且参数全是基本类型，没有"多方共享的契约类型"，
 * 放在 ruoyi-task 的 {@code api.spi} 下即可，不必污染 ruoyi-common。
 * 方向仍是「接口在 ruoyi-task、实现在 smartor」，编译期无环。
 *
 * <h3>⚠️ 实现必须保持"纯转发"</h3>
 */
public interface TaskFtpPort {

    /**
     * 递归下载远端目录到本地（原 {@code FtpService#downloadFolder}）。
     *
     * @param remoteDir 远端目录
     * @param localDir  本地目录
     */
    void downloadFolder(String remoteDir, String localDir);
}