package com.ruoyi.common.core.service;
|
|
import java.util.Map;
|
|
/**
|
* 满意度分类查询接口（供 ruoyi-system 等模块通过 Spring 容器调用满意度模块的实现）。
|
* <p>
|
* <b>为什么单独拆出这个接口</b>：满意度分类原本挂在 {@link IUserExtInfoService} 上，
|
* 由 smartor 模块的 {@code UserExtInfoServiceImpl} 实现。满意度模块化后，
|
* 该查询已整段搬入 ruoyi-satisfaction；为了不让调用方（登录链路）与满意度模块直接耦合，
|
* 这里把"满意度分类"这一能力单独抽成接口放在 ruoyi-common：
|
* <ul>
|
* <li>接口在 ruoyi-common —— 调用方只依赖接口，不依赖满意度模块；</li>
|
* <li>实现由满意度模块的常驻门面 {@code SatisfactionFacade} 提供，
|
* 该 Bean <b>永远存在</b>，因此调用方不会因为满意度模块被关闭而启动失败；</li>
|
* <li>满意度模块关闭（{@code satisfaction.enabled=false}）或该模块整体不在依赖里时，
|
* 调用方拿不到实现，应降级为空结果（见 {@code SysUserServiceImpl#loadSatisfactionCategories}）。</li>
|
* </ul>
|
*/
|
public interface ISatisfactionCategoryService {
|
|
/**
|
* 获取满意度问题分类（语音 + 问卷），带缓存。
|
*
|
* @param orgid 机构ID
|
* @return 包含 {@code voiceCategories} 与 {@code questionnaireCategorys} 的 Map；
|
* 满意度模块关闭或不可用时返回空 Map
|
*/
|
Map<String, Object> getSatisfactionCategories(String orgid);
|
}
|
