namespace GerbilManagerWebAPI.Dtos
{
    /// <summary>FEEDBACK: payload for POST /feedback (the "Fehler melden" dialog).</summary>
    public record FeedbackInput(
        string Message,
        string Context,
        Guid? GerbilId,
        Guid? LitterId,
        Guid? ContactId,
        string? EntityName,
        string? Url,
        DateTimeOffset? ClientTimestamp);

    /// <summary>
    /// FEEDBACK: one past Q&A turn in the ticket's thread/history.
    /// Role is "maintainer" (Rückfrage) or "breeder" (Antwort).
    /// </summary>
    public record FeedbackThreadEntry(
        string Role,
        string Text,
        DateTimeOffset? At);

    /// <summary>FEEDBACK: response DTO for a stored report.</summary>
    public record FeedbackDto(
        Guid Id,
        string Message,
        string Context,
        Guid? GerbilId,
        Guid? LitterId,
        Guid? ContactId,
        string? EntityName,
        string? Url,
        DateTimeOffset? ClientTimestamp,
        string? UserAgent,
        DateTimeOffset CreatedAt,
        string Status,
        DateTimeOffset? ResolvedAt,
        string? Question,
        string? Answer,
        DateTimeOffset? AnsweredAt,
        /// <summary>Breeder-friendly changelog written on resolve (shown in the UI).</summary>
        string? FixNote,
        /// <summary>INTERNAL agent working memory — exposed for tooling, NEVER shown to the breeder.</summary>
        string? AgentContext,
        /// <summary>Earlier Q&A rounds, oldest first; the current open exchange stays in Question/Answer.</summary>
        IReadOnlyList<FeedbackThreadEntry> Thread,
        /// <summary>When a genuinely-resolved ticket (no pending Rückfrage) was reopened; else null.</summary>
        DateTimeOffset? ReopenedAt = null,
        /// <summary>Soft-delete marker: when the ticket was deleted via the UI (recoverable); else null.</summary>
        DateTimeOffset? DeletedAt = null,
        /// <summary>Optional AI-set category/topic for filtering (e.g. "Genetik", "Import"); null = none.</summary>
        string? Category = null,
        /// <summary>Was the resolution helpful? true=👍, false=👎, null=no feedback yet.</summary>
        bool? Helpful = null);

    /// <summary>
    /// FEEDBACK: payload for PUT /feedback/{id}. Edit the message and/or toggle status,
    /// attach a clarifying question (Rückfrage), submit the breeder's answer, set the
    /// breeder-friendly fix note (changelog), or update the internal agent context.
    /// </summary>
    public record FeedbackUpdate(
        string? Message,
        string? Status,
        string? Question,
        string? Answer,
        string? FixNote,
        string? AgentContext,
        /// <summary>Set/clear the ticket category. Empty/whitespace clears it.</summary>
        string? Category = null,
        /// <summary>👍/👎 on a resolved ticket. null leaves it unchanged.</summary>
        bool? Helpful = null);
}