namespace GB5Shared.Deployment
{
    /// <summary>
    /// The three deployment tiers a GB5 (or any GB5Shared-consuming) process can run as.
    /// Deliberately a single, narrow axis — which physical/logical box this process is —
    /// not conflated with SOURCETYPE (authorship tier: Framework/DevAdmin/ImpAdmin/Admin/User)
    /// or any future per-product axis. See Docs/SqlWorkbench-DB-Settings-Guide.md and the
    /// environment-tiering plan for the full rationale.
    /// </summary>
    public enum GB5Tier : byte
    {
        Dev = 1,
        QC = 2,
        Live = 3
    }

    /// <summary>
    /// Strongly typed configuration for the GB5 deployment-tier abstraction.
    /// Bound from the <c>"GB5"</c> configuration section. Every host that resolves a
    /// tier-suffixed connection name (Entitlement, DXP, Promotion) must set
    /// <c>GB5:Environment</c> explicitly — there is no safe implicit default in production,
    /// which is why <see cref="GB5EnvironmentServiceExtensions.AddGB5Environment"/> fails
    /// fast rather than silently assuming Dev.
    /// </summary>
    public class GB5EnvironmentOptions
    {
        public const string SectionName = "GB5";

        /// <summary>Which tier this process is running as: Dev, QC, or Live.</summary>
        public GB5Tier Environment { get; set; } = GB5Tier.Dev;
    }
}