chore: add documentation comments and stylecop rules

src/Api/TakeoutSaaS.UserApi/Program.cs

@@ -12,9 +12,11 @@ using TakeoutSaaS.Shared.Kernel.Ids;
 using TakeoutSaaS.Shared.Web.Extensions;
 using TakeoutSaaS.Shared.Web.Swagger;
 
+// 1. 创建构建器与日志模板
 var builder = WebApplication.CreateBuilder(args);
 const string logTemplate = "[{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} {Level:u3}] [TraceId:{TraceId}] [SpanId:{SpanId}] [Service:{Service}] {SourceContext} {Message:lj}{NewLine}{Exception}";
 
+// 2. 注册雪花 ID 生成器与 Serilog
 builder.Services.AddSingleton<IIdGenerator>(_ => new SnowflakeIdGenerator());
 builder.Host.UseSerilog((_, _, configuration) =>
 {
@@ -30,6 +32,7 @@ builder.Host.UseSerilog((_, _, configuration) =>
             outputTemplate: logTemplate);
 });
 
+// 3. 注册通用 Web 能力与 Swagger
 builder.Services.AddSharedWebCore();
 builder.Services.AddSharedSwagger(options =>
 {
@@ -37,8 +40,12 @@ builder.Services.AddSharedSwagger(options =>
     options.Description = "C 端用户 API 文档";
     options.EnableAuthorization = true;
 });
+
+// 4. 注册多租户与健康检查
 builder.Services.AddTenantResolution(builder.Configuration);
 builder.Services.AddHealthChecks();
+
+// 5. 配置 OpenTelemetry 采集
 var otelSection = builder.Configuration.GetSection("Otel");
 var otelEndpoint = otelSection.GetValue<string>("Endpoint");
 var useConsoleExporter = otelSection.GetValue<bool?>("UseConsoleExporter") ?? builder.Environment.IsDevelopment();
@@ -90,6 +97,7 @@ builder.Services.AddOpenTelemetry()
         }
     });
 
+// 6. 配置 CORS
 var userOrigins = ResolveCorsOrigins(builder.Configuration, "Cors:User");
 builder.Services.AddCors(options =>
 {
@@ -99,6 +107,7 @@ builder.Services.AddCors(options =>
     });
 });
 
+// 7. 构建应用并配置中间件管道
 var app = builder.Build();
 
 app.UseCors("UserApiCors");
@@ -111,6 +120,7 @@ app.MapPrometheusScrapingEndpoint();
 app.MapControllers();
 app.Run();
 
+// 8. 解析配置中的 CORS 域名
 static string[] ResolveCorsOrigins(IConfiguration configuration, string sectionKey)
 {
     var origins = configuration.GetSection(sectionKey).Get<string[]>();
@@ -120,6 +130,7 @@ static string[] ResolveCorsOrigins(IConfiguration configuration, string sectionK
         .ToArray() ?? [];
 }
 
+// 9. 构建 CORS 策略
 static void ConfigureCorsPolicy(CorsPolicyBuilder policy, string[] origins)
 {
     if (origins.Length == 0)