AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.AiDOP/MaterialWarehouse/IqcInspBillFlowBizHandler.cs

using Admin.NET.Plugin.ApprovalFlow;
using Admin.NET.Plugin.ApprovalFlow.Service;

namespace Admin.NET.Plugin.AiDOP.MaterialWarehouse;

/// <summary>
/// S5 来料检验单流程常量（BizType / 节点码 / 角色码 / 角色固定 Id / 字典）。集中避免散落字符串。
/// </summary>
public static class IqcInspBillFlowConst
{
    /// <summary>流程业务类型编码</summary>
    public const string BizType = "S5_IQC_INSPBILL";

    /// <summary>N1 检验员检验节点</summary>
    public const string NodeInspect = "N1_INSPECT";

    /// <summary>N2 检验主管审核节点</summary>
    public const string NodeSupervisor = "N2_SUP_REVIEW";

    /// <summary>GW_PD 排他网关（按 pd 分流：pd=1→SQE，否则完成）</summary>
    public const string GatewayPd = "GW_PD";

    /// <summary>N3 SQE 处置节点</summary>
    public const string NodeSqe = "N3_SQE_DISPOSITION";

    /// <summary>检验员角色编码</summary>
    public const string RoleInspectorCode = "ROLE_S5_IQC_INSPECTOR";

    /// <summary>检验主管角色编码</summary>
    public const string RoleSupervisorCode = "ROLE_S5_IQC_SUPERVISOR";

    /// <summary>SQE 角色编码</summary>
    public const string RoleSqeCode = "ROLE_S5_SQE";

    /// <summary>检验员角色固定 Id（种子与流程定义共用）</summary>
    public const long RoleInspectorId = 1329915010001L;

    /// <summary>检验主管角色固定 Id</summary>
    public const long RoleSupervisorId = 1329915010002L;

    /// <summary>SQE 角色固定 Id</summary>
    public const long RoleSqeId = 1329915010003L;

    /// <summary>流程定义版本（升 v2 加入 GW_PD/N3_SQE；seed 幂等升级依据）</summary>
    public const int FlowDefinitionVersion = 2;

    /// <summary>UAT 冒烟绑定账号（同绑两角色，仅 UAT 自审）</summary>
    public const string UatAccount = "superAdmin.NET";

    // pd 判定：0=合格 1=不合格 ｜ clfs 处理方式：0=让步接收 1=挑选 2=报废
}

/// <summary>
/// S5 来料检验单审批流回调处理器（BizType=S5_IQC_INSPBILL）。
///
/// 本批（检验员+主管最小闭环）Handler 全部 no-op：不写 qms、不写库存、不发额外通知、不转 SQE。
/// 检验结果字段 pd/dhsl/bhgsl/clfs 由 IqcInspBillFlowService.submit-result 在事务内写入；
/// 流程状态由 ApprovalFlowInstance 承载，不回写 qms_qcp_inspbill。GetBizData 仅返回基础信息供流程日志/条件（本批线性流程无网关）。
/// </summary>
public class IqcInspBillFlowBizHandler : IFlowBizHandler, ITransient
{
    public string BizType => IqcInspBillFlowConst.BizType;

    private readonly ISqlSugarClient _db;

    public IqcInspBillFlowBizHandler(ISqlSugarClient db)
    {
        _db = db;
    }

    /// <summary>流程发起后回调：本批 no-op（不回写 qms）。</summary>
    public Task OnFlowStarted(long bizId, long instanceId) => Task.CompletedTask;

    /// <summary>单节点完成回调：本批 no-op。</summary>
    public Task OnNodeCompleted(long bizId, long instanceId, string nodeId, string nodeName, long? approverUserId) => Task.CompletedTask;

    /// <summary>流程结束回调：本批 no-op（不写 qms/FBILLSTATUS/FAUDITORID/库存）。审核结果由 ApprovalFlowInstance 状态承载。</summary>
    public Task OnFlowCompleted(long bizId, long instanceId, FlowInstanceStatusEnum finalStatus, long? lastApproverId) => Task.CompletedTask;

    /// <summary>返回检验单基础信息（本批线性流程无网关条件，仅供日志/展示）。</summary>
    public async Task<Dictionary<string, object>> GetBizData(long bizId)
    {
        var rows = await _db.Ado.SqlQueryAsync<IqcInspBillFlowBizData>(
            "SELECT FBILLNO AS BillNo, FMATERIALCFG AS MaterialCode, wlmc AS MaterialName, pd AS Pd, clfs AS Clfs FROM qms_qcp_inspbill WHERE id=@id LIMIT 1",
            new List<SugarParameter> { new("@id", bizId) });
        var r = rows.FirstOrDefault();
        if (r == null) return new Dictionary<string, object>();
        return new Dictionary<string, object>
        {
            ["billNo"] = r.BillNo ?? "",
            ["materialCode"] = r.MaterialCode ?? "",
            ["materialName"] = r.MaterialName ?? "",
            ["pd"] = r.Pd ?? -1,
            ["clfs"] = r.Clfs ?? -1,
        };
    }

    private class IqcInspBillFlowBizData
    {
        public string? BillNo { get; set; }
        public string? MaterialCode { get; set; }
        public string? MaterialName { get; set; }
        public long? Pd { get; set; }
        public long? Clfs { get; set; }
    }
}