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();
}