Расширение reminders (#19)

Co-authored-by: gorbenko.pavel <gorbenko.pavel@tansu.kz>
Reviewed-on: http://git.tnsu.kz/gorbenko.pavel/tnsu-approval-route/pulls/19

backend/Tnsu.ApprovalRoute.Application/Reminders/ReminderService.cs

@@ -7,6 +7,7 @@ using Tnsu.ApprovalRoute.Application.ListPartitioning;
 using Tnsu.ApprovalRoute.Domain.Entities;
 using Tnsu.ApprovalRoute.Infrastructure.Persistence;
 using Tnsu.ApprovalRoute.Infrastructure.SharePoint;
+using Tnsu.ApprovalRoute.Infrastructure.TnsuPortal;
 
 namespace Tnsu.ApprovalRoute.Application.Reminders;
 
@@ -22,6 +23,8 @@ public sealed class ReminderService(
     ApprovalRouteDbContext db,
     ISharePointClient sharePoint,
     ListPartitionRegistry partitionRegistry,
+    ITnsuPortalClient portalClient,
+    TimeProvider timeProvider,
     IOptions<RemindersOptions> options,
     ILogger<ReminderService> logger)
 {
@@ -30,6 +33,32 @@ public sealed class ReminderService(
     private const string ActiveStatusFilter =
         $"$filter=ApprovalStatus eq '{ApprovalStatuses.OnApproval}' or ApprovalStatus eq '{ApprovalStatuses.OnExecution}'";
 
+    /// <summary>
+    /// Оверлоад без feed — для обратной совместимости со старыми вызовами: раньше
+    /// это был единственный вид напоминаний, и без явного выбора им и остаётся.
+    /// </summary>
+    public Task<Result<IReadOnlyList<ReminderDto>>> GetRemindersAsync(CancellationToken cancellationToken) =>
+        GetRemindersAsync(ReminderFeed.ApprovalOverdue, cancellationToken);
+
+    /// <summary>
+    /// То, что реально отдаёт контроллер — один вид напоминаний по выбору вызывающей
+    /// стороны. Момент «сейчас» берётся здесь же, из <see cref="TimeProvider"/>, а не
+    /// пробрасывается вызывающей стороной — во всех проде это <c>TimeProvider.System</c>
+    /// (см. Program.cs), в тестах подменяется, а нижестоящие GetOverdueAsync/
+    /// GetProbationEndingAsync по-прежнему принимают <c>now</c> явным параметром: так
+    /// их сценарии остаются детерминированными без своего TimeProvider на каждый тест.
+    /// </summary>
+    public Task<Result<IReadOnlyList<ReminderDto>>> GetRemindersAsync(
+        ReminderFeed feed, CancellationToken cancellationToken)
+    {
+        var now = timeProvider.GetUtcNow();
+        return feed switch
+        {
+            ReminderFeed.ProbationEnding => GetProbationEndingAsync(now, cancellationToken),
+            _ => GetOverdueAsync(now, cancellationToken),
+        };
+    }
+
     public async Task<Result<IReadOnlyList<ReminderDto>>> GetOverdueAsync(
         DateTimeOffset now, CancellationToken cancellationToken)
     {
@@ -176,9 +205,17 @@ public sealed class ReminderService(
                 // ДО появления колонки (см. ApprovalRow) или если request-portal
                 // почему-то не проставил её при активации. Без даты старта SLA не
                 // от чего отсчитывать — пропускаем, а не подставляем сейчас.
+                //
+                // RequestTypeId — всегда, чтобы искать TicketId в правильном типе
+                // заявок. RequestUniqueCode — то, по чему заявку реально ищут в
+                // портале, добавляется, только если он уже есть (строка данных
+                // могла ещё не появиться или заявка старше появления колонки).
+                var identifier = uniqueCodes.GetValueOrDefault(row.TicketId) is { Length: > 0 } code
+                    ? $"requestTypeId={type.Id}, code={code}"
+                    : $"requestTypeId={type.Id}";
                 logger.LogWarning(
-                    "Строка {Row} заявки {Ticket} активна, но дата активации (Date) не заполнена — пропущена",
-                    row.Id, row.TicketId);
+                    "Строка {Row} заявки {Ticket} ({Identifier}) активна, но дата активации (Date) не заполнена — пропущена",
+                    row.Id, row.TicketId, identifier);
                 continue;
             }
 
@@ -188,16 +225,17 @@ public sealed class ReminderService(
             var deadline = activatedAt.AddHours(slaHours);
             if (deadline >= now) continue;
 
-            reminders.Add(new ReminderDto(
+            reminders.Add(new ApprovalOverdueReminderDto(
                 row.ApproverEmail!,
                 (int)Math.Floor((now - deadline).TotalHours),
-                BuildUrl(type, row, listId),
                 row.AskOverdueReason ?? type.AskOverdueReason ?? false,
                 type.Id,
                 type.Name,
                 row.TicketId,
                 row.Status,
-                uniqueCodes.GetValueOrDefault(row.TicketId)));
+                uniqueCodes.GetValueOrDefault(row.TicketId),
+                BuildUrl(type, row, listId),
+                row.ApproverName));
         }
 
         return reminders;
@@ -234,7 +272,7 @@ public sealed class ReminderService(
 
     private const string RowSelect =
         "$select=Id,ApprovalStatus,Phase,Date,SLAhours,AskOverdueReason,TicketId," +
-        "TansuSiteApprover/EMail&$expand=TansuSiteApprover&$top=5000";
+        "TansuSiteApprover/EMail,TansuSiteApprover/Title&$expand=TansuSiteApprover&$top=5000";
 
     private async Task<IReadOnlyList<ApprovalRow>> ReadRowsAsync(
         string siteUrl, string listTitle, string filter, CancellationToken cancellationToken)
@@ -273,4 +311,190 @@ public sealed class ReminderService(
 
         return result;
     }
+
+    /// <summary>
+    /// Часовой пояс, в котором считаются КАЛЕНДАРНЫЕ даты испытательного срока.
+    ///
+    /// Нужен потому, что портал пишет дату приёма как местную полночь, переведённую
+    /// в UTC: в списке она лежит как 19:00Z ПРЕДЫДУЩЕГО дня. Сравнивая по UTC-датам,
+    /// сервис видел бы дату приёма на сутки раньше той, что видит кадровик в
+    /// портале, и напоминание уходило бы на день раньше срока.
+    ///
+    /// Константой, а не настройкой: смещение фиксировано для всей организации и не
+    /// меняется от окружения (перехода на летнее время нет).
+    /// </summary>
+    private static readonly TimeSpan LocalOffset = TimeSpan.FromHours(6);
+
+    private static readonly IReadOnlyDictionary<string, int> ProbationMonthsByOption =
+        new Dictionary<string, int>
+        {
+            ["1 месяц"] = 1,
+            ["2 месяца"] = 2,
+            ["3 месяца"] = 3,
+            ["6 месяцев"] = 6,
+        };
+
+    /// <summary>
+    /// Кому скоро выходить из испытательного срока — по заявкам «Заявка на приём»
+    /// (recruiting-hire). В отличие от <see cref="GetOverdueAsync"/> НЕ завязано на
+    /// SlaHours типа заявки: это отдельный вид напоминаний со своим триггером
+    /// (дата приёма + испытательный срок), а не просрочка шага согласования.
+    /// </summary>
+    public async Task<Result<IReadOnlyList<ReminderDto>>> GetProbationEndingAsync(
+        DateTimeOffset now, CancellationToken cancellationToken)
+    {
+        var type = await db.RequestTypes.AsNoTracking()
+            .FirstOrDefaultAsync(
+                x => x.PageUrl == options.Value.RecruitingHirePageUrl && x.ListId != null && x.SiteUrl != null,
+                cancellationToken);
+
+        if (type is null) return Result.Ok<IReadOnlyList<ReminderDto>>([]);
+
+        var archived = await partitionRegistry.GetArchivedAsync(type, cancellationToken);
+        var current = await partitionRegistry.BuildCurrentAsync(type, archived, cancellationToken);
+
+        // Испытательный срок — не больше 6 месяцев (см. ProbationMonthsByOption),
+        // поэтому заявка, способная дать напоминание сегодня, обязана лежать в
+        // текущей партиции или в партиции прямо перед ней: более старая партиция
+        // физически не может содержать ещё актуальный испытательный срок. Читать
+        // весь архив, как это делает GetOverdueAsync (там заявка может висеть
+        // непринятой годами), здесь незачем — только лишняя нагрузка на SharePoint.
+        var lastArchived = archived.OrderByDescending(x => x.Number).FirstOrDefault();
+        var partitions = new List<(string ListId, int Number)> { (current.ListId, current.Number) };
+        if (lastArchived is not null) partitions.Add((lastArchived.ListId, lastArchived.Number));
+
+        // Обе базы сотрудников читаются по одному разу на весь обход партиций (а не
+        // на каждого кандидата): точечного поиска по ФИО в api.tnsu.kz нет, а нужны
+        // сразу и дата увольнения (только в FullBase), и email (только в All).
+        var directory = new EmployeeDirectorySnapshot(
+            await portalClient.GetFullBaseAsync(cancellationToken),
+            await portalClient.GetAllEmployeesAsync(cancellationToken));
+
+        var reminders = new List<ReminderDto>();
+        foreach (var (listId, number) in partitions)
+        {
+            try
+            {
+                reminders.AddRange(
+                    await GetProbationEndingForPartitionAsync(type, listId, directory, now, cancellationToken));
+            }
+            catch (Exception e)
+            {
+                logger.LogError(
+                    e, "Напоминания об испытательном сроке по списку {ListId} (партиция №{Number}) не собраны",
+                    listId, number);
+            }
+        }
+
+        return Result.Ok<IReadOnlyList<ReminderDto>>(reminders);
+    }
+
+    private const string HireRowSelect =
+        "$select=Id,RequestStatus,CandidateName,HireDate,ProbationPeriod,RequestUniqueCode&$top=5000";
+
+    private async Task<IReadOnlyList<ReminderDto>> GetProbationEndingForPartitionAsync(
+        RequestType type, string listId, EmployeeDirectorySnapshot directory,
+        DateTimeOffset now, CancellationToken cancellationToken)
+    {
+        var siteUrl = type.SiteUrl!;
+
+        var dataListTitle = await sharePoint.GetListTitleAsync(siteUrl, listId, cancellationToken);
+        if (string.IsNullOrWhiteSpace(dataListTitle)) return [];
+
+        // HireDate не старше 6 месяцев — тот же смысл, что и ограничение на две
+        // последних партиции (см. GetProbationEndingAsync): более старый приём уже
+        // не может дать напоминание, читать его строки незачем даже в пределах
+        // партиции, где они могут лежать вперемешку со свежими.
+        var since = now.AddMonths(-6);
+        var filter =
+            $"$filter=(RequestStatus eq '{HireRequestStatuses.Approved}' or RequestStatus eq '{HireRequestStatuses.Closed}')" +
+            $" and HireDate ge datetime'{since:yyyy-MM-ddTHH:mm:ssZ}'";
+        var items = await sharePoint.GetItemsByListTitleAsync(
+            siteUrl, dataListTitle, $"{HireRowSelect}&{filter}", cancellationToken);
+        var rows = items.Select(HireRow.TryParse).Where(r => r is not null).Select(r => r!).ToList();
+
+        var reminders = new List<ReminderDto>();
+        foreach (var row in rows)
+        {
+            var reminder = await TryBuildProbationReminderAsync(row, directory, now, cancellationToken);
+            if (reminder is not null) reminders.Add(reminder);
+        }
+
+        return reminders;
+    }
+
+    /// <summary>
+    /// Ни type, ни listId здесь больше не нужны: ссылка в этом виде напоминаний —
+    /// константа из настроек (см. ProbationReminderUrl), а поля самой заявки
+    /// (RequestTypeId и т.п.) в ProbationEndingReminderDto не входят.
+    /// </summary>
+    private async Task<ReminderDto?> TryBuildProbationReminderAsync(
+        HireRow row, EmployeeDirectorySnapshot directory,
+        DateTimeOffset now, CancellationToken cancellationToken)
+    {
+        if (string.IsNullOrWhiteSpace(row.CandidateName) || row.HireDate is not { } hireDate) return null;
+
+        if (!ProbationMonthsByOption.TryGetValue(row.ProbationPeriod ?? string.Empty, out var months))
+            return null; // "Без испытательного срока", пусто или значение вне справочника — отсчитывать нечего.
+
+        // Обе даты — в местном поясе (см. LocalOffset): и дату приёма, и «сегодня»
+        // надо брать по тому же календарю, который видит человек в портале.
+        var hireDateLocal = hireDate.ToOffset(LocalOffset);
+        var probationEndsAt = hireDateLocal.AddMonths(months);
+        var daysLeft = (probationEndsAt.Date - now.ToOffset(LocalOffset).Date).Days;
+        if (daysLeft != options.Value.ProbationReminderDaysBeforeEnd) return null;
+
+        var candidateName = row.CandidateName.Trim();
+
+        // Перечислены оба «продолжающих» исхода явно, а «пропустить» — это default:
+        // так любое НЕ подтверждённое трудоустройство (в том числе EmploymentStatus.None,
+        // если он когда-нибудь сюда доедет) приводит к пропуску с предупреждением, а не
+        // молча считается «работает».
+        switch (directory.EmploymentOf(candidateName))
+        {
+            case EmploymentStatus.Employed:
+                break;
+            case EmploymentStatus.Dismissed:
+                return null; // уже уволен — напоминать не о чем.
+            default:
+                logger.LogWarning(
+                    "Заявка на приём {RequestId}: кандидат «{Fio}» не найден в /Employee/FullBase — статус трудоустройства не подтверждён, напоминание пропущено",
+                    row.Id, candidateName);
+                return null;
+        }
+
+        var candidateEmail = directory.EmailOf(candidateName);
+        if (string.IsNullOrWhiteSpace(candidateEmail))
+        {
+            logger.LogWarning(
+                "Заявка на приём {RequestId}: у кандидата «{Fio}» не найден email в справочнике — напоминание пропущено",
+                row.Id, candidateName);
+            return null;
+        }
+
+        var managerEmail = await portalClient.GetManagerAsync(candidateEmail, "chief", cancellationToken);
+        if (string.IsNullOrWhiteSpace(managerEmail))
+        {
+            logger.LogWarning(
+                "Заявка на приём {RequestId}: у кандидата «{Fio}» не найден руководитель — напоминание пропущено",
+                row.Id, candidateName);
+            return null;
+        }
+
+        return new ProbationEndingReminderDto(
+            ReceiverEmail: managerEmail,
+            CandidateEmail: candidateEmail,
+            CandidateName: candidateName,
+            ProbationPeriod: row.ProbationPeriod,
+            // Тоже в местном поясе — иначе в письме дата приёма была бы на сутки
+            // раньше той, от которой посчитан ProbationEndsAt рядом.
+            HireDate: hireDateLocal,
+            ProbationEndsAt: probationEndsAt,
+            DaysUntilProbationEnds: daysLeft,
+            // Не ссылка на саму заявку на приём (она уже закрыта, решать по ней
+            // нечего) — константный адрес раздела, где руководитель заводит новую
+            // заявку по итогам испытательного срока. См. ProbationReminderUrl.
+            Url: options.Value.ProbationReminderUrl,
+            ReceiverName: directory.NameByEmail(managerEmail));
+    }
 }