package com.ruoyi.satisfaction.mapper;
|
|
import com.ruoyi.satisfaction.domain.row.SatisfactionCategoryRow;
|
import com.ruoyi.satisfaction.domain.row.SatisfactionIvrScriptRow;
|
import com.ruoyi.satisfaction.domain.row.SatisfactionOptionScoreRow;
|
import com.ruoyi.satisfaction.domain.row.SatisfactionScriptQuery;
|
import com.ruoyi.satisfaction.domain.row.SatisfactionSvyScriptRow;
|
import org.apache.ibatis.annotations.Mapper;
|
import org.apache.ibatis.annotations.Param;
|
|
import java.util.List;
|
import java.util.Map;
|
|
/**
|
* 满意度统计取「满意度分类 / 模板问题 / 选项分值」的只读 Mapper。
|
* <p>
|
* <b>为什么不复用 smartor 的模板/分类 Mapper：</b>
|
* <ul>
|
* <li>{@code com.ruoyi.template.domain.IvrLibaScriptAssort} / {@code IvrLibaTemplateScript} /
|
* {@code SvyLibScriptCategory} / {@code SvyLibTemplateScript} 这 4 个实体属于
|
* smartor 的**模板与分类管理**业务（分别被 11/9/12/13 个文件使用，含增删改查），
|
* 不能搬进本模块；</li>
|
* <li>本模块要求「不依赖 smartor，其它模块要用只能调本模块 api」，所以不能 import 它们；</li>
|
* <li>原文这些查询依赖 `resultMap` + 共享 `<sql>` 片段，而片段被同文件里其它
|
* <b>非满意度</b>查询共用。直接复制片段会造成「同一份 SQL 两处维护」的隐患，
|
* 因此这里<b>改写为显式列清单</b>，只取满意度真正用到的字段。</li>
|
* </ul>
|
* <p>
|
* ⚠️ 本 Mapper 全部是<b>只读查询</b>，不会对 {@code ivr_liba_*} / {@code svy_lib_*} 做任何写操作。
|
* <p>
|
* 对应 XML：{@code mapper/satisfaction/SatisfactionScriptMapper.xml}
|
*/
|
@Mapper
|
public interface SatisfactionScriptMapper {
|
|
// ================================================================ 满意度分类
|
|
/**
|
* 查询指定机构下的满意度分类（语音侧）。
|
* <p>
|
* 原实现：{@code IvrLibaScriptAssortMapper.selectIvrLibaScriptAssortList}
|
* <pre>
|
* select id, index_assort_name, type from ivr_liba_script_assort
|
* where del_flag = 0 and orgid = ? and type like '%myd%' order by seqno asc
|
* </pre>
|
* 调用方再按 {@code type.contains("myd")} 过滤出满意度分类 id。
|
*
|
* @param query orgid 与 type（type 传 "myd"）
|
* @return 每行含 id、index_assort_name、type
|
*/
|
List<SatisfactionCategoryRow> selectIvrCategoryList(@Param("q") SatisfactionScriptQuery query);
|
|
/**
|
* 查询指定机构下的满意度分类（问卷侧）。
|
* <p>
|
* 原实现：{@code SvyLibScriptCategoryMapper.selectSvyLibScriptCategoryList}
|
* （注意：该 statement 定义在 {@code SvyLibTopicCategoryMapper.xml} 里，namespace 与文件名不一致）
|
* <pre>
|
* select id, name, type from svy_lib_script_category
|
* where del_flag = 0 and orgid = ? and type like '%myd%' order by seqno asc
|
* </pre>
|
*
|
* @param query orgid 与 type（type 传 "myd"）
|
* @return 每行含 id、name、type
|
*/
|
List<SatisfactionCategoryRow> selectSvyCategoryList(@Param("q") SatisfactionScriptQuery query);
|
|
// ================================================================ 模板问题（按分类）
|
|
/**
|
* 按语音分类 id 取问题。
|
* <p>
|
* 原实现：{@code IvrLibaTemplateScriptMapper.queryLibTemplateIds}
|
* <pre>
|
* select templateid, scriptid, script_content, script_assortname, dimension
|
* from ivr_liba_template_script
|
* where del_flag = 0 [and script_assortid in (...)]
|
* </pre>
|
* <b>口径注意</b>：{@code scriptAssortids} 为空时不再拼该条件（原实现是
|
* {@code if test="scriptAssortids != null and scriptAssortids.size > 0"}）。
|
*/
|
List<SatisfactionIvrScriptRow> queryIvrScriptByAssort(@Param("q") SatisfactionScriptQuery query);
|
|
/**
|
* 按问卷分类 id 取问题。
|
* <p>
|
* 原实现：{@code SvyLibTemplateScriptMapper.querySvyLibTemplateIds}
|
* <pre>
|
* select id, svyid, script_content, categoryName, dimension
|
* from svy_lib_template_script
|
* where del_flag = 0 [and categoryid in (...)]
|
* </pre>
|
* <b>口径注意</b>：原实现取选项分值时用的是 {@code id}（主键），
|
* 而聚合统计的模板 id 用的是 {@code svyid}——两者都保留在结果行里。
|
*/
|
List<SatisfactionSvyScriptRow> querySvyScriptByCategory(@Param("q") SatisfactionScriptQuery query);
|
|
// ================================================================ 模板问题（按维度）
|
|
/**
|
* 按维度取问题（语音侧）。
|
* <p>
|
* 原实现：{@code IvrLibaTemplateScriptMapper.selectILTSBydimension}
|
* <pre>
|
* ... where del_flag = 0
|
* [and dimension in (...)]
|
* [dimension IS NOT NULL] ← dimensionList 为空时拼这个
|
* </pre>
|
* <b>口径注意</b>：{@code dimensionList} 为空时，语音侧会拼
|
* {@code dimension IS NOT NULL}（问卷侧不会）——这是原实现的行为，必须保留。
|
* 同时原实现还支持 duty/report 相关过滤，满意度调用时不传，故不再暴露。
|
*/
|
List<SatisfactionIvrScriptRow> selectIvrScriptByDimension(@Param("q") SatisfactionScriptQuery query);
|
|
/**
|
* 按维度取问题（问卷侧）。
|
* <p>
|
* 原实现：{@code SvyLibTemplateScriptMapper.selectSLTScriptListBydimension}
|
* <pre>
|
* ... where del_flag = 0 [and dimension in (...)]
|
* </pre>
|
* <b>口径注意</b>：与语音侧不同，{@code dimensionList} 为空时<b>不拼</b>
|
* {@code dimension IS NOT NULL}（等于取该表全部 del_flag=0 的问题）。
|
* 另外此处聚合统计用的模板 id 与取选项分值用的关联 id <b>都是 {@code svyid}</b>。
|
*/
|
List<SatisfactionSvyScriptRow> selectSvyScriptByDimension(@Param("q") SatisfactionScriptQuery query);
|
|
// ================================================================ 选项分值
|
|
/**
|
* 按问题 id 批量取语音选项分值（只取 scriptid、score 两列）。
|
* <p>
|
* 原实现：{@code IvrLibaTemplateTargetoptionMapper.selectIvrLibaTargetoptionScores}
|
* <p>
|
* <b>口径注意</b>：{@code scriptIds} 为 null 时原实现不拼 scriptid 条件
|
* （等于取该表全部分值），调用方用 null 作 key 存这一份。
|
*/
|
List<SatisfactionOptionScoreRow> selectIvrTargetOptionScores(@Param("scriptIds") List<Long> scriptIds);
|
|
/**
|
* 按问题 id 批量取问卷选项分值（只取 scriptid、score 两列）。
|
* <p>
|
* 原实现：{@code SvyLibTemplateTargetoptionMapper.selectSvyLibTargetoptionScores}
|
*/
|
List<SatisfactionOptionScoreRow> selectSvyTargetOptionScores(@Param("scriptIds") List<Long> scriptIds);
|
}
|
