the-biergarten-app/web/backend/Domain/Domain.Entities/Entities/UserAccount.cs

namespace Domain.Entities;

/// <summary>
///     Represents a registered user of the application. Maps to the <c>UserAccount</c> table, the root entity
///     referenced by <see cref="UserCredential" />, <see cref="UserVerification" />, brewery posts, and other user-owned
///     data.
/// </summary>
public class UserAccount
{
   /// <summary>
   ///     Primary key identifying this user account. Maps to <c>UserAccountID</c>.
   /// </summary>
   public Guid UserAccountId { get; set; }

   /// <summary>
   ///     The user's unique username, used for login and display. Enforced unique at the database level.
   /// </summary>
   public string Username { get; set; } = string.Empty;

   /// <summary>
   ///     The user's first name.
   /// </summary>
   public string FirstName { get; set; } = string.Empty;

   /// <summary>
   ///     The user's last name.
   /// </summary>
   public string LastName { get; set; } = string.Empty;

   /// <summary>
   ///     The user's email address. Enforced unique at the database level.
   /// </summary>
   public string Email { get; set; } = string.Empty;

   /// <summary>
   ///     The date and time the account was created.
   /// </summary>
   public DateTime CreatedAt { get; set; }

   /// <summary>
   ///     The date and time the account was last updated, or <c>null</c> if it has never been updated.
   /// </summary>
   public DateTime? UpdatedAt { get; set; }

   /// <summary>
   ///     The user's date of birth.
   /// </summary>
   public DateTime DateOfBirth { get; set; }

   /// <summary>
   ///     SQL Server <c>ROWVERSION</c> concurrency token used to detect concurrent updates. <c>null</c> until the row has
   ///     been read from the database.
   /// </summary>
   public byte[]? Timer { get; set; }
}