namespace GB5Shared.Deployment
{
    /// <summary>
    /// Process-wide deployment tier. Bound once at startup from GB5:Environment and never
    /// re-read per request — this is static process configuration, same lifetime class as
    /// VaultOptions, not per-request state like LoginDTO (never register LoginDTO itself as
    /// a singleton; this interface only ever hands back plain strings/enum values).
    /// </summary>
    public interface IGB5Environment
    {
        /// <summary>Which tier this process is running as.</summary>
        GB5Tier Tier { get; }

        /// <summary>True only when <see cref="Tier"/> is <see cref="GB5Tier.Live"/>.</summary>
        bool IsLive { get; }

        /// <summary>"Dev" | "QC" | "Live" — matches GB5Tier's own name.</summary>
        string TierCode { get; }

        /// <summary>
        /// Applies this tier's MSERVERCONFIG.CONNECTIONNAME suffix convention. Live
        /// intentionally maps to the base name UNCHANGED — every already-deployed Live
        /// CONNECTIONNAME (EntitlementDb, DXPDb, ...) keeps working with no MSERVERCONFIG
        /// change; only Dev/QC need new, additively-registered rows.
        /// </summary>
        string Resolve(string baseConnectionName);

        /// <summary>
        /// GOP's own historical free-text environment code. Live intentionally still
        /// resolves to "PROD" — that's the pre-existing MGOPSOURCEBINDING/MGOPFLOWSNAPSHOT
        /// column default, and changing it would orphan every row seeded before this
        /// abstraction existed.
        /// </summary>
        string GopEnvironmentCode { get; }
    }
}