using FrameworkDAL.DTO.GBPeriod;
using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace FrameworkBLL.GBPeriod
{
    public interface IGBPeriodBLL
    {
        Task<string> GetGBPeriod(int gbPeriodId, LoginDTO loginDTO);
        /// <summary>
        /// Inserts a new GBPeriod record or updates an existing one.
        /// Applies business rules such as auto-number assignment for new records.
        /// </summary>
        /// <param name="GBPeriodDTO">The GBPeriod data to save or update.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A message string indicating success and the GBPeriod ID.</returns>
        Task<string> SaveGBPeriod(GBPeriodDTO GBPeriodDTO, LoginDTO LoginDTO);
        /// <summary>
        /// Deletes a GBPeriod record by its unique identifier.
        /// </summary>
        /// <param name="GBPeriodId">The ID of the GBPeriod to delete.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A message string indicating success or failure of the delete operation.</returns>
        Task<string> DeleteGBPeriod(int GBPeriodId, LoginDTO LoginDTO);
        /// <summary>
        /// Retrieves a paginated list of GBPeriod records based on specified filter criteria.
        /// Can optionally return the total count of records instead of the list.
        /// </summary>
        /// <param name="firstNumber">The starting index of records to fetch (for pagination).</param>
        /// <param name="maxResult">The maximum number of records to fetch.</param>
        /// <param name="criteriaDTO">Filter criteria for selecting GBPeriod records.</param>
        /// <param name="loginDTO">The current user's login details.</param>
        /// <param name="isCount">If true, returns the total count of matching records instead of the list.</param>
        /// <returns>A JSON string representing either the list of GBPeriod records or the total count.</returns>
        Task<string> GetSelectListGBPeriod(int firstNumber, int maxResult, CriteriaDTO criteriaDTO, LoginDTO loginDTO, bool isCount = false);
        /// <summary>
        /// Retrieves a paginated list of GBPeriodDetail records (sub-periods) across all GBPeriods.
        /// Can optionally return the total count of records instead of the list.
        /// </summary>
        /// <param name="firstNumber">The starting index of records to fetch (for pagination).</param>
        /// <param name="maxResult">The maximum number of records to fetch.</param>
        /// <param name="criteriaDTO">Filter criteria for selecting GBPeriodDetail records.</param>
        /// <param name="loginDTO">The current user's login details.</param>
        /// <param name="isCount">If true, returns the total count of matching records instead of the list.</param>
        /// <returns>A JSON string representing either the list of GBPeriodDetail records or the total count.</returns>
        Task<string> GetSelectListGBPeriodDetail(int firstNumber, int maxResult, CriteriaDTO criteriaDTO, LoginDTO loginDTO, bool isCount = false);
        /// <summary>
        /// Retrieves the full GBPeriod/GBPeriodDetail picklist (no paging) filtered by the supplied criteria.
        /// Mirrors the GB4 Gb4PeriodPicklist behavior used by legacy period-selection pickers.
        /// </summary>
        /// <param name="criteriaDTO">Filter criteria (e.g. PeriodType, SubPeriodName, PeiodFromDate, PeiodToDate).</param>
        /// <param name="loginDTO">The current user's login details.</param>
        /// <returns>A JSON string representing the list of matching GBPeriodDetail picklist records.</returns>
        Task<string> Gb4PeriodPicklist(CriteriaDTO criteriaDTO, LoginDTO loginDTO);
    }
}