using FrameworkDAL.DTO.Workflow;
using GB5Shared.DTO.Framework.Criteria;
using GB5Shared.DTO.Framework.Login;
using GB5Shared.DTO.WorkFlow;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using static GB5Shared.DTO.WorkFlow.ContractsDTO;
using WorkflowDTO = FrameworkDAL.DTO.Workflow.WorkflowDTO;

namespace FrameworkDAL.CustomCode.WorkFlow
{
    public interface IWorkFlowDAL
    {
        // ── Applicability check ───────────────────────────────────────────────

        /// <summary>
        /// Checks MWORKFLOWCONFIG to determine whether a workflow applies
        /// and returns the result with the resolved workflow id.
        /// </summary>
        Task<WorkflowPreCheckResult> CheckApplicability(
            WorkflowCheckContext context,
            LoginDTO loginDTO);

        // ── Start workflow ────────────────────────────────────────────────────

        /// <summary>
        /// Starts a new workflow instance for the given document.
        /// Returns the full <see cref="WorkflowStartResult"/> including any
        /// PendingNotifications (tasks created at the first approval level).
        /// </summary>
        Task<WorkflowStartResult> StartWorkflow(
            WorkflowStartRequest request,
            LoginDTO loginDTO);

        // ── Action handling ───────────────────────────────────────────────────

        /// <summary>
        /// Processes workflow actions. Returns WorkflowActionResult which may contain
        /// PendingDispatches for WIP instances that reached final approval.
        /// Caller (BLL) must dispatch these AFTER committing the transaction.
        /// </summary>
        Task<WorkflowActionResult> Actions(
            WorkFlowActionDTO workFlowActionDTO,
            LoginDTO loginDTO);

        /// <summary>
        /// Friendly MENTITY.ENTITYNAME for an EntityId. Used by the BLL to label the
        /// success message for entity types it doesn't have a hardcoded name for.
        /// </summary>
        Task<string?> GetEntityNameAsync(int entityId, LoginDTO loginDTO);

        // ── Approval list ─────────────────────────────────────────────────────

        /// <summary>
        /// WorkflowType: 1 = RequestToMe, other = RequestByMe.
        /// </summary>
        Task<List<WorkflowApprovalListDTO>> WorkflowApprovalList(
            int workflowType,
            int firstNumber,
            int maxResult,
            CriteriaDTO criteriaDTO,
            LoginDTO loginDTO);

        // ── History and status ────────────────────────────────────────────────

        Task<List<WorkflowHistoryListDTO>> WorkflowHistory(
            int workflowType,
            CriteriaDTO criteriaDTO,
            LoginDTO loginDTO);

        Task<List<WorkflowStatusDTO>> WorkflowStatus(
            CriteriaDTO criteriaDTO,
            LoginDTO loginDTO);

        /// <summary>
        /// Returns real-time approval status for a specific document
        /// (current level, pending approvers, completed approvers, history).
        /// </summary>
        Task<List<WorkflowStatusDTO>> CurrentApprovalStatus(
            int entityId,
            int objectId,
            LoginDTO loginDTO);

        // ── Auto-approve ─────────────────────────────────────────────────────

        /// <summary>
        /// Returns all pending tasks whose DUEON has passed and step has ISAUTOAPPROVE = 0 (0=Yes).
        /// </summary>
        Task<IReadOnlyList<OverdueAutoApproveTaskDTO>> GetOverdueAutoApproveTasks(LoginDTO loginDTO);

        // ── Monitor dashboard ─────────────────────────────────────────────────

        Task<WorkflowMonitorSummaryDTO> GetWorkflowMonitor(
            int entityId, DateTime? dateFrom, DateTime? dateTo,
            int page, int pageSize,
            LoginDTO loginDTO);

        // ── Workflow CRUD ─────────────────────────────────────────────────────

        Task<string> GetWorkflow(int WorkflowId, LoginDTO LoginDTO);
        Task<int> SaveWorkflow(WorkflowDTO workflowDTO, LoginDTO login);
        Task<int> UpdateWorkflow(WorkflowDTO workflowDTO, LoginDTO login);
        Task<int> DeleteWorkflowDetail(int WorkflowId, LoginDTO LoginDTO);
        Task<int> DeleteWorkflow(int WorkflowId, LoginDTO LoginDTO);
        Task<IEnumerable<WorkflowDTO>> GetSelectListWorkflow(CriteriaDTO criteriaDTO, LoginDTO LoginDTO);
    }
}