using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;

namespace MMBLL.Allocation
{
    /// <summary>
    /// Interface defining the Business Logic Layer contract for Allocation operations.
    /// Supports both SQL Server (GB5 default) and Oracle database routing.
    /// </summary>
    public interface IAllocationBLL
    {
        /// <summary>
        /// Retrieves a single allocation record by its unique identifier.
        /// </summary>
        Task<string> GetAllocation(int AllocationId, LoginDTO LoginDTO);

        /// <summary>
        /// Loads paginated allocation picklist data for the "Load From Allocation" screen.
        /// Routes to the appropriate DAL method based on database type:
        /// - SQL Server → LoadFromAllocationPicklist (optimized lazy-load query)
        /// - Oracle → GetPendingNew (trigger-based pending allocation logic)
        /// </summary>
        /// <param name="FirstNumber">Zero-based starting index for pagination.</param>
        /// <param name="MaxResult">Maximum number of records to return per page.</param>
        /// <param name="CriteriaDTO">Filter criteria including OU, item, header, biz type filters.</param>
        /// <param name="LoginDTO">Current user session and database connection context.</param>
        /// <returns>JSON-serialized list of <see cref="AllocationNewDTO"/>.</returns>
        Task<string> LoadFromAllocationPicklist(int FirstNumber, int MaxResult, CriteriaDTO CriteriaDTO, LoginDTO LoginDTO);

        /// <summary>
        /// GB4 Source: AllocationService.GetPendingNewListForProductionPlan (Allocation.svc.cs),
        /// GB4 route /Allocation/PendingAllocationSelectList. Returns AllocationNewDTO rows —
        /// wired to GB5's /Allocation/GetSelectListTPendingAllocation endpoint since that route
        /// name is the closest textual match to GB4's actual URL.
        /// </summary>
        Task<string> GetPendingNewListForProductionPlan(CriteriaDTO CriteriaDTO, LoginDTO LoginDTO);
    }
}