shoc-backend/SeaHaven.DataServices/Interfaces/IWorkOrderDetailDataService.cs

using Data.SeaHavenIndustries;
using Data.SeaHavenIndustries.Enums;
using SeaHaven.DataServices.Interfaces;

namespace SeaHaven.DataServices.Interfaces
{
    public interface IWorkOrderDetailDataService
    {
        Task<bool> ExistsAsync(
            int workOrderId,
            CancellationToken cancellationToken = default,
            int? accountId = null);
        Task<WorkOrderDetailExtendedFields?> GetExtendedFieldsAsync(int workOrderId);
        Task<IReadOnlyList<Comments>> GetCommentsAsync(int workOrderId);
        Task<IReadOnlyList<WorkOrderAuditLog>> GetAuditLogsAsync(int workOrderId, int? limit = null);
        Task<IReadOnlyList<WorkOrderAttachments>> GetAttachmentsAsync(
            int workOrderId,
            CancellationToken cancellationToken = default);
        Task<IReadOnlyList<DispatchSignoffRow>> GetDispatchSignoffsAsync(int workOrderId);
        Task<WorkOrder?> GetWorkOrderForMediaAsync(
            int workOrderId,
            CancellationToken cancellationToken = default,
            int? accountId = null);
    }

    public interface ICompletionDocTemplateDataService
    {
        Task<CompletionDocTemplateRow?> ResolveForWorkOrderAsync(string? trade, WorkOrderType? workOrderType);

        Task<IReadOnlyList<CompletionDocTemplateDetailRow>> ListAsync(
            string? search,
            string? serviceKey,
            WorkOrderType? workOrderType,
            CancellationToken cancellationToken);

        Task<CompletionDocTemplateDetailRow?> GetDetailAsync(int id, CancellationToken cancellationToken);

        /// <summary>Tracked, not-deleted template with its procedures loaded, for editing.</summary>
        Task<CompletionDocTemplate?> GetTrackedForEditAsync(int id, CancellationToken cancellationToken);

        Task<int> CreateAsync(CompletionDocTemplate template, CancellationToken cancellationToken);

        /// <summary>
        /// Commits edits to a template from <see cref="GetTrackedForEditAsync"/>. A non-null
        /// <paramref name="replacementProcedures"/> replaces the whole procedure list.
        /// </summary>
        Task SaveEditAsync(
            CompletionDocTemplate template,
            IReadOnlyList<CompletionDocTemplateProcedure>? replacementProcedures,
            CancellationToken cancellationToken);

        /// <summary>
        /// Soft-deletes the template and clears every Service link to it in the same commit.
        /// Services keep RequiresCompletionDocument. False when the template does not exist.
        /// </summary>
        Task<bool> DeleteAndUnlinkServicesAsync(int id, string? deleterUserId, CancellationToken cancellationToken);

        /// <summary>
        /// Ids of open (non-terminal) work orders whose Service links this template,
        /// restricted to <paramref name="accountId"/> when set.
        /// </summary>
        Task<IReadOnlyList<int>> GetOpenLinkedWorkOrderIdsAsync(
            int templateId,
            int? accountId,
            CancellationToken cancellationToken);
    }
}