package com.dao;

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

/**
 * 通用接口
 * 定义系统中常用的通用数据操作方法
 * 这些方法可以被多个实体或模块复用
 */
public interface CommonDao {

    /**
     * 获取选项列表
     * 通常用于下拉框、复选框等表单组件的选项数据
     * @param params 查询参数，可能包含表名、字段名、条件等
     * @return 返回选项值的字符串列表
     */
    List<String> getOption(Map<String, Object> params);

    /**
     * 根据选项获取关联数据
     * 用于获取与某个选项相关联的详细信息
     * @param params 查询参数，包含选项值和关联条件
     * @return 返回关联数据的键值对映射
     */
    Map<String, Object> getFollowByOption(Map<String, Object> params);

    /**
     * 根据选项获取关联数据列表
     * 与getFollowByOption类似，但返回字符串列表而不是Map
     * @param params 查询参数
     * @return 返回关联数据的字符串列表
     */
    List<String> getFollowByOption2(Map<String, Object> params);

    /**
     * 审核操作
     * 通常用于更新审核状态，如通过、拒绝等
     * @param params 审核参数，包含审核ID、审核状态、审核意见等
     */
    void sh(Map<String, Object> params);

    /**
     * 提醒统计
     * 用于统计需要提醒的记录数量，如待办事项、逾期任务等
     * @param params 统计参数，包含统计条件、时间范围等
     * @return 返回符合提醒条件的记录数量
     */
    int remindCount(Map<String, Object> params);

    /**
     * 选择计算值
     * 用于执行计算查询，如求和、平均值、最大值、最小值等
     * @param params 计算参数，包含计算字段、计算类型、条件等
     * @return 返回计算结果的键值对映射
     */
    Map<String, Object> selectCal(Map<String, Object> params);

    /**
     * 分组查询
     * 用于按某个字段分组统计数据
     * @param params 分组参数，包含分组字段、统计字段、条件等
     * @return 返回分组统计结果列表，每个元素是一个分组的统计信息
     */
    List<Map<String, Object>> selectGroup(Map<String, Object> params);

    /**
     * 选择值
     * 通用的数据查询方法，用于获取特定字段的值
     * @param params 查询参数，包含表名、字段名、条件等
     * @return 返回查询结果的键值对列表
     */
    List<Map<String, Object>> selectValue(Map<String, Object> params);

    /**
     * 时间统计值
     * 专门用于按时间维度进行统计，如按日、周、月、年统计
     * @param params 时间统计参数，包含时间字段、统计类型、时间范围等
     * @return 返回时间统计结果列表
     */
    List<Map<String, Object>> selectTimeStatValue(Map<String, Object> params);
}