Harden support update access and maintenance page

app/Filament/Pages/Supporto/Modifiche.php

@@ -246,7 +246,16 @@ public static function canAccess(): bool
             return false;
         }
 
-        return app(ProgramAclService::class)->canAccessProgram($user, 'supporto.modifiche');
+        if (class_exists(ProgramAclService::class)) {
+            try {
+                return app(ProgramAclService::class)->canAccessProgram($user, 'supporto.modifiche');
+            } catch (\Throwable) {
+                // Fallback below keeps the support page reachable during partial deploys.
+            }
+        }
+
+        return method_exists($user, 'hasAnyRole')
+            && $user->hasAnyRole(['super-admin', 'admin', 'amministratore']);
     }
 
     public function canRunUpdate(): bool

docs/support/AGGIORNAMENTI-STAGING-GIT.md

@@ -149,6 +149,15 @@ ## Emergenza: pagina Supporto > Modifiche in out-of-memory
 
 Nota operativa: questa rotazione manuale e solo una misura di contenimento. Il fix vero deve restare nel codice e poi essere riportato subito su Git, altrimenti il problema puo tornare al prossimo log grande o sul prossimo nodo remoto.
 
+Se il nodo fallisce invece per classi mancanti durante l apertura di `Supporto > Modifiche` o di `aggiornamento-nodo`, la procedura corretta e:
+
+1. verificare subito se il file mancante esiste davvero nel checkout deployato;
+2. se la pagina tecnica dipende da un service non essenziale al recupero del nodo, introdurre un fallback locale sicuro per non bloccare il pannello;
+3. riallineare repository e nodo via Git appena il pannello torna accessibile;
+4. eseguire `php artisan optimize:clear` dopo il fix.
+
+Per la manutenzione utente finale, il nodo deve servire una `503` dedicata con refresh automatico sulla stessa URL. In questo modo l utente vede solo il messaggio di aggiornamento e rientra da solo alla pagina richiesta quando il deploy termina, senza restare mischiato a pagine parziali o a tracce tecniche.
+
 ## Rilascio operativo 2026-04-06
 
 Questo e il blocco che puo essere aggiornato adesso con la procedura Git-first senza correzioni manuali extra su staging.

docs/support/BUG-RISOLTI-E-VALIDAZIONI.md

@@ -19,6 +19,14 @@ ### Supporto > Modifiche in memory exhaustion su log grandi
 - Stato: [U] riprodotto e corretto sul nodo locale `/var/www/netgescon`; validazione eseguita via reflection su `loadRuntimeErrors()` con `laravel.log` grande, picco memoria rimasto intorno a `89 MB` e `39` righe BUG caricate correttamente.
 - Prevenzione: non usare aumento del `memory_limit` come rimedio principale; mantenere logrotate attivo e preferire sempre parsing incrementale o tail bounded per i file operativi letti dalla UI.
 
+### Supporto > Modifiche con `ProgramAclService` assente su nodo staging
+
+- Problema: la pagina `admin-filament/supporto/aggiornamento-nodo` poteva andare in `BindingResolutionException` con `Target class [App\Services\ProgramAclService] does not exist` durante `canAccess()`.
+- Causa tecnica: sul nodo staging il checkout deployato non conteneva `app/Services/ProgramAclService.php`; la pagina supporto dipendeva in modo rigido da quel service anche per un semplice controllo accessi.
+- Fix applicato: `Modifiche::canAccess()` usa `ProgramAclService` solo se la classe esiste e si risolve correttamente; se manca, fa fallback ai ruoli amministrativi (`super-admin`, `admin`, `amministratore`) e non blocca la pagina tecnica.
+- Stato: [U] validato su `/var/www/netgescon` con service realmente assente; `App\Filament\Pages\Supporto\Modifiche::canAccess()` non genera piu eccezioni e ritorna correttamente `true` per un utente amministrativo.
+- Prevenzione: nelle pagine di supporto e deploy evitare dipendenze rigide da moduli opzionali o non ancora allineati sul nodo; il pannello di recupero deve sempre avere un percorso di fallback minimale.
+
 ### Ripristino bootstrap pannello admin
 
 - Problema: `AdminFilamentPanelProvider.php` era stato corrotto da una modifica incompleta e impediva il bootstrap corretto.

