using System;
using System.Collections.Generic;

namespace ManagerService.Data
{
    /// <summary>
    /// Une question posée au guide IA, et ce qu'il a répondu.
    /// Une ligne par tour de conversation — pas l'historique complet à chaque tour,
    /// sinon le tour 5 réécrirait les tours 1 à 4.
    ///
    /// ⚠️ RGPD : texte libre saisi par un visiteur, pouvant contenir des données
    /// personnelles voire sensibles (« je suis en fauteuil, c'est accessible ? »).
    /// Aucun identifiant nominatif — ConversationId est un GUID de session.
    /// Les questions brutes se purgent à 90 jours, les agrégats survivent.
    /// </summary>
    public class VisitorQuestion
    {
        public long Id { get; set; }

        /// <summary>GUID de session généré par le front, stable sur une conversation. Seul lien entre deux tours.</summary>
        public string ConversationId { get; set; }

        public string InstanceId { get; set; }

        /// <summary>Null = question posée hors d'une visite (scope instance).</summary>
        public string ConfigurationId { get; set; }

        public AppType AppType { get; set; }

        public bool IsVoice { get; set; }

        public string Language { get; set; }

        public string Question { get; set; }

        public string Reply { get; set; }

        public long TokensUsed { get; set; }

        /// <summary>Faux = le guide n'a rien trouvé. C'est la colonne qui produit le rapport de trous de contenu.</summary>
        public bool HasAnswer { get; set; }

        /// <summary>Meilleur score de similarité du retrieval. 0 tant que le RAG n'est pas branché.</summary>
        public double TopScore { get; set; }

        /// <summary>Contenus cités dans la réponse (Section.Id / Resource.Id).</summary>
        public List<string> CitedContentIds { get; set; }

        /// <summary>Rempli a posteriori par le job de regroupement, null jusque-là.</summary>
        public string ThemeId { get; set; }

        public DateTime CreatedAt { get; set; }
    }
}