package com.ruoyi.satisfaction.service.strategy;
|
|
import com.ruoyi.satisfaction.domain.ServiceSubtaskDetailRatioExport;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* 满意度「站点口径」策略：<b>一个站点一套综合满意度得分口径</b>。
|
* <p>
|
* 这是本模块用来区分「南华」与「省立同德」两套满意度口径的<b>策略接口</b>：
|
* <ul>
|
* <li>{@link CommonSatisfactionScoreStrategy}（{@link SatisfactionSites#COMMON}）—— 通用/南华口径；</li>
|
* <li>{@link SltdSatisfactionScoreStrategy}（{@link SatisfactionSites#SLTD}）—— 省立同德口径。</li>
|
* </ul>
|
* 由 {@link SatisfactionScoreStrategyResolver} 按站点标识选择实现；调用方（Controller / Service）
|
* 只依赖本接口 + 解析器，不再自己写站点分支 —— 以后新增站点只需新增一个实现类。
|
* <p>
|
* <b>入参统一为</b>{@code List<ServiceSubtaskDetailRatioExport>}（"问题详情占比"行：选项 + 数量 + 分值），
|
* 因为两个站点的综评入口拿到的都是这个结构。
|
*/
|
public interface SatisfactionScoreStrategy {
|
|
/**
|
* 站点标识（规范值，取自 {@link SatisfactionSites}）
|
*/
|
String site();
|
|
/**
|
* 站点名称（中文，用于文档与日志）
|
*/
|
String siteName();
|
|
/**
|
* 计算「综合满意度得分」。
|
* <p>
|
* 返回值语义由各站点口径自行定义（通用口径是<b>平均分</b>保留 1 位；
|
* 同德口径是<b>百分制加权得分</b>保留 2 位），调用方按站点既有约定呈现。
|
*
|
* @param rows 同一道题（或同一批）的选项占比行
|
* @return 得分；<b>无法计算时返回 {@code null}</b>（调用方按站点既有约定回退，例如同德回退为 "0.00"）
|
*/
|
BigDecimal comprehensiveScore(List<ServiceSubtaskDetailRatioExport> rows);
|
}
|
