Business Rules — Unit 03: Availability Module

Dit document beschrijft de functionele logica voor de beschikbaarheidscontrole en de remote shutdown functionaliteit.

1. Beschikbaarheidsstatus (BR-AVAIL-01)

Status Typen:
- Available: Het systeem is volledig operationeel.
- Maintenance: Het systeem is in onderhoud; alleen beheerders hebben toegang.
- Degraded: Sommige functies zijn beperkt, maar het systeem is in principe bereikbaar.
- NotAvailable: Het systeem is volledig afgesloten (Remote Shutdown).
Default (MVP): In de MVP versie retourneert de StubAvailabilityService altijd Available, tenzij handmatig anders geconfigureerd in appsettings.json.

Mechanisme: Een globale middleware controleert bij elk inkomend request de status via de IAvailabilityService.
Gedrag:
- Als status == NotAvailable -> Retourneer 503 Service Unavailable.
- Als status == Maintenance -> Blokkeer requests voor reguliere gebruikers; sta alleen toe voor gebruikers met de rol Owner of Administrator.
Response: De response moet het gestandaardiseerde ApiErrorResponse formaat gebruiken (U01).

Endpoint: GET /api/availability/status moet voor iedereen bereikbaar zijn (geen authenticatie vereist).
Informatie: Het endpoint retourneert de huidige status en een timestamp van de laatste controle.

Rechten: Gebruikers met de rol Owner of Administrator kunnen de blokkades van de Availability Middleware omzeilen om onderhoudstaken uit te voeren.
Identificatie: De bypass is gebaseerd op de JWT claims (role).