namespace Flaro.Api;

/// <summary>Welche Version läuft — und welcher Build genau.</summary>
///
/// <remarks>
/// <para>
/// <b>Warum zwei Angaben.</b> Die Version sagt, welcher Stand gemeint ist;
/// sie steht fest und ändert sich nur von Hand. Der Build sagt, welches
/// Abbild tatsächlich läuft, und ändert sich bei <i>jedem</i> Bau — auch
/// dann, wenn am Quelltext nichts anders ist.
/// </para>
/// <para>
/// <b>Und warum das nötig wurde.</b> Es hat einen halben Tag gekostet: zwei
/// Funktionen waren nachweislich im Quelltext und auf dem Server trotzdem
/// nicht zu sehen. Ob dort ein älteres Abbild lief, liess sich nicht
/// feststellen — der Server sagte es nirgends. Jede Fehlersuche lief damit
/// ins Leere, weil die erste Frage unbeantwortbar war: reden wir vom selben
/// Build?
/// </para>
/// <para>
/// <b>Sechs Zeichen, Grossbuchstaben und Ziffern.</b> Kurz genug, um sie
/// vorzulesen und abzutippen, lang genug, um nicht zufällig zweimal
/// vorzukommen. Ohne <c>I</c>, <c>O</c>, <c>0</c> und <c>1</c>, weil die
/// beim Vorlesen verwechselt werden.
/// </para>
/// </remarks>
public static class Buildkennung
{
    /// <summary>Die feste Version. Steigt nur, wenn jemand sie hier ändert.</summary>
    public const string Version = "1.0.0";

    /// <summary>Die Kennung dieses Abbilds — oder <c>DEV</c> ausserhalb eines Containers.</summary>
    ///
    /// <remarks>
    /// Gesetzt wird sie beim Bau des Abbilds über <c>FLARO_BUILD</c>. Fehlt
    /// sie, läuft der Server aus dem Quellbaum: dann ist <c>DEV</c> die
    /// ehrlichere Angabe als eine erfundene Kennung, die nichts bezeichnet.
    /// </remarks>
    public static string Build { get; } =
        Environment.GetEnvironmentVariable("FLARO_BUILD") is { Length: > 0 } wert
            ? wert.Trim()
            : "DEV";

    /// <summary>„1.0.0 · K7F2QX" — für Protokoll und Anzeige.</summary>
    public static string Beides => $"{Version} · {Build}";
}