tnsu-approval-route/backend/Tnsu.ApprovalRoute.Infrastructure/TnsuPortal/ITnsuPortalClient.cs

namespace Tnsu.ApprovalRoute.Infrastructure.TnsuPortal;

public interface ITnsuPortalClient
{
    /// <summary>
    /// Все записи сотрудника по email — /Employee/ByEmail отдаёт массив: сотрудник может
    /// числиться в нескольких компаниях одновременно (один Id/Fio/Email, разные Company/
    /// CompanyId/Section/DepartmentId/Position на каждую). Пусто, если не найден вовсе.
    /// </summary>
    Task<IReadOnlyList<EmployeeDirectoryInfo>> GetEmployeeByEmailAsync(string email, CancellationToken cancellationToken);

    Task<EmployeeLookupResult> GetEmployeeByPositionAsync(string position, string company, CancellationToken cancellationToken);

    Task<string?> GetManagerAsync(string email, string managerType, CancellationToken cancellationToken);

    Task<IReadOnlyList<ProjectExecutorInfo>> GetProjectExecutorsAsync(Guid projectId, CancellationToken cancellationToken);

    /// <summary>Email руководителя указанного отдела (для HeadType.DepartmentHead) — null, если не найден.</summary>
    Task<string?> GetDepartmentHeadEmailAsync(Guid departmentId, CancellationToken cancellationToken);
}