ds8-solution-pro/ds-wms-service/DS.WMS.Core/Flow/Interface/IClientFlowInstanceService.cs

using System.Linq.Expressions;
using DS.Module.Core;
using DS.WMS.Core.Flow.Dtos;
using DS.WMS.Core.Flow.Entity;
using DS.WMS.Core.Op.Entity;

namespace DS.WMS.Core.Flow.Interface;

/// <summary>
/// 租户端工作流
/// </summary>
public interface IClientFlowInstanceService
{
    /// <summary>
    /// 确定是否为最后审批人
    /// </summary>
    /// <param name="taskType">任务类型</param>
    /// <param name="bsId">业务ID</param>
    /// <param name="bsType">业务类型</param>
    /// <returns></returns>
    DataResult<bool> IsLastMarker(TaskBaseTypeEnum taskType, long bsId, BusinessType? bsType);

    /// <summary>
    /// 确定工作流是否正在运行中
    /// </summary>
    /// <param name="type">工作流类型</param>
    /// <param name="businessType">业务类型</param>
    /// <param name="ids">业务ID</param>
    /// <returns></returns>
    Task<bool> IsRunning(TaskBaseTypeEnum type, BusinessType? businessType = null, params long[] ids);

    /// <summary>
    /// 确定工作流是否存在
    /// </summary>
    /// <param name="type">工作流类型</param>
    /// <param name="businessType">业务类型</param>
    /// <param name="expression">自定义查询条件</param>
    /// <param name="ids">业务ID</param>
    /// <returns></returns>
    Task<bool> Exists(TaskBaseTypeEnum? type = null, BusinessType? businessType = null, Expression<Func<FlowInstance, bool>>? expression = null, params long[] ids);

    /// <summary>
    /// 根据业务ID获取关联工作流
    /// </summary>
    /// <param name="type">工作流类型</param>
    /// <param name="businessType">业务类型</param>
    /// <param name="ids">业务ID</param>
    /// <returns></returns>
    Task<List<FlowInstance>> GetInstanceByBSIdAsync(TaskBaseTypeEnum type, BusinessType? businessType = null, params long[] ids);

    /// <summary>
    /// 列表查询
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    DataResult<List<FlowInstanceRes>> GetListByPage(PageRequest request);

    /// <summary>
    /// 添加编辑
    /// </summary>
    /// <param name="req"></param>
    /// <returns></returns>
    DataResult EditFlowInstance(FlowInstanceReq req);

    /// <summary>
    /// 获取详情
    /// </summary>
    /// <param name="id"></param>
    /// <returns></returns>
    DataResult<FlowInstanceRes> GetFlowInstanceInfo(string id);

    /// <summary>
    /// 启动实例
    /// </summary>
    /// <param name="id"></param>
    /// <returns></returns>
    DataResult StartFlowInstance(string id);
    /// <summary>
    /// 创建工作流实例
    /// </summary>
    /// <param name="req"></param>
    /// <returns></returns>
    DataResult CreateFlowInstance(CreateFlowInstanceReq req);

    /// <summary>
    /// 工作流审批
    /// </summary>
    /// <param name="req"></param>
    /// <returns></returns>
    Task<DataResult> AuditAsync(FlowInstanceAuditReq req);

    /// <summary>
    /// 工作流审批
    /// </summary>
    /// <param name="info"></param>
    /// <returns></returns>
    Task<DataResult> AuditAsync(FlowAuditInfo info);

    /// <summary>
    /// 撤销工作流
    /// </summary>
    /// <param name="req"></param>
    /// <returns></returns>
    DataResult WithdrawFlowInstance(CancelFlowInstanceReq req);

    /// <summary>
    /// 撤销工作流
    /// </summary>
    /// <param name="ids"></param>
    /// <param name="note">备注</param>
    /// <returns></returns>
    Task<DataResult> WithdrawAsync(long[] ids, string? note = null);

    /// <summary>
    /// 撤销审核
    /// </summary>
    /// <param name="taskType">任务类型</param>
    /// <param name="bsIds">业务ID</param>
    /// <param name="businessType">业务类型</param>
    /// <param name="note">备注</param>
    /// <returns></returns>
    Task<DataResult> WithdrawAsync(TaskBaseTypeEnum taskType, long[] bsIds,
         BusinessType? businessType = null, string? note = null);

    /// <summary>
    /// 运行回调更新
    /// </summary>
    /// <param name="taskType">审核类型</param>
    /// <param name="bsId">业务ID</param>
    /// <param name="businessType">业务类型</param>
    /// <param name="callbackURL">回调URL</param>
    /// <returns></returns>
    Task<DataResult> RunCallbackAsync(TaskBaseTypeEnum taskType, long bsId, BusinessType? businessType = null, string? callbackURL = null);

    /// <summary>
    /// 获取流程操作历史
    /// </summary>
    /// <param name="id"></param>
    /// <returns></returns>
    DataResult<List<FlowInstanceHistoryRes>> GetFlowInstanceHistoryList(string id);

    /// <summary>
    /// 获取流程操作历史
    /// </summary>
    /// <param name="bsId">业务ID</param>
    /// <param name="bsType">bsType</param>
    /// <returns></returns>
    DataResult<List<FlowInstanceHistoryRes>> GetFlowInstanceHistoryList(long bsId, BusinessType? bsType);

    /// <summary>
    /// 获取工作流实例信息
    /// </summary>
    /// <param name="businessId">业务ID</param>
    /// <param name="businessType">业务类型</param>
    /// <param name="types">审批类型</param>
    /// <returns></returns>
    DataResult<List<FlowInstanceRes>> GetFlowInstances(long businessId, BusinessType? businessType, params TaskBaseTypeEnum[]? types);
}