package com.ruoyi.satisfaction.mapper;

import com.ruoyi.satisfaction.domain.ServiceSubtaskDetailRatioExport;
import com.ruoyi.satisfaction.domain.dto.MydTrendReqDTO;
import com.ruoyi.satisfaction.domain.dto.MzMydScoreRankDTO;
import com.ruoyi.satisfaction.domain.dto.QuestionCountKsOrBqDTO;
import com.ruoyi.satisfaction.domain.dto.ServiceSubtaskOptionStatDTO;
import com.ruoyi.satisfaction.domain.entity.SatisfactionStatQuery;
import com.ruoyi.satisfaction.domain.row.SatisfactionSubtaskQuery;
import com.ruoyi.satisfaction.domain.row.SatisfactionSubtaskRef;
import com.ruoyi.satisfaction.domain.row.SatisfactionTaskRow;
import com.ruoyi.satisfaction.domain.vo.MzMydScoreRankVO;
import com.ruoyi.satisfaction.domain.vo.PatSatisfactionReqVO;
import com.ruoyi.satisfaction.domain.vo.QuestionCountKsOrBqVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * 满意度统计 Mapper 接口。
 * <p>
 * 迁移说明：方法原本散落在 {@code com.smartor.mapper.ServiceSubtaskMapper} 与
 * {@code com.smartor.mapper.ServiceSubtaskDetailMapper} 中，满意度模块化后集中到此处。
 * <p>
 * 本模块自带 SQL，<b>直接查询</b> {@code service_subtask} / {@code service_subtask_detail}，
 * 以及模板分类表；不依赖任何其它模块的 Mapper。
 * <p>
 * 对应 XML：{@code ruoyi-satisfaction/src/main/resources/mapper/satisfaction/SatisfactionMapper.xml}
 * <p>
 * 已删除的死代码（搬迁时确认零调用点）：
 * <ul>
 *   <li>{@code selectSatisfactionSubtaskList} —— 被 {@code selectSatisfactionSubtaskTypes} 替代；</li>
 *   <li>{@code querySendCount} —— 被 {@code selectSatisfactionSendCount} 替代。</li>
 * </ul>
 */
@Mapper
public interface SatisfactionMapper {

    // ================================================================ 发送量统计

    /**
     * 满意度柱状图：一次性统计本次请求全部模板的发送量（按 libtemplateid 分组）。
     *
     * @param query 聚合查询条件
     * @return 每行含 libtemplateid、cnt
     */
    List<Map<String, Object>> selectSatisfactionSendCount(SatisfactionStatQuery query);

    /**
     * 满意度统计：只查本次条件下实际存在哪些 type（1 语音 / 2 问卷）。
     *
     * @param patSatisfactionReqVO 查询条件
     * @return 去重后的 type 列表（可能为 null）
     */
    List<String> selectSatisfactionSubtaskTypes(PatSatisfactionReqVO patSatisfactionReqVO);

    // ================================================================ 填报量统计

    /**
     * 满意度柱状图：一次性统计本次请求全部模板的填报量（按 模板+问题+score 分组）。
     *
     * @param query 聚合查询条件
     * @return 每行含 libtemplateid、questiontext、score、cnt
     */
    List<Map<String, Object>> selectSatisfactionFillStat(SatisfactionStatQuery query);

    /**
     * 满意度统计：一次性统计本次请求全部问题的填报量（按 模板+问题+matchedtext+score 分组）。
     *
     * @param query 聚合查询条件
     * @return 每行含 libtemplateid、questiontext、matchedtext、score、cnt、targetvalue
     */
    List<Map<String, Object>> selectSatisfactionFillStatByMatchedtext(SatisfactionStatQuery query);

    /**
     * 满意度柱状图：一次性统计本次请求全部模板的「回收人数」。
     * <p>
     * 回收人数必须是人数口径（count distinct sub_id），不能按题目汇总答案行数（题量口径）。
     *
     * @param query 聚合查询条件
     * @return 每行含 libtemplateid、cnt
     */
    List<Map<String, Object>> selectSatisfactionFillPersonCount(SatisfactionStatQuery query);

