新增统计功能

2026-02-24 15:05:47 +08:00
parent f96ce8fb07
commit 589dd0305b
10 changed files with 970 additions and 3 deletions
@@ -0,0 +1,32 @@
+// Copyright (c) 2022-Now 少林寺驻北固山办事处大神父王喇嘛
+//
+// SimpleAdmin 基于 Apache License Version 2.0 协议发布，可用于商业项目，但必须遵守以下补充条款:
+// 1.请不要删除和修改根目录下的LICENSE文件。
+// 2.请不要删除和修改SimpleAdmin源码头部的版权声明。
+// 3.分发源码时候，请注明软件出处 https://gitee.com/dotnetmoyu/SimpleAdmin
+
+namespace SimpleAdmin.Application.Services.Statistics
+{
+    /// <summary>
+    /// 统计分析 Service 接口
+    /// </summary>
+    public interface IStatisticsService : ITransient
+    {
+        /// <summary>
+        /// 获取全量总览数据（不区分年份，含剩余药材库存价值）
+        /// </summary>
+        Task<TotalOverviewDto> GetTotalOverview();
+
+        /// <summary>
+        /// 获取指定年份的年度汇总统计数据（含同比趋势）
+        /// </summary>
+        /// <param name="year">年份，如 2025</param>
+        Task<YearlyStatisticsDto> GetYearlyStatistics(int year);
+
+        /// <summary>
+        /// 获取指定年份的逐月明细数据（返回 12 条，无数据月份补零）
+        /// </summary>
+        /// <param name="year">年份，如 2025</param>
+        Task<List<MonthlyDetailDto>> GetMonthlyDetails(int year);
+    }
+}