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

namespace TMSBLL.TrainingNeed
{
    public interface ITrainingNeedBLL
    {
        Task<string> GetTrainingNeed(int trainingNeedId, LoginDTO loginDTO);
        Task<string> GetTrainingNeedList(byte? needStatus, int? domainId, byte? priority, byte? sourceType, int page, int size, LoginDTO loginDTO);
        Task<string> SaveTrainingNeed(TrainingNeedDTO dto, LoginDTO loginDTO);
        Task<string> GetSelectList(CriteriaDTO criteriaDTO, LoginDTO login, CancellationToken ct);
        Task<string> DeleteTrainingNeed(int trainingNeedId, LoginDTO loginDTO);
        Task<string> SubmitTrainingNeed(SubmitTrainingNeedDTO dto, LoginDTO loginDTO);

        /// <summary>
        /// Generalized, non-interactive entry point for any producer module to raise a Training
        /// Need programmatically (as opposed to SaveTrainingNeed, which is UI-form shaped and
        /// requires a human RaisedById). Idempotent: repeated calls for the same
        /// (SourceRefEntity, SourceRefId, NeedSourceType) return the existing open need's ID
        /// rather than creating a duplicate. Returns the TrainingNeedId (existing or newly created).
        /// </summary>
        Task<int> ProposeTrainingNeed(ProposeTrainingNeedDTO dto, LoginDTO loginDTO, CancellationToken ct);
    }
}