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

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

public class AdoS8ExceptionQueryDto
{
    public long TenantId { get; set; } = 1;
    public long FactoryId { get; set; } = 1;
    public string? Keyword { get; set; }
    public string? Status { get; set; }
    public string? StatusBucket { get; set; }
    public string? Severity { get; set; }
    public string? SceneCode { get; set; }
    /// <summary>模块码过滤（S1-S7），用于监控页下钻</summary>
    public string? ModuleCode { get; set; }
    public long? DeptId { get; set; }
    public bool? TimeoutFlag { get; set; }
    public string? ProcessNodeCode { get; set; }
    public string? RelatedObjectCode { get; set; }
    public DateTime? BeginTime { get; set; }
    public DateTime? EndTime { get; set; }
    /// <summary>是否包含 exception_type_code 为 NULL 的未分类历史异常；默认 false（隐藏）。</summary>
    public bool? IncludeUnclassified { get; set; }
    /// <summary>恢复状态筛选：RECOVERED / ACTIVE / 空=不限。</summary>
    public string? RecoveredStatus { get; set; }
    /// <summary>规则类型筛选：OUT_OF_RANGE / TIMEOUT / SHORTAGE / 空=不限；通过 source_rule_code join watch_rule.rule_type。</summary>
    public string? RuleType { get; set; }
    /// <summary>S8-DASHBOARD-DATA-ALIGN-S1S7-1：仅返回 module_code IN S1-S7 的异常；看板明细表传 true 与 KPI 口径对齐。
    /// 默认 false 以保证异常列表页（/aidop/s8/exceptions）行为不变。</summary>
    public bool? OnlyS1S7Modules { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：按订单链路阶段（大写 ORDER_FLOW code）筛选。</summary>
    public string? OrderFlowCode { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：按 S_STAGE 阶段筛选。</summary>
    public string? StageCode { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：按规则机制筛选。</summary>
    public string? RuleMechanism { get; set; }
    public int Page { get; set; } = 1;
    public int PageSize { get; set; } = 20;
}

public class AdoS8ExceptionListItemDto
{
    public long Id { get; set; }
    public long FactoryId { get; set; }
    public string ExceptionCode { get; set; } = string.Empty;
    public string Title { get; set; } = string.Empty;
    public string Status { get; set; } = string.Empty;
    public string? StatusLabel { get; set; }
    public string Severity { get; set; } = string.Empty;
    public string? SeverityLabel { get; set; }
    public decimal PriorityScore { get; set; }
    public string PriorityLevel { get; set; } = string.Empty;
    public string SceneCode { get; set; } = string.Empty;
    public string? SceneName { get; set; }
    /// <summary>S8-EXCEPTION-MODULE-DISPLAY-1：业务展示主口径（S1-S7）。SceneCode/SceneName 保留兼容期。</summary>
    public string? ModuleCode { get; set; }
    public string? ModuleName { get; set; }
    public long ResponsibleDeptId { get; set; }
    public string? ResponsibleDeptName { get; set; }
    public long OccurrenceDeptId { get; set; }
    public string? OccurrenceDeptName { get; set; }
    public long? AssigneeId { get; set; }
    public string? AssigneeName { get; set; }
    public DateTime? SlaDeadline { get; set; }
    public bool TimeoutFlag { get; set; }
    public DateTime CreatedAt { get; set; }
    public DateTime? ClosedAt { get; set; }
    public string? ExceptionTypeCode { get; set; }
    public DateTime? RecoveredAt { get; set; }
    public string? SourceRuleCode { get; set; }
    public string? SourceObjectType { get; set; }
    public string? SourceObjectId { get; set; }
    public string? DedupKey { get; set; }
    public DateTime? LastDetectedAt { get; set; }
    public string? RuleType { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：关联对象编码（订单链路场景下为 order_code）。</summary>
    public string? RelatedObjectCode { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：订单链路大写 code（5 阶段协议枚举）。</summary>
    public string? OrderFlowCode { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：S_STAGE 阶段。</summary>
    public string? StageCode { get; set; }
    /// <summary>ORDER-FLOW-S8-INTEGRATED-DOMAIN-RESET-1 t3j：规则机制。</summary>
    public string? RuleMechanism { get; set; }
}

public class AdoS8ExceptionDetailDto : AdoS8ExceptionListItemDto
{
    public string? Description { get; set; }
    public string SourceType { get; set; } = string.Empty;
    public long? ResponsibleGroupId { get; set; }
    public long? ReporterId { get; set; }
    public string? ReporterName { get; set; }
    public DateTime? AssignedAt { get; set; }
    public DateTime? UpdatedAt { get; set; }
    public long? ActiveFlowInstanceId { get; set; }
    public string? ActiveFlowBizType { get; set; }
    public long? VerifierId { get; set; }
    public string? VerifierName { get; set; }
    public DateTime? VerificationAssignedAt { get; set; }
    public DateTime? VerifiedAt { get; set; }
    public string? VerificationResult { get; set; }
    public string? VerificationRemark { get; set; }
    public long? SourceRuleId { get; set; }
}

public class AdoS8ManualReportCreateDto
{
    public long TenantId { get; set; } = 1;
    public long FactoryId { get; set; } = 1;
    public string Title { get; set; } = string.Empty;
    public string? Description { get; set; }
    public string SceneCode { get; set; } = string.Empty;
    public string Severity { get; set; } = "FOLLOW";
    public long OccurrenceDeptId { get; set; }
    public long ResponsibleDeptId { get; set; }
    public long? ReporterId { get; set; }
    /// <summary>关联对象编码：当前按订单项 / 类订单项对象理解，允许重复，可为空。最长 64 字符（与 ado_s8_exception.related_object_code 一致）。</summary>
    public string? RelatedObjectCode { get; set; }

    // TASK-002-RESET-DIMENSION-MODEL-DEV-2B：手工提报维度选择（前端首版可不传，按 module_code 兜底；rule_mechanism 固定 MANUAL_REPORT）。
    public string? StageCode { get; set; }
    public string? OrderFlowCode { get; set; }
}

public class AdoS8ManualReportResultDto
{
    public long ExceptionId { get; set; }
    public string ExceptionCode { get; set; } = string.Empty;
    public long TaskId { get; set; }
}

public class AdoS8TimelineItemDto
{
    public long Id { get; set; }
    public string ActionCode { get; set; } = string.Empty;
    public string ActionLabel { get; set; } = string.Empty;
    public string? FromStatus { get; set; }
    public string? ToStatus { get; set; }
    public long? OperatorId { get; set; }
    public string? OperatorName { get; set; }
    public string? ActionRemark { get; set; }
    public DateTime CreatedAt { get; set; }
}

public class AdoS8DecisionItemDto
{
    public long Id { get; set; }
    public string DecisionType { get; set; } = string.Empty;
    public long DecisionMakerId { get; set; }
    public string DecisionMakerName { get; set; } = string.Empty;
    public string? DecisionBasis { get; set; }
    public string? DecisionResult { get; set; }
    public string? DecisionRemark { get; set; }
    public DateTime DecisionTime { get; set; }
}

public class AdoS8EvidenceItemDto
{
    public long Id { get; set; }
    public string EvidenceType { get; set; } = string.Empty;
    public string FileName { get; set; } = string.Empty;
    public string FileUrl { get; set; } = string.Empty;
    public string? SourceSystem { get; set; }
    public long? UploadedBy { get; set; }
    public DateTime UploadedAt { get; set; }
}

public class AdoS8CommentDto
{
    public string? Remark { get; set; }
}

public class AdoS8TransferDto
{
    public long AssigneeId { get; set; }
    public string? Remark { get; set; }
}

public class AdoS8AttachmentCreateDto
{
    public string EvidenceType { get; set; } = "file";
    public string FileName { get; set; } = string.Empty;
    public string FileUrl { get; set; } = string.Empty;
    public string? SourceSystem { get; set; }
    public long? UploadedBy { get; set; }
}

// ── 监控汇总 DTO ─────────────────────────────────────────────────────────────

public class AdoS8MonitoringSummaryQueryDto
{
    public long TenantId { get; set; } = 1;
    public long FactoryId { get; set; } = 1;
    /// <summary>场景码过滤（不传 = 全部）</summary>
    public string? SceneCode { get; set; }
    /// <summary>模块码过滤（不传 = 全部）</summary>
    public string? ModuleCode { get; set; }
    public DateTime? BizDateFrom { get; set; }
    public DateTime? BizDateTo { get; set; }
    /// <summary>统一时间筛选：today / this_week / this_month。BizDateFrom/BizDateTo 已传时优先于 Period。</summary>
    public string? Period { get; set; }
}

/// <summary>单个模块的异常汇总行</summary>
public class AdoS8ModuleSummaryItem
{
    public string ModuleCode { get; set; } = string.Empty;
    public string ModuleLabel { get; set; } = string.Empty;
    public string SceneCode { get; set; } = string.Empty;
    public string SceneLabel { get; set; } = string.Empty;
    public int Total { get; set; }
    public int Red { get; set; }
    public int Yellow { get; set; }
    public int Green { get; set; }
    public int Timeout { get; set; }
}

/// <summary>监控汇总出参（综合全景页顶部 + 表格数据）</summary>
public class AdoS8MonitoringSummaryDto
{
    public int Total { get; set; }
    public int Red { get; set; }
    public int Yellow { get; set; }
    public int Green { get; set; }
    public int Timeout { get; set; }
    public List<AdoS8ModuleSummaryItem> ByModule { get; set; } = new();
}

// ── 9宫格 OrderGrid DTO ──────────────────────────────────────────────────────

/// <summary>S1-S7 单个模块的订单健康分布（9宫格前7格）</summary>
public class AdoS8ModuleOrderSummary
{
    public string ModuleCode { get; set; } = string.Empty;
    public string ModuleLabel { get; set; } = string.Empty;
    /// <summary>绿色订单数（来自订单主数据，不从异常 severity 推导）。</summary>
    public int Green { get; set; }
    /// <summary>黄色订单数（FOLLOW 关注）。</summary>
    public int Yellow { get; set; }
    /// <summary>红色订单数（SERIOUS 严重，或黄色超时）。</summary>
    public int Red { get; set; }
    public int Total { get; set; }
    /// <summary>异常发生频率（每百订单异常数）</summary>
    public double Frequency { get; set; }
    /// <summary>平均处理时效（小时）</summary>
    public double AvgProcessHours { get; set; }
    /// <summary>异常关闭百分比</summary>
    public double CloseRate { get; set; }
}

/// <summary>S8格：按业务类别汇总（第8格）</summary>
public class AdoS8CategorySummary
{
    public string Category { get; set; } = string.Empty;
    public int Total { get; set; }
    public double AvgProcessHours { get; set; }
    public double CloseRate { get; set; }
}

/// <summary>S9格：按责任部门汇总（第9格）</summary>
public class AdoS8DeptSummary
{
    public string DeptName { get; set; } = string.Empty;
    public int Total { get; set; }
    public double AvgProcessHours { get; set; }
    public double CloseRate { get; set; }
}

/// <summary>9宫格完整出参</summary>
public class AdoS8OrderGridDto
{
    public List<AdoS8ModuleOrderSummary> Modules { get; set; } = new();
    public List<AdoS8CategorySummary> ByCategory { get; set; } = new();
    public List<AdoS8DeptSummary> ByDept { get; set; } = new();
}

/// <summary>S9 QDC 四主线聚合单项</summary>
public class AdoS8QdcSummaryItemDto
{
    /// <summary>主线码：QUALITY / DELIVERY / COST / INVENTORY</summary>
    public string Code { get; set; } = string.Empty;
    public string Title { get; set; } = string.Empty;
    public int Total { get; set; }
    public double? AvgProcessHours { get; set; }
    public double? OnTimeCloseRate { get; set; }
    public double? CloseRate { get; set; }
    public string? Remark { get; set; }
}

/// <summary>S9 QDC 四主线聚合出参</summary>
public class AdoS8QdcSummaryDto
{
    public List<AdoS8QdcSummaryItemDto> Items { get; set; } = new();
}

/// <summary>
/// TASK-012-S9-QDC-RATIO-MIGRATION-2：S9 result KPI 单项（订单交付率/到货达成率/检验合格率/工单完工率）。
/// 与 S9 QDC exception-side 卡片是不同语义；本期仅返回字典基础信息 + 占位 currentValue/targetRatio。
/// 真实计算入口待 RATIO-REAL-1 后续任务接入。
/// </summary>
public class AdoS8ResultKpiItemDto
{
    /// <summary>指标码（与 ado_s8_monitor_metric.metric_code 同源）</summary>
    public string MetricCode { get; set; } = string.Empty;
    public string MetricName { get; set; } = string.Empty;
    public string ObjectCode { get; set; } = string.Empty;
    public string Unit { get; set; } = "%";
    /// <summary>当前值占位；本期为 NULL 表示未计算</summary>
    public decimal? CurrentValue { get; set; }
    /// <summary>目标值；取自 ado_s8_monitor_metric.default_target_ratio</summary>
    public decimal? TargetRatio { get; set; }
    /// <summary>S8 dictionary 是否启用（本期均为 false，因 RATIO 已迁出 S8 watch_rule）</summary>
    public bool DictionaryEnabled { get; set; }
    public string? Remark { get; set; }
}

/// <summary>TASK-012-S9-QDC-RATIO-MIGRATION-2：result KPI summary 出参（mock 阶段）</summary>
public class AdoS8ResultKpiSummaryDto
{
    public List<AdoS8ResultKpiItemDto> Items { get; set; } = new();
    /// <summary>数据来源标记：DICTIONARY_MOCK = 字典 + 占位值；REAL = 真实计算（待后续任务）</summary>
    public string Source { get; set; } = "DICTIONARY_MOCK";
}

/// <summary>S8-DELIVERY-TREND-CHART-REPLACE-DUPLICATE-SECTION-1：Delivery 页近 N 日交付异常趋势出参。</summary>
public class AdoS8DeliveryTrendDto
{
    public List<AdoS8DeliveryTrendDayDto> Days { get; set; } = new();
    public AdoS8DeliveryTrendSummaryDto Summary { get; set; } = new();
}

public class AdoS8DeliveryTrendDayDto
{
    /// <summary>日期短格式 MM/dd（图表 X 轴）</summary>
    public string Date { get; set; } = string.Empty;
    /// <summary>原始日期 yyyy-MM-dd</summary>
    public string RawDate { get; set; } = string.Empty;
    public int OrderChange { get; set; }
    public int DeliveryDelay { get; set; }
    public int PendingShipment { get; set; }
    public int Total { get; set; }
}

public class AdoS8DeliveryTrendSummaryDto
{
    public int PeakValue { get; set; }
    public string? PeakDate { get; set; }
    public double AvgValue { get; set; }
    public int TodayValue { get; set; }
    /// <summary>今日相对昨日变化率（%）；昨日为 0 时返回 null。</summary>
    public double? TodayChangeRate { get; set; }
}

/// <summary>S8-PROD-SUPPLY-TREND-CHART-REPLACE-DUPLICATE-SECTION-1：Production 页近 N 日生产异常趋势出参。</summary>
public class AdoS8ProductionTrendDto
{
    public List<AdoS8ProductionTrendDayDto> Days { get; set; } = new();
    public AdoS8DeliveryTrendSummaryDto Summary { get; set; } = new();
}

public class AdoS8ProductionTrendDayDto
{
    public string Date { get; set; } = string.Empty;
    public string RawDate { get; set; } = string.Empty;
    public int EquipmentFault { get; set; }
    public int MaterialFault { get; set; }
    public int QualityFault { get; set; }
    public int Total { get; set; }
}

/// <summary>S8-PROD-SUPPLY-TREND-CHART-REPLACE-DUPLICATE-SECTION-1：Supply 页近 N 日供应异常趋势出参。</summary>
public class AdoS8SupplyTrendDto
{
    public List<AdoS8SupplyTrendDayDto> Days { get; set; } = new();
    public AdoS8DeliveryTrendSummaryDto Summary { get; set; } = new();
}

public class AdoS8SupplyTrendDayDto
{
    public string Date { get; set; } = string.Empty;
    public string RawDate { get; set; } = string.Empty;
    public int SupplierEtaIssue { get; set; }
    public int SupplierShipIssue { get; set; }
    public int WarehouseReceiptAbnormal { get; set; }
    public int IqcIssue { get; set; }
    public int WarehousePutawayIssue { get; set; }
    public int WorkOrderKittingAbnormal { get; set; }
    public int WorkOrderIssueAbnormal { get; set; }
    public int Total { get; set; }
}

/// <summary>
/// S8-SIDEBAR-TYPE-CARD-WINDOW-TOGGLE-1：右侧异常类型卡按时间窗口切片（LAST_24H / LAST_7D）出参。
/// 同一窗口内 total / open / closed / avgProcessHours / closeRate 共用同一分母，避免跨窗口拼接误读。
/// </summary>
public class AdoS8DomainTypeMetricsDto
{
    public string Domain { get; set; } = string.Empty;
    public string Window { get; set; } = string.Empty;
    public int Total { get; set; }
    public List<AdoS8DomainTypeMetricItemDto> Items { get; set; } = new();
}

public class AdoS8DomainTypeMetricItemDto
{
    public string Key { get; set; } = string.Empty;
    public string Label { get; set; } = string.Empty;
    public string TypeCode { get; set; } = string.Empty;
    public int Total { get; set; }
    public int OpenCount { get; set; }
    public int ClosedCount { get; set; }
    /// <summary>已关闭样本均时（小时）；无 closed 样本时 null，前端展示 --。</summary>
    public double? AvgProcessHours { get; set; }
    /// <summary>关闭率 %；total=0 时 null，前端展示 --。</summary>
    public double? CloseRate { get; set; }
}

public class AdoS8SubmitVerificationDto
{
    public long VerifierId { get; set; }
    public string? Remark { get; set; }
}

public class AdoS8ApproveVerificationDto
{
    public string? Remark { get; set; }
}

public class AdoS8RejectVerificationDto
{
    public string Remark { get; set; } = string.Empty;
}

// TASK-002-RESET-DIMENSION-MODEL-DEV-1: S8 业务维度元数据 DTO
public class AdoS8DimensionDto
{
    public string DimensionCode { get; set; } = string.Empty;
    public string DimensionName { get; set; } = string.Empty;
    public bool Enabled { get; set; }
    public int SortNo { get; set; }
    public string? Remark { get; set; }
}

// ── TASK-015-TREE-DEV-1：异常类型树形结构 DTO ─────────────────────────────
/// <summary>
/// 异常类型树节点；2 层结构（父节点 IsGroup=true → 子节点 IsGroup=false）。
/// 父节点不可作为业务异常类型；未归类子节点（ParentId=null AND IsGroup=false）由前端组装虚拟根。
/// </summary>
public class AdoS8ExceptionTypeTreeNodeDto
{
    public long Id { get; set; }
    public string TypeCode { get; set; } = string.Empty;
    public string TypeName { get; set; } = string.Empty;
    public long? ParentId { get; set; }
    public bool IsGroup { get; set; }
    public string SceneCode { get; set; } = string.Empty;
    public string SeverityDefault { get; set; } = string.Empty;
    public int SlaMinutes { get; set; }
    public string? OwnerRoleCode { get; set; }
    public string? EscalateRoleCode { get; set; }
    public string StatsMode { get; set; } = string.Empty;
    public string? MonitoringCategoryKey { get; set; }
    public bool MobileVisible { get; set; }
    public string? Icon { get; set; }
    public bool Enabled { get; set; }
    public int SortNo { get; set; }
    public string? Remark { get; set; }
    public DateTime CreatedAt { get; set; }
    public DateTime? UpdatedAt { get; set; }
    public List<AdoS8ExceptionTypeTreeNodeDto> Children { get; set; } = new();
}

/// <summary>
/// 异常类型树出参：顶层只包含 5 个真实父节点（IsGroup=true）。
/// 未归类节点单独以 Orphans 列表返回，由前端拼装虚拟根，避免 DB 引入未归类父节点。
/// </summary>
public class AdoS8ExceptionTypeTreeDto
{
    public List<AdoS8ExceptionTypeTreeNodeDto> Roots { get; set; } = new();
    public List<AdoS8ExceptionTypeTreeNodeDto> Orphans { get; set; } = new();
}

public class AdoS8DimensionNodeDto
{
    public long Id { get; set; }
    public string DimensionCode { get; set; } = string.Empty;
    public string NodeCode { get; set; } = string.Empty;
    public string NodeName { get; set; } = string.Empty;
    public long? ParentId { get; set; }
    public int Level { get; set; }
    public string Path { get; set; } = string.Empty;
    public bool IsSelectable { get; set; }
    /// <summary>= !IsSelectable，供前端树选择器直接消费</summary>
    public bool Disabled { get; set; }
    public bool Enabled { get; set; }
    public int SortNo { get; set; }
    public string? Remark { get; set; }
    public List<AdoS8DimensionNodeDto> Children { get; set; } = new();
}