package com.ruoyi.satisfaction.domain.row;

import lombok.Data;

/**
 * 满意度统计用的「语音模板问题」只读视图。
 * <p>
 * 为什么需要这个类（而不是直接用 {@code com.ruoyi.template.domain.IvrLibaTemplateScript}）：
 * <ul>
 *   <li>那个实体属于 smartor 的**语音模板管理**业务，被 9 个文件使用（含模板增删改查），不能搬进本模块；</li>
 *   <li>满意度统计其实只用到它的 5 个字段（见下），按需取列比整套实体更清晰；</li>
 *   <li>本模块要求「不依赖 smartor」，所以不能 import 它。</li>
 * </ul>
 * 字段与源表 {@code ivr_liba_template_script} 的列一一对应，口径与原实现完全一致。
 * <p>
 * ⚠️ 这是<b>只读</b>视图，本模块不会对它做任何写操作。
 */
@Data
public class SatisfactionIvrScriptRow {

    /**
     * 对应列 {@code templateid}：语音模板 id。
     * <p>聚合统计（发送量/回收人数/填报量）按它分组。
     */
    private Long templateid;

    /**
     * 对应列 {@code scriptid}：选项表 {@code ivr_liba_template_targetoption} 关联的问题 id。
     * <p>用于取该问题的选项分值（算最高/最低分）。<b>可能为 null</b>，
     * 此时原实现的 SQL 不拼 scriptid 条件（等于取该表全部分值）。
     */
    private Long scriptid;

    /**
     * 对应列 {@code script_content}：问题内容。
     * <p>用于与填报明细的 {@code questiontext} 做匹配（MySQL 的 {@code =} 忽略大小写与尾部空格）。
     */
    private String scriptContent;

    /**
     * 对应列 {@code script_assortname}：语音满意度分类名称。
     * <p>分类口径统计（{@code satisfactionGraph}）按它分组。
     */
    private String scriptAssortname;

    /**
     * 对应列 {@code dimension}：维度。
     * <p>维度口径统计（{@code satisfactionGraphDimension}）按它分组。
     */
    private String dimension;

    // ==================== 仅「满意度异常配置题目」接口使用 ====================
    // 下面 3 个字段只有 /smartor/trace/getSatisfactionExceptConfigQuestion 需要，
    // 统计口径（satisfactionGraph / satisfactionGraphDimension）的查询不取这些列，保持为 null。

    /**
     * 对应列 {@code id}：{@code ivr_liba_template_script} 主键。
     * <p>「满意度异常配置题目」接口把它作为返回里的 {@code questionId}。
     */
    private Long id;
    /**
     * 对应列 {@code script_topic}：题目主题。
     * <p>「满意度异常配置题目」接口把它作为返回里的 {@code questionTopic}。
     */
    private String scriptTopic;

    /**
     * 对应列 {@code script_type}：题目类型。
     * <p>「满意度异常配置题目」接口把它作为返回里的 {@code questionType}。
     */
    private String scriptType;

    /**
     * 对应列 {@code script_assortid}：所属语音分类 id。
     * <p>「满意度异常配置题目」接口把它作为返回里的 {@code categoryId}。
     */
    private Long scriptAssortid;
}