AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/FinishedWarehouse/Dto/FqcInspBillFlowDto.cs

using Admin.NET.Plugin.AiDOP.FinishedWarehouse;

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

/// <summary>
/// 检验员提交检验结果入参。写 qms_qcpp_inspbill.pd/hgsl/bhgsl/clfs（业务结果）
/// + qms_fqcbj.jyfzr/jykssj/jywcsj/FINSPECTSTATUS（检验任务执行进度，经 lydjbh=FBILLNO 关联），并推进 N1→N2。
/// </summary>
public class FqcSubmitResultInput
{
    /// <summary>检验单 id（qms_qcpp_inspbill.id，BizId）</summary>
    public long Id { get; set; }

    /// <summary>判定：0=合格 1=不合格</summary>
    public int Pd { get; set; }

    /// <summary>合格数量（qms_qcpp_inspbill.hgsl）</summary>
    public decimal Hgsl { get; set; }

    /// <summary>不合格数量（qms_qcpp_inspbill.bhgsl）</summary>
    public decimal Bhgsl { get; set; }

    /// <summary>处理方式：0=让步接收 1=挑选 2=报废（pd=1 时必填；本批仅保存，不触发返工/报废/放行/复检/库存/生产动作）</summary>
    public int? Clfs { get; set; }

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

/// <summary>检验主管通过入参（N2→end，不覆盖检验员业务结果）。</summary>
public class FqcSupervisorApproveInput
{
    /// <summary>检验单 id</summary>
    public long Id { get; set; }

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

/// <summary>检验主管退回入参（ReturnToPrev 回 N1，意见必填；保留 pd/hgsl/bhgsl/clfs/FINSPECTSTATUS/jywcsj）。</summary>
public class FqcSupervisorRejectInput
{
    /// <summary>检验单 id</summary>
    public long Id { get; set; }

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

/// <summary>
/// FQC 检验单流程状态输出（只读，供前端按钮控制）。
/// </summary>
public class FqcFlowStateOutput
{
    /// <summary>BizType（S7_FQC_INSPBILL）</summary>
    public string BizType { get; set; } = FqcInspBillFlowConst.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>当前节点码（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>当前用户是否可提交检验结果（N1 待办）</summary>
    public bool CanSubmitResult { get; set; }

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

    /// <summary>当前用户是否可主管退回（N2 待办）</summary>
    public bool CanSupervisorReject { get; set; }

    /// <summary>当前用户是否可提交 QE 处置（N3 待办）</summary>
    public bool CanSubmitDisposition { get; set; }

    /// <summary>网关判据：是否需要 QE 处置（1=需要/pd=1，0=不需要）；供前端展示/调试</summary>
    public int DispositionRequired { get; set; }

    /// <summary>是否停留在 QE 处置节点</summary>
    public bool IsWaitingDisposition { get; set; }

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

    /// <summary>QE 处置类型（已提交时展示，REWORK/CONCESSION/SCRAP/OTHER）</summary>
    public string? DispositionType { get; set; }

    /// <summary>QE 处置意见（已提交时展示）</summary>
    public string? DispositionOpinion { get; set; }

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

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

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

/// <summary>
/// QE 提交处置方案入参（N3_QE_DISPOSITION）。写 ado_s7_fqc_qe_disposition 并推进 N3→end。
/// 仅记录处置结论，不覆盖 qms_qcpp_inspbill.pd/hgsl/bhgsl/clfs、不写 qms_fqcbj/库存/仓储/生产。
/// </summary>
public class FqcQeSubmitDispositionInput
{
    /// <summary>检验单 id（qms_qcpp_inspbill.id，BizId）</summary>
    public long Id { get; set; }

    /// <summary>处置类型：REWORK 返工 / CONCESSION 让步放行 / SCRAP 报废 / OTHER 其它</summary>
    public string? DispositionType { get; set; }

    /// <summary>处置数量</summary>
    public decimal? DispositionQty { get; set; }

    /// <summary>返工数量</summary>
    public decimal? ReworkQty { get; set; }

    /// <summary>让步数量</summary>
    public decimal? ConcessionQty { get; set; }

    /// <summary>报废数量</summary>
    public decimal? ScrapQty { get; set; }

    /// <summary>处置意见（必填）</summary>
    public string? DispositionOpinion { get; set; }

    /// <summary>责任部门</summary>
    public string? ResponsibilityDept { get; set; }

    /// <summary>责任人</summary>
    public string? ResponsibleUser { get; set; }

    /// <summary>附件 JSON（预留，本批不做上传）</summary>
    public string? AttachmentJson { get; set; }

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