using GB5Shared.DTO.Framework.Login;
using TCMSDAL.DTO;

namespace TCMSDAL.Interfaces;

public interface ITCMSTraceabilityDAL
{
    // ── Screen links ──────────────────────────────────────────────────────────
    Task<int>                               InsertScreenLinkAsync(TCMSSaveLinkDTO dto, LoginDTO login, CancellationToken ct);
    Task                                    DeleteScreenLinkAsync(int screenLinkId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSScreenLinkDTO>>    GetScreenLinksForTestCaseAsync(int testCaseId, LoginDTO login, CancellationToken ct);

    // ── API links ─────────────────────────────────────────────────────────────
    Task<int>                               InsertApiLinkAsync(TCMSSaveApiLinkDTO dto, LoginDTO login, CancellationToken ct);
    Task                                    DeleteApiLinkAsync(int apiLinkId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSApiLinkDTO>>       GetApiLinksForTestCaseAsync(int testCaseId, LoginDTO login, CancellationToken ct);

    // ── Read (traceability view + widget) ─────────────────────────────────────
    Task<IEnumerable<TCMSTracedTestCaseDTO>> GetTestCasesByScreenAsync(string screenRoute, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSTracedTestCaseDTO>> GetTestCasesByApiOperationAsync(long apiOperationId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSTracedStepDTO>>    GetStepsForCasesAsync(IEnumerable<int> caseIds, LoginDTO login, CancellationToken ct);
    Task<TCMSScreenCoverageDTO?>            GetScreenSummaryAsync(string screenRoute, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSScreenTreeNodeDTO>> GetScreenTreeAsync(LoginDTO login, CancellationToken ct);

    // ── Gap detection ─────────────────────────────────────────────────────────
    Task<IEnumerable<TCMSCoverageGapDTO>>   GetScreenGapsAsync(LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSCoverageGapDTO>>   GetApiGapsAsync(LoginDTO login, CancellationToken ct);
}