package cn.iocoder.yudao.module.im.service.statistics;
|
|
import java.time.LocalDateTime;
|
import java.util.Map;
|
|
/**
|
* IM 数据看板 Service 接口
|
* <p>
|
* 仅服务于 manager 后台统计页，独立于业务 Service，避免污染。
|
* 返回的均为聚合后的简单结构，由 Controller 负责 VO 装配与昵称回填。
|
*
|
* @author 芋道源码
|
*/
|
public interface ImStatisticsManagerService {
|
|
// ==================== 用户 ====================
|
|
/**
|
* 获取用户总数
|
*/
|
Long getTotalUserCount();
|
|
/**
|
* 获取区间内新增用户数
|
*/
|
Long getNewUserCount(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内活跃用户数（私聊+群聊去重）
|
*/
|
Long getActiveUserCount(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内每日新增用户数 Map（key 为 yyyy-MM-dd 日期）
|
*/
|
Map<LocalDateTime, Long> getNewUserDailyCountMap(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内每日活跃用户数 Map
|
*/
|
Map<LocalDateTime, Long> getActiveUserDailyCountMap(LocalDateTime beginTime, LocalDateTime endTime);
|
|
// ==================== 群 ====================
|
|
/**
|
* 获取群总数
|
*/
|
Long getTotalGroupCount();
|
|
/**
|
* 获取区间内新建群数
|
*/
|
Long getNewGroupCount(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取群规模分布 Map（key 为分桶名）
|
*/
|
Map<String, Long> getGroupSizeCountMap();
|
|
// ==================== 消息 ====================
|
|
/**
|
* 获取区间内私聊消息数
|
*/
|
Long getPrivateMessageCount(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内群聊消息数
|
*/
|
Long getGroupMessageCount(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内每日私聊消息数 Map
|
*/
|
Map<LocalDateTime, Long> getPrivateMessageDailyCountMap(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内每日群聊消息数 Map
|
*/
|
Map<LocalDateTime, Long> getGroupMessageDailyCountMap(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内内容类型分布 Map（key 为消息类型）
|
*/
|
Map<Integer, Long> getMessageTypeCountMap(LocalDateTime beginTime, LocalDateTime endTime);
|
|
/**
|
* 获取区间内 TOP 发送者 Map（key 为 userId，value 为消息数；按消息数倒序）
|
*/
|
Map<Long, Long> getTopSenderCountMap(LocalDateTime beginTime, LocalDateTime endTime, int limit);
|
|
}
|
