package com.reading.platform.service;

import java.util.List;
import java.util.Map;

/**
 * 学校统计服务接口
 */
public interface SchoolStatsService {

    /**
     * 获取学校统计数据
     */
    Map<String, Object> getStats(String tenantId);

    /**
     * 获取活跃教师统计（授课次数最多的前 N 名教师）
     */
    List<Map<String, Object>> getActiveTeachers(String tenantId, Integer limit);

    /**
     * 获取课程使用统计（按课时完成次数排序）
     */
    List<Map<String, Object>> getCourseUsageStats(String tenantId);

    /**
     * 获取最近活动记录
     */
    List<Map<String, Object>> getRecentActivities(String tenantId, Integer limit);

    /**
     * 获取课时趋势（最近 N 个月）
     */
    List<Map<String, Object>> getLessonTrend(String tenantId, Integer months);

    /**
     * 获取课程分布统计（饼图数据）
     */
    List<Map<String, Object>> getCourseDistribution(String tenantId);

}
