IUsAppLabelingAppService.cs 2.11 KB
using FoodLabeling.Application.Contracts.Dtos.Common;
using FoodLabeling.Application.Contracts.Dtos.Reports;
using FoodLabeling.Application.Contracts.Dtos.UsAppLabeling;
using Volo.Abp.Application.Services;

namespace FoodLabeling.Application.Contracts.IServices;

/// <summary>
/// App Labeling:四级列表(标签分类 → 产品分类 → 产品卡片「按模板拆分」→ 标签种类)
/// </summary>
public interface IUsAppLabelingAppService : IApplicationService
{
    /// <summary>
    /// 获取当前门店下四级嵌套树,供移动端 Labeling 首页使用
    /// </summary>
    Task<List<UsAppLabelCategoryTreeNodeDto>> GetLabelingTreeAsync(UsAppLabelingTreeInputVo input);

    /// <summary>
    /// App 打印预览:按标签编码解析模板并返回顶部展示字段 + 预览模板结构。
    /// 出参 <c>labelId</c> 为门店当日**下一个**打印序号(<c>yyyyMMdd-n</c>),非 <c>fl_label.Id</c>。
    /// </summary>
    Task<UsAppLabelPreviewDto> PreviewAsync(UsAppLabelPreviewInputVo input);

    /// <summary>
    /// App 打印:创建打印任务并落库打印明细(fl_label_print_task / fl_label_print_data)
    /// </summary>
    Task<UsAppLabelPrintOutputDto> PrintAsync(UsAppLabelPrintInputVo input);

    /// <summary>
    /// App 重新打印:根据历史任务Id重打(创建新任务与明细)
    /// </summary>
    Task<UsAppLabelPrintOutputDto> ReprintAsync(UsAppLabelReprintInputVo input);

    /// <summary>
    /// App 打印日志:当前门店打印记录(分页)。已绑定该门店的账号可见门店内<b>全部用户</b>的打印任务。
    /// 支持 <c>printDateDay</c> / <c>printDate</c> 按自然日筛选;出参 <c>labelId</c> 为门店当日打印序号(<c>yyyyMMdd-n</c>)。
    /// </summary>
    Task<PagedResultWithPageDto<PrintLogItemDto>> GetPrintLogListAsync(PrintLogGetListInputVo input);

    /// <summary>
    /// App Label Report:当前门店统计(该门店下全部用户的打印任务,不按 CreatedBy 过滤)。
    /// </summary>
    Task<ReportsLabelReportOutputDto> GetLabelReportAsync(UsAppLabelReportQueryInputVo input);
}