// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。 // // 本项目主要遵循 MIT 许可证和 Apache 许可证(版本 2.0)进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。 // // 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动!任何基于本项目二次开发而产生的一切法律纠纷和责任,我们不承担任何责任! using System.Text.Json; namespace Admin.NET.Plugin.ApprovalFlow.Service; /// /// 审批流程服务 /// [ApiDescriptionSettings(ApprovalFlowConst.GroupName, Order = 100)] public class ApprovalFlowService : IDynamicApiController, ITransient { private readonly SqlSugarRepository _approvalFlowRep; private readonly SqlSugarRepository _versionRep; private readonly UserManager _userManager; public ApprovalFlowService( SqlSugarRepository approvalFlowRep, SqlSugarRepository versionRep, UserManager userManager) { _approvalFlowRep = approvalFlowRep; _versionRep = versionRep; _userManager = userManager; } /// /// 分页查询审批流 /// /// /// [HttpPost] [ApiDescriptionSettings(Name = "Page")] public async Task> Page(ApprovalFlowInput input) { return await _approvalFlowRep.AsQueryable() .WhereIF(!string.IsNullOrWhiteSpace(input.Keyword), u => u.Code.Contains(input.Keyword.Trim()) || u.Name.Contains(input.Keyword.Trim()) || u.Remark.Contains(input.Keyword.Trim())) .WhereIF(!string.IsNullOrWhiteSpace(input.Code), u => u.Code.Contains(input.Code.Trim())) .WhereIF(!string.IsNullOrWhiteSpace(input.Name), u => u.Name.Contains(input.Name.Trim())) .WhereIF(!string.IsNullOrWhiteSpace(input.Remark), u => u.Remark.Contains(input.Remark.Trim())) .Select() .ToPagedListAsync(input.Page, input.PageSize); } /// /// 增加审批流 /// /// /// [ApiDescriptionSettings(Name = "Add"), HttpPost] public async Task Add(AddApprovalFlowInput input) { var entity = input.Adapt(); if (input.Code == null) { entity.Code = await LastCode(""); } await _approvalFlowRep.InsertAsync(entity); return entity.Id; } /// /// 更新审批流 /// /// /// [ApiDescriptionSettings(Name = "Update"), HttpPost] public async Task Update(UpdateApprovalFlowInput input) { var entity = input.Adapt(); await _approvalFlowRep.AsUpdateable(entity).IgnoreColumns(ignoreAllNullColumns: true).ExecuteCommandAsync(); } /// /// 删除审批流 /// /// /// [ApiDescriptionSettings(Name = "Delete"), HttpPost] public async Task Delete(DeleteApprovalFlowInput input) { var entity = await _approvalFlowRep.GetByIdAsync(input.Id) ?? throw Oops.Oh(ErrorCodeEnum.D1002); await _approvalFlowRep.FakeDeleteAsync(entity); // 假删除 } /// /// 获取审批流 /// /// /// public async Task GetDetail([FromQuery] QueryByIdApprovalFlowInput input) { return await _approvalFlowRep.GetByIdAsync(input.Id); } /// /// 根据编码获取审批流信息 /// /// /// public async Task GetInfo([FromQuery] string code) { return await _approvalFlowRep.GetFirstAsync(u => u.Code == code); } /// /// 获取审批流列表 /// /// /// public async Task> GetList([FromQuery] ApprovalFlowInput input) { return await _approvalFlowRep.AsQueryable().Select().ToListAsync(); } /// /// 获取今天创建的最大编号 /// /// /// private async Task LastCode(string prefix) { var today = DateTime.Now.Date; var count = await _approvalFlowRep.AsQueryable().Where(u => u.CreateTime >= today).CountAsync(); return prefix + DateTime.Now.ToString("yyMMdd") + string.Format("{0:d2}", count + 1); } /// /// 发布流程(Version+1, IsPublished=true) /// [ApiDescriptionSettings(Name = "Publish"), HttpPost] [DisplayName("发布审批流")] public async Task Publish([FromBody] BaseIdInput input) { var entity = await _approvalFlowRep.GetByIdAsync(input.Id) ?? throw Oops.Oh(ErrorCodeEnum.D1002); if (string.IsNullOrWhiteSpace(entity.FlowJson)) throw Oops.Oh("请先设计流程图再发布"); if (string.IsNullOrWhiteSpace(entity.BizType)) throw Oops.Oh("请先设置业务类型再发布"); entity.Version += 1; entity.IsPublished = true; await _approvalFlowRep.AsUpdateable(entity) .UpdateColumns(u => new { u.Version, u.IsPublished }) .ExecuteCommandAsync(); await _versionRep.InsertAsync(new ApprovalFlowVersion { FlowId = entity.Id, Version = entity.Version, FlowJson = entity.FlowJson, FormJson = entity.FormJson, PublishTime = DateTime.Now, PublisherName = _userManager.RealName, }); } /// /// 获取流程版本历史 /// [HttpGet] [ApiDescriptionSettings(Name = "VersionHistory")] [DisplayName("获取版本历史")] public async Task> VersionHistory([FromQuery] long flowId) { return await _versionRep.AsQueryable() .Where(v => v.FlowId == flowId) .OrderByDescending(v => v.Version) .Select(v => new FlowVersionOutput { Id = v.Id, Version = v.Version, PublishTime = v.PublishTime, PublisherName = v.PublisherName, }) .ToListAsync(); } /// /// 获取指定版本详情(含 FlowJson) /// [HttpGet] [ApiDescriptionSettings(Name = "VersionDetail")] [DisplayName("获取版本详情")] public async Task VersionDetail([FromQuery] long versionId) { return await _versionRep.GetByIdAsync(versionId); } /// /// 回退到指定版本(将该版本的 FlowJson/FormJson 复制回主记录) /// [HttpPost] [ApiDescriptionSettings(Name = "RevertVersion")] [DisplayName("回退版本")] public async Task RevertVersion([FromBody] BaseIdInput input) { var version = await _versionRep.GetByIdAsync(input.Id) ?? throw Oops.Oh("版本记录不存在"); var flow = await _approvalFlowRep.GetByIdAsync(version.FlowId) ?? throw Oops.Oh("流程不存在"); flow.FlowJson = version.FlowJson; flow.FormJson = version.FormJson; flow.IsPublished = false; await _approvalFlowRep.AsUpdateable(flow) .UpdateColumns(u => new { u.FlowJson, u.FormJson, u.IsPublished }) .ExecuteCommandAsync(); } /// /// 获取业务类型列表 /// [HttpGet] [ApiDescriptionSettings(Name = "BizTypes")] [DisplayName("获取业务类型列表")] public async Task> GetBizTypes() { return await _approvalFlowRep.AsQueryable() .Where(u => !string.IsNullOrWhiteSpace(u.BizType) && !u.IsDelete) .Select(u => u.BizType!) .Distinct() .ToListAsync(); } /// /// 获取指定业务类型的最新已发布流程定义 /// [HttpGet] [ApiDescriptionSettings(Name = "PublishedByBizType")] [DisplayName("获取已发布流程")] public async Task GetPublishedByBizType([FromQuery] string bizType) { return await _approvalFlowRep.AsQueryable() .Where(u => u.BizType == bizType && u.IsPublished && !u.IsDelete) .OrderByDescending(u => u.Version) .Select() .FirstAsync(); } [HttpGet] [ApiDescriptionSettings(Name = "FlowList")] [DisplayName("获取审批流结构")] public async Task FlowList([FromQuery] string code) { var result = await _approvalFlowRep.AsQueryable().Where(u => u.Code == code).Select().FirstAsync(); var FlowJson = result.FlowJson != null ? JsonSerializer.Deserialize(result.FlowJson) : new ApprovalFlowItem(); var FormJson = result.FormJson != null ? JsonSerializer.Deserialize(result.FormJson) : new ApprovalFormItem(); return new { FlowJson, FormJson }; } [HttpGet] [ApiDescriptionSettings(Name = "FormRoutes")] [DisplayName("获取审批流规则")] public async Task> FormRoutes() { var results = await _approvalFlowRep.AsQueryable().Select().ToListAsync(); var list = new List(); foreach (var item in results) { if (string.IsNullOrWhiteSpace(item.FormJson)) continue; var formJson = JsonSerializer.Deserialize(item.FormJson); if (formJson != null && !string.IsNullOrEmpty(formJson.Route)) list.Add(formJson.Route); } return list; } }