新增统计功能

This commit is contained in:
fuenmao
2026-02-24 15:05:47 +08:00
parent f96ce8fb07
commit 589dd0305b
10 changed files with 970 additions and 3 deletions
@@ -215,6 +215,127 @@
</summary>
<returns></returns>
</member>
<member name="T:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto">
<summary>
年度统计数据 DTO(对应前端 YearlyStatisticsDto)
</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.Year">
<summary>统计年份(如 "2025")</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.TotalCost">
<summary>处方总花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.TotalQty">
<summary>处方总数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.StaffCost">
<summary>员工处方花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.FamilyCost">
<summary>家属处方花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.StaffQty">
<summary>员工处方数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.FamilyQty">
<summary>家属处方数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.MaterialCost">
<summary>药材耗材花费(元)—— 当年所有入库药材总价</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.ServiceCount">
<summary>服务人数(当年有过处方记录的不重复人员数)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.TotalCostTrend">
<summary>处方总花费同比趋势 (%)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.TotalQtyTrend">
<summary>处方总数量同比趋势 (%)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.MaterialCostTrend">
<summary>药材花费同比趋势 (%)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.YearlyStatisticsDto.ServiceCountTrend">
<summary>服务人数同比趋势 (%)</summary>
</member>
<member name="T:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto">
<summary>
月度明细数据 DTO(对应前端 MonthlyDetailDto)
</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto.Month">
<summary>月份显示(如 "1月")</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto.StaffCost">
<summary>员工处方花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto.FamilyCost">
<summary>家属处方花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto.StaffQty">
<summary>员工处方数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto.FamilyQty">
<summary>家属处方数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.MonthlyDetailDto.MaterialCost">
<summary>药材耗材花费(元)—— 当月入库总价</summary>
</member>
<member name="T:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto">
<summary>
全量总览 DTO(不区分年份,含剩余药材价值)
</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.TotalCost">
<summary>处方总花费(元,含所有年份)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.TotalQty">
<summary>处方总数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.StaffCost">
<summary>员工处方花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.FamilyCost">
<summary>家属处方花费(元)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.StaffQty">
<summary>员工处方数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.FamilyQty">
<summary>家属处方数量(张)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.MaterialCost">
<summary>药材采购总花费(元,历史所有入库总额)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.ServiceCount">
<summary>累计服务人数(不重复人员)</summary>
</member>
<member name="P:SimpleAdmin.Application.Services.Statistics.TotalOverviewDto.RemainingMedicinalValue">
<summary>当前剩余药材库存价值(元,按最新入库单价估算)</summary>
</member>
<member name="T:SimpleAdmin.Application.Services.Statistics.IStatisticsService">
<summary>
统计分析 Service 接口
</summary>
</member>
<member name="M:SimpleAdmin.Application.Services.Statistics.IStatisticsService.GetTotalOverview">
<summary>
获取全量总览数据(不区分年份,含剩余药材库存价值)
</summary>
</member>
<member name="M:SimpleAdmin.Application.Services.Statistics.IStatisticsService.GetYearlyStatistics(System.Int32)">
<summary>
获取指定年份的年度汇总统计数据(含同比趋势)
</summary>
<param name="year">年份,如 2025</param>
</member>
<member name="M:SimpleAdmin.Application.Services.Statistics.IStatisticsService.GetMonthlyDetails(System.Int32)">
<summary>
获取指定年份的逐月明细数据(返回 12 条,无数据月份补零)
</summary>
<param name="year">年份,如 2025</param>
</member>
<member name="T:SimpleAdmin.Application.IOrgService">
<summary>
机构服务
@@ -845,5 +966,40 @@
</summary>
<returns></returns>
</member>
<member name="T:StatisticsService">
<summary>
统计分析 Service 实现
</summary>
</member>
<member name="M:StatisticsService.GetTotalOverview">
<inheritdoc/>
</member>
<member name="M:StatisticsService.GetYearlyStatistics(System.Int32)">
<inheritdoc/>
</member>
<member name="M:StatisticsService.GetMonthlyDetails(System.Int32)">
<inheritdoc/>
</member>
<member name="M:StatisticsService.BuildYearData(System.Int32)">
<summary>
计算指定年份的聚合数据(用于年度统计与同比计算)
</summary>
</member>
<member name="M:StatisticsService.GetFifoData(System.Collections.Generic.List{System.Int64})">
<summary>
读取 FIFO 入库数据(按时间升序)
</summary>
</member>
<member name="M:StatisticsService.CalculateFifoCost(System.Collections.Generic.Dictionary{System.Int64,System.Collections.Generic.List{SimpleAdmin.Application.Services.Prescription.Dto.MedicinalFifoRecord}},System.Collections.Generic.Dictionary{System.Int64,System.Decimal},System.Int64,System.Decimal)">
<summary>
按 FIFO 规则(含累计偏移)计算单次消耗成本,并推进偏移量
</summary>
</member>
<member name="M:StatisticsService.CalcTrend``1(``0,``0)">
<summary>计算同比增涨率(%),基期为 0 时返回 0</summary>
</member>
<member name="M:StatisticsService.BuildEmptyMonthList">
<summary>返回全零的 12 个月明细列表</summary>
</member>
</members>
</doc>