package com.ruoyi.message.sms.provider.ls;

/**
 * 丽水机构级配置 / token 提供方（扩展点 SPI）。
 * <p>
 * 现状：丽水的「短信地址 / 租户信息 / 发送人」存在数据库表 {@code sys_config} 的 {@code ls.msg.info} 里，
 * 而表访问在 {@code ruoyi-system} / {@code smartor} 模块；token 换取逻辑在 {@code smartor} 的
 * {@code LSHospTokenUtil}。
 * <p>
 * 为了让 {@code ruoyi-message} 保持「不依赖业务模块」的干净分层，这里定义 SPI，
 * 由业务模块（smartor）实现并注册为 Spring Bean；若容器里没有实现，本模块会退化为使用
 * 代码内静态配置（等价于 {@code MsgLSEnum}）且不换 token。
 * <p>
 * 推荐实现放在 smartor 模块，内部通过 {@code ISysConfigService} 查询 {@code ls.msg.info}。
 */
public interface LishuiMessageConfigProvider {

    /**
     * 查询指定机构的丽水短信配置
     *
     * @param orgid 机构ID
     * @return 配置；查不到返回 {@code null}
     */
    LishuiMessageConfig getConfig(String orgid);

    /**
     * 获取丽水 360 平台 token
     *
     * @param orgid    机构ID
     * @param tokenUrl token 获取地址
     * @return token；获取失败返回 {@code null}
     */
    String getToken(String orgid, String tokenUrl);
}