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

using Data.SeaHavenIndustries;

namespace SeaHaven.DataServices.Interfaces
{
    /// <summary>
    /// SH-379: data access for the work-order-level POC override.
    /// </summary>
    public interface IWorkOrderPocDataService
    {
        /// <summary>
        /// SH-221 account-scoped tracked load for POC updates. Includes the site's
        /// contacts and the linked WorkOrderContacts POC. Null when the work order
        /// does not exist or is outside the caller's account scope.
        /// </summary>
        Task<WorkOrder?> GetTrackedWorkOrderAsync(
            int workOrderId,
            int? accountId,
            CancellationToken cancellationToken);

        /// <summary>
        /// The site's live contacts for a location ordered by SiteContactOrder then Id.
        /// Deleted contacts are excluded. Empty when the location has none.
        /// </summary>
        Task<IReadOnlyList<Contacts>> GetSiteContactsAsync(
            int? locationId,
            CancellationToken cancellationToken);
    }
}