using Deal.Modules.Cards.Application.Abstractions;

namespace Deal.Modules.Cards.Application.Models;

/// <summary>
/// Контекст перехода карточки: кто инициировал и что делать с обучением.
/// </summary>
/// <remarks>Переход — единый механизм (<see cref="ICardMover"/>); контекст отличает действие пользователя
/// (обучать ML), системы (автоархив/очистка) и ИИ/ML (классификация). Reason — для возвратов из отсева
/// и ручных исключений, чтобы ML/ИИ учились на решении.</remarks>
public sealed record TransitionContext
{
    /// <summary>
    /// Инициатор перехода: <c>user</c>|<c>system</c>|<c>ai</c>|<c>ml</c>.
    /// </summary>
    public required string Actor { get; init; }

    /// <summary>
    /// Причина (возврат из отсева, ручная отмена); null — нет.
    /// </summary>
    public string? Reason { get; init; }

    /// <summary>
    /// Обучать ML на этом действии (действия пользователя — да; системные — нет).
    /// </summary>
    public bool Learn { get; init; }
}