ADD file via upload

CommonService.java

@@ -0,0 +1,128 @@
+/**
+ * 通用业务服务接口
+ *
+ * 在面向对象编程和分层架构中，接口定义了一组方法签名，
+ * 用于声明特定业务功能的契约，而不包含具体的实现细节。
+ * 这些接口起到了抽象业务逻辑的作用，使得上层代码（如控制器层）可以通过依赖注入的方式使用这些接口，
+ * 而不需要关心具体的实现，从而提高了代码的可维护性、可扩展性和可测试性。
+ */
+
+/**
+ * 用于定义通用的业务方法。
+ * 这些方法可以被多个业务模块复用，提供统一的通用业务能力。
+ */
+
+package com.service;
+
+import java.util.List;
+import java.util.Map;
+
+public interface CommonService {
+
+    /**
+     * 获取选项列表
+     * 通常用于前端下拉框、单选按钮等表单组件的选项数据
+     *
+     * @param params 查询参数，包含：
+     *               - table: 表名
+     *               - field: 字段名
+     *               - condition: 查询条件
+     * @return 选项值的字符串列表
+     */
+    List<String> getOption(Map<String, Object> params);
+
+    /**
+     * 根据选项获取关联数据
+     * 用于获取与某个选项值相关联的详细信息
+     *
+     * @param params 查询参数，包含：
+     *               - table: 主表名
+     *               - field: 选项字段名
+     *               - value: 选项值
+     *               - followTable: 关联表名
+     *               - followField: 关联字段名
+     * @return 关联数据的键值对映射
+     */
+    Map<String, Object> getFollowByOption(Map<String, Object> params);
+
+    /**
+     * 审核操作
+     * 用于处理业务流程中的审核状态更新
+     *
+     * @param params 审核参数，包含：
+     *               - id: 审核记录ID
+     *               - status: 审核状态（通过/拒绝）
+     *               - remark: 审核意见
+     *               - auditor: 审核人
+     */
+    void sh(Map<String, Object> params);
+
+    /**
+     * 提醒统计
+     * 用于统计需要提醒的记录数量，如待办事项、逾期任务等
+     *
+     * @param params 统计参数，包含：
+     *               - table: 表名
+     *               - column: 提醒字段名（如截止时间）
+     *               - type: 提醒类型
+     *               - remindstart: 提醒开始范围
+     *               - remindend: 提醒结束范围
+     * @return 符合提醒条件的记录数量
+     */
+    int remindCount(Map<String, Object> params);
+
+    /**
+     * 选择计算值
+     * 用于执行聚合计算查询，如求和、平均值、最大值、最小值等
+     *
+     * @param params 计算参数，包含：
+     *               - table: 表名
+     *               - column: 计算字段名
+     *               - type: 计算类型（sum、avg、max、min、count）
+     *               - condition: 计算条件
+     * @return 计算结果的键值对映射
+     */
+    Map<String, Object> selectCal(Map<String, Object> params);
+
+    /**
+     * 分组查询
+     * 用于按某个字段分组统计数据
+     *
+     * @param params 分组参数，包含：
+     *               - table: 表名
+     *               - groupColumn: 分组字段名
+     *               - calcColumn: 统计字段名
+     *               - calcType: 统计类型
+     *               - condition: 分组条件
+     * @return 分组统计结果列表，每个元素是一个分组的统计信息
+     */
+    List<Map<String, Object>> selectGroup(Map<String, Object> params);
+
+    /**
+     * 选择值
+     * 通用的数据查询方法，用于获取特定字段的值
+     *
+     * @param params 查询参数，包含：
+     *               - table: 表名
+     *               - column: 字段名
+     *               - condition: 查询条件
+     * @return 查询结果的键值对列表
+     */
+    List<Map<String, Object>> selectValue(Map<String, Object> params);
+
+    /**
+     * 时间统计值
+     * 专门用于按时间维度进行统计，如按日、周、月、年统计
+     *
+     * @param params 时间统计参数，包含：
+     *               - table: 表名
+     *               - timeColumn: 时间字段名
+     *               - statType: 统计类型（day、week、month、year）
+     *               - calcColumn: 计算字段名
+     *               - calcType: 计算类型
+     *               - startTime: 开始时间
+     *               - endTime: 结束时间
+     * @return 时间统计结果列表
+     */
+    List<Map<String, Object>> selectTimeStatValue(Map<String, Object> params);
+}