Refactor comments and update documentation for backend and pipeline (#246)

* Remove restating comments in backend

* Remove restating comments in frontend stories

* Remove restating comments in pipeline

* Remove restating comments in pipeline scripts

* Restore location-clear comment in BreweryRepository

* Remove stale/restating comments found in second pass

* Restore mock curated-data branch comment in main.cc

* Remove more restating/filler comments in backend

* Document account-management endpoints, compose files, and env generator

* Squashed commit of the following:

commit a8a5b8abd9969859c695092fae6990d03b2135ed
Author: Aaron Po <aaron.po97@gmail.com>
Date:   Sun Aug 23 23:53:56 2026 -0400

    Add reverse geocoding for brewery street addresses (#245)

    * Add geocoding to seed application, remove postal codes from generator

    Update comments

* Update pipeline class diagram for OpenAI generator

* Update pipeline activity diagram for brewery coordinates and OpenAI backend

* Add mailpit, production, db-only, and minimal environments to deployment diagram

* Fix authentication flow diagram for Identity migration

* Add account-management flows to authentication diagram

* Fix database schema diagram note referencing removed AuthRepository

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

@@ -93,14 +93,12 @@ public class SmtpEmailProvider : IEmailProvider
 
         try
         {
-            // Determine the SecureSocketOptions based on SSL setting
             SecureSocketOptions secureSocketOptions = _useSsl
                 ? SecureSocketOptions.StartTls
                 : SecureSocketOptions.None;
 
             await client.ConnectAsync(_host, _port, secureSocketOptions);
 
-            // Authenticate if credentials are provided
             if (!string.IsNullOrEmpty(_username) && !string.IsNullOrEmpty(_password))
                 await client.AuthenticateAsync(_username, _password);
 

web/backend/Infrastructure/Infrastructure.Jwt/ITokenInfrastructure.cs

@@ -12,9 +12,6 @@ public interface ITokenInfrastructure
     /// </summary>
     string GenerateJwt(Guid userId, string username, DateTime expiry, string secret);
 
-    /// <summary>
-    ///     Validates a JWT and returns the resulting claims principal.
-    /// </summary>
     /// <exception cref="Domain.Exceptions.UnauthorizedException">Thrown when the token is invalid, expired, or fails validation.</exception>
     Task<ClaimsPrincipal> ValidateJwtAsync(string token, string secret);
 }

web/backend/Infrastructure/Infrastructure.Sql/DefaultSqlConnectionFactory.cs

@@ -26,7 +26,6 @@ public class DefaultSqlConnectionFactory(IConfiguration configuration) : ISqlCon
     /// <exception cref="InvalidOperationException">Thrown when no connection string can be resolved from any source.</exception>
     private static string GetConnectionString(IConfiguration configuration)
     {
-        // Check for full connection string first
         string? fullConnectionString = configuration["DB_CONNECTION_STRING"];
         if (!string.IsNullOrEmpty(fullConnectionString))
             return fullConnectionString;

web/backend/Infrastructure/Infrastructure.Sql/SqlConnectionStringHelper.cs

@@ -38,9 +38,6 @@ public static class SqlConnectionStringHelper
         return builder.ConnectionString;
     }
 
-    /// <summary>
-    ///     Builds a connection string to the master database using configuration.
-    /// </summary>
     public static string BuildMasterConnectionString(IConfiguration configuration)
     {
         return BuildConnectionString(configuration, "master");