S8ManualReportService.cs 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372
  1. using Admin.NET.Plugin.AiDOP.Dto.S8;
  2. using Admin.NET.Plugin.AiDOP.Entity.S0.Manufacturing;
  3. using Admin.NET.Plugin.AiDOP.Entity.S0.Warehouse;
  4. using Admin.NET.Plugin.AiDOP.Entity.S8;
  5. using Admin.NET.Plugin.AiDOP.Infrastructure.S8;
  6. using Admin.NET.Plugin.AiDOP.Service.S8.Rules;
  7. using Admin.NET.Plugin.ApprovalFlow.Service;
  8. using Microsoft.Extensions.Logging;
  9. namespace Admin.NET.Plugin.AiDOP.Service.S8;
  10. public class S8ManualReportService : ITransient
  11. {
  12. // 合法严重度白名单(与 GetFormOptionsAsync.severities 同源);前端/后端默认值 MEDIUM。
  13. private static readonly HashSet<string> AllowedSeverities = new(StringComparer.Ordinal)
  14. {
  15. "CRITICAL", "HIGH", "MEDIUM", "LOW"
  16. };
  17. private readonly SqlSugarRepository<AdoS8Exception> _rep;
  18. private readonly SqlSugarRepository<AdoS8ExceptionTimeline> _timelineRep;
  19. private readonly SqlSugarRepository<AdoS8Evidence> _evidenceRep;
  20. private readonly SqlSugarRepository<AdoS8SceneConfig> _sceneRep;
  21. private readonly SqlSugarRepository<AdoS0DepartmentMaster> _deptRep;
  22. private readonly SqlSugarRepository<AdoS0LineMaster> _lineRep;
  23. private readonly SqlSugarRepository<AdoS8ExceptionType> _typeRep;
  24. private readonly UserManager _userManager;
  25. private readonly FlowEngineService _flowEngine;
  26. private readonly ILogger<S8ManualReportService> _logger;
  27. public S8ManualReportService(
  28. SqlSugarRepository<AdoS8Exception> rep,
  29. SqlSugarRepository<AdoS8ExceptionTimeline> timelineRep,
  30. SqlSugarRepository<AdoS8Evidence> evidenceRep,
  31. SqlSugarRepository<AdoS8SceneConfig> sceneRep,
  32. SqlSugarRepository<AdoS0DepartmentMaster> deptRep,
  33. SqlSugarRepository<AdoS0LineMaster> lineRep,
  34. SqlSugarRepository<AdoS8ExceptionType> typeRep,
  35. UserManager userManager,
  36. FlowEngineService flowEngine,
  37. ILogger<S8ManualReportService> logger)
  38. {
  39. _rep = rep;
  40. _timelineRep = timelineRep;
  41. _evidenceRep = evidenceRep;
  42. _sceneRep = sceneRep;
  43. _deptRep = deptRep;
  44. _lineRep = lineRep;
  45. _typeRep = typeRep;
  46. _userManager = userManager;
  47. _flowEngine = flowEngine;
  48. _logger = logger;
  49. }
  50. /// <summary>
  51. /// 主动提报推断 ExceptionTypeCode:场景下取启用且 SortNo 最小的一条。
  52. /// baseline 异常类型当前 tenant_id=0/factory_id=0(全局基线),所以匹配条件为
  53. /// (tenantId 命中 OR 0) AND (factoryId 命中 OR 0)。ClearFilter 兜底全局多租户过滤器。
  54. /// 找不到返回 null(保持兼容)。
  55. /// </summary>
  56. private async Task<string?> InferExceptionTypeCodeAsync(long tenantId, long factoryId, string sceneCode)
  57. {
  58. if (string.IsNullOrWhiteSpace(sceneCode)) return null;
  59. return await _typeRep.AsQueryable().ClearFilter()
  60. .Where(x => (x.TenantId == tenantId || x.TenantId == 0)
  61. && (x.FactoryId == factoryId || x.FactoryId == 0)
  62. && x.SceneCode == sceneCode && x.Enabled)
  63. .OrderBy(x => x.SortNo)
  64. .Select(x => x.TypeCode)
  65. .FirstAsync();
  66. }
  67. /// <summary>
  68. /// TB001 异常提报审批流:自动监控 + 主动提报后软触发,失败仅 warn 日志,不阻断建单。
  69. /// </summary>
  70. private async Task TryStartIntakeFlowAsync(AdoS8Exception entity)
  71. {
  72. try
  73. {
  74. await _flowEngine.StartFlow(new StartFlowInput
  75. {
  76. BizType = "EXCEPTION_REPORT",
  77. BizId = entity.Id,
  78. Title = $"异常提报 - {entity.ExceptionCode}",
  79. Comment = entity.SourceType == "AUTO_WATCH" ? "自动监控触发" : "主动提报触发",
  80. BizData = new Dictionary<string, object>
  81. {
  82. ["sceneCode"] = entity.SceneCode ?? "",
  83. ["exceptionTypeCode"] = entity.ExceptionTypeCode ?? "",
  84. ["sourceType"] = entity.SourceType ?? ""
  85. }
  86. });
  87. }
  88. catch (Exception ex)
  89. {
  90. _logger.LogWarning(ex, "TB001 异常提报审批流触发失败 ExceptionId={Id} ExceptionCode={Code}", entity.Id, entity.ExceptionCode);
  91. }
  92. }
  93. public async Task<object> GetFormOptionsAsync(long tenantId, long factoryId)
  94. {
  95. var scenes = await _sceneRep.AsQueryable()
  96. .Where(x => x.TenantId == tenantId && x.FactoryId == factoryId && x.Enabled)
  97. .OrderBy(x => x.SortNo)
  98. .Select(x => new { value = x.SceneCode, label = x.SceneName })
  99. .ToListAsync();
  100. // ClearFilter:DepartmentMaster.tenant_id 属 S0 域租户,不与登录 token TenantId 一致;
  101. // 用 factory_ref_id 做硬边界,安全等价。同 BUG-S8-EMPLOYEES-TENANT-FILTER 协议。
  102. var departments = await _deptRep.AsQueryable().ClearFilter()
  103. .Where(x => x.FactoryRefId == factoryId)
  104. .OrderBy(x => x.Department)
  105. .Take(500)
  106. .Select(x => new { value = x.Id, label = x.Descr ?? x.Department })
  107. .ToListAsync();
  108. var lines = await _lineRep.AsQueryable().ClearFilter()
  109. .Where(x => x.FactoryRefId == factoryId)
  110. .OrderBy(x => x.Line)
  111. .Take(500)
  112. .Select(x => new { value = x.Id, label = x.Describe ?? x.Line })
  113. .ToListAsync();
  114. return new
  115. {
  116. scenes,
  117. severities = new[]
  118. {
  119. new { value = "CRITICAL", label = "紧急" },
  120. new { value = "HIGH", label = "高" },
  121. new { value = "MEDIUM", label = "中" },
  122. new { value = "LOW", label = "低" }
  123. },
  124. departments,
  125. lines,
  126. materials = Array.Empty<object>()
  127. };
  128. }
  129. public async Task<AdoS8ManualReportResultDto> CreateAsync(AdoS8ManualReportCreateDto dto)
  130. {
  131. if (string.IsNullOrWhiteSpace(dto.Title)) throw new S8BizException("标题必填");
  132. if (string.IsNullOrWhiteSpace(dto.SceneCode)) throw new S8BizException("场景必填");
  133. // 严重度白名单校验:空值兜底为 MEDIUM;非法值直接拒绝,避免 P3 等错位写入。
  134. var severity = string.IsNullOrWhiteSpace(dto.Severity) ? "MEDIUM" : dto.Severity.Trim();
  135. if (!AllowedSeverities.Contains(severity))
  136. throw new S8BizException($"严重度 {severity} 非法,仅允许 CRITICAL/HIGH/MEDIUM/LOW");
  137. // 提报人以服务端登录上下文为准,忽略前端传入;未登录上下文落 null。
  138. var currentUserId = _userManager.UserId > 0 ? _userManager.UserId : (long?)null;
  139. // 主动提报无前端 type 字段,按场景兜底推断;保证不进"未分类"桶。
  140. var inferredType = await InferExceptionTypeCodeAsync(dto.TenantId, dto.FactoryId, dto.SceneCode.Trim());
  141. var code = $"EX-{DateTime.Now:yyyyMMdd}-{Guid.NewGuid().ToString("N")[..8].ToUpperInvariant()}";
  142. var entity = new AdoS8Exception
  143. {
  144. TenantId = dto.TenantId,
  145. FactoryId = dto.FactoryId,
  146. ExceptionCode = code,
  147. Title = dto.Title.Trim(),
  148. Description = dto.Description,
  149. SceneCode = dto.SceneCode.Trim(),
  150. SourceType = "MANUAL",
  151. Status = "NEW",
  152. Severity = severity,
  153. PriorityScore = 0,
  154. PriorityLevel = "P3",
  155. OccurrenceDeptId = dto.OccurrenceDeptId,
  156. ResponsibleDeptId = dto.ResponsibleDeptId,
  157. ReporterId = currentUserId,
  158. ExceptionTypeCode = inferredType,
  159. CreatedAt = DateTime.Now,
  160. IsDeleted = false
  161. };
  162. await _rep.AsTenant().UseTranAsync(async () =>
  163. {
  164. entity = await _rep.AsInsertable(entity).ExecuteReturnEntityAsync();
  165. await _timelineRep.InsertAsync(new AdoS8ExceptionTimeline
  166. {
  167. ExceptionId = entity.Id,
  168. ActionCode = "CREATE",
  169. ActionLabel = "创建",
  170. FromStatus = null,
  171. ToStatus = "NEW",
  172. OperatorId = currentUserId,
  173. ActionRemark = "主动提报",
  174. CreatedAt = DateTime.Now
  175. });
  176. }, ex => throw ex);
  177. await TryStartIntakeFlowAsync(entity);
  178. return new AdoS8ManualReportResultDto
  179. {
  180. ExceptionId = entity.Id,
  181. ExceptionCode = entity.ExceptionCode,
  182. TaskId = entity.Id
  183. };
  184. }
  185. /// <summary>
  186. /// G01-06:自动建单分支(非第二套创建主链)。
  187. /// 这是本服务内的自动监控建单路径,与 <see cref="CreateAsync"/> 并列,
  188. /// 复用同一仓储(_rep / _timelineRep)、同一事务边界、同一 ExceptionCode 生成规则、
  189. /// 同一时间线主链(ActionCode="CREATE"、ToStatus="NEW");仅差异点:
  190. /// - SourceType 标识为自动监控来源
  191. /// - 填入 SourceRuleId / SourceDataSourceId / SourcePayload / RelatedObjectCode 追溯
  192. /// - ExceptionTypeCode 固定 EQUIP_FAULT(G-01 首版唯一映射)
  193. /// - SceneCode 固定 S2S6_PRODUCTION(G-01 首版唯一场景)
  194. /// 不做补偿、重试、对账;失败由调用方接住。
  195. /// </summary>
  196. public async Task<AdoS8Exception> CreateFromWatchAsync(S8WatchHitResult hit)
  197. {
  198. if (hit.SourceRuleId <= 0 || string.IsNullOrWhiteSpace(hit.RelatedObjectCode))
  199. throw new S8BizException("自动建单缺失追溯键");
  200. var code = $"EX-{DateTime.Now:yyyyMMdd}-{Guid.NewGuid().ToString("N")[..8].ToUpperInvariant()}";
  201. var title = $"[自动] 设备 {hit.RelatedObjectCode} {hit.TriggerCondition} {hit.ThresholdValue}(当前 {hit.CurrentValue})";
  202. var entity = new AdoS8Exception
  203. {
  204. // 租户/工厂:与 S8WatchSchedulerService.RunOnceAsync 当前固定上下文一致。
  205. TenantId = 1,
  206. FactoryId = 1,
  207. ExceptionCode = code,
  208. Title = title,
  209. Description = null,
  210. SceneCode = S8SceneCode.S2S6Production,
  211. // 首版自动监控建单来源标识(字符串值,先不抽常量类)。
  212. SourceType = "AUTO_WATCH",
  213. Status = "NEW",
  214. Severity = string.IsNullOrWhiteSpace(hit.Severity) ? "MEDIUM" : hit.Severity,
  215. PriorityScore = 0,
  216. PriorityLevel = "P3",
  217. // 首版兜底口径:Hit 未提供部门时置 0 仅为保证“能建成标准异常单并进入主链”,
  218. // 不是最终业务部门语义;后续需由上游查询结果提供,或在专项任务中补口径。
  219. OccurrenceDeptId = hit.OccurrenceDeptId ?? 0,
  220. ResponsibleDeptId = hit.ResponsibleDeptId ?? 0,
  221. ReporterId = null,
  222. CreatedAt = DateTime.Now,
  223. IsDeleted = false,
  224. // G-01 首版唯一异常类型映射(seed 已确认 EQUIP_FAULT 属 S2S6_PRODUCTION 场景)。
  225. ExceptionTypeCode = "EQUIP_FAULT",
  226. // ModuleCode:S2S6_PRODUCTION 场景对应 S2+S6 两个模块(见 S8ModuleCode.SceneOf),
  227. // 无稳定“scene → 单一 module”映射;首版置空,不靠经验写死。
  228. ModuleCode = null,
  229. ProcessNodeCode = null,
  230. // 追溯三件套(自动建单必填口径)。
  231. SourceRuleId = hit.SourceRuleId,
  232. SourceDataSourceId = hit.DataSourceId,
  233. SourcePayload = hit.SourcePayload,
  234. RelatedObjectCode = hit.RelatedObjectCode
  235. };
  236. await _rep.AsTenant().UseTranAsync(async () =>
  237. {
  238. entity = await _rep.AsInsertable(entity).ExecuteReturnEntityAsync();
  239. await _timelineRep.InsertAsync(new AdoS8ExceptionTimeline
  240. {
  241. ExceptionId = entity.Id,
  242. ActionCode = "CREATE",
  243. ActionLabel = "创建",
  244. FromStatus = null,
  245. ToStatus = "NEW",
  246. OperatorId = null,
  247. ActionRemark = "自动建单",
  248. CreatedAt = DateTime.Now
  249. });
  250. }, ex => throw ex);
  251. await TryStartIntakeFlowAsync(entity);
  252. return entity;
  253. }
  254. /// <summary>
  255. /// R2 自动建单分支(TIMEOUT 等新 evaluator 走此路径)。
  256. /// 与 <see cref="CreateFromWatchAsync"/> 并列:复用同一仓储 / 事务 / 时间线 ActionCode;
  257. /// 差异点:消费 <see cref="S8RuleHit"/> 一份命中模型,把 R2 新列(DedupKey / LastDetectedAt /
  258. /// SourceRuleCode / SourceObjectType / SourceObjectId)落齐;ExceptionTypeCode 由 hit 自带,
  259. /// 不再硬编码 EQUIP_FAULT。RecoveredAt 本轮不写。
  260. /// 调用方负责前置检查 ExceptionTypeCode 是否在 baseline;本方法不再二次校验。
  261. /// </summary>
  262. public async Task<AdoS8Exception> CreateFromHitAsync(S8RuleHit hit)
  263. {
  264. if (hit.SourceRuleId <= 0 || string.IsNullOrWhiteSpace(hit.RelatedObjectCode))
  265. throw new S8BizException("自动建单缺失追溯键");
  266. var code = $"EX-{DateTime.Now:yyyyMMdd}-{Guid.NewGuid().ToString("N")[..8].ToUpperInvariant()}";
  267. var entity = new AdoS8Exception
  268. {
  269. // 与 CreateFromWatchAsync 当前固定上下文一致;R2 不变更租户/工厂上下文语义。
  270. TenantId = 1,
  271. FactoryId = 1,
  272. ExceptionCode = code,
  273. Title = string.IsNullOrWhiteSpace(hit.Title)
  274. ? $"[自动] {hit.SourceObjectType} {hit.SourceObjectId}"
  275. : hit.Title,
  276. Description = null,
  277. SceneCode = string.IsNullOrWhiteSpace(hit.SceneCode) ? S8SceneCode.S2S6Production : hit.SceneCode,
  278. SourceType = "AUTO_WATCH",
  279. Status = "NEW",
  280. Severity = string.IsNullOrWhiteSpace(hit.Severity) ? "MEDIUM" : hit.Severity,
  281. PriorityScore = 0,
  282. PriorityLevel = "P3",
  283. OccurrenceDeptId = hit.OccurrenceDeptId ?? 0,
  284. ResponsibleDeptId = hit.ResponsibleDeptId ?? 0,
  285. ReporterId = null,
  286. CreatedAt = DateTime.Now,
  287. IsDeleted = false,
  288. ExceptionTypeCode = hit.ExceptionTypeCode,
  289. ModuleCode = null,
  290. ProcessNodeCode = null,
  291. SourceRuleId = hit.SourceRuleId,
  292. SourceDataSourceId = hit.DataSourceId == 0 ? null : hit.DataSourceId,
  293. SourcePayload = hit.SourcePayload,
  294. RelatedObjectCode = hit.RelatedObjectCode,
  295. // R2 新列回填
  296. DedupKey = hit.DedupKey,
  297. LastDetectedAt = hit.DetectedAt,
  298. RecoveredAt = null,
  299. SourceRuleCode = hit.SourceRuleCode,
  300. SourceObjectType = hit.SourceObjectType,
  301. SourceObjectId = hit.SourceObjectId
  302. };
  303. await _rep.AsTenant().UseTranAsync(async () =>
  304. {
  305. entity = await _rep.AsInsertable(entity).ExecuteReturnEntityAsync();
  306. await _timelineRep.InsertAsync(new AdoS8ExceptionTimeline
  307. {
  308. ExceptionId = entity.Id,
  309. ActionCode = "CREATE",
  310. ActionLabel = "创建",
  311. FromStatus = null,
  312. ToStatus = "NEW",
  313. OperatorId = null,
  314. ActionRemark = "自动建单(R2)",
  315. CreatedAt = DateTime.Now
  316. });
  317. }, ex => throw ex);
  318. await TryStartIntakeFlowAsync(entity);
  319. return entity;
  320. }
  321. public async Task<AdoS8Exception?> GetAsync(long id) =>
  322. await _rep.GetByIdAsync(id);
  323. public async Task<AdoS8Evidence> AddAttachmentAsync(long id, AdoS8AttachmentCreateDto dto)
  324. {
  325. var entity = await _rep.GetFirstAsync(x => x.Id == id && !x.IsDeleted)
  326. ?? throw new S8BizException("异常不存在");
  327. if (string.IsNullOrWhiteSpace(dto.FileName) || string.IsNullOrWhiteSpace(dto.FileUrl))
  328. throw new S8BizException("附件名称和地址必填");
  329. var evidence = new AdoS8Evidence
  330. {
  331. ExceptionId = id,
  332. EvidenceType = string.IsNullOrWhiteSpace(dto.EvidenceType) ? "file" : dto.EvidenceType,
  333. FileName = dto.FileName.Trim(),
  334. FileUrl = dto.FileUrl.Trim(),
  335. SourceSystem = dto.SourceSystem,
  336. UploadedBy = dto.UploadedBy,
  337. UploadedAt = DateTime.Now,
  338. IsDeleted = false
  339. };
  340. await _evidenceRep.InsertAsync(evidence);
  341. return evidence;
  342. }
  343. }