AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/Entity/S8/OrderFlow/AdoS8OrderFlowFinalAssemblyParallel.cs

namespace Admin.NET.Plugin.AiDOP.Entity.S8.OrderFlow;

/// <summary>
/// S8-ORDER-CHAIN-ASSEMBLY-DELIVERY-DATA-LINEAGE-AUDIT-1：
/// S8 订单执行链路 FINAL_ASSEMBLY_DELIVERY 阶段「并行准备」表（baseline + 订单级 SEED）。
///
/// order_id / order_code 允许为空：
///   - NULL → baseline 行（scenario_code=BASELINE_PPT）
///   - 非 NULL → 订单级行（scenario_code=ORDER_LEVEL）
///
/// prep_code 取值：PACKAGING_MATERIAL_PREP / LABEL_DOC_PREP / SHIPPING_PLAN / SHIPPING_DOC_PREP。
/// kitting_rate 使用 decimal(5,4)（与 manufacturing achievement_rate 同口径），取值 0.0000~1.0000。
///
/// 业务口径（拍板版本）：
///   - baseline kitting_rate：0.9500 / 0.9700 / 0.9200 / 0.9600；
///   - order-level kitting_rate 按 stage.status 修正：
///     green 单：保持 baseline；
///     yellow 单：baseline - 0.0500（4 项统一下调以保 status >= 0.85 yellow）；
///     pending 单：不生成 ORDER_LEVEL 行。
///   - status 阈值：≥0.95 green / ≥0.85 yellow / 否则 red（seed 时固化，运行期不重判）。
///
/// SEED 落地路径：不通过 IncreSeed 自动写入，由 UpdateScripts SQL（1.0.153.sql）
///   的 DELETE+INSERT 落地（与 procurement / manufacturing 三表同模式）。
/// </summary>
[SugarTable("ado_s8_order_flow_final_assembly_parallel", "S8 订单执行链路总装发货并行准备")]
[SugarIndex("idx_order_flow_fa_parallel_baseline", nameof(TenantId), OrderByType.Asc, nameof(FactoryId), OrderByType.Asc, nameof(PrepCode), OrderByType.Asc)]
[SugarIndex("idx_order_flow_fa_parallel_order", nameof(TenantId), OrderByType.Asc, nameof(FactoryId), OrderByType.Asc, nameof(OrderCode), OrderByType.Asc)]
[SugarIndex("idx_order_flow_fa_parallel_scenario", nameof(TenantId), OrderByType.Asc, nameof(FactoryId), OrderByType.Asc, nameof(ScenarioCode), OrderByType.Asc, nameof(IsDeleted), OrderByType.Asc)]
public class AdoS8OrderFlowFinalAssemblyParallel
{
    [SugarColumn(ColumnName = "id", IsPrimaryKey = true, ColumnDataType = "bigint")]
    public long Id { get; set; }

    /// <summary>NULL = baseline 行；非 NULL = 订单级行。</summary>
    [SugarColumn(ColumnName = "order_id", ColumnDataType = "bigint", IsNullable = true)]
    public long? OrderId { get; set; }

    /// <summary>NULL = baseline 行；非 NULL = 订单业务键。</summary>
    [SugarColumn(ColumnName = "order_code", Length = 64, IsNullable = true)]
    public string? OrderCode { get; set; }

    /// <summary>准备项编码：PACKAGING_MATERIAL_PREP / LABEL_DOC_PREP / SHIPPING_PLAN / SHIPPING_DOC_PREP。</summary>
    [SugarColumn(ColumnName = "prep_code", Length = 32)]
    public string PrepCode { get; set; } = string.Empty;

    /// <summary>准备项名称：包装材料准备 / 标签随箱资料准备 / 发运计划准备 / 出货单据准备。</summary>
    [SugarColumn(ColumnName = "prep_name", Length = 32)]
    public string PrepName { get; set; } = string.Empty;

    /// <summary>齐套率：decimal(5,4)，取值 0.0000~1.0000；pending 时为 NULL。</summary>
    [SugarColumn(ColumnName = "kitting_rate", DecimalDigits = 4, Length = 5, IsNullable = true)]
    public decimal? KittingRate { get; set; }

    /// <summary>状态：green / yellow / red / pending。≥0.95 green / ≥0.85 yellow / 否则 red（seed 时固化）。</summary>
    [SugarColumn(ColumnName = "status", Length = 16)]
    public string Status { get; set; } = "green";

    /// <summary>影响订单数：order-level 行为 0 或 1；baseline 行为聚合摘要（baseline 视图当前固定 0）。</summary>
    [SugarColumn(ColumnName = "impacted_order_count", ColumnDataType = "int", IsNullable = true)]
    public int? ImpactedOrderCount { get; set; }

    /// <summary>风险订单数：order-level 行为 0 或 1（status=red 时为 1）；baseline 行为聚合摘要（baseline 视图当前固定 0）。</summary>
    [SugarColumn(ColumnName = "risk_order_count", ColumnDataType = "int", IsNullable = true)]
    public int? RiskOrderCount { get; set; }

    /// <summary>主要风险类型码：稳定 sample；status=green 或 baseline 行为 NULL。</summary>
    [SugarColumn(ColumnName = "top_risk_type", Length = 64, IsNullable = true)]
    public string? TopRiskType { get; set; }

    /// <summary>主要风险展示文本：与 top_risk_type 同源；status=green 或 baseline 行为 NULL。</summary>
    [SugarColumn(ColumnName = "top_risk_label", Length = 255, IsNullable = true)]
    public string? TopRiskLabel { get; set; }

    /// <summary>责任侧文案：包装线·物料 / 技术·质量 / 发运协调 / 计划·商务。可空，前端 fallback fixture 字典。</summary>
    [SugarColumn(ColumnName = "owner_side_text", Length = 64, IsNullable = true)]
    public string? OwnerSideText { get; set; }

    /// <summary>排序号 10/20/30/40（与 4 并行准备固定顺序对齐）。</summary>
    [SugarColumn(ColumnName = "sort_no", ColumnDataType = "int")]
    public int SortNo { get; set; }

    /// <summary>BASELINE_PPT / ORDER_LEVEL。</summary>
    [SugarColumn(ColumnName = "scenario_code", Length = 16)]
    public string ScenarioCode { get; set; } = "BASELINE_PPT";

    /// <summary>SEED / IMPORT / AGG。同 (order_code, prep_code) 上 IMPORT/AGG 优先于 SEED。</summary>
    [SugarColumn(ColumnName = "data_source", Length = 16)]
    public string DataSource { get; set; } = "SEED";

    [SugarColumn(ColumnName = "tenant_id", ColumnDataType = "bigint")]
    public long TenantId { get; set; }

    [SugarColumn(ColumnName = "factory_id", ColumnDataType = "bigint")]
    public long FactoryId { get; set; }

    [SugarColumn(ColumnName = "created_at")]
    public DateTime CreatedAt { get; set; } = DateTime.Now;

    [SugarColumn(ColumnName = "updated_at", IsNullable = true)]
    public DateTime? UpdatedAt { get; set; }

    [SugarColumn(ColumnName = "is_deleted", ColumnDataType = "boolean")]
    public bool IsDeleted { get; set; }
}