namespace F9WebAiTest.Application.Dtos.SYS.Reports;

/// <summary>已注册的报表数据源（IReportDataProvider.ReportName）</summary>
public class ReportDataSourceInfoDto
{
    public string DsName { get; set; } = "";
}

/// <summary>明细字段（.grf 模板 DetailGrid.Recordset.Field 的映射来源），全部由查询结果推断</summary>
public class ReportFieldDefDto
{
    public string Name { get; set; } = "";
    public string Label { get; set; } = "";
    public string DataType { get; set; } = "String";
}

/// <summary>探测请求：按 DsName（或 DataSql）执行一次查询，识别返回的列</summary>
public class ReportProbeRequestDto
{
    /// <summary>数据源名称（IReportDataProvider.ReportName），优先于 DataSql</summary>
    public string? DsName { get; set; }

    /// <summary>数据 SQL（无 DsName 时用于探测列）</summary>
    public string? DataSql { get; set; }

    /// <summary>执行探测时传入的参数值（键 = 参数名；报表上已配置的参数由前端带入）</summary>
    public Dictionary<string, object?> Params { get; set; } = new();
}

/// <summary>
/// 报表参数（后端 DataSource.Parameter_Data 的键值）。
/// 注意：这是「报表参数」——由查询执行后返回、供模板头展示的统计口径；
/// 与 Config.Parms 里的「查询条件」（q_*，用于查询面板传参）不是一回事。
/// </summary>
public class ReportParamValueDto
{
    public string Name { get; set; } = "";
    public string Value { get; set; } = "";
}

/// <summary>探测结果：查询返回的明细字段 + 报表参数 + 少量样本行</summary>
public class ReportProbeResultDto
{
    public string DsName { get; set; } = "";
    public List<ReportFieldDefDto> Fields { get; set; } = new();

    /// <summary>报表参数（Parameter_Data 的键值），模板头/合计区直接引用</summary>
    public List<ReportParamValueDto> Parameters { get; set; } = new();

    public List<Dictionary<string, object?>> Rows { get; set; } = new();
    public int Total { get; set; }

    /// <summary>探测失败原因</summary>
    public string? Error { get; set; }
}