this commit introduces package references and reusable components across all ASP.NET projects

Author: https-richardy

Artifacts/Comanda.Internal.AspNet/Source/Comanda.Internal.AspNet.csproj

@@ -29,8 +29,16 @@
   </ItemGroup>
 
   <ItemGroup>
-    <!-- source link configuration for debugging -->
     <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
+    <PackageReference Include="FluentValidation.AspNetCore" Version="11.3.1" />
+    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.12" />
+    <PackageReference Include="Scalar.AspNetCore" Version="2.12.27" />
+    <PackageReference Include="Scalar.AspNetCore.Microsoft" Version="2.12.27" />
+    <PackageReference Include="Sentry.AspNetCore" Version="6.0.0" />
+    <PackageReference Include="Sentry.Serilog" Version="6.0.0" />
+    <PackageReference Include="Serilog.AspNetCore" Version="10.0.0" />
+    <PackageReference Include="Serilog.Sinks.Seq" Version="9.0.0" />
+    <PackageReference Include="HttpsRichardy.Federation.Sdk" Version="4.2.0" />
   </ItemGroup>
 
 </Project>

Artifacts/Comanda.Internal.AspNet/Source/Constants/Headers.cs

@@ -0,0 +1,12 @@
+namespace Comanda.Internal.AspNet.Constants;
+
+public static class Headers
+{
+    public const string Credential = "Credential";
+    public const string Location = "Location";
+    public const string Link = "Link";
+    public const string Pagination = "Pagination";
+    public const string Authorization = "Authorization";
+    public const string Idempotency = "Idempotency-Key";
+    public const string Correlation = "Correlation";
+}

Artifacts/Comanda.Internal.AspNet/Source/Constants/SecuritySchemes.cs

@@ -0,0 +1,8 @@
+namespace Comanda.Internal.AspNet.Constants;
+
+public static class SecuritySchemes
+{
+    public const string OAuth2 = "OAuth2";
+    public const string Bearer = "Bearer";
+}
+

Artifacts/Comanda.Internal.AspNet/Source/Interceptors/CorrelationInterceptor.cs

@@ -0,0 +1,17 @@
+namespace Comanda.Internal.AspNet.Interceptors;
+
+public sealed class CorrelationInterceptor(IHttpContextAccessor accessor) : DelegatingHandler
+{
+    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
+    {
+        var correlation = accessor.HttpContext?.Items[Headers.Correlation]?.ToString();
+
+        if (!string.IsNullOrWhiteSpace(correlation))
+        {
+            request.Headers.Remove(Headers.Correlation);
+            request.Headers.Add(Headers.Correlation, correlation);
+        }
+
+        return await base.SendAsync(request, cancellationToken);
+    }
+}

Artifacts/Comanda.Internal.AspNet/Source/Middlewares/CorrelationMiddleware.cs

@@ -0,0 +1,29 @@
+namespace Comanda.Internal.AspNet.Middlewares;
+
+public sealed class CorrelationMiddleware(RequestDelegate next)
+{
+    public async Task InvokeAsync(HttpContext context)
+    {
+        var correlationId = context.Request.Headers[Headers.Correlation].FirstOrDefault();
+
+        if (string.IsNullOrWhiteSpace(correlationId))
+            correlationId = context.TraceIdentifier;
+
+        context.Items[Headers.Correlation] = correlationId;
+        context.Response.Headers[Headers.Correlation] = correlationId;
+
+        /* enriches the logging scope with the current correlation identifier, ensuring all logs within this request pipeline share the same identifier */
+        /* more details: https://microsoft.github.io/code-with-engineering-playbook/observability/correlation-id/ */
+
+        using (LogContext.PushProperty(Headers.Correlation, correlationId))
+        using (SentrySdk.PushScope())
+        {
+            SentrySdk.ConfigureScope(scope =>
+            {
+                scope.SetTag("correlation_id", correlationId);
+            });
+
+            await next(context);
+        }
+    }
+}

Artifacts/Comanda.Internal.AspNet/Source/Middlewares/CorrelationMiddlewareExtension.cs

@@ -0,0 +1,9 @@
+namespace Comanda.Internal.AspNet.Middlewares;
+
+public static class CorrelationMiddlewareExtension
+{
+    public static IApplicationBuilder UseCorrelationMiddleware(this IApplicationBuilder builder)
+    {
+        return builder.UseMiddleware<CorrelationMiddleware>();
+    }
+}

Artifacts/Comanda.Internal.AspNet/Source/Usings.cs

@@ -0,0 +1,5 @@
+global using Microsoft.AspNetCore.Http;
+global using Microsoft.AspNetCore.Builder;
+
+global using Comanda.Internal.AspNet.Constants;
+global using Serilog.Context;