namespace Flaro.Core.Users;

/// <summary>Ein Benutzerkonto.</summary>
///
/// <remarks>
/// Mehrbenutzer von Anfang an — auch wenn der erste Server nur einen hat.
/// Fortschritt und Gesehen-Status je Benutzer nachträglich einzuziehen wäre
/// ein Umbau am Datenmodell und an jeder Abfrage darauf, kein Zusatz.
/// </remarks>
public sealed class User
{
    /// <summary>Zeitlich geordnet, damit der Index nicht zerfasert.</summary>
    public Guid Id { get; init; } = Guid.CreateVersion7();

    public required string UserName { get; set; }

    /// <summary>Im PHC-Format, siehe <see cref="PasswordHasher"/>.</summary>
    public required string PasswordHash { get; set; }

    public bool IsAdministrator { get; set; }

    /// <summary>Dem Besitzer kann niemand das Adminrecht nehmen.</summary>
    ///
    /// <remarks>
    /// <para>
    /// <b>Damit sich ein Server nicht selbst aussperren kann.</b> Sobald
    /// Administratoren einander das Recht entziehen können, gibt es einen
    /// Zustand ohne jeden Administrator — und aus dem führt kein Weg zurück
    /// ausser dem an der Datenbank. Ein Konto, das ausgenommen ist, schliesst
    /// diesen Zustand aus.
    /// </para>
    /// <para>
    /// <b>Es ist das erste Konto</b>, also das, mit dem der Server
    /// eingerichtet wurde. Übertragen lässt es sich — an einen anderen
    /// Administrator, und nur vom Besitzer selbst.
    /// </para>
    /// </remarks>
    public bool IsOwner { get; set; }

    /// <summary>Die bevorzugte Sprache — <c>null</c> heisst: die des Servers.</summary>
    ///
    /// <remarks>
    /// <b>Und sie ist nicht kostenlos.</b> Metadaten werden in der Sprache des
    /// Servers geholt und gespeichert. Wer eine andere wählt, bekommt, was in
    /// der Übersetzungstabelle liegt — und für den Rest die Serversprache.
    /// Darauf wird beim Umstellen deutlich hingewiesen; es stillschweigend
    /// halb zu übersetzen wäre schlechter als gar nicht.
    /// </remarks>
    public string? Language { get; set; }

    /// <summary>Das eigene Bild — der Schlüssel aus derselben Ablage wie Plakate.</summary>
    ///
    /// <remarks>
    /// <b>Kein eigener Speicher für Profilbilder.</b> Es ist ein Bild wie
    /// jedes andere: derselbe Ordner, dieselbe Adresse, derselbe
    /// Zwischenspeicher im Browser. Ein zweiter Weg hiesse ein zweites Mal
    /// Pfadprüfung, Grössengrenze und Aufräumen — dreimal dieselbe Arbeit für
    /// ein Bild von 200 Pixeln.
    ///
    /// <c>null</c> heisst: der Buchstabenkreis. Der ist keine Notlösung,
    /// sondern eine gültige Antwort — niemand muss ein Bild haben.
    /// </remarks>
    public string? AvatarImage { get; set; }

    public DateTimeOffset CreatedAt { get; init; } = DateTimeOffset.UtcNow;
}