S8TaskFlowService.cs 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500
  1. using Admin.NET.Plugin.AiDOP.Entity.S0.Warehouse;
  2. using Admin.NET.Plugin.AiDOP.Entity.S8;
  3. using Admin.NET.Plugin.AiDOP.Infrastructure.S8;
  4. using Admin.NET.Plugin.ApprovalFlow;
  5. using Admin.NET.Plugin.ApprovalFlow.Service;
  6. using Microsoft.Extensions.Logging;
  7. namespace Admin.NET.Plugin.AiDOP.Service.S8;
  8. public class S8TaskFlowService : ITransient
  9. {
  10. private readonly SqlSugarRepository<AdoS8Exception> _rep;
  11. private readonly SqlSugarRepository<AdoS8ExceptionTimeline> _timelineRep;
  12. private readonly SqlSugarRepository<AdoS0EmployeeMaster> _employeeRep;
  13. private readonly SqlSugarRepository<ApprovalFlowInstance> _flowInstanceRep;
  14. private readonly SqlSugarRepository<ApprovalFlowTask> _flowTaskRep;
  15. private readonly FlowEngineService _flowEngine;
  16. private readonly UserManager _userManager;
  17. private readonly ILogger<S8TaskFlowService> _logger;
  18. public S8TaskFlowService(
  19. SqlSugarRepository<AdoS8Exception> rep,
  20. SqlSugarRepository<AdoS8ExceptionTimeline> timelineRep,
  21. SqlSugarRepository<AdoS0EmployeeMaster> employeeRep,
  22. SqlSugarRepository<ApprovalFlowInstance> flowInstanceRep,
  23. SqlSugarRepository<ApprovalFlowTask> flowTaskRep,
  24. FlowEngineService flowEngine,
  25. UserManager userManager,
  26. ILogger<S8TaskFlowService> logger)
  27. {
  28. _rep = rep;
  29. _timelineRep = timelineRep;
  30. _employeeRep = employeeRep;
  31. _flowInstanceRep = flowInstanceRep;
  32. _flowTaskRep = flowTaskRep;
  33. _flowEngine = flowEngine;
  34. _userManager = userManager;
  35. _logger = logger;
  36. }
  37. public async Task<AdoS8Exception> ClaimAsync(long id, long tenantId, long factoryId, long assigneeId, string? remark)
  38. {
  39. if (assigneeId <= 0) throw new S8BizException("认领需指定处理人 AssigneeId");
  40. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  41. if (!S8StatusRules.IsAllowedTransition(e.Status, "ASSIGNED"))
  42. throw new S8BizException($"状态 {e.Status} 不可认领");
  43. var fromStatus = e.Status;
  44. e.Status = "ASSIGNED";
  45. e.AssigneeId = assigneeId;
  46. e.AssignedAt = DateTime.Now;
  47. e.UpdatedAt = DateTime.Now;
  48. await _rep.AsTenant().UseTranAsync(async () =>
  49. {
  50. await _rep.UpdateAsync(e);
  51. await InsertTimelineAsync(e.Id, "CLAIM", "认领", fromStatus, "ASSIGNED", assigneeId, null, remark);
  52. }, ex => throw ex);
  53. // 注:认领仅承接异常,不视为审批流完成。审批流的"通过"在"开始处理"那一步触发。
  54. return e;
  55. }
  56. public async Task<AdoS8Exception> TransferAsync(long id, long tenantId, long factoryId, long newAssigneeId, string? remark)
  57. {
  58. var allowedStatuses = new HashSet<string> { "ASSIGNED", "IN_PROGRESS" };
  59. if (newAssigneeId <= 0) throw new S8BizException("转派目标无效");
  60. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  61. if (e.ActiveFlowInstanceId.HasValue)
  62. throw new S8BizException("审批进行中不可转派");
  63. if (e.Status == "ESCALATED")
  64. throw new S8BizException("升级审批中不可转派");
  65. if (S8StatusRules.IsTerminal(e.Status))
  66. throw new S8BizException("已关闭不可转派");
  67. if (!allowedStatuses.Contains(e.Status))
  68. throw new S8BizException($"状态 {e.Status} 不可转派");
  69. e.AssigneeId = newAssigneeId;
  70. e.UpdatedAt = DateTime.Now;
  71. await _rep.AsTenant().UseTranAsync(async () =>
  72. {
  73. await _rep.UpdateAsync(e);
  74. await InsertTimelineAsync(e.Id, "TRANSFER", "转派", e.Status, e.Status, newAssigneeId, null, remark);
  75. }, ex => throw ex);
  76. // 双线合一:S8 转派 = TB001 任务转办给新处理人。
  77. await TryTransferIntakeOnTransferAsync(e.Id, newAssigneeId, remark);
  78. return e;
  79. }
  80. private async Task TryTransferIntakeOnTransferAsync(long exceptionId, long newAssigneeRecId, string? remark)
  81. {
  82. try
  83. {
  84. var instance = await _flowInstanceRep.AsQueryable()
  85. .Where(x => x.BizType == "EXCEPTION_REPORT"
  86. && x.BizId == exceptionId
  87. && x.Status == FlowInstanceStatusEnum.Running)
  88. .FirstAsync();
  89. if (instance == null) return;
  90. var currentUserId = _userManager.UserId;
  91. var task = await _flowTaskRep.AsQueryable()
  92. .Where(x => x.InstanceId == instance.Id
  93. && x.AssigneeId == currentUserId
  94. && x.Status == FlowTaskStatusEnum.Pending)
  95. .FirstAsync();
  96. if (task == null) return;
  97. // newAssigneeRecId 是 EmployeeMaster.RecID;FlowEngine.Transfer 要 SysUser.UserId。
  98. var targetSysUserId = await _employeeRep.AsQueryable().ClearFilter()
  99. .Where(x => x.Id == newAssigneeRecId && x.SysUserId != null)
  100. .Select(x => x.SysUserId)
  101. .FirstAsync();
  102. if (targetSysUserId == null || targetSysUserId == 0)
  103. {
  104. _logger.LogWarning(
  105. "S8 转派联动审批流跳过:员工 {RecId} 未绑定 SysUser,TB001 任务保留原 assignee",
  106. newAssigneeRecId);
  107. return;
  108. }
  109. await _flowEngine.Transfer(task.Id, targetSysUserId.Value, remark ?? "S8 转派(双线合一自动转办)");
  110. }
  111. catch (Exception ex)
  112. {
  113. _logger.LogWarning(ex,
  114. "S8 转派时自动转办 TB001 任务失败 exceptionId={Id} newAssigneeRecId={AssigneeId}",
  115. exceptionId, newAssigneeRecId);
  116. }
  117. }
  118. public async Task<AdoS8Exception> StartProgressAsync(long id, long tenantId, long factoryId, string? remark)
  119. {
  120. var currentUserId = GetCurrentUserId();
  121. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  122. if (!S8StatusRules.IsAllowedTransition(e.Status, "IN_PROGRESS"))
  123. throw new S8BizException($"状态 {e.Status} 不可开始处理");
  124. var fromStatus = e.Status;
  125. e.Status = "IN_PROGRESS";
  126. e.UpdatedAt = DateTime.Now;
  127. await _rep.AsTenant().UseTranAsync(async () =>
  128. {
  129. await _rep.UpdateAsync(e);
  130. await InsertTimelineAsync(e.Id, "START_PROGRESS", "开始处理", fromStatus, "IN_PROGRESS", currentUserId, null, remark);
  131. }, ex => throw ex);
  132. // 双线合一:开始处理 = TB001 异常提报审批通过。
  133. // 当前用户必须是 TB001 task 的 AssigneeId,FlowEngine 强校验。
  134. await TryApproveIntakeOnStartProgressAsync(e.Id, currentUserId);
  135. return e;
  136. }
  137. private async Task TryApproveIntakeOnStartProgressAsync(long exceptionId, long currentUserId)
  138. {
  139. try
  140. {
  141. var instance = await _flowInstanceRep.AsQueryable()
  142. .Where(x => x.BizType == "EXCEPTION_REPORT"
  143. && x.BizId == exceptionId
  144. && x.Status == FlowInstanceStatusEnum.Running)
  145. .FirstAsync();
  146. if (instance == null) return;
  147. var task = await _flowTaskRep.AsQueryable()
  148. .Where(x => x.InstanceId == instance.Id
  149. && x.AssigneeId == currentUserId
  150. && x.Status == FlowTaskStatusEnum.Pending)
  151. .FirstAsync();
  152. if (task == null) return;
  153. await _flowEngine.Approve(task.Id, "S8 已开始处理(双线合一自动同意)");
  154. }
  155. catch (Exception ex)
  156. {
  157. _logger.LogWarning(ex,
  158. "S8 开始处理时自动同意 TB001 任务失败 exceptionId={Id} userId={UserId}",
  159. exceptionId, currentUserId);
  160. }
  161. }
  162. public async Task<AdoS8Exception> UpgradeAsync(long id, long tenantId, long factoryId, string? remark)
  163. {
  164. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  165. if (e.ActiveFlowInstanceId.HasValue)
  166. throw new S8BizException("该异常已有进行中的审批流程,请等待审批完成");
  167. if (!S8StatusRules.IsAllowedTransition(e.Status, "ESCALATED"))
  168. throw new S8BizException($"状态 {e.Status} 不可升级");
  169. await _flowEngine.StartFlow(new StartFlowInput
  170. {
  171. BizType = "EXCEPTION_ESCALATION",
  172. BizId = e.Id,
  173. Title = $"异常升级审批 - {e.ExceptionCode}",
  174. Comment = remark,
  175. BizData = new Dictionary<string, object>
  176. {
  177. ["severity"] = e.Severity,
  178. ["sceneCode"] = e.SceneCode,
  179. ["priorityLevel"] = e.PriorityLevel,
  180. }
  181. });
  182. // 状态和时间线由 ExceptionEscalationBizHandler.OnFlowStarted 回调更新
  183. return await LoadAsync(id, tenantId, factoryId) ?? e;
  184. }
  185. public async Task<AdoS8Exception> RejectAsync(long id, long tenantId, long factoryId, string? remark)
  186. {
  187. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  188. if (!S8StatusRules.IsAllowedTransition(e.Status, "REJECTED"))
  189. throw new S8BizException($"状态 {e.Status} 不可驳回");
  190. var from = e.Status;
  191. e.Status = "REJECTED";
  192. e.UpdatedAt = DateTime.Now;
  193. await _rep.AsTenant().UseTranAsync(async () =>
  194. {
  195. await _rep.UpdateAsync(e);
  196. await InsertTimelineAsync(e.Id, "REJECT", "驳回", from, "REJECTED", null, null, remark);
  197. }, ex => throw ex);
  198. // 双线合一:S8 驳回 = TB001 流程整体拒绝(取消所有 pending 任务、Instance 终止)。
  199. await TryRejectIntakeOnRejectAsync(e.Id, remark);
  200. return e;
  201. }
  202. private async Task TryRejectIntakeOnRejectAsync(long exceptionId, string? remark)
  203. {
  204. try
  205. {
  206. var instance = await _flowInstanceRep.AsQueryable()
  207. .Where(x => x.BizType == "EXCEPTION_REPORT"
  208. && x.BizId == exceptionId
  209. && x.Status == FlowInstanceStatusEnum.Running)
  210. .FirstAsync();
  211. if (instance == null) return;
  212. var currentUserId = _userManager.UserId;
  213. var task = await _flowTaskRep.AsQueryable()
  214. .Where(x => x.InstanceId == instance.Id
  215. && x.AssigneeId == currentUserId
  216. && x.Status == FlowTaskStatusEnum.Pending)
  217. .FirstAsync();
  218. if (task == null) return;
  219. await _flowEngine.Reject(task.Id, remark ?? "S8 已驳回(双线合一自动拒绝)");
  220. }
  221. catch (Exception ex)
  222. {
  223. _logger.LogWarning(ex,
  224. "S8 驳回时自动拒绝 TB001 流程失败 exceptionId={Id}",
  225. exceptionId);
  226. }
  227. }
  228. public async Task<AdoS8Exception> SubmitVerificationAsync(
  229. long id, long tenantId, long factoryId,
  230. long verifierId, string? remark)
  231. {
  232. var currentUserId = GetCurrentUserId();
  233. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  234. await EnsureCurrentUserIsOperatorAsync(e.AssigneeId, currentUserId,
  235. "只有当前处理人才能提交复检(或当前账号未绑定员工主数据)");
  236. if (verifierId <= 0)
  237. throw new S8BizException("请选择检验人");
  238. if (!S8StatusRules.IsAllowedTransition(e.Status, "PENDING_VERIFICATION"))
  239. throw new S8BizException($"状态 {e.Status} 不可提交复检");
  240. var from = e.Status;
  241. e.Status = "PENDING_VERIFICATION";
  242. e.VerifierId = verifierId;
  243. e.VerificationAssignedAt = DateTime.Now;
  244. e.UpdatedAt = DateTime.Now;
  245. await _rep.AsTenant().UseTranAsync(async () =>
  246. {
  247. await _rep.UpdateAsync(e);
  248. await InsertTimelineAsync(e.Id, "VERIFY_SUBMITTED", "提交复检", from, "PENDING_VERIFICATION",
  249. currentUserId, null, remark);
  250. }, ex => throw ex);
  251. // 双线合一:提交复检 = 启动 EXCEPTION_CLOSURE 流程,指派检验人。
  252. // 该流程定义复用,作为复检/关闭确认通用审批载体;handler 只做 ActiveFlowInstanceId 维护。
  253. await TryStartVerificationFlowAsync(e, verifierId, remark);
  254. return await LoadAsync(id, tenantId, factoryId) ?? e;
  255. }
  256. private async Task TryStartVerificationFlowAsync(AdoS8Exception e, long verifierRecId, string? remark)
  257. {
  258. try
  259. {
  260. await _flowEngine.StartFlow(new StartFlowInput
  261. {
  262. BizType = "EXCEPTION_CLOSURE",
  263. BizId = e.Id,
  264. BizNo = e.ExceptionCode,
  265. Title = $"异常复检 - {e.ExceptionCode}",
  266. Comment = remark,
  267. BizData = new Dictionary<string, object>
  268. {
  269. ["sceneCode"] = e.SceneCode ?? string.Empty,
  270. ["verifierRecId"] = verifierRecId,
  271. }
  272. });
  273. }
  274. catch (Exception ex)
  275. {
  276. _logger.LogWarning(ex,
  277. "S8 提交复检时启动 EXCEPTION_CLOSURE 流程失败 exceptionId={Id} verifierRecId={VerifierId}",
  278. e.Id, verifierRecId);
  279. }
  280. }
  281. public async Task<AdoS8Exception> ApproveVerificationAsync(
  282. long id, long tenantId, long factoryId,
  283. string? remark)
  284. {
  285. var currentUserId = GetCurrentUserId();
  286. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  287. await EnsureCurrentUserIsOperatorAsync(e.VerifierId, currentUserId,
  288. "只有指定检验人才能检验通过(或当前账号未绑定员工主数据)");
  289. if (!S8StatusRules.IsAllowedTransition(e.Status, "CLOSED"))
  290. throw new S8BizException($"状态 {e.Status} 不可检验通过");
  291. var from = e.Status;
  292. e.Status = "CLOSED";
  293. e.VerifiedAt = DateTime.Now;
  294. e.VerificationResult = "APPROVED";
  295. e.VerificationRemark = remark;
  296. e.ClosedAt = DateTime.Now;
  297. e.UpdatedAt = DateTime.Now;
  298. await _rep.AsTenant().UseTranAsync(async () =>
  299. {
  300. await _rep.UpdateAsync(e);
  301. await InsertTimelineAsync(e.Id, "VERIFY_APPROVED", "检验通过", from, "CLOSED",
  302. currentUserId, null, remark);
  303. }, ex => throw ex);
  304. // 双线合一:检验通过 = EXCEPTION_CLOSURE 复检流程审批通过。
  305. await TryApproveVerificationFlowAsync(e.Id, currentUserId);
  306. return e;
  307. }
  308. private async Task TryApproveVerificationFlowAsync(long exceptionId, long currentUserId)
  309. {
  310. try
  311. {
  312. var instance = await _flowInstanceRep.AsQueryable()
  313. .Where(x => x.BizType == "EXCEPTION_CLOSURE"
  314. && x.BizId == exceptionId
  315. && x.Status == FlowInstanceStatusEnum.Running)
  316. .FirstAsync();
  317. if (instance == null) return;
  318. var task = await _flowTaskRep.AsQueryable()
  319. .Where(x => x.InstanceId == instance.Id
  320. && x.AssigneeId == currentUserId
  321. && x.Status == FlowTaskStatusEnum.Pending)
  322. .FirstAsync();
  323. if (task == null) return;
  324. await _flowEngine.Approve(task.Id, "S8 检验通过(双线合一自动同意)");
  325. }
  326. catch (Exception ex)
  327. {
  328. _logger.LogWarning(ex,
  329. "S8 检验通过时自动同意 EXCEPTION_CLOSURE 流程失败 exceptionId={Id} userId={UserId}",
  330. exceptionId, currentUserId);
  331. }
  332. }
  333. public async Task<AdoS8Exception> RejectVerificationAsync(
  334. long id, long tenantId, long factoryId,
  335. string remark)
  336. {
  337. var currentUserId = GetCurrentUserId();
  338. var e = await LoadAsync(id, tenantId, factoryId) ?? throw new S8BizException("异常不存在");
  339. await EnsureCurrentUserIsOperatorAsync(e.VerifierId, currentUserId,
  340. "只有指定检验人才能检验退回(或当前账号未绑定员工主数据)");
  341. if (!S8StatusRules.IsAllowedTransition(e.Status, "IN_PROGRESS"))
  342. throw new S8BizException($"状态 {e.Status} 不可检验退回");
  343. if (string.IsNullOrWhiteSpace(remark))
  344. throw new S8BizException("检验退回必须填写退回原因");
  345. var from = e.Status;
  346. e.Status = "IN_PROGRESS";
  347. e.VerifiedAt = DateTime.Now;
  348. e.VerificationResult = "REJECTED";
  349. e.VerificationRemark = remark;
  350. e.UpdatedAt = DateTime.Now;
  351. await _rep.AsTenant().UseTranAsync(async () =>
  352. {
  353. await _rep.UpdateAsync(e);
  354. await InsertTimelineAsync(e.Id, "VERIFY_REJECTED", "检验退回", from, "IN_PROGRESS",
  355. currentUserId, null, remark);
  356. }, ex => throw ex);
  357. // 双线合一:检验退回 = EXCEPTION_CLOSURE 复检流程整体拒绝。
  358. await TryRejectVerificationFlowAsync(e.Id, currentUserId, remark);
  359. return e;
  360. }
  361. private async Task TryRejectVerificationFlowAsync(long exceptionId, long currentUserId, string? remark)
  362. {
  363. try
  364. {
  365. var instance = await _flowInstanceRep.AsQueryable()
  366. .Where(x => x.BizType == "EXCEPTION_CLOSURE"
  367. && x.BizId == exceptionId
  368. && x.Status == FlowInstanceStatusEnum.Running)
  369. .FirstAsync();
  370. if (instance == null) return;
  371. var task = await _flowTaskRep.AsQueryable()
  372. .Where(x => x.InstanceId == instance.Id
  373. && x.AssigneeId == currentUserId
  374. && x.Status == FlowTaskStatusEnum.Pending)
  375. .FirstAsync();
  376. if (task == null) return;
  377. await _flowEngine.Reject(task.Id, remark ?? "S8 检验退回(双线合一自动拒绝)");
  378. }
  379. catch (Exception ex)
  380. {
  381. _logger.LogWarning(ex,
  382. "S8 检验退回时自动拒绝 EXCEPTION_CLOSURE 流程失败 exceptionId={Id} userId={UserId}",
  383. exceptionId, currentUserId);
  384. }
  385. }
  386. public async Task CommentAsync(long id, string? remark)
  387. {
  388. var e = await _rep.GetFirstAsync(x => x.Id == id && !x.IsDeleted)
  389. ?? throw new S8BizException("异常不存在");
  390. await InsertTimelineAsync(e.Id, "COMMENT", "补充说明", e.Status, e.Status, null, null, remark);
  391. }
  392. private Task<AdoS8Exception?> LoadAsync(long id, long tenantId, long factoryId) =>
  393. _rep.GetFirstAsync(x => x.Id == id && x.TenantId == tenantId && x.FactoryId == factoryId && !x.IsDeleted);
  394. // 统一复用框架登录上下文,避免业务身份继续信任前端传参。
  395. private long GetCurrentUserId()
  396. {
  397. var currentUserId = _userManager.UserId;
  398. if (currentUserId <= 0)
  399. throw new S8BizException("未获取到当前登录用户");
  400. return currentUserId;
  401. }
  402. // 把异常上的处理人/检验人(employeeId) 经 EmployeeMaster.SysUserId 解析到系统账号 ID。
  403. // EmployeeMaster.tenant_id 与 SysUser.TenantId 历史错位,必须 ClearFilter 跳过多租户全局 filter;
  404. // 通过 employee.Id 主键精确查询作为安全边界,无跨租户泄漏风险。
  405. private async Task<long?> GetEmployeeSysUserIdAsync(long? employeeId)
  406. {
  407. if (!employeeId.HasValue || employeeId.Value <= 0) return null;
  408. var emp = await _employeeRep.AsQueryable().ClearFilter()
  409. .Where(x => x.Id == employeeId.Value)
  410. .FirstAsync();
  411. return emp?.SysUserId;
  412. }
  413. // 鉴权统一入口:要求当前登录用户必须是 employeeId 解析后的 SysUserId。
  414. private async Task EnsureCurrentUserIsOperatorAsync(long? employeeId, long currentUserId, string failMessage)
  415. {
  416. var ownerSysUserId = await GetEmployeeSysUserIdAsync(employeeId);
  417. if (ownerSysUserId != currentUserId)
  418. throw new S8BizException(failMessage);
  419. }
  420. private async Task InsertTimelineAsync(long exceptionId, string code, string label, string? from, string? to,
  421. long? operatorId, string? operatorName, string? remark) =>
  422. await _timelineRep.InsertAsync(new AdoS8ExceptionTimeline
  423. {
  424. ExceptionId = exceptionId,
  425. ActionCode = code,
  426. ActionLabel = label,
  427. FromStatus = from,
  428. ToStatus = to,
  429. OperatorId = operatorId,
  430. OperatorName = operatorName,
  431. ActionRemark = remark,
  432. CreatedAt = DateTime.Now
  433. });
  434. }