add xmldoc comments

web/backend/Domain/Domain.Entities/Entities/UserAccount.cs

@@ -1,14 +1,53 @@
 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; }
 }