package com.ruoyi.satisfaction.service;
|
|
import com.ruoyi.satisfaction.domain.PatSatisfaction;
|
import com.ruoyi.satisfaction.domain.vo.PatSatisfactionReqVO;
|
import com.ruoyi.satisfaction.domain.vo.PatSatisfactionResVO;
|
|
import java.util.List;
|
import java.util.Map;
|
|
/**
|
* 患者满意度 Service 接口。
|
* <p>
|
* 迁移说明：原为 {@code com.smartor.service.IPatSatisfactionService}，整体搬入满意度模块。
|
* 方法签名与语义<b>一字未改</b>，Controller 的 URL 与出入参也因此保持不变。
|
* <p>
|
* ⚠️ 本接口只应在满意度模块内部使用；其它模块需要满意度数据请使用
|
* {@code com.ruoyi.satisfaction.api} 下的门面接口。
|
*
|
* @author lihu
|
* @date 2025-06-30
|
*/
|
public interface IPatSatisfactionService {
|
|
// ================================================================ pat_satisfaction 表 CRUD
|
|
/**
|
* 查询患者满意度
|
*
|
* @param id 患者满意度主键
|
* @return 患者满意度
|
*/
|
PatSatisfaction selectPatSatisfactionById(Long id);
|
|
/**
|
* 查询患者满意度列表
|
*
|
* @param patSatisfaction 患者满意度
|
* @return 患者满意度集合
|
*/
|
List<PatSatisfaction> selectPatSatisfactionList(PatSatisfaction patSatisfaction);
|
|
/**
|
* 新增患者满意度
|
*/
|
int insertPatSatisfaction(PatSatisfaction patSatisfaction);
|
|
/**
|
* 批量新增患者满意度
|
*/
|
int batchInsert(List<PatSatisfaction> patSatisfactions);
|
|
/**
|
* 修改患者满意度
|
*/
|
int updatePatSatisfaction(PatSatisfaction patSatisfaction);
|
|
/**
|
* 批量删除患者满意度
|
*/
|
int deletePatSatisfactionByIds(Long[] ids);
|
|
/**
|
* 删除患者满意度信息
|
*/
|
int deletePatSatisfactionById(Long id);
|
|
// ================================================================ 统计
|
|
/**
|
* 患者满意度统计（明细口径：逐问题返回答题人数、平均分、最高/最低分、答题率、选项占比）
|
*
|
* @param patSatisfactionReqVO 统计条件
|
* @return 统计结果
|
*/
|
PatSatisfactionResVO statistics(PatSatisfactionReqVO patSatisfactionReqVO);
|
|
/**
|
* 患者满意度统计（维度口径，与 {@link #statistics} 的差异仅在「问题来源」：
|
* 前者按满意度分类取，本方法按入参 dimensionList 取）
|
*/
|
PatSatisfactionResVO statisticsByDimension(PatSatisfactionReqVO patSatisfactionReqVO);
|
|
/**
|
* 患者满意度柱状图信息（分类口径：按分类汇总发送量、回收人数、回收率、平均分）
|
*/
|
Map<String, Object> satisfactionGraph(PatSatisfactionReqVO patSatisfactionReqVO);
|
|
/**
|
* 患者满意度柱状图信息（维度口径）
|
*/
|
Map<String, Object> satisfactionGraphDimension(PatSatisfactionReqVO patSatisfactionReqVO);
|
}
|
