package com.ruoyi.phone;

/**
 * 电话模块包根。
 *
 * <h3>这个模块装了什么</h3>
 * 原先散在 {@code ruoyi-task} 的 {@code ServiceSubtaskController} 与
 * {@code ServiceSubtaskServiceImpl} 里的"电话"能力，本模块化后<b>整体搬到这里</b>：
 * <ul>
 *   <li>{@code controller} —— 三条外呼通道的回调端点，<b>URL 与原样完全一致</b>
 *       （上海/雨绮挂在 {@code /smartor/serviceSubtask/**}，三汇挂在 {@code /smartor/shphone/**}），
 *       外部电话平台不需要改回调地址；</li>
 *   <li>{@code service} —— 电话会话状态机（redis 会话、TTS 播报、ASR 匹配、AI 匹配、静默/挂机、
 *       通话记录落库）的全部实现；</li>
 *   <li>{@code domain} —— 电话回调/拉取的入参与出参；</li>
 *   <li>{@code api} —— <b>唯一对外包</b>：其它模块只能经 {@code PhoneFacade} 调电话能力。</li>
 * </ul>
 *
 * <h3>数据访问边界（重要）</h3>
 * {@code service_subtask} / {@code service_subtask_detail} / {@code service_task} 等表归 {@code ruoyi-task}，
 * 按 {@code doc/跨模块数据访问原则与收口方案.md} 的落地口径，<b>非归属模块一律禁止写这些表</b>；
 * 因此本模块<b>刻意不带 Mapper / XML</b>：
 * <ul>
 *   <li>任务数据 → {@code com.ruoyi.task.api.TaskSubtaskApi}（归属模块内实现，本模块只调 API）；</li>
 *   <li>模板话术 → {@code com.ruoyi.template.service} 下的 service 接口；</li>
 *   <li>发送方式状态 → {@code com.ruoyi.task.api.spi.TaskPreachformPort}；</li>
 *   <li>录音下载 → {@code com.ruoyi.task.api.spi.TaskFtpPort}；</li>
 *   <li>参数配置 → {@code com.ruoyi.task.api.spi.TaskSysConfigPort}；</li>
 *   <li>AI 选项匹配 → {@code com.ruoyi.common.core.service.SubtaskOptionMatchApi}（ruoyi-common 契约）。</li>
 * </ul>
 *
 * <h3>开关</h3>
 * 模块可通过 {@code sys_config} 参数表的 {@code phone.enabled=false} 整体关闭
 * （运行时读取，改完最多 10 秒生效）：命中的端点被 {@code PhoneAvailabilityInterceptor}
 * 拦下并返回明确的"未启用"业务错误；门面 {@code PhoneFacade} 仍常驻，调用降级为空值/空列表。
 */
public final class PhoneModule {

    /**
     * 模块配置前缀（仅作为 yml 兜底配置的键前缀；主开关在 sys_config 参数表里）
     */
    public static final String PROPERTIES_PREFIX = "phone";

    private PhoneModule() {
    }
}