王明 / Food-Labeling-Management-Platform

  using FoodLabeling.Application.Contracts.Dtos.Dashboard;
  using Volo.Abp.Application.Services;
  
  namespace FoodLabeling.Application.Contracts.IServices;
  
  /// <summary>
  /// Dashboard 统计接口（美国版）
  /// </summary>
  public interface IDashboardAppService : IApplicationService
  {
      /// <summary>

      /// 获取 Dashboard 总览统计（卡片 + 周趋势 + 分类分布 + Recent Labels 最近打印）。

      /// </summary>

      /// <remarks>
      /// 按 Token 数据范围统计：<b>系统管理员</b>为全平台；<b>其它账号</b>仅统计其 <c>userlocation</c> 绑定门店所属公司范围内数据。
      /// <c>activeUsers</c> / <c>people</c> 仅统计有门店绑定的成员，且<b>不包含</b>内置系统 admin（用户名 <c>admin</c> 或角色码 <c>admin</c>）。
      /// <c>recentLabels[].labelCode</c> 为门店当日打印序号 <c>yyyyMMdd-n</c>，规则与 <c>POST /api/app/us-app-labeling/preview</c>、print-log 一致。
      /// </remarks>

      Task<DashboardOverviewOutputDto> GetOverviewAsync();
  }