feat: add Scalar API reference UI

- Scalar.AspNetCore 2.14.9
- Available in Development at /scalar/v1
- Theme: DeepSpace

Ref: IT-628

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Directory.Packages.props

@@ -17,6 +17,7 @@
         <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.6" />
         <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.6" />
         <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.6" />
+        <PackageVersion Include="Scalar.AspNetCore" Version="2.14.9" />
 
         <!-- Serilog -->
         <PackageVersion Include="Serilog" Version="4.2.0" />

HrynCo.NotificationService.Api/HrynCo.NotificationService.Api.csproj

@@ -8,6 +8,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" />
+    <PackageReference Include="Scalar.AspNetCore" />
     <PackageReference Include="Serilog.AspNetCore" />
     <PackageReference Include="Serilog.Settings.Configuration" />
     <PackageReference Include="Serilog.Sinks.Console" />

HrynCo.NotificationService.Api/Program.cs

@@ -1,6 +1,7 @@
 using HrynCo.NotificationService.Api;
 using HrynCo.NotificationService.DAL.EF;
 using HrynCo.NotificationService.Services;
+using Scalar.AspNetCore;
 
 var builder = WebApplication.CreateBuilder(args);
 
@@ -19,7 +20,14 @@ builder.Services.AddNotificationServices();
 var app = builder.Build();
 
 if (app.Environment.IsDevelopment())
+{
     app.MapOpenApi();
+    app.MapScalarApiReference(options =>
+    {
+        options.Title = "HrynCo Notification Service";
+        options.Theme = ScalarTheme.DeepSpace;
+    });
+}
 
 app.UseHttpsRedirection();
 app.MapControllers();