package com.ruoyi.phone.config;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * 电话模块的 MVC 配置：把 {@link PhoneAvailabilityInterceptor} 挂到电话模块自己的端点上。
 *
 * <h3>为什么必须逐个精确枚举（不能用前缀）</h3>
 * 电话端点<b>刻意保持原有 URL 不变</b>（外部电话平台的回调地址不能改），因此它散落在两个前缀下：
 * <pre>
 * /smartor/serviceSubtask/phoneCallBack         上海：语音识别结果回调
 * /smartor/serviceSubtask/phoneCallBackYQ       雨绮：ASR / 静默 / 播放事件回调
 * /smartor/serviceSubtask/taskPull              雨绮：任务拉取
 * /smartor/serviceSubtask/saveQuestionAnswerPhone  电话：患者问题结果记录
 * /smartor/serviceSubtask/recordAcceptshanghai  上海：通话记录回调
 * /smartor/serviceSubtask/recordAccept          雨绮：通话记录回调
 * /smartor/shphone/getFirstQues                 三汇：按号码取首个问题
 * /smartor/shphone/processResust                三汇：ASR 结果处理
 * </pre>
 * 这两个前缀<b>都不是电话模块独占</b>：
 * <ul>
 *   <li>{@code /smartor/serviceSubtask/**} 下还有 40+ 个随访端点（归 ruoyi-task）；</li>
 *   <li>{@code /smartor/shphone/**} 下还有 {@code addOutboundInstance}（归 smartor 的外呼实例配置）。</li>
 * </ul>
 * 用前缀会把别人的端点一起拦掉，所以这里只挂上面这 8 条精确路径。
 * <p>
 * 与之配套：{@code TaskWebConfig} 里把前 6 条（电话自己的）用 {@code excludePathPatterns} 排除掉，
 * 避免"关任务"顺手把电话回调也关了 —— 电话已独立成模块，开关理应各自独立。
 *
 * <h3>新增端点时的约定</h3>
 * 往后本模块若再加端点：默认<b>不</b>加入本清单（回调类端点必须加），
 * 并同步更新 {@code PhoneSwitchCheck} 里的受保护路径条数断言。
 */
@Configuration
public class PhoneWebConfig implements WebMvcConfigurer {

    /**
     * 上海：语音识别结果回调
     */
    public static final String PHONE_CALLBACK_ENDPOINT = "/smartor/serviceSubtask/phoneCallBack";

    /**
     * 雨绮：ASR / 静默 / 播放事件回调
     */
    public static final String PHONE_CALLBACK_YQ_ENDPOINT = "/smartor/serviceSubtask/phoneCallBackYQ";

    /**
     * 雨绮：任务拉取
     */
    public static final String TASK_PULL_ENDPOINT = "/smartor/serviceSubtask/taskPull";

    /**
     * 电话：患者问题结果记录
     */
    public static final String SAVE_QUESTION_ANSWER_PHONE_ENDPOINT =
            "/smartor/serviceSubtask/saveQuestionAnswerPhone";

    /**
     * 上海：通话记录回调
     */
    public static final String RECORD_ACCEPT_SHANGHAI_ENDPOINT =
            "/smartor/serviceSubtask/recordAcceptshanghai";

    /**
     * 雨绮：通话记录回调
     */
    public static final String RECORD_ACCEPT_ENDPOINT = "/smartor/serviceSubtask/recordAccept";

    /**
     * 三汇：按号码取首个问题
     */
    public static final String SH_GET_FIRST_QUES_ENDPOINT = "/smartor/shphone/getFirstQues";

    /**
     * 三汇：ASR 结果处理
     */
    public static final String SH_PROCESS_RESUST_ENDPOINT = "/smartor/shphone/processResust";

    @Autowired
    private PhoneAvailabilityInterceptor phoneAvailabilityInterceptor;

    /**
     * 供测试/非 Spring 环境直接构造
     */
    public PhoneWebConfig() {
    }

    public PhoneWebConfig(PhoneAvailabilityInterceptor phoneAvailabilityInterceptor) {
        this.phoneAvailabilityInterceptor = phoneAvailabilityInterceptor;
    }

    /**
     * 本模块需要"关闭即明确报错"的 URL 路径（供校验脚本/单元测试断言）
     */
    public static String[] guardedPathPatterns() {
        return new String[]{
                PHONE_CALLBACK_ENDPOINT,
                PHONE_CALLBACK_YQ_ENDPOINT,
                TASK_PULL_ENDPOINT,
                SAVE_QUESTION_ANSWER_PHONE_ENDPOINT,
                RECORD_ACCEPT_SHANGHAI_ENDPOINT,
                RECORD_ACCEPT_ENDPOINT,
                SH_GET_FIRST_QUES_ENDPOINT,
                SH_PROCESS_RESUST_ENDPOINT,
        };
    }

    /**
     * 挂在 {@code /smartor/serviceSubtask/**} 前缀下、但属于电话模块的路径
     * （供 {@code TaskWebConfig} 排除，见类注释）。
     */
    public static String[] subtaskPathsOwnedByPhone() {
        return new String[]{
                PHONE_CALLBACK_ENDPOINT,
                PHONE_CALLBACK_YQ_ENDPOINT,
                TASK_PULL_ENDPOINT,
                SAVE_QUESTION_ANSWER_PHONE_ENDPOINT,
                RECORD_ACCEPT_SHANGHAI_ENDPOINT,
                RECORD_ACCEPT_ENDPOINT,
        };
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(phoneAvailabilityInterceptor)
                .addPathPatterns(guardedPathPatterns())
                // 拦截器本身很轻（只读一个 boolean），order 给个小值让它在业务拦截器之前执行
                .order(-100);
    }
}