src/MaxSystems.Application/Abstractions/IWorkService.cs - master - afanasevn/MaxSystems

src/MaxSystems.Application/Abstractions/IWorkService.cs

53 строки2 KB

IBS\NAfanasev

Update documentation and comments

22 июн 2026, 19:13

22 июн 2026, 19:13ff853a6

using MaxSystems.Application.Contracts.Works;
using MaxSystems.Domain.Enums;

namespace MaxSystems.Application.Abstractions;

/// <summary>
/// Внутренний таск-трекер «Работы инфраструктуры».
/// </summary>
public interface IWorkService
{
    /// <summary>
    /// Список работ с фильтрами по статусу, системе, типу и просрочке.
    /// </summary>
    Task<IReadOnlyList<WorkListItemDto>> ListAsync(
        WorkStatus? status = null,
        EquipmentSystem? system = null,
        WorkType? type = null,
        bool? overdue = null,
        CancellationToken ct = default);

    /// <summary>
    /// Полная карточка работы: поля карточки, чек-лист, материалы.
    /// </summary>
    Task<WorkDetailDto?> GetByIdAsync(
        Guid id,
        CancellationToken ct = default);

    /// <summary>
    /// Создание новой работы. Обязательные поля карточки работы.
    /// </summary>
    Task<WorkListItemDto> CreateAsync(
        CreateWorkRequest request,
        Guid? actorUserId = null,
        CancellationToken ct = default);

    /// <summary>
    /// Смена статуса работы с проверкой правил ожидания и закрытия.
    /// </summary>
    Task<WorkListItemDto?> UpdateStatusAsync(
        Guid id,
        UpdateWorkStatusRequest request,
        Guid? actorUserId = null,
        CancellationToken ct = default);

    /// <summary>
    /// Сохранение чек-листа выполнения работы.
    /// </summary>
    Task SaveChecklistAsync(
        Guid workId,
        SaveChecklistRequest request,
        Guid? actorUserId = null,
        CancellationToken ct = default);
}