using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using AdminDAL.DTO.FinanceBook;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

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

        /// <summary>
        /// Inserts a new Finance Book or updates an existing Finance Book.
        /// Automatically applies any business rules, such as setting Created/Modified fields.
        /// </summary>
        /// <param name="FinanceBookDTO">The Finance Book 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 FinanceBookId.</returns>
        Task<string> SaveFinanceBook(FinanceBookDTO FinanceBookDTO, LoginDTO LoginDTO);

        /// <summary>
        /// Retrieves a list of Finance Books based on specified criteria.
        /// Typically used to populate dropdowns or selection lists in the UI.
        /// </summary>
        /// <param name="CriteriaDTO">Filter criteria for selecting Finance Books.</param>
        /// <param name="LoginDTO">The current user's login details.</param>
        /// <returns>A JSON string representing a list of Finance Books.</returns>
        Task<string> GetSelectListFinanceBook(CriteriaDTO CriteriaDTO, LoginDTO LoginDTO);

        /// <summary>
        /// Deletes a Finance Book by its unique identifier.
        /// </summary>
        /// <param name="FinanceBookId">The unique identifier of the Finance Book 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> DeleteFinanceBook(int FinanceBookId, LoginDTO LoginDTO);
    }
}