    /**
     * 【按 模板 + 问题】统计答题人数（{@code count(distinct ssd.sub_id)}）。
     * <p>
     * <b>为什么单独加这一条</b>：{@code /statistics} 的「答题人数 / 未答题人数」必须与
     * 「发送人数」（{@link #selectSatisfactionSendCount}，也是人数）同口径。
     * 原实现误用 {@link #selectSatisfactionFillStatByMatchedtext} 的 {@code count(*)}（明细<b>行数</b>），
     * 而一条 {@code (sub_id, questiontext)} 可能有多行明细（多选项 / 重复明细），
     * 导致「未答题人数 = 发送人数 − 明细行数」出现负数（实测 -120）。
     * <p>
     * ⚠️ 平均分 / 最高分 / 最低分 / 各选项占比仍使用明细行数（那些口径本来就按行计），未改动。
     * <p>
     * 除聚合键与 {@code distinct} 外，from/where 与 {@link #selectSatisfactionFillStatByMatchedtext}
     * 完全一致，保证两者统计的是同一批数据。
     *
     * @param query 聚合查询条件
     * @return 每行含 libtemplateid、questiontext、cnt（人数）
     */
    List<Map<String, Object>> selectSatisfactionFillPersonCountByQuestion(SatisfactionStatQuery query);

    // ================================================================ 省立同德：趋势与维度

    /**
     * 省立同德患者满意度趋势。
     *
     * @param startFinishTime 开始时间
     * @param endFinishTime   结束时间
     * @param type            粒度：week / month / year / day
     * @return 趋势数据
     */
    List<MydTrendReqDTO> mydTrend(@Param("startFinishTime") Date startFinishTime,
                                  @Param("endFinishTime") Date endFinishTime,
                                  @Param("type") String type);

    /**
     * 省立同德患者满意度——按科室维度统计。
     */
    List<MydTrendReqDTO> sltdMydTotalByDimension(@Param("startFinishTime") Date startFinishTime,
                                                 @Param("endFinishTime") Date endFinishTime,
                                                 @Param("type") String type);

    /**
     * 省立同德患者满意度——按院区维度统计。
     */
    List<MydTrendReqDTO> sltdMydTotalByYQ(@Param("startFinishTime") Date startFinishTime,
                                          @Param("endFinishTime") Date endFinishTime,
                                          @Param("type") String type);

    // ================================================================ 选项占比

    /**
     * 统计满意度选项的百分比。
     *
     * @param taskIds         任务 ID 列表
     * @param subtaskIds      子任务 ID 列表（非空时只统计这些子任务；为空则统计这些任务下的全部子任务）
     * @param startOutHospTime 出院开始时间
     * @param endOutHospTime   出院结束时间
     * @param startFinishTime  完成开始时间
     * @param endFinishTime    完成结束时间
     * @param scoreStart       分值下限
     * @param scoreEnd         分值上限
     * @param questiontext     题目内容（模糊匹配）
     * @param valueType        题型（2=多选）
     */
    List<ServiceSubtaskDetailRatioExport> statQuestionOption(
            @Param("taskIds") List<Long> taskIds,
            @Param("startOutHospTime") Date startOutHospTime,
            @Param("endOutHospTime") Date endOutHospTime,
            @Param("startFinishTime") Date startFinishTime,
            @Param("endFinishTime") Date endFinishTime,
            @Param("scoreStart") Double scoreStart,
            @Param("scoreEnd") Double scoreEnd,
            @Param("questiontext") String questiontext,
            @Param("valueType") String valueType,
            @Param("subtaskIds") List<Long> subtaskIds);

    /**
     * 满意度导出：选项占比。
     * <p>
     * 项数 = 选了该选项的患者数（同一人同一题只取最新一条明细）；分数 = 该选项所有明细 score 之和。
     *
     * @param subtaskIds   本次导出的子任务 ID
     * @param questiontext 题目内容（可选，模糊匹配）
     */
    List<ServiceSubtaskOptionStatDTO> statMydQuestionOptionForExport(
            @Param("subtaskIds") List<Long> subtaskIds,
            @Param("questiontext") String questiontext);

