Adds 2 units and docs for unit 3. nfr-requirements plan

This commit is contained in:
2026-06-29 22:18:37 +02:00
parent 0e01ca1e1c
commit c156107cb1
126 changed files with 15204 additions and 80199 deletions
@@ -4,13 +4,10 @@ using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using SlpModularCms.Core.Availability;
using SlpModularCms.Core.Exceptions;
using SlpModularCms.Modules.Availability.Services;
namespace SlpModularCms.Modules.Availability.Middleware;
/// <summary>
/// Middleware die de beschikbaarheid van het systeem controleert en requests blokkeert indien nodig.
/// </summary>
public class AvailabilityMiddleware
{
private readonly RequestDelegate _next;
@@ -25,14 +22,19 @@ public class AvailabilityMiddleware
// Paths that are always accessible regardless of system availability.
// Auth and Setup must stay open so admins can log in and the frontend
// can determine whether the system is initialized.
// Master endpoints bypass so master can always push status or re-register.
private static readonly string[] _bypassPrefixes =
[
"/api/v1/Availability/status",
"/api/v1/Auth/",
"/api/v1/Setup/status",
"/api/v1/master/",
];
public async Task InvokeAsync(HttpContext context, IAvailabilityService availabilityService)
public async Task InvokeAsync(
HttpContext context,
IAvailabilityService availabilityService,
IMasterAvailabilityService masterAvailabilityService)
{
var path = context.Request.Path.Value ?? string.Empty;
if (_bypassPrefixes.Any(p => path.StartsWith(p, StringComparison.OrdinalIgnoreCase)))
@@ -41,35 +43,47 @@ public class AvailabilityMiddleware
return;
}
var status = await availabilityService.IsAvailableAsync();
if (status == AvailabilityStatus.Available)
{
await _next(context);
return;
}
// Check voor Beheerder Bypass (Owner of Administrator)
if (IsAdminBypass(context))
{
await _next(context);
return;
}
_logger.LogWarning("Request geblokkeerd vanwege systeemstatus: {Status}. Path: {Path}", status, context.Request.Path);
var masterStatus = masterAvailabilityService.GetMasterStatus();
if (!masterStatus.IsAvailable)
{
_logger.LogWarning(
"Request blocked by master gate. Path: {Path}, DisableMessage: {DisableMessage}",
path, masterStatus.DisableMessage);
context.Response.StatusCode = StatusCodes.Status503ServiceUnavailable;
await context.Response.WriteAsJsonAsync(new ProblemDetails
{
Status = StatusCodes.Status503ServiceUnavailable,
Title = "Service Unavailable",
Detail = masterStatus.DisableMessage ?? "De service is tijdelijk niet beschikbaar.",
Instance = context.Request.Path
});
return;
}
var status = await availabilityService.IsAvailableAsync();
if (status == AvailabilityStatus.Available)
{
await _next(context);
return;
}
_logger.LogWarning("Request geblokkeerd vanwege systeemstatus: {Status}. Path: {Path}", status, context.Request.Path);
context.Response.StatusCode = StatusCodes.Status503ServiceUnavailable;
var problemDetails = new ProblemDetails
await context.Response.WriteAsJsonAsync(new ProblemDetails
{
Status = StatusCodes.Status503ServiceUnavailable,
Title = "Service Unavailable",
Detail = status == AvailabilityStatus.Maintenance
? "Het systeem is momenteel in onderhoud. Probeer het later opnieuw."
Detail = status == AvailabilityStatus.Maintenance
? "Het systeem is momenteel in onderhoud. Probeer het later opnieuw."
: "De service is tijdelijk niet beschikbaar.",
Instance = context.Request.Path
};
await context.Response.WriteAsJsonAsync(problemDetails);
});
}
private bool IsAdminBypass(HttpContext context)
@@ -91,7 +105,6 @@ public class AvailabilityMiddleware
}
catch (Exception)
{
// Ongeldig token of parsing fout: geen bypass
return false;
}
}