5 Collaudo DevTools

🔥 Capitolo 4: La Prova del Battesimo di Fuoco (Debug & Log)

Il collaudo e la manutenzione del motore Panzer v7 all'interno delle infrastrutture della Pubblica Amministrazione richiedono un monitoraggio rigoroso tramite la console dei moduli di sviluppo del browser (F12 / DevTools) applicando un approccio Zero Trust.

---

📊 Tassonomia dei Log di Logistica e Storage

Durante le sessioni di ispezione attiva, l'operatore tecnico deve fare riferimento alla seguente mappatura semantica delle stringhe generate nativamente dal Service Worker nei log di console:

🔹Log

Log del Sistema in Console	Livello	Significato Operativo e Innesco Codice
🟢 SW: Fetching from Network ->	SUCCESS	La rete risponde entro i timeout del profilo attivo. Rilascio immediato al frontend.
⚙️ SW: Background Caching Execution...	ASYNC	Esecuzione asincrona di isValidBlob e cifratura senza bloccare il thread dell'utente.
📦🛡️ [Bunker-Decrypted] Serviced:	OFFLINE	Subentro del Bunker. Risorsa core estratta, decifrata in AES-GCM 256-bit e servita.
🚨 SW: Storage Pieno! Emergency Clean...	WARNING	Scattato QuotaExceededError. Pulizia automatica del Magazzino volatile.
⚠️ SW: ErrorPage B64 Not Blob...	ERROR	Eccezione o fallimento logico nella gestione dei flussi binari o dei fallback del database.
ACTIVATION_ABORTED_SECURITY_BREACH	CRITICAL	Fallimento del Canary Check sul vettore statico. Wipe totale dell'IndexedDB PWA_Vault.

---

📊 Mappa Visiva dei Log di Console

graph LR
    subgraph DevTools ["Ispezione Console F12"]
        L1["🟢 SW: Fetching from Network"]
        L2["⚙️ SW: Background Caching"]
        L3["📦🛡️  Bunker-Decrypted  Serviced"]
        L4["🚨 SW: Storage Pieno!"]
        L5["⚠️ SW: ErrorPage B64 Not Blob"]
    end

    subgraph Provenienza ["Infrastruttura Client / Server"]
        Server["☁️ Server Remoto"]
        Cache["💾 Cache Locale"]
        Bunker["📦🛡️ CONFIG.cacheName"]
        Quota["🚨 QuotaExceededError"]
        B64["⚠️ Base64 Conversione"]
    end

    L1 --> Server
    L2 --> Cache
    L3 --> Bunker
    L4 --> Quota
    L5 --> B64

    style L1 fill:#e2f0d9,stroke:#385723,color:#000
    style L3 fill:#fff2cc,stroke:#d6b656,color:#000
    style L4 fill:#fce4d6,stroke:#c00000,color:#000
    style L5 fill:#fff2cc,stroke:#b25900,color:#000

Loading

---

📦 Identificazione dei Magazzini di Memoria

🔹`📦🛡️ (Bunker)` (mappato in `CONFIG.cacheName`)

Indica operazioni di lettura, scrittura o ripristino di un asset di sistema core. Questa zona è protetta da cifratura hardware-assisted AES-GCM, isolata e vitale per il funzionamento offline. Il frontend riceve queste risorse marchiate dall'header personalizzato `X-PWA-Source: Bunker-Decrypted`.

🔹`📦🔓 (Magazzino)` (mappato in `CONFIG.userCacheName`)

Indica la gestione delle risorse utente sussidiarie. È un'area di storage dinamica, volatile, non cifrata e sacrificabile in caso di emergenza, vincolata al ciclo di vita di `CONFIG.userCacheTTL`.

---

🚨 Gestione delle Emergenze e Stati Critici

In presenza di anomalie hardware sul client o di degrado severo dei canali di comunicazione, la console registrerà i seguenti comportamenti automatici di sicurezza:

🔹`🚨 SW: Storage Pieno! Emergency Clean...`

Causa: Il dispositivo client ha esaurito lo spazio disco allocato dal browser per l'applicazione (`QuotaExceededError`).

🔹Azione del software:

Il Service Worker avvia immediatamente una purga selettiva del magazzino volatile `CONFIG.userCacheName` (cache utente), preservando l'integrità assoluta dei file ospitati nel bunker `CONFIG.cacheName`.

🔹`ACTIVATION_ABORTED_SECURITY_BREACH` o Eccezione Critica del Vault

Causa: Rilevata corruzione irreversibile, alterazione strutturale, fallimento del test sul vettore di controllo binario (Canary Data "KANARY") o totale assenza delle chiavi logiche del Vault all'interno di IndexedDB (`PWA_Vault`).

🔹Azione del software (Wipe, Messaggistica & Refresh):

Il Service Worker attiva un protocollo distruttivo-rigenerativo immediato (Factory Reset). Esegue un wipe totale cancellando istantaneamente tutte le cache attive legate a `CONFIG.cacheName` e `CONFIG.userCacheName`, rasa al suolo l'IndexedDB e invia una notifica broadcast via `postMessage` a tutte le finestre aperte del frontend. L'interfaccia intercetta il segnale e forza un ricaricamento immediato della pagina (`window.location.reload()`).

sequenceDiagram
    autonumber
    participant DB as 🗄️ IndexedDB (PWA_Vault)
    participant SW as ⚙️ Service Worker (sw.js)
    participant CA as 💾 Caches (Bunker/Magazzino)
    participant FE as 🖥️ Frontend (Finestre Aperte)

    Note over SW: Rilevato Errore Critico o Fallimento Canary Check
    SW->>DB: Wipe Totale (Tabula Rasa)
    SW->>CA: Cancellazione di CONFIG.cacheName & CONFIG.userCacheName
    SW->>FE: broadcastMessage ('ACTIVATION_ABORTED_SECURITY_BREACH')
    Note over FE: Intercettazione segnale postMessage
    FE->>FE: Esecuzione window.location.reload()
    Note over FE: Il browser riparte da zero come prima installazione pulita

Loading

🔹Effetto Nuova Installazione:

Il browser si ritrova davanti a una tabula rasa assoluta e avvia un ciclo di re-installazione ex-novo. Se la comunicazione diretta con il frontend dovesse fallire durante la crisi, l'effetto si concretizza in modo deterministico alla primissima riapertura o aggiornamento manuale dell'applicazione da parte dell'utente, costringendo il sistema a ripartire da uno stato nativo pulito e a riscaricare tutti gli asset core integri direttamente dal server d'origine. Nel caso limite in cui la rete sia totalmente assente e il re-fetch fallisca, il motore si isolerà definitivamente nello stato logico protetto **`VAULT_LOCKED_NO_KEY`**, dirottando l'erogazione verso `CONFIG.fallbackImage` o stampando la pagina d'emergenza HTML 503.

---

🛠️ Protocollo di Debug Consigliato

Per forzare la verifica delle routine di rete, si raccomanda di configurare il pannello Network dei DevTools emulando profili di connessione degradati (es. Fast 3G o Slow 3G). Questo permette di validare visivamente il corretto funzionamento della routine getNetworkProfile, l'estrazione dei limiti da CONFIG.networkResilient.profiles e lo scatto automatico dei relativi timeout dinamici.

Tip

SIMULAZIONE DEL TOTAL BLACKOUT NEI TEST DI COLLAUDO: Nel pannello Application -> Service Workers dei DevTools, spunta la casella "Offline" e monitora i log. Se il sistema è a regime, vedrai comparire esclusivamente stringhe con il marcatore 📦🛡️ [Bunker-Decrypted] Serviced:, a testimonianza del fatto che la PWA sta girando in totale isolamento dal server e decifrando le risorse al volo via Web Crypto API.

↩ Torna alla Home