    /**
     * 根据子任务 ID 统计满意度选项的百分比（用于满意度统计 serviceType=6/14）。
     */
    List<ServiceSubtaskDetailRatioExport> statQuestionOptionBySubtaskIds(
            @Param("subtaskIds") List<Long> subtaskIds,
            @Param("startOutHospTime") Date startOutHospTime,
            @Param("endOutHospTime") Date endOutHospTime,
            @Param("startFinishTime") Date startFinishTime,
            @Param("endFinishTime") Date endFinishTime,
            @Param("scoreStart") Double scoreStart,
            @Param("scoreEnd") Double scoreEnd,
            @Param("questiontext") String questiontext,
            @Param("valueType") String valueType);

    /**
     * 按科室/病区对满意度题目做归类统计。
     */
    List<QuestionCountKsOrBqDTO> statQuestionOptionByKsOrBq(QuestionCountKsOrBqVO questionCountKsOrBqVO);

    // ================================================================ 综合得分排名

    /**
     * 门诊满意度综合得分排名（按科室或病区）。
     * <p>
     * 综合满意度 = Σ(评分明细权重) / 评分明细条数 × 100%；权重只取 1、0.8、0.6、0.4、0.2 五档。
     *
     * @param mzMydScoreRankVO 查询条件（dimensionType、serviceType、时间区间、科室/病区编号、orgid/campusid）
     * @return 每行科室/病区的综合得分，已按综合得分降序
     */
    List<MzMydScoreRankDTO> selectMzMydScoreRank(MzMydScoreRankVO mzMydScoreRankVO);
    // ================================================================ 重复明细清理（满意度统计前置）

    /**
     * 找出「同一 sub_id + questiontext」下除最新一条之外的重复明细 id。
     * <p>
     * 原属 {@code ServiceSubtaskDetailMapper}，只有满意度统计调用（已核实），故一并搬入。
     * <p>
     * ⚠️ 注意：调用它的 {@code statQuestionOption} / {@code statQuestionOptionBySubtaskIds}
     * 会先执行本查询再执行 {@link #deleteRepeatDetailByIds}，<b>这是会写库的行为</b>（原实现即如此）。
     *
     * @return 需要清理的明细 id
     */
    List<Long> selectRepeatDetailIds();

    /**
     * 按 id 逻辑删除重复明细（{@code del_flag = 1}）。
     */
    Integer deleteRepeatDetailByIds(@Param("ids") List<Long> ids);
    // ================================================================ 子任务（满意度统计取数）

    /**
     * 按机构/院区/服务类型/出院时间/科室病区取子任务，<b>只返回 id 与 taskid</b>。
     * <p>
     * 对应原实现 {@code ServiceSubtaskServiceImpl.getServiceSubtasks(ServiceSubtaskEntity)}
     * 中 {@code sltdMydTotalByScore} 实际用到的口径。原方法基于
     * {@code selectServiceSubtaskList}（近百个可选条件 + 返回全表字段），
     * 满意度只需要上述条件与两个 id 列，因此这里专写一条精简查询。
     * <p>
     * <b>条件与原文逐字一致</b>（均「非空才拼」）：
     * {@code del_flag = 0}、{@code orgid}、{@code campusid}、{@code service_type}、
     * {@code endtime} 的日期区间、{@code deptOrDistrict==1} 时的病区 IN、
     * {@code leaveldeptcodes} 的科室 IN。
     * <p>
     * ⚠️ 原文无默认排序、无默认分页（{@code sort}/{@code pageSize} 未设置即不生效），
     * 本查询同样不加排序，保证结果顺序行为一致。
     */
    List<SatisfactionSubtaskRef> selectMydSubtaskRefs(@Param("q") SatisfactionSubtaskQuery query);

