shoc-backend/SeaHaven.Services/Interfaces/ICompletionDocTemplateService.cs

using System.Security.Claims;
using Data.SeaHavenIndustries.Enums;
using SeaHaven.Services.DTOs;

namespace SeaHaven.Services.Interfaces
{
    /// <summary>
    /// Completion document templates registry: authoring (title, extra safety note,
    /// ordered procedures), search, and safe deletion. Reads are open to every
    /// authenticated caller; writes require the matching team permission.
    /// </summary>
    public interface ICompletionDocTemplateService
    {
        Task<IReadOnlyList<CompletionDocTemplateDetailDto>> ListAsync(
            string? search,
            string? serviceKey,
            WorkOrderType? workOrderType,
            CancellationToken cancellationToken);

        Task<CompletionDocTemplateDetailDto?> GetAsync(int id, CancellationToken cancellationToken);

        Task<CompletionDocTemplateLinkedWorkOrdersDto> GetLinkedWorkOrdersAsync(
            ClaimsPrincipal user,
            int id,
            CancellationToken cancellationToken);

        Task<CompletionDocTemplateDetailDto> CreateAsync(
            ClaimsPrincipal user,
            CompletionDocTemplateCreateDto request,
            CancellationToken cancellationToken);

        Task<CompletionDocTemplateDetailDto> UpdateAsync(
            ClaimsPrincipal user,
            int id,
            CompletionDocTemplateCreateDto request,
            CancellationToken cancellationToken);

        Task DeleteAsync(ClaimsPrincipal user, int id, CancellationToken cancellationToken);
    }
}