tnsu-approval-route/backend/Tnsu.ApprovalRoute.Application/Reminders/ReminderDto.cs

using System.Text.Json.Serialization;

namespace Tnsu.ApprovalRoute.Application.Reminders;

/// <param name="ReceiverEmail">Email того, кому адресовано напоминание.</param>
/// <param name="ReceiverName">
/// ФИО получателя, если оно известно. Не всегда доступно (например, у согласующего
/// в старой строке списка без заполненного Title персонального поля) — тогда null.
/// </param>
/// <param name="Url">
/// Ссылка на заявку. Собирается здесь, в сервисе (а не на стороне потребителя),
/// потому что не константна: requestId и партиция списка (server-relative url,
/// параметр rplist) у каждой заявки свои, и сервис их всё равно уже знает —
/// дублировать эту логику снаружи незачем.
/// </param>
/// <remarks>
/// Общая часть двух видов напоминаний — <see cref="ApprovalOverdueReminderDto"/> и
/// <see cref="ProbationEndingReminderDto"/>. Категории заявки (RequestTypeId,
/// RequestId и т.п.) здесь нет: она нужна только просроченным шагам согласования
/// (Power Automate ссылается на неё, работая со списком согласования конкретного
/// типа заявки) и объявлена прямо в ApprovalOverdueReminderDto.
///
/// [JsonPolymorphic]/[JsonDerivedType] нужны, потому что ReminderService отдаёт
/// список именно базового типа (IReadOnlyList&lt;ReminderDto&gt;) — без этих
/// атрибутов System.Text.Json сериализовал бы только то, что объявлено здесь,
/// теряя специфичные для наследника поля. Дискриминатор — системное поле "$type"
/// со значением "ApprovalOverdue"/"ProbationEnding".
/// </remarks>
[JsonPolymorphic]
[JsonDerivedType(typeof(ApprovalOverdueReminderDto), "ApprovalOverdue")]
[JsonDerivedType(typeof(ProbationEndingReminderDto), "ProbationEnding")]
public abstract record ReminderDto(string ReceiverEmail, string? ReceiverName, string Url);