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

namespace TCMSBLL.Interfaces;

public interface ITCMSTraceabilityBLL
{
    // ── Screen links (QA admin) ───────────────────────────────────────────────
    Task<string>                             LinkScreenAsync(TCMSSaveLinkDTO dto, LoginDTO login, CancellationToken ct);
    Task<string>                             UnlinkScreenAsync(int screenLinkId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSScreenLinkDTO>>     GetScreenLinksForTestCaseAsync(int testCaseId, LoginDTO login, CancellationToken ct);

    // ── API links (QA admin) ──────────────────────────────────────────────────
    Task<string>                             LinkApiAsync(TCMSSaveApiLinkDTO dto, LoginDTO login, CancellationToken ct);
    Task<string>                             UnlinkApiAsync(int apiLinkId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSApiLinkDTO>>        GetApiLinksForTestCaseAsync(int testCaseId, LoginDTO login, CancellationToken ct);

    // ── Read (coverage widget + traceability view) ────────────────────────────
    Task<TCMSScreenCoverageDTO>              GetByScreenAsync(string screenRoute, LoginDTO login, CancellationToken ct);
    Task<TCMSApiCoverageDTO>                 GetByApiOperationAsync(long apiOperationId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<TCMSScreenTreeNodeDTO>> GetScreenTreeAsync(LoginDTO login, CancellationToken ct);

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