using FrameworkDAL.DTO.ECMRights;
using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using System.Threading.Tasks;

namespace FrameworkBLL.ECMRights
{
    /// <summary>
    /// Business Logic Layer interface for managing ECMRights operations.
    /// Provides methods to retrieve, insert/update, list, and delete ECMRights records with business rules applied.
    /// </summary>
    public interface IECMRightsBLL
    {
        /// <summary>
        /// Retrieves the details of a single ECMRights record by its unique identifier.
        /// </summary>
        /// <param name="ECMRightsId">The unique identifier of the ECMRights record.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string representing the ECMRights details.</returns>
        Task<string> GetECMRights(int ECMRightsId, LoginDTO LoginDTO);

        /// <summary>
        /// Inserts a new ECMRights record or updates an existing one.
        /// Automatically applies any business rules, such as setting Created/Modified fields.
        /// </summary>
        /// <param name="ECMRightsDTO">The ECMRights data to save or update.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string indicating the success of the operation, optionally with the ECMRightsId.</returns>
        Task<string> SaveECMRights(ECMRightsDTO ECMRightsDTO, LoginDTO LoginDTO);

        /// <summary>
        /// Retrieves a paginated list of ECMRights 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 ECMRights.</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 ECMRights records or the total count.</returns>
        Task<string> GetSelectListECMRights(int firstNumber, int maxResult, CriteriaDTO criteriaDTO, LoginDTO LoginDTO, bool isCount = false);

        /// <summary>
        /// Deletes an ECMRights record by its unique identifier.
        /// </summary>
        /// <param name="ECMRightsId">The unique identifier of the ECMRights record to delete.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string indicating success or failure of the delete operation.</returns>
        Task<string> DeleteECMRights(int ECMRightsId, LoginDTO LoginDTO);
    }
}