package com.moka.gdtauto.service;

import java.util.Map;

/**
 * Dashboard仪表盘服务接口
 * 提供首页统计数据和系统状态信息服务
 * 
 * @author moka
 * @since 2026-02-06
 */
public interface DashboardService {

    /**
     * 获取首页统计概览数据
     * 包括视频、图片、广告组、转化等核心指标
     * 
     * @return 统计数据Map
     */
    Map<String, Object> getStatisticsOverview();

    /**
     * 获取视频相关统计数据
     * 
     * @return 视频统计数据Map
     */
    Map<String, Object> getVideoStatistics();

    /**
     * 获取图片相关统计数据
     * 
     * @return 图片统计数据Map
     */
    Map<String, Object> getImageStatistics();

    /**
     * 获取广告组相关统计数据
     * 
     * @return 广告组统计数据Map
     */
    Map<String, Object> getAdgroupStatistics();

    /**
     * 获取转化相关统计数据
     * 
     * @return 转化统计数据Map
     */
    Map<String, Object> getConversionStatistics();

    /**
     * 获取系统状态信息
     * 
     * @return 系统状态Map
     */
    Map<String, Object> getSystemStatus();

    /**
     * 获取最近活动记录
     * 
     * @param limit 限制数量
     * @return 最近活动Map
     */
    Map<String, Object> getRecentActivities(String jobNumber, Integer limit);
}