using F9WebAiTest.Application.Common;
using F9WebAiTest.Application.Dtos.SYS.Reports;
using F9WebAiTest.Domain.Entities.SYS.Reports;

namespace F9WebAiTest.Application.Services.Reports;

public interface IReportService
{
    Task<PageResult<ReportListDto>> GetPagedAsync(string like, string category, bool? isActive, int pageIndex, int pageSize);
    Task<ReportDetailDto> GetByIdAsync(long id);
    Task<long> CreateAsync(ReportCreateDto dto);
    Task UpdateAsync(long id, ReportUpdateDto dto);
    Task DeleteAsync(long id);

    /// <summary>上传 .grf 模板文件（f9designer:// 本机设计器协议回传用）；常规保存走 Create/Update 的 templateJson</summary>
    Task UploadTemplateAsync(long id, byte[] data, string fileName);

    /// <summary>直接保存模板文本（前端在线编辑模板源码用，免下载 / 上传），返回保存后的字符数</summary>
    Task<int> SaveTemplateContentAsync(long id, string content);

    /// <summary>读取报表模板内容（ReportFile.DesignContent，.grf 的 JSON 文本）；无模板返回 null</summary>
    Task<string?> GetTemplateContentAsync(Report report);

    /// <summary>用户可见报表（按权限码过滤，admin 返回全部启用报表）</summary>
    Task<List<ReportViewDto>> GetVisibleReportsAsync(long userId, bool isAdmin, IReadOnlyCollection<string> permissions);

    /// <summary>校验用户是否拥有某报表的查看权限（admin 视为通过）</summary>
    Task EnsureReportAccessAsync(long userId, bool isAdmin, IReadOnlyCollection<string> permissions, long reportId);

    /// <summary>执行报表数据查询 SQL，返回 Grid++Report 约定的 JSON 形态</summary>
    Task<Dictionary<string, object?>> ExecuteDataAsync(Report report, IReadOnlyDictionary<string, object?> parameters);

    /// <summary>列出所有启用的报表（角色管理-报表权限分配时使用）</summary>
    Task<List<ReportListDto>> GetAllActiveAsync();

    /// <summary>数据源清单（IReportDataProvider 注册表 + 各自声明的查询参数），新增报表自动配置用</summary>
    Task<List<ReportDataSourceInfoDto>> GetDataSourcesAsync();

    /// <summary>探测数据源结构：按 DsName / DataSql 执行一次查询，识别明细列与参数</summary>
    Task<ReportProbeResultDto> ProbeAsync(ReportProbeRequestDto request);
}