feat: 初始化收支管理系统

This commit is contained in:
wangshuo
2026-08-30 14:36:22 +08:00
commit 733ed4bb86
79 changed files with 5808 additions and 0 deletions
@@ -0,0 +1,41 @@
package com.example.finance.service;
import com.example.finance.dto.StatisticsQuery;
import com.example.finance.vo.CategoryStatisticsVO;
import com.example.finance.vo.MonthlyStatisticsVO;
import com.example.finance.vo.TrendStatisticsVO;
import java.util.List;
/**
* 统计服务接口,提供月度收支统计、分类统计和趋势分析功能。
*/
public interface StatisticsService {
/**
* 获取月度收支统计(总收入、总支出、结余、交易笔数)
*
* @param userId 用户ID
* @param query 统计查询条件(年份、月份)
* @return 月度统计结果
*/
MonthlyStatisticsVO getMonthlyStatistics(Long userId, StatisticsQuery query);
/**
* 获取分类维度的统计数据(各分类的金额、笔数、占比)
*
* @param userId 用户ID
* @param query 统计查询条件(年份、月份)
* @return 分类统计列表
*/
List<CategoryStatisticsVO> getCategoryStatistics(Long userId, StatisticsQuery query);
/**
* 获取每日收支趋势统计数据
*
* @param userId 用户ID
* @param query 统计查询条件(年份、月份)
* @return 按日排列的趋势统计列表
*/
List<TrendStatisticsVO> getTrendStatistics(Long userId, StatisticsQuery query);
}