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

namespace TMSBLL.AssessmentAttempt
{
    public interface IAssessmentAttemptBLL
    {
        Task<string> GetAssessmentAttempt(int assessmentAttemptId, LoginDTO loginDTO);
        Task<string> GetAssessmentAttemptList(int enrollmentId, LoginDTO loginDTO);
        Task<string> GetAssessmentAttemptFullList(LoginDTO loginDTO);
        Task<string> GetSelectListAssessmentAttempt(CriteriaDTO criteriaDTO, LoginDTO loginDTO);

        /// <summary>Starts attempt — saves header + all responses. Computes AttemptNo.</summary>
        Task<string> StartAssessmentAttempt(AssessmentAttemptDTO dto, LoginDTO loginDTO);

        /// <summary>Submits attempt — computes score/pass from responses, updates header.</summary>
        Task<string> SubmitAssessmentAttempt(AssessmentAttemptDTO dto, LoginDTO loginDTO);

        /// <summary>Manual evaluation — evaluator updates response marks, recalculates score.</summary>
        Task<string> EvaluateAssessmentAttempt(AssessmentAttemptDTO dto, LoginDTO loginDTO);

        Task<string> DeleteAssessmentAttempt(int assessmentAttemptId, LoginDTO loginDTO);

        /// <summary>
        /// Records an assessment taken entirely outside the system (proctored/paper-based exam).
        /// Full-detail mode: dto.Responses populated — scored through the normal pipeline.
        /// Summary-only mode: dto.Responses empty, dto.ScorePct supplied directly by the grader.
        /// Tags DeliveryChannel = Manual so it's distinguishable from in-app/FLS attempts in reporting.
        /// </summary>
        Task<string> RecordManualAttempt(AssessmentAttemptDTO dto, LoginDTO loginDTO);
    }
}