AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/Manufacturing/Dto/IpqcInspectionFlowDto.cs

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

/// <summary>
/// 检验员提交检验结果入参。写 qms_gcjyd 白名单列（jgpd/jyhgsl/jybhgsl/ybl/jyr/bz），并推进 ApprovalFlow N1→N2。
/// 判定 jgpd 可空（枚举未确认时不阻塞技术链路，不强写未知值）。
/// </summary>
public class IpqcSubmitInspectionInput
{
    /// <summary>检验单 id（qms_gcjyd.id，BizId）</summary>
    public long Id { get; set; }

    /// <summary>结果判定（jgpd，字典码；枚举未确认，可空，不强写）</summary>
    public int? Jgpd { get; set; }

    /// <summary>检验合格数量（jyhgsl，不得为负）</summary>
    public decimal Jyhgsl { get; set; }

    /// <summary>检验不合格数量（jybhgsl，不得为负，不得大于样本量）</summary>
    public decimal Jybhgsl { get; set; }

    /// <summary>样本量（ybl，检验数，不得为负）</summary>
    public decimal? Ybl { get; set; }

    /// <summary>备注（bz，可选）</summary>
    public string? Bz { get; set; }

    /// <summary>提交说明（流程意见，可选）</summary>
    public string? Comment { get; set; }
}

/// <summary>
/// 检验主管审核通过入参（整批判定驱动流程分流）。
/// Qualified=true 整批合格→end；Qualified=false 整批不合格→N3 质量处置。
/// Jgpd 为整批判定值（写 qms_gcjyd.jgpd，可空，枚举未确认不硬编码、由前端传测试/已确认合法值）。
/// </summary>
public class IpqcSupervisorApproveInput
{
    /// <summary>检验单 id</summary>
    public long Id { get; set; }

    /// <summary>整批是否合格（true=合格结束 / false=不合格转质量处置）</summary>
    public bool Qualified { get; set; } = true;

    /// <summary>整批判定 jgpd（写 qms_gcjyd.jgpd，可空，不硬编码枚举）</summary>
    public int? Jgpd { get; set; }

    /// <summary>审批意见（可选）</summary>
    public string? Comment { get; set; }
}

/// <summary>检验主管退回入参（回 N1，意见必填）。</summary>
public class IpqcSupervisorReturnInput
{
    /// <summary>检验单 id</summary>
    public long Id { get; set; }

    /// <summary>退回意见（必填）</summary>
    public string? Comment { get; set; }
}

/// <summary>
/// 过程检验单流程状态输出（只读，供前端按钮控制）。
/// </summary>
public class IpqcFlowStateOutput
{
    /// <summary>BizType（IPQC_INSPECTION）</summary>
    public string BizType { get; set; } = IpqcInspectionFlowConst.BizType;

    /// <summary>BizId（=检验单 id）</summary>
    public long BizId { get; set; }

    /// <summary>流程实例 id（未启动为 null）</summary>
    public long? InstanceId { get; set; }

    /// <summary>流程状态（NotStarted / Running / Approved / Rejected / Cancelled / Terminated）</summary>
    public string FlowStatus { get; set; } = "NotStarted";

    /// <summary>业务状态（INSPECTING / PENDING_REVIEW / APPROVED / RETURNED）</summary>
    public string? BusinessStatus { get; set; }

    /// <summary>当前节点码（N1_INSPECT / N2_SUP_REVIEW，未启动/已结束为 null）</summary>
    public string? CurrentNodeCode { get; set; }

    /// <summary>当前节点名</summary>
    public string? CurrentNodeName { get; set; }

    /// <summary>当前节点角色</summary>
    public string? CurrentAssigneeRole { get; set; }

    /// <summary>当前用户是否可提交检验结果</summary>
    public bool CanSubmitResult { get; set; }

    /// <summary>当前用户是否可主管通过</summary>
    public bool CanSupervisorApprove { get; set; }

    /// <summary>当前用户是否可主管退回</summary>
    public bool CanSupervisorReturn { get; set; }

    /// <summary>当前用户是否可提交质量处置（当前节点 N3 且本人 pending）</summary>
    public bool CanSubmitDisposition { get; set; }

    /// <summary>是否需质量处置（1=不合格转N3 / 0=合格结束；主管 N2 整批判定驱动）</summary>
    public int? DispositionRequired { get; set; }

    /// <summary>是否已有质量处置记录</summary>
    public bool HasDisposition { get; set; }

    /// <summary>流程是否已完成/终态</summary>
    public bool IsCompleted { get; set; }

    /// <summary>检验员姓名</summary>
    public string? InspectorName { get; set; }

    /// <summary>检验主管姓名</summary>
    public string? SupervisorName { get; set; }

    /// <summary>更新时间</summary>
    public DateTime? UpdatedAt { get; set; }

    /// <summary>提示信息</summary>
    public string? Message { get; set; }
}