hotline/src/Hotline.Application/FlowEngine/IWorkflowApplication.cs

using Hotline.FlowEngine.Definitions;
using Hotline.FlowEngine.WorkflowModules;
using Hotline.FlowEngine.Workflows;
using Hotline.Orders;
using Hotline.Share.Dtos;
using Hotline.Share.Dtos.File;
using Hotline.Share.Dtos.FlowEngine;
using Hotline.Share.Dtos.FlowEngine.Definition;
using Hotline.Share.Dtos.Order;
using Hotline.Share.Dtos.Settings;
using Hotline.Share.Enums.FlowEngine;
using XF.Domain.Authentications;

namespace Hotline.Application.FlowEngine
{
    public interface IWorkflowApplication
    {
        /// <summary>
        /// 开始流程
        /// </summary>
        Task<string> StartWorkflowAsync(StartWorkflowDto dto, ISessionContext current, string externalId, DateTime? expiredTime = null,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 流转至下一节点（节点办理）
        /// </summary>
        Task<Workflow> NextAsync(NextWorkflowDto dto, ISessionContext current, DateTime? expiredTime = null,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 退回（返回前一节点）
        /// </summary>
        Task PreviousAsync(PreviousWorkflowDto dto, CancellationToken cancellationToken);

        /// <summary>
        /// 工单退回（返回前一节点）
        /// </summary>
        Task PreviousAsync(PreviousWorkflowDto dto, string userId, CancellationToken cancellationToken);

        /// <summary>
        /// 撤回至任意节点
        /// </summary>
        Task RecallAsync(RecallDto dto, DateTime? expiredTime, CancellationToken cancellationToken);

        /// <summary>
        /// 跳转至结束节点(无视流程模板配置直接跳至结束节点)
        /// </summary>
        Task HandleToEndAsync(ISessionContext current, string workflowId, string opinion, List<FileDto> file,
            EReviewResult? reviewResult = EReviewResult.Unknown, CancellationToken cancellationToken = default);

        ////////

        /// <summary>
        /// 查询开始流程的下一步待选节点
        /// </summary>
        Task<NextStepsDto<NextStepOption>> GetStartStepsAsync(string moduleCode, CancellationToken cancellationToken);

        /// <summary>
        /// 查询办理流程的下一步待选节点
        /// </summary>
        Task<NextStepsWithOpinionDto<NextStepOption>> GetNextStepsAsync(string workflowId, CancellationToken cancellationToken);

        /// <summary>
        /// 查询撤回可选节点
        /// </summary>
        Task<NextStepsDto<RecallStepOption>> GetRecallStepsAsync(string workflowId, CancellationToken cancellationToken);

        /// <summary>
        /// 否决
        /// </summary>
        Task RejectAsync(RejectDto dto, CancellationToken cancellationToken);

        /// <summary>
        /// 获取流程模板信息
        /// </summary>
        /// <param name="code"></param>
        /// <param name="cancellationToken"></param>
        /// <returns></returns>
        Task<WorkflowModule> GetWorkflowModuleAsync(string code, CancellationToken cancellationToken);

        /// <summary>
        /// 检查退回节点信息
        /// </summary>
        Task<(WorkflowStep currentStep, WorkflowStep prevStep, bool isOrgToCenter, bool isSecondToFirstOrgLevel)>
            GetPreviousInformationAsync(string workflowId, string operatorId, string operatorOrgId,
                CancellationToken cancellationToken);
        
        /// <summary>
        /// 开启流程直接归档
        /// </summary>
        Task StartToEndAsync(StartWorkflowDto dto, ISessionContext current, string externalId, DateTime? expiredTime = null,
            CancellationToken cancellationToken = default);
    }
}