ds8-solution-pro/ds-wms-service/DS.WMS.Core/TaskPlat/Interface/ITaskManageService.cs

using DS.Module.Core;
using DS.Module.DjyServiceStatus;
using DS.WMS.Core.TaskPlat.Dtos;
using DS.WMS.Core.TaskPlat.Entity;
using Microsoft.AspNetCore.Http;
using SqlSugar;
using System.Linq.Expressions;

namespace DS.WMS.Core.TaskPlat.Interface
{
    public interface ITaskManageService : ITaskManageBaseService
    {
        /// <summary>
        /// 取消任务(可批量)
        /// </summary>
        /// <param name="ids">任务主键数组</param>
        /// <returns>返回结果</returns>
        Task<DataResult<TaskManageOrderResultDto>> CancelTask(long[] ids);

        /// <summary>
        /// 完成任务(可批量)
        /// </summary>
        /// <param name="ids">任务主键数组</param>
        /// <returns>返回结果</returns>
        Task<DataResult<TaskManageOrderResultDto>> CompleteTask(long[] ids);

        /// <summary>
        /// 获取登陆人相关的任务统计信息
        /// </summary>
        /// <returns>返回回执</returns>
        Task<DataResult<TaskUserStatResultInfo>> GetCurrentTotalStat(GetCurrentTotalStatQueryDto querySearch);

        /// <summary>
        /// 任务台台账列表查询
        /// </summary>
        Task<DataResult<List<dynamic>>> GetPageAsync(PageRequest<QueryTaskManageDto> querySearch);

        /// <summary>
        /// 创建任务
        /// </summary>
        /// <param name="info">任务详情</param>
        /// <param name="file"></param>
        /// <param name="modifyFile"></param>
        /// <returns>返回回执</returns>
        Task<DataResult> InitTaskJob(TaskManageOrderMessageInfo info, IFormFile file = null, IFormFile modifyFile = null);

        /// <summary>
        /// 工作流设置任务在个人下的状态
        /// </summary>
        /// <param name="bsno">业务主键</param>
        /// <param name="taskBaseTypeEnum">业务类型</param>
        /// <param name="taskStatusEnum">业务状态</param>
        /// <param name="statusTime">状态发生时间</param>
        /// <param name="userInfos">要设置任务状态的人员列表</param>
        Task<DataResult> SetTaskUserStatus(long bsno, TaskBaseTypeEnum taskBaseTypeEnum, TaskStatusEnum taskStatusEnum, DateTime? statusTime, List<RecvUserInfo> userInfos);
        /// <summary>
        /// 工作流设置任务状态
        /// </summary>
        /// <param name="bsno">业务主键</param>
        /// <param name="taskBaseTypeEnum">业务类型</param>
        /// <param name="taskStatusEnum">业务状态</param>
        /// <param name="statusTime">状态发生时间</param>
        /// <param name="taskDesc">任务描述</param>
        /// <param name="userIdList">用户Id列表，用于筛选指定用户下的任务</param> 
        Task<DataResult> SetTaskStatusWithBsno(long bsno, TaskBaseTypeEnum taskBaseTypeEnum, TaskStatusEnum taskStatusEnum, DateTime? statusTime, string? taskDesc = null, List<long>? userIdList = null);
        /// <summary>
        /// 工作流任务转交
        /// </summary>
        /// <param name="bsno">业务主键</param>
        /// <param name="taskBaseTypeEnum">业务类型</param>
        /// <param name="userInfos">要转交的人员信息列表</param>
        Task<DataResult> TransferTask(long bsno, TaskBaseTypeEnum taskBaseTypeEnum, List<RecvUserInfo> userInfos, SqlSugarScopeProvider? tenantDb = null);


        /// <summary>
        /// 工作流设置任务对象属性
        /// </summary>
        Task<DataResult> SetTaskBaseInfoPropertyWithBsno(long bsno, TaskBaseTypeEnum taskBaseTypeEnum, params Expression<Func<TaskBaseInfo, bool>>[] columns);

        /// <summary>
        /// 测试用
        /// </summary>
        Task<DataResult> TestTaskFlow(string taskType, long taskId, int testType);

        /// <summary>
        /// 领取任务到当前登陆人(可批量)
        /// </summary>
        Task<DataResult> PullTask(long[] ids);
    }
}