resources/views/errors/503.blade.php

@@ -0,0 +1,236 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    @php
+        $retrySeconds = (int) config('netgescon.maintenance.retry', 60);
+        $refreshSeconds = (int) config('netgescon.maintenance.refresh', 15);
+        $refreshSeconds = max($refreshSeconds, 5);
+    @endphp
+    <meta http-equiv="refresh" content="{{ $refreshSeconds }}">
+    <title>{{ config('netgescon.maintenance.title', 'Aggiornamento in corso') }}</title>
+    <style>
+        :root {
+            color-scheme: light;
+            --bg-top: #f7fafc;
+            --bg-bottom: #e6eef5;
+            --panel: rgba(255, 255, 255, 0.94);
+            --line: rgba(15, 23, 42, 0.08);
+            --text: #0f172a;
+            --muted: #475569;
+            --badge-bg: #dbeafe;
+            --badge-text: #1d4ed8;
+            --accent: #0f766e;
+            --accent-soft: #ccfbf1;
+        }
+
+        * {
+            box-sizing: border-box;
+        }
+
+        body {
+            margin: 0;
+            min-height: 100vh;
+            font-family: "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+            color: var(--text);
+            background:
+                radial-gradient(circle at top left, rgba(15, 118, 110, 0.12), transparent 34%),
+                radial-gradient(circle at bottom right, rgba(29, 78, 216, 0.1), transparent 28%),
+                linear-gradient(180deg, var(--bg-top), var(--bg-bottom));
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            padding: 32px 20px;
+        }
+
+        .shell {
+            width: min(760px, 100%);
+            border: 1px solid var(--line);
+            border-radius: 24px;
+            background: var(--panel);
+            box-shadow: 0 24px 80px rgba(15, 23, 42, 0.12);
+            overflow: hidden;
+        }
+
+        .hero {
+            padding: 28px 28px 22px;
+            border-bottom: 1px solid var(--line);
+            background: linear-gradient(135deg, rgba(255, 255, 255, 0.88), rgba(240, 253, 250, 0.88));
+        }
+
+        .badge {
+            display: inline-flex;
+            align-items: center;
+            gap: 8px;
+            padding: 8px 12px;
+            border-radius: 999px;
+            background: var(--badge-bg);
+            color: var(--badge-text);
+            font-size: 12px;
+            font-weight: 700;
+            letter-spacing: 0.06em;
+            text-transform: uppercase;
+        }
+
+        h1 {
+            margin: 18px 0 10px;
+            font-size: clamp(30px, 5vw, 42px);
+            line-height: 1.08;
+        }
+
+        .lead {
+            margin: 0;
+            max-width: 58ch;
+            color: var(--muted);
+            font-size: 16px;
+            line-height: 1.6;
+        }
+
+        .content {
+            padding: 24px 28px 28px;
+            display: grid;
+            gap: 18px;
+        }
+
+        .grid {
+            display: grid;
+            grid-template-columns: repeat(2, minmax(0, 1fr));
+            gap: 14px;
+        }
+
+        .card {
+            border: 1px solid var(--line);
+            border-radius: 18px;
+            padding: 16px 18px;
+            background: rgba(255, 255, 255, 0.78);
+        }
+
+        .card-label {
+            margin: 0 0 8px;
+            font-size: 11px;
+            font-weight: 700;
+            letter-spacing: 0.08em;
+            text-transform: uppercase;
+            color: #64748b;
+        }
+
+        .card-value {
+            margin: 0;
+            font-size: 18px;
+            font-weight: 700;
+        }
+
+        .card-note {
+            margin: 8px 0 0;
+            color: var(--muted);
+            font-size: 13px;
+            line-height: 1.5;
+        }
+
+        .status {
+            display: inline-flex;
+            align-items: center;
+            gap: 10px;
+            border-radius: 16px;
+            padding: 14px 16px;
+            background: var(--accent-soft);
+            color: #134e4a;
+            font-size: 14px;
+            font-weight: 600;
+        }
+
+        .dot {
+            width: 10px;
+            height: 10px;
+            border-radius: 999px;
+            background: var(--accent);
+            box-shadow: 0 0 0 6px rgba(15, 118, 110, 0.12);
+        }
+
+        a {
+            color: inherit;
+        }
+
+        @media (max-width: 640px) {
+            body {
+                padding: 16px;
+            }
+
+            .hero,
+            .content {
+                padding-left: 18px;
+                padding-right: 18px;
+            }
+
+            .grid {
+                grid-template-columns: 1fr;
+            }
+        }
+    </style>
+</head>
+<body>
+    @php
+        $siteMode = (string) config('netgescon.maintenance.site_mode', 'app');
+        $siteLabel = (string) config('netgescon.maintenance.site_label', config('app.name', 'NetGescon'));
+        $supportEmail = trim((string) config('netgescon.maintenance.support_email', ''));
+        $supportUrl = trim((string) config('netgescon.maintenance.support_url', ''));
+        $siteBadge = $siteMode === 'demo' ? 'Demo' : 'App';
+        $siteNote = $siteMode === 'demo'
+            ? 'L\'ambiente demo e temporaneamente bloccato per un aggiornamento controllato.'
+            : 'L\'ambiente applicativo e temporaneamente bloccato per un aggiornamento controllato.';
+    @endphp
+
+    <main class="shell">
+        <section class="hero">
+            <div class="badge">{{ $siteBadge }} · {{ $siteLabel }}</div>
+            <h1>{{ config('netgescon.maintenance.title', 'Aggiornamento in corso') }}</h1>
+            <p class="lead">
+                {{ config('netgescon.maintenance.message', 'Stiamo applicando una nuova distribuzione del servizio.') }}
+            </p>
+        </section>
+
+        <section class="content">
+            <div class="status">
+                <span class="dot"></span>
+                <span>{{ config('netgescon.maintenance.detail', 'L\'accesso sara ripristinato automaticamente al termine dell\'aggiornamento.') }}</span>
+            </div>
+
+            <div class="grid">
+                <article class="card">
+                    <p class="card-label">Ambiente</p>
+                    <p class="card-value">{{ $siteLabel }}</p>
+                    <p class="card-note">{{ $siteNote }}</p>
+                </article>
+
+                <article class="card">
+                    <p class="card-label">Riprova Tra</p>
+                    <p class="card-value">{{ max($retrySeconds, 1) }} secondi</p>
+                    <p class="card-note">La pagina si aggiorna automaticamente ogni {{ $refreshSeconds }} secondi e torna da sola alla pagina richiesta quando l aggiornamento termina.</p>
+                </article>
+
+                @if($supportEmail !== '')
+                    <article class="card">
+                        <p class="card-label">Supporto</p>
+                        <p class="card-value"><a href="mailto:{{ $supportEmail }}">{{ $supportEmail }}</a></p>
+                        <p class="card-note">Usa questo contatto solo se il blocco si prolunga oltre la normale finestra tecnica.</p>
+                    </article>
+                @endif
+
+                @if($supportUrl !== '')
+                    <article class="card">
+                        <p class="card-label">Pagina Operativa</p>
+                        <p class="card-value"><a href="{{ $supportUrl }}">Apri riferimento</a></p>
+                        <p class="card-note">Puoi pubblicare qui un link di stato o una pagina informativa esterna.</p>
+                    </article>
+                @endif
+            </div>
+        </section>
+    </main>
+    <script>
+        window.setTimeout(function () {
+            window.location.reload();
+        }, {{ $refreshSeconds * 1000 }});
+    </script>
+</body>
+</html>