AiDOPWarehouse/server/Plugins/Admin.NET.Plugin.ApprovalFlow/Service/FlowInstance/Dto/FlowInstanceDtos.cs

namespace Admin.NET.Plugin.ApprovalFlow.Service;

/// <summary>
/// 流程实例详情输出
/// </summary>
public class FlowInstanceDetailOutput
{
    public long Id { get; set; }
    public long FlowId { get; set; }
    public string BizType { get; set; } = "";
    public long BizId { get; set; }
    public string? BizNo { get; set; }
    public string Title { get; set; } = "";
    public long InitiatorId { get; set; }
    public string? InitiatorName { get; set; }
    public FlowInstanceStatusEnum Status { get; set; }
    public string? CurrentNodeId { get; set; }
    public DateTime StartTime { get; set; }
    public DateTime? EndTime { get; set; }
    /// <summary>流程 JSON 快照（发起时冻结的版本），前端可用来渲染流程图</summary>
    public string? FlowJsonSnapshot { get; set; }
    public List<FlowTaskOutput> Tasks { get; set; } = new();

    /// <summary>
    /// 已完成节点 Id 列表（来自 ApprovalFlowCompletedNode 子表，含 userTask 与网关节点）
    /// </summary>
    public List<string> CompletedNodeIds { get; set; } = new();

    /// <summary>
    /// 当前进行中的节点 Id 列表（Pending 任务 NodeId 去重；并行场景下会有多项）
    /// </summary>
    public List<string> CurrentNodeIds { get; set; } = new();
}

/// <summary>
/// 审批任务输出
/// </summary>
public class FlowTaskOutput
{
    public long Id { get; set; }
    public string NodeId { get; set; } = "";
    public string? NodeName { get; set; }
    public long AssigneeId { get; set; }
    public string? AssigneeName { get; set; }
    public FlowTaskStatusEnum Status { get; set; }
    public string? Comment { get; set; }
    public DateTime? ActionTime { get; set; }

    /// <summary>是否为代理任务</summary>
    public bool IsDelegate { get; set; }

    /// <summary>被代理人（原审批人）Id</summary>
    public long? DelegateForUserId { get; set; }

    /// <summary>被代理人（原审批人）姓名</summary>
    public string? DelegateForUserName { get; set; }
}

/// <summary>
/// 审批时间线条目
/// </summary>
public class FlowTimelineItem
{
    public long Id { get; set; }
    public string? NodeId { get; set; }
    public string? NodeName { get; set; }
    public FlowLogActionEnum Action { get; set; }
    public long OperatorId { get; set; }
    public string? OperatorName { get; set; }
    public string? Comment { get; set; }
    public DateTime CreateTime { get; set; }
}

/// <summary>
/// 流程实例分页查询输入
/// </summary>
public class InstancePageInput : BasePageInput
{
    public string? BizType { get; set; }
    public FlowInstanceStatusEnum? Status { get; set; }
}

/// <summary>
/// 流程实例分页输出
/// </summary>
public class InstancePageOutput
{
    public long Id { get; set; }
    public string BizType { get; set; } = "";
    public long BizId { get; set; }
    public string? BizNo { get; set; }
    public string Title { get; set; } = "";
    public FlowInstanceStatusEnum Status { get; set; }
    public string? CurrentNodeId { get; set; }
    public DateTime StartTime { get; set; }
    public DateTime? EndTime { get; set; }
    public string? InitiatorName { get; set; }

    /// <summary>
    /// 当前待审批人姓名（多人逗号分隔）
    /// </summary>
    public string? CurrentAssigneeName { get; set; }
}