AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/Dto/S8/AdoS8PageConfigDto.cs

namespace Admin.NET.Plugin.AiDOP.Dto.S8;

/// <summary>
/// 大屏页面结构配置出参（GET /api/aidop/s8/dashboard/page-config）。
/// 面向四大屏启动渲染使用：只返回 enabled=true 的配置，按 layout_area + sort_no 排序。
/// 不替代 CRUD 接口 /api/aidop/s8/config/dashboard-cells，也不触发 ado_s8_exception 查询。
/// G-09 一期：DTO 不含 ShowInSidebar、FilterExpression、TenantId/FactoryId/Id、CreatedAt/UpdatedAt。
/// </summary>
public class AdoS8PageConfigDto
{
    public string PageCode { get; set; } = string.Empty;
    public List<AdoS8PageConfigCellDto> Cells { get; set; } = new();
}

public class AdoS8PageConfigCellDto
{
    /// <summary>卡片编码（页面内唯一，前端 v-for key 锚点）</summary>
    public string CellCode { get; set; } = string.Empty;

    /// <summary>卡片标题（可为空，前端按组件默认标题渲染）</summary>
    public string? CellTitle { get; set; }

    /// <summary>前端图标 key（对应 @element-plus/icons-vue 组件名）</summary>
    public string? Icon { get; set; }

    /// <summary>主布局区域：MODULES / ANALYSIS / SIDEBAR</summary>
    public string LayoutArea { get; set; } = "ANALYSIS";

    /// <summary>展示形态：STAGE_CARD / CATEGORY_CARD / CATEGORY_COMPACT / DEPT_CLUSTER / CUSTOM</summary>
    public string DisplayMode { get; set; } = "CATEGORY_CARD";

    /// <summary>页面内排序</summary>
    public int SortNo { get; set; }

    /// <summary>绑定类型：EXCEPTION_TYPE / AGGREGATE / CUSTOM</summary>
    public string BindingType { get; set; } = "CUSTOM";

    /// <summary>binding_type=EXCEPTION_TYPE 时的异常类型编码</summary>
    public string? ExceptionTypeCode { get; set; }

    /// <summary>binding_type=AGGREGATE 时的聚合范围</summary>
    public string? AggregateScope { get; set; }

    /// <summary>统计指标：OPEN_COUNT / FREQUENCY / AVG_DURATION / CLOSE_RATE</summary>
    public string StatMetric { get; set; } = "OPEN_COUNT";

    /// <summary>时间窗：TODAY / LAST_24H / LAST_7D / LAST_30D</summary>
    public string TimeWindow { get; set; } = "LAST_24H";

    /// <summary>部门聚合维度：OWNER / OCCUR</summary>
    public string DeptGroupBy { get; set; } = "OWNER";

    /// <summary>是否启用（接口仅返回 enabled=true，此字段为前端知情副本）</summary>
    public bool Enabled { get; set; }
}

/// <summary>page-config 查询入参</summary>
public class AdoS8PageConfigQueryDto
{
    /// <summary>页面编码：OVERVIEW / DELIVERY / PRODUCTION / SUPPLY</summary>
    public string PageCode { get; set; } = string.Empty;

    /// <summary>租户 ID（0 = 仅全局基线；非 0 时会叠加工厂覆盖）</summary>
    public long TenantId { get; set; } = 0;

    /// <summary>工厂 ID（0 = 仅全局基线；非 0 时会叠加工厂覆盖）</summary>
    public long FactoryId { get; set; } = 0;
}