package com.ruoyi.satisfaction.domain.row;

import lombok.Data;

/**
 * 满意度统计用的「问卷模板问题」只读视图。
 * <p>
 * 为什么需要这个类（而不是直接用 {@code com.ruoyi.template.domain.SvyLibTemplateScript}）：
 * <ul>
 *   <li>那个实体属于 smartor 的**问卷模板管理**业务，被 13 个文件使用（含模板增删改查），不能搬进本模块；</li>
 *   <li>满意度统计只用到它的 5 个字段（见下）；</li>
 *   <li>本模块要求「不依赖 smartor」，所以不能 import 它。</li>
 * </ul>
 * <p>
 * ⚠️ 重要口径差异（原实现就有，必须保留）：
 * <ul>
 *   <li>{@code querySvyLibTemplateIds}（按分类取问题）：聚合统计用的模板 id 是 {@code svyid} 列，
 *       而取选项分值用的关联 id 是 {@code id} 列（{@code svy_lib_template_script} 主键）；</li>
 *   <li>{@code selectSLTScriptListBydimension}（按维度取问题）：两者都用 {@code svyid}。</li>
 * </ul>
 * 为保持与被迁移实现完全一致，本类<b>同时</b>保留 {@code svyid} 与 {@code id}，
 * 由各查询自行决定取哪一列（与原来逐字对应）。
 * <p>
 * ⚠️ 这是<b>只读</b>视图，本模块不会对它做任何写操作。
 */
@Data
public class SatisfactionSvyScriptRow {

    /**
     * 对应列 {@code svyid}：问卷模板 id。
     */
    private Long svyid;

    /**
     * 对应列 {@code id}：{@code svy_lib_template_script} 主键。
     * <p>按分类查询时，选项表 {@code svy_lib_template_targetoption} 按它关联。
     */
    private Long id;

    /**
     * 对应列 {@code script_content}：问题内容。
     */
    private String scriptContent;

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

    /**
     * 对应列 {@code dimension}：维度。
     */
    private String dimension;

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

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

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

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