Migrate Auth/Brewery/Location repositories to pure Dapper; rename Timer to RowVersion (#237)

* Integrate Spectre.Console into seed application, use async data loading

* Replace stored-procedure repositories with Dapper-based repositories

Removes the USP_* stored procedures for Auth, Location, and Brewery
data access in favour of services built with Dapper.

Adds a new Features.Locations slice and optimistic concurrency support
for the Brewery slice.

* Add new documentation for Dapper migration/database schema

* Update FluentAssertions to most recent open source ver

* Update XML doc comment in backend projects

* Modify brewery location dto to include denormalized data

* - Updated column names from 'Timer' to 'RowVersion' in schema.sql for
- Introduced new BeerPost entity and updated BreweryPost and BreweryPostLocation entities to use 'RowVersion' for concurrency.
- Modified UserAccount, UserCredential, UserVerification, City, StateProvince, and Country entities to use 'RowVersion' instead of 'Timer'.
- Updated tests and command handlers to reflect changes in concurrency token from 'Timer' to 'RowVersion'.
- Adjusted BreweryDto and BreweryDtoMapper to include 'RowVersion' and updated mapping logic accordingly.
- Ensured all repository methods and interfaces are aligned with the new concurrency handling approach.

* updates

* Add BeerStyle entity and related properties; refactor BreweryDto to remove BeerPosts

* Fix Api.Specs test failures: stale Timer column refs and missing test.user fixture

* Remove repository tests, usages of registration dto used in repo

* archive old stored procs/functions

* update stale docs

* Add instructions for generating cryptographically secure base64 secrets on macOS/Linux and Windows

web/backend/Infrastructure/Infrastructure.Email/IEmailProvider.cs

@@ -1,11 +1,21 @@
 namespace Infrastructure.Email;
 
 /// <summary>
-///     Service for sending emails via SMTP.
+///     Service for sending emails.
 /// </summary>
 public interface IEmailProvider
 {
+    /// <summary>Sends an email to a single recipient.</summary>
+    /// <param name="to">The recipient's email address.</param>
+    /// <param name="subject">The email subject line.</param>
+    /// <param name="body">The email body content.</param>
+    /// <param name="isHtml">Whether <paramref name="body"/> is HTML; when <see langword="false"/> it is sent as plain text.</param>
     Task SendAsync(string to, string subject, string body, bool isHtml = true);
 
+    /// <summary>Sends an email to multiple recipients.</summary>
+    /// <param name="to">The recipients' email addresses.</param>
+    /// <param name="subject">The email subject line.</param>
+    /// <param name="body">The email body content.</param>
+    /// <param name="isHtml">Whether <paramref name="body"/> is HTML; when <see langword="false"/> it is sent as plain text.</param>
     Task SendAsync(IEnumerable<string> to, string subject, string body, bool isHtml = true);
 }

web/backend/Infrastructure/Infrastructure.Email/SmtpEmailProvider.cs

@@ -51,15 +51,17 @@ public class SmtpEmailProvider : IEmailProvider
         _fromName = Environment.GetEnvironmentVariable("SMTP_FROM_NAME") ?? "The Biergarten";
     }
 
+    /// <inheritdoc/>
     public async Task SendAsync(string to, string subject, string body, bool isHtml = true)
     {
         await SendAsync([to], subject, body, isHtml);
     }
 
-    /// <summary>
+    /// <inheritdoc/>
+    /// <remarks>
     ///     Connects using StartTls when SSL is enabled (or no encryption otherwise), authenticates
     ///     if credentials were configured, sends the message, and disconnects.
-    /// </summary>
+    /// </remarks>
     /// <exception cref="InvalidOperationException">
     ///     Thrown when connecting, authenticating, or sending via SMTP fails, wrapping the original exception.
     /// </exception>