using System;
using System.Collections.Generic;

namespace ManagerService.DTOs
{
    /// <summary>
    /// Le contenu complet d'une configuration, en un seul appel — le <b>contrat public</b>
    /// entre le back-office et tout ce qui affiche une visite.
    ///
    /// Trois consommateurs, et c'est ce qui en fait un contrat plutôt qu'un DTO interne :
    /// la visite hors ligne de <c>mymuseum-visitapp</c>, l'import/export du back-office,
    /// et l'app Unity du canal VR — qui n'a pas de client généré et lit ce JSON tel quel.
    ///
    /// <b>Règles de compatibilité</b>, à tenir tant que le numéro ne change pas :
    /// <list type="bullet">
    ///   <item>on <b>ajoute</b> des champs, on n'en retire ni n'en renomme aucun ;</item>
    ///   <item>les valeurs d'enum s'ajoutent <b>en fin</b> — elles sont persistées en int
    ///         et un client plus ancien doit pouvoir ignorer ce qu'il ne connaît pas ;</item>
    ///   <item>un champ absent vaut « pas de valeur », jamais « valeur par défaut »
    ///         différente de celle du client.</item>
    /// </list>
    ///
    /// Documentation complète : <c>DOCS/export-contract.md</c>.
    /// </summary>
    public class ExportConfigurationDTO : ConfigurationDTO
    {
        /// <summary>
        /// Version du <b>format</b>, pas du contenu. Un client qui lit un numéro plus
        /// grand que celui qu'il connaît doit le dire à l'utilisateur plutôt que de
        /// deviner — c'est exactement ce que fait <c>ManifestReader</c> côté casque.
        /// </summary>
        public int exportVersion { get; set; } = CurrentExportVersion;

        /// <summary>Quand ce JSON a été produit. Sert au diagnostic d'un cache périmé.</summary>
        public DateTime generatedAt { get; set; }

        public List<SectionDTO> sections { get; set; }
        public List<ResourceDTO> resources { get; set; }

        /// <summary>
        /// <b>1</b> — version initiale, figée le 2026-09-12. L'export existait avant, sans
        /// numéro : un client qui n'en trouve pas lit un export antérieur à cette date, et
        /// doit le traiter comme la version 1.
        /// </summary>
        public const int CurrentExportVersion = 1;
    }
}