DD.WellWorkover.Cloud/AsbCloudInfrastructure/Repository/IFileRepository.cs

using AsbCloudApp.Data;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;

namespace AsbCloudInfrastructure.Repository
{
    /// <summary>
    /// Сервис доступа к файлам
    /// </summary>
    public interface IFileRepository
    {
        /// <summary>
        /// Добавление, в БД, информации о файле
        /// </summary>
        /// <param name="idWell"></param>
        /// <param name="idUser"></param>
        /// <param name="idCategory"></param>
        /// <param name="destinationFileName"></param>
        /// <param name="fileSize"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> AddAsync(int idWell, int? idUser, int idCategory,
            string destinationFileName, long fileSize, CancellationToken token = default);

        /// <summary>
        /// Получить файлы определенной категории
        /// </summary>
        /// <param name="idWell"></param>
        /// <param name="idCategory"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<IEnumerable<FileInfoDto>> GetInfosByCategoryAsync(int idWell, int idCategory, CancellationToken token);

        /// <summary>
        /// Получить список файлов в контейнере
        /// </summary>
        /// <param name="idWell"></param>
        /// <param name="idCategory"></param>
        /// <param name="companyName"></param>
        /// <param name="fileName"></param>
        /// <param name="begin"></param>
        /// <param name="end"></param>
        /// <param name="skip"></param>
        /// <param name="take"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<PaginationContainer<FileInfoDto>> GetInfosAsync(int idWell,
            int idCategory, string companyName = default, string fileName = default, DateTime begin = default,
            DateTime end = default, int skip = 0, int take = 32, CancellationToken token = default);

        /// <summary>
        /// Инфо о файле
        /// </summary>
        /// <param name="idFile"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<FileInfoDto> GetInfoAsync(int idFile, CancellationToken token);

        /// <summary>
        /// Пометить файл как удаленный
        /// </summary>
        /// <param name="idFile"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> MarkAsDeletedAsync(int idFile, CancellationToken token = default);

        /// <summary>
        /// удалить файлы
        /// </summary>
        /// <param name="ids"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<IEnumerable<FileInfoDto>> DeleteAsync(IEnumerable<int> ids, CancellationToken token);

        /// <summary>
        /// получить инфо о файле по метке
        /// </summary>
        /// <param name="idMark"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<FileInfoDto> GetByMarkId(int idMark, CancellationToken token);

        /// <summary>
        /// добавить метку на файл
        /// </summary>
        /// <param name="fileMarkDto"></param>
        /// <param name="idUser"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> CreateFileMarkAsync(FileMarkDto fileMarkDto, int idUser, CancellationToken token);

        /// <summary>
        /// Инфо о файлах
        /// </summary>
        /// <param name="idsFile"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<IEnumerable<FileInfoDto>> GetInfoByIdsAsync(IEnumerable<int> idsFile, CancellationToken token);

        /// <summary>
        /// пометить метки файлов как удаленные
        /// </summary>
        /// <param name="idsMarks"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> MarkFileMarkAsDeletedAsync(IEnumerable<int> idsMarks, CancellationToken token);

        /// <summary>
        /// Получение файлов по скважине
        /// </summary>
        /// <param name="idWell"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<IEnumerable<FileInfoDto>> GetInfosByWellIdAsync(int idWell, CancellationToken token);
    }
}