using System.Text.Json;
namespace Admin.NET.Plugin.ApprovalFlow.Service;
///
/// 流程推进引擎 — 核心状态机
/// 不暴露为 API,由其他 Service 内部调用
///
public class FlowEngineService : ITransient
{
private readonly SqlSugarRepository _flowRep;
private readonly SqlSugarRepository _instanceRep;
private readonly SqlSugarRepository _taskRep;
private readonly SqlSugarRepository _logRep;
private readonly SqlSugarRepository _userRoleRep;
private readonly SqlSugarRepository _userRep;
private readonly UserManager _userManager;
private readonly FlowNotifyService _notifyService;
public FlowEngineService(
SqlSugarRepository flowRep,
SqlSugarRepository instanceRep,
SqlSugarRepository taskRep,
SqlSugarRepository logRep,
SqlSugarRepository userRoleRep,
SqlSugarRepository userRep,
UserManager userManager,
FlowNotifyService notifyService)
{
_flowRep = flowRep;
_instanceRep = instanceRep;
_taskRep = taskRep;
_logRep = logRep;
_userRoleRep = userRoleRep;
_userRep = userRep;
_userManager = userManager;
_notifyService = notifyService;
}
// ═══════════════════════════════════════════
// 核心生命周期
// ═══════════════════════════════════════════
///
/// 发起流程
///
public async Task StartFlow(StartFlowInput input)
{
var flow = await _flowRep.AsQueryable()
.Where(u => u.BizType == input.BizType && u.IsPublished && !u.IsDelete)
.OrderByDescending(u => u.Version)
.FirstAsync() ?? throw Oops.Oh($"未找到业务类型 [{input.BizType}] 的已发布流程定义");
if (string.IsNullOrWhiteSpace(flow.FlowJson))
throw Oops.Oh("流程定义的 FlowJson 为空,请先设计流程图");
var flowData = JsonSerializer.Deserialize(flow.FlowJson)
?? throw Oops.Oh("FlowJson 反序列化失败");
var instance = new ApprovalFlowInstance
{
FlowId = flow.Id,
FlowVersion = flow.Version,
BizType = input.BizType,
BizId = input.BizId,
BizNo = input.BizNo,
Title = input.Title ?? $"{flow.Name}-{input.BizNo}",
InitiatorId = _userManager.UserId,
InitiatorName = _userManager.RealName,
Status = FlowInstanceStatusEnum.Running,
FlowJsonSnapshot = flow.FlowJson,
StartTime = DateTime.Now,
};
var startNode = flowData.Nodes.FirstOrDefault(n =>
n.Type is "bpmn:startEvent" or "start-node")
?? throw Oops.Oh("流程图中未找到开始节点");
var firstTaskNodeId = FindNextNodeId(flowData, startNode.Id);
instance.CurrentNodeId = firstTaskNodeId;
await _instanceRep.InsertAsync(instance);
await WriteLog(instance.Id, null, startNode.Id, FlowLogActionEnum.Submit, input.Comment);
await CreateTasksForNode(instance, flowData, firstTaskNodeId);
await InvokeHandler(input.BizType, h => h.OnFlowStarted(input.BizId, instance.Id));
return instance.Id;
}
///
/// 同意
///
public async Task Approve(long taskId, string? comment)
{
var task = await GetPendingTask(taskId);
task.Status = FlowTaskStatusEnum.Approved;
task.Comment = comment;
task.ActionTime = DateTime.Now;
await _taskRep.AsUpdateable(task).ExecuteCommandAsync();
await WriteLog(task.InstanceId, taskId, task.NodeId, FlowLogActionEnum.Approve, comment);
var instance = await _instanceRep.GetByIdAsync(task.InstanceId)
?? throw Oops.Oh("流程实例不存在");
if (await IsNodeCompleted(instance, task.NodeId))
{
await InvokeHandler(instance.BizType,
h => h.OnNodeCompleted(instance.BizId, task.NodeId, task.NodeName ?? ""));
var flowData = DeserializeFlowJson(instance.FlowJsonSnapshot);
await AdvanceToNext(instance, flowData, task.NodeId);
}
}
///
/// 拒绝
///
public async Task Reject(long taskId, string? comment)
{
var task = await GetPendingTask(taskId);
task.Status = FlowTaskStatusEnum.Rejected;
task.Comment = comment;
task.ActionTime = DateTime.Now;
await _taskRep.AsUpdateable(task).ExecuteCommandAsync();
await CancelPendingTasks(task.InstanceId, task.NodeId, task.Id);
var instance = await _instanceRep.GetByIdAsync(task.InstanceId)
?? throw Oops.Oh("流程实例不存在");
instance.Status = FlowInstanceStatusEnum.Rejected;
instance.EndTime = DateTime.Now;
await _instanceRep.AsUpdateable(instance).ExecuteCommandAsync();
await WriteLog(instance.Id, taskId, task.NodeId, FlowLogActionEnum.Reject, comment);
await InvokeHandler(instance.BizType,
h => h.OnFlowCompleted(instance.BizId, FlowInstanceStatusEnum.Rejected));
await _notifyService.NotifyFlowCompleted(instance.InitiatorId, instance.Id, instance.Title, FlowInstanceStatusEnum.Rejected);
}
// ═══════════════════════════════════════════
// 扩展操作
// ═══════════════════════════════════════════
///
/// 转办
///
public async Task Transfer(long taskId, long targetUserId, string? comment)
{
var task = await GetPendingTask(taskId);
task.Status = FlowTaskStatusEnum.Transferred;
task.Comment = comment;
task.ActionTime = DateTime.Now;
task.TransferToId = targetUserId;
await _taskRep.AsUpdateable(task).ExecuteCommandAsync();
var targetUser = await _userRep.GetByIdAsync(targetUserId);
var newTask = new ApprovalFlowTask
{
InstanceId = task.InstanceId,
NodeId = task.NodeId,
NodeName = task.NodeName,
AssigneeId = targetUserId,
AssigneeName = targetUser?.RealName,
Status = FlowTaskStatusEnum.Pending,
};
await _taskRep.InsertAsync(newTask);
await WriteLog(task.InstanceId, taskId, task.NodeId, FlowLogActionEnum.Transfer,
$"{comment} → 转办给 {targetUser?.RealName}");
var instance = await _instanceRep.GetByIdAsync(task.InstanceId);
await _notifyService.NotifyTransferred(targetUserId, task.InstanceId, instance?.Title ?? "", _userManager.RealName);
}
///
/// 撤回(发起人撤回)
///
public async Task Withdraw(long instanceId)
{
var instance = await _instanceRep.GetByIdAsync(instanceId)
?? throw Oops.Oh("流程实例不存在");
if (instance.InitiatorId != _userManager.UserId)
throw Oops.Oh("只有发起人可以撤回");
if (instance.Status != FlowInstanceStatusEnum.Running)
throw Oops.Oh("当前流程状态不允许撤回");
var pendingTasks = await _taskRep.AsQueryable()
.Where(t => t.InstanceId == instanceId && t.Status == FlowTaskStatusEnum.Pending)
.ToListAsync();
var doneTasks = await _taskRep.AsQueryable()
.Where(t => t.InstanceId == instanceId &&
t.Status != FlowTaskStatusEnum.Pending &&
t.Status != FlowTaskStatusEnum.Cancelled)
.CountAsync();
if (doneTasks > 0)
throw Oops.Oh("已有人审批过,不可撤回");
var cancelledUserIds = pendingTasks.Select(t => t.AssigneeId).Distinct().ToList();
foreach (var t in pendingTasks)
{
t.Status = FlowTaskStatusEnum.Cancelled;
t.ActionTime = DateTime.Now;
}
await _taskRep.AsUpdateable(pendingTasks).ExecuteCommandAsync();
instance.Status = FlowInstanceStatusEnum.Cancelled;
instance.EndTime = DateTime.Now;
await _instanceRep.AsUpdateable(instance).ExecuteCommandAsync();
await WriteLog(instanceId, null, instance.CurrentNodeId, FlowLogActionEnum.Withdraw, null);
await InvokeHandler(instance.BizType,
h => h.OnFlowCompleted(instance.BizId, FlowInstanceStatusEnum.Cancelled));
await _notifyService.NotifyWithdrawn(cancelledUserIds, instanceId, instance.Title, instance.InitiatorName);
}
///
/// 退回上一步
///
public async Task ReturnToPrev(long taskId, string? comment)
{
var task = await GetPendingTask(taskId);
var instance = await _instanceRep.GetByIdAsync(task.InstanceId)
?? throw Oops.Oh("流程实例不存在");
var flowData = DeserializeFlowJson(instance.FlowJsonSnapshot);
var prevNodeId = FindPrevUserTaskNodeId(flowData, task.NodeId);
if (prevNodeId == null)
throw Oops.Oh("已是第一个审批节点,无法退回");
await CancelPendingTasks(task.InstanceId, task.NodeId);
task.Status = FlowTaskStatusEnum.Returned;
task.Comment = comment;
task.ActionTime = DateTime.Now;
await _taskRep.AsUpdateable(task).ExecuteCommandAsync();
instance.CurrentNodeId = prevNodeId;
await _instanceRep.AsUpdateable(instance).ExecuteCommandAsync();
await CreateTasksForNode(instance, flowData, prevNodeId);
await WriteLog(instance.Id, taskId, task.NodeId, FlowLogActionEnum.Return, comment);
var returnedTasks = await _taskRep.AsQueryable()
.Where(t => t.InstanceId == instance.Id && t.NodeId == prevNodeId && t.Status == FlowTaskStatusEnum.Pending)
.ToListAsync();
var returnedUserIds = returnedTasks.Select(t => t.AssigneeId).Distinct().ToList();
await _notifyService.NotifyReturned(returnedUserIds, instance.Id, instance.Title, _userManager.RealName);
}
///
/// 加签
///
public async Task AddSign(long taskId, long targetUserId, string? comment)
{
var task = await GetPendingTask(taskId);
var targetUser = await _userRep.GetByIdAsync(targetUserId);
var newTask = new ApprovalFlowTask
{
InstanceId = task.InstanceId,
NodeId = task.NodeId,
NodeName = task.NodeName,
AssigneeId = targetUserId,
AssigneeName = targetUser?.RealName,
Status = FlowTaskStatusEnum.Pending,
IsAddSign = true,
AddSignById = _userManager.UserId,
};
await _taskRep.InsertAsync(newTask);
await WriteLog(task.InstanceId, taskId, task.NodeId, FlowLogActionEnum.AddSign,
$"{comment} → 加签给 {targetUser?.RealName}");
var instance = await _instanceRep.GetByIdAsync(task.InstanceId);
await _notifyService.NotifyAddSign(targetUserId, task.InstanceId, instance?.Title ?? "", _userManager.RealName);
}
///
/// 催办
///
public async Task Urge(long instanceId)
{
var instance = await _instanceRep.GetByIdAsync(instanceId)
?? throw Oops.Oh("流程实例不存在");
if (instance.Status != FlowInstanceStatusEnum.Running)
throw Oops.Oh("当前流程不在审批中");
await WriteLog(instanceId, null, instance.CurrentNodeId, FlowLogActionEnum.Urge, "催办");
var pendingTasks = await _taskRep.AsQueryable()
.Where(t => t.InstanceId == instanceId && t.Status == FlowTaskStatusEnum.Pending)
.ToListAsync();
var userIds = pendingTasks.Select(t => t.AssigneeId).Distinct().ToList();
await _notifyService.NotifyUrge(userIds, instanceId, instance.Title);
}
// ═══════════════════════════════════════════
// 内部引擎方法
// ═══════════════════════════════════════════
private async Task AdvanceToNext(ApprovalFlowInstance instance, ApprovalFlowItem flowData, string currentNodeId)
{
var nextNodeId = FindNextNodeId(flowData, currentNodeId);
if (nextNodeId == null)
{
await CompleteInstance(instance, FlowInstanceStatusEnum.Approved);
return;
}
var nextNode = flowData.Nodes.FirstOrDefault(n => n.Id == nextNodeId);
if (nextNode == null)
{
await CompleteInstance(instance, FlowInstanceStatusEnum.Approved);
return;
}
if (nextNode.Type is "bpmn:endEvent" or "end-node")
{
await CompleteInstance(instance, FlowInstanceStatusEnum.Approved);
return;
}
if (nextNode.Type is "bpmn:exclusiveGateway")
{
var bizData = await GetBizData(instance.BizType, instance.BizId);
var targetNodeId = EvaluateGateway(nextNode.Properties?.Conditions, flowData, nextNode.Id, bizData);
instance.CurrentNodeId = targetNodeId;
await _instanceRep.AsUpdateable(instance).UpdateColumns(i => new { i.CurrentNodeId }).ExecuteCommandAsync();
await AdvanceToNext(instance, flowData, nextNode.Id);
return;
}
instance.CurrentNodeId = nextNodeId;
await _instanceRep.AsUpdateable(instance).UpdateColumns(i => new { i.CurrentNodeId }).ExecuteCommandAsync();
await CreateTasksForNode(instance, flowData, nextNodeId);
}
private async Task CompleteInstance(ApprovalFlowInstance instance, FlowInstanceStatusEnum status)
{
instance.Status = status;
instance.EndTime = DateTime.Now;
await _instanceRep.AsUpdateable(instance)
.UpdateColumns(i => new { i.Status, i.EndTime })
.ExecuteCommandAsync();
await InvokeHandler(instance.BizType,
h => h.OnFlowCompleted(instance.BizId, status));
await _notifyService.NotifyFlowCompleted(instance.InitiatorId, instance.Id, instance.Title, status);
}
private async Task CreateTasksForNode(ApprovalFlowInstance instance, ApprovalFlowItem flowData, string nodeId)
{
var node = flowData.Nodes.FirstOrDefault(n => n.Id == nodeId)
?? throw Oops.Oh($"FlowJson 中未找到节点 [{nodeId}]");
var approvers = await ResolveApprovers(node.Properties, instance.InitiatorId);
if (approvers.Count == 0)
throw Oops.Oh($"节点 [{node.Properties?.NodeName ?? nodeId}] 未配置审批人或审批人列表为空");
var tasks = approvers.Select(a => new ApprovalFlowTask
{
InstanceId = instance.Id,
NodeId = nodeId,
NodeName = node.Properties?.NodeName ?? node.Text?.Value,
AssigneeId = a.userId,
AssigneeName = a.userName,
Status = FlowTaskStatusEnum.Pending,
}).ToList();
await _taskRep.AsInsertable(tasks).ExecuteCommandAsync();
var assigneeIds = tasks.Select(t => t.AssigneeId).Distinct().ToList();
await _notifyService.NotifyNewTask(assigneeIds, instance.Id, instance.Title, node.Properties?.NodeName ?? node.Text?.Value);
}
private async Task> ResolveApprovers(FlowProperties? props, long initiatorId)
{
if (props == null || string.IsNullOrWhiteSpace(props.ApproverType))
return new List<(long, string)>();
var approverType = props.ApproverType;
if (approverType == nameof(ApproverTypeEnum.Initiator))
{
var initiator = await _userRep.GetByIdAsync(initiatorId);
return initiator != null
? new List<(long, string)> { (initiator.Id, initiator.RealName ?? "") }
: new List<(long, string)>();
}
if (string.IsNullOrWhiteSpace(props.ApproverIds))
return new List<(long, string)>();
var ids = props.ApproverIds.Split(',', StringSplitOptions.RemoveEmptyEntries)
.Select(s => long.TryParse(s.Trim(), out var v) ? v : 0).Where(id => id > 0).ToList();
if (approverType == nameof(ApproverTypeEnum.SpecificUser))
{
var users = await _userRep.AsQueryable()
.Where(u => ids.Contains(u.Id)).ToListAsync();
return users.Select(u => (u.Id, u.RealName ?? "")).ToList();
}
if (approverType == nameof(ApproverTypeEnum.Role))
{
var userIds = await _userRoleRep.AsQueryable()
.Where(ur => ids.Contains(ur.RoleId))
.Select(ur => ur.UserId)
.ToListAsync();
var users = await _userRep.AsQueryable()
.Where(u => userIds.Contains(u.Id)).ToListAsync();
return users.Select(u => (u.Id, u.RealName ?? "")).ToList();
}
if (approverType == nameof(ApproverTypeEnum.Department))
{
var users = await _userRep.AsQueryable()
.Where(u => ids.Contains(u.OrgId)).ToListAsync();
return users.Select(u => (u.Id, u.RealName ?? "")).ToList();
}
return new List<(long, string)>();
}
///
/// 评估排他网关 — 依次尝试各非默认分支的条件表达式,首个匹配的获胜;
/// 全不匹配则走默认分支;无默认则走第一条出边
/// 支持简单比较表达式:variable op value(op: ==,!=,>,>=,<,<=)
///
private string EvaluateGateway(List? conditions, ApprovalFlowItem flowData, string gatewayNodeId, Dictionary? bizData)
{
if (conditions != null && conditions.Count > 0 && bizData != null && bizData.Count > 0)
{
foreach (var cond in conditions.Where(c => !c.IsDefault))
{
if (!string.IsNullOrWhiteSpace(cond.Expression) && EvalSimpleExpression(cond.Expression, bizData))
return cond.TargetNodeId;
}
var defaultBranch = conditions.FirstOrDefault(c => c.IsDefault);
if (defaultBranch != null)
return defaultBranch.TargetNodeId;
}
else if (conditions != null && conditions.Count > 0)
{
var defaultBranch = conditions.FirstOrDefault(c => c.IsDefault);
if (defaultBranch != null) return defaultBranch.TargetNodeId;
return conditions.First().TargetNodeId;
}
var edge = flowData.Edges.FirstOrDefault(e => e.SourceNodeId == gatewayNodeId);
return edge?.TargetNodeId ?? throw Oops.Oh("排他网关没有出边");
}
///
/// 简单表达式求值:支持 "field op value" 格式(如 "urgent == 1", "customLevel >= 3", "amount > 10000")
/// 多条件用 && 连接
///
private static bool EvalSimpleExpression(string expression, Dictionary bizData)
{
var parts = expression.Split("&&", StringSplitOptions.TrimEntries);
foreach (var part in parts)
{
if (!EvalSingleComparison(part.Trim(), bizData))
return false;
}
return true;
}
private static bool EvalSingleComparison(string expr, Dictionary bizData)
{
string[] ops = { ">=", "<=", "!=", "==", ">", "<" };
foreach (var op in ops)
{
var idx = expr.IndexOf(op, StringComparison.Ordinal);
if (idx < 0) continue;
var fieldName = expr[..idx].Trim();
var valueStr = expr[(idx + op.Length)..].Trim().Trim('"', '\'');
if (!bizData.TryGetValue(fieldName, out var fieldValue))
return false;
if (decimal.TryParse(fieldValue?.ToString(), out var numLeft) && decimal.TryParse(valueStr, out var numRight))
{
return op switch
{
"==" => numLeft == numRight,
"!=" => numLeft != numRight,
">" => numLeft > numRight,
">=" => numLeft >= numRight,
"<" => numLeft < numRight,
"<=" => numLeft <= numRight,
_ => false,
};
}
var strLeft = fieldValue?.ToString() ?? "";
return op switch
{
"==" => strLeft.Equals(valueStr, StringComparison.OrdinalIgnoreCase),
"!=" => !strLeft.Equals(valueStr, StringComparison.OrdinalIgnoreCase),
_ => false,
};
}
return false;
}
private async Task?> GetBizData(string bizType, long bizId)
{
var handlers = App.GetServices();
var handler = handlers?.FirstOrDefault(h => h.BizType == bizType);
if (handler == null) return null;
return await handler.GetBizData(bizId);
}
private string? FindNextNodeId(ApprovalFlowItem flowData, string currentNodeId)
{
var edge = flowData.Edges.FirstOrDefault(e => e.SourceNodeId == currentNodeId);
return edge?.TargetNodeId;
}
private string? FindPrevUserTaskNodeId(ApprovalFlowItem flowData, string currentNodeId)
{
var inEdge = flowData.Edges.FirstOrDefault(e => e.TargetNodeId == currentNodeId);
if (inEdge == null) return null;
var prevNode = flowData.Nodes.FirstOrDefault(n => n.Id == inEdge.SourceNodeId);
if (prevNode == null) return null;
if (prevNode.Type is "bpmn:userTask" or "user-node" or "task-node")
return prevNode.Id;
// 递归跳过网关等非用户任务节点
return FindPrevUserTaskNodeId(flowData, prevNode.Id);
}
private async Task IsNodeCompleted(ApprovalFlowInstance instance, string nodeId)
{
var flowData = DeserializeFlowJson(instance.FlowJsonSnapshot);
var node = flowData.Nodes.FirstOrDefault(n => n.Id == nodeId);
var mode = node?.Properties?.MultiApproveMode;
if (mode == nameof(MultiApproveModeEnum.All))
{
var pendingCount = await _taskRep.AsQueryable()
.Where(t => t.InstanceId == instance.Id && t.NodeId == nodeId && t.Status == FlowTaskStatusEnum.Pending)
.CountAsync();
return pendingCount == 0;
}
// 默认或签(Any):一人通过即完成,取消其他 Pending
await CancelPendingTasks(instance.Id, nodeId);
return true;
}
private async Task CancelPendingTasks(long instanceId, string nodeId, long? excludeTaskId = null)
{
var tasks = await _taskRep.AsQueryable()
.Where(t => t.InstanceId == instanceId && t.NodeId == nodeId && t.Status == FlowTaskStatusEnum.Pending)
.WhereIF(excludeTaskId.HasValue, t => t.Id != excludeTaskId!.Value)
.ToListAsync();
foreach (var t in tasks)
{
t.Status = FlowTaskStatusEnum.Cancelled;
t.ActionTime = DateTime.Now;
}
if (tasks.Count > 0)
await _taskRep.AsUpdateable(tasks).ExecuteCommandAsync();
}
private async Task GetPendingTask(long taskId)
{
var task = await _taskRep.GetByIdAsync(taskId)
?? throw Oops.Oh("审批任务不存在");
if (task.Status != FlowTaskStatusEnum.Pending)
throw Oops.Oh("该任务已处理");
if (task.AssigneeId != _userManager.UserId)
throw Oops.Oh("当前用户不是该任务的审批人");
return task;
}
private async Task WriteLog(long instanceId, long? taskId, string? nodeId, FlowLogActionEnum action, string? comment)
{
await _logRep.InsertAsync(new ApprovalFlowLog
{
InstanceId = instanceId,
TaskId = taskId,
NodeId = nodeId,
Action = action,
OperatorId = _userManager.UserId,
OperatorName = _userManager.RealName,
Comment = comment,
});
}
private static ApprovalFlowItem DeserializeFlowJson(string? json)
{
if (string.IsNullOrWhiteSpace(json))
throw Oops.Oh("FlowJson 快照为空");
return JsonSerializer.Deserialize(json)
?? throw Oops.Oh("FlowJson 反序列化失败");
}
private async Task InvokeHandler(string bizType, Func action)
{
var handlers = App.GetServices();
var handler = handlers?.FirstOrDefault(h => h.BizType == bizType);
if (handler != null)
await action(handler);
}
}