    // ================================================================ 随访「满意度指数」取数
    // 以下 5 个方法服务于 getSatisfactionIndex（随访统计页的「满意度题目总量/填报量/完成比例」），
    // 原本散落在 smartor 的 ServiceTaskMapper / IvrTaskTemplateScriptMapper /
    // SvyTaskTemplateScriptMapper / ServiceSubtaskMapper / ServiceSubtaskDetailMapper 中，
    // 由 ServiceSubtaskServiceImpl#getSatisfactionIndex 逐个调用。

    /**
     * 按科室 <b>或</b> 病区取随访任务（只取统计用到的 4 列）。
     * <p>
     * 对应原实现 {@code ServiceTaskMapper.selectServiceTaskList}，调用方按 type 二选一传参：
     * <ul>
     *   <li>{@code deptcode} 非空 → 拼 {@code deptcode REGEXP CONCAT('(^|,)', #{deptcode}, '(,|$)')}；</li>
     *   <li>{@code leavehospitaldistrictcode} 非空 → 拼同形态的 REGEXP；</li>
     * </ul>
     * 两者只会有一个非空，因此本方法一条 SQL 即可覆盖原实现的两个分支。
     * <p>
     * <b>口径逐字一致</b>：{@code del_flag = 0}、{@code orgid}、{@code order by update_time desc, taskid desc}。
     */
    List<SatisfactionTaskRow> selectSatisfactionServiceTasks(
            @Param("orgid") String orgid,
            @Param("deptcode") String deptcode,
            @Param("leavehospitaldistrictcode") String leavehospitaldistrictcode);

    /**
     * 统计某模板下的语音满意度题目数量。
     * <p>
     * 对应原实现 {@code IvrTaskTemplateScriptMapper.selectIvrTaskTemplateScriptList}
     * 在 {@code templateID + orgid + scriptAssortid} 三个条件下的 {@code size()}。
     * <p>
     * <b>口径注意</b>：{@code scriptAssortid} 为 {@code null} 时<b>不拼</b>该条件
     * （等于统计该模板全部题目）——与原文 {@code <if test="scriptAssortid != null">} 一致。
     */
    int countIvrTaskTemplateScripts(@Param("templateID") Long templateID,
                                    @Param("orgid") String orgid,
                                    @Param("scriptAssortid") Long scriptAssortid);

    /**
     * 统计某模板下的问卷满意度题目数量。
     * <p>
     * 对应原实现 {@code SvyTaskTemplateScriptMapper.selectSvyTaskTemplateScriptList}
     * 在 {@code templateID + orgid + categoryid} 三个条件下的 {@code size()}。
     * <p>
     * <b>口径注意</b>：{@code categoryid} 为 {@code null} 时<b>不拼</b>该条件（与原文一致）。
     */
    int countSvyTaskTemplateScripts(@Param("templateID") Long templateID,
                                    @Param("orgid") String orgid,
                                    @Param("categoryid") Long categoryid);

    /**
     * 统计某任务下指定发送状态的子任务数量。
     * <p>
     * 对应原实现 {@code ServiceSubtaskMapper.selectServiceSubtaskBySendstate}
     * 在 {@code taskid + sendstates(3,5,6)} 两个条件下的 {@code size()}。
     * 原调用没有设置 {@code orgid}，故本方法也不含该条件。
     * <p>
     * <b>口径注意</b>：含 {@code del_flag = 0}；{@code sendstates} 为 {@code null} 时不拼 IN 条件。
     */
    int countSubtaskBySendstates(@Param("taskid") Long taskid,
                                @Param("sendstates") List<Long> sendstates);

    /**
     * 统计某任务下的满意度明细数量。
     * <p>
     * 对应原实现 {@code ServiceSubtaskDetailMapper.selectServiceSubtaskDetailList}
     * 在 {@code taskid + categoryid + orgid} 三个条件下的 {@code size()}。
     * <p>
     * <b>口径注意</b>：原文<b>没有</b> {@code del_flag} 条件，本查询同样不加；
     * {@code categoryid} 为 {@code null} 时不拼该条件（保留原文的"按任务类型决定是否设 categoryid"行为）。
     */
    int countSubtaskDetail(@Param("taskid") Long taskid,
                           @Param("categoryid") Long categoryid,
                           @Param("orgid") String orgid);
}