2 funzionamento

⚙️ Capitolo 2 : Architettura e Funzionamento
( 🧐 Sotto il cofano )

• Il funzionamento del Motore
  🪖 Panzer v7.x+ si basa sull'Isolamento dei Flussi, sull'Erogazione Polimorfa 🔀🎭 basata sui profili hardware della rete, sul protocollo di sterilizzazione forense 🕳️ "Black-Hole" e su pilastri di sicurezza 🔐 "Zero-Trust" progettati per garantire la massima tolleranza ai guasti.

Note

🔀🎭 Il Regolatore di Flusso Polimorfo si attiva a ogni singola richiesta dell'utente tramite la routine assegnaFlussoPolimorfo, decidendo in tempo reale se instradare la richiesta via Network-First o Stale-While-Revalidate ( SWR ) in base ai profili hardware.

Warning

🚨 In caso di fallimento del test crittografico a runtime sul Canary Data (CONFIG.vaultCanaryText), il Service Worker attiva la routine distruttiva di Emergency Wipe, cancellando l'intera stiva per prevenire violazioni di tipo Cache Poisoning o corruzioni strutturali.

⚠️ Configurazione: L'algoritmo esegue campionamenti RTT e downlink tramite navigator.connection. Non disabilitare le API di telemetria di rete.

---

⚖️ Analisi Comparativa:

• Standard Minimi di Sicurezza
  • 🏦 PA ( 🥊Vs🥊 ) 🪖 Panzer v7.x+

graph LR
    %% Stili Generali
    classDef default fill:#1a1a1a,stroke:#333,stroke-width:2px,color:#fff;
    classDef pa fill:#2d2d3d,stroke:#ff5555,stroke-width:2px,color:#fff;
    classDef panzer fill:#2d2d3d,stroke:#8888ff,stroke-width:3px,color:#fff;
    classDef root fill:#2d2d3d,stroke:#0000ff,stroke-width:2px,color:#fff;

    %% Nodo Radice
    ROOT[🥊Vs🥊<br>Confronto Standard di Sicurezza]:::root

    %% Ramo Standard Minimi PA
    ROOT --> PA[❌ Software PA Standard<br>Livello Commerciale Comune]:::pa
    
    PA --> PA_MEM[🧠 Gestione Memoria Volatile]:::pa
    PA_MEM --> PA_MEM_VULN[🔓 <b>Dati sensibili in chiaro</b> nella RAM<br>Soggetti a Memory Scraping fino al Garbage Collector]:::pa
    
    PA --> PA_NET[🌐 Resilienza di Rete]:::pa
    PA_NET --> PA_NET_VULN[🛑 Dipendenza totale da connettività attiva<br>UI bloccata o errore 404 in caso di blackout]:::pa
    
    PA --> PA_INTEG[📦 Integrità Applicativa]:::pa
    PA_INTEG --> PA_INTEG_VULN[⚠️ Cache del browser vulnerabile<br>Nessun controllo binario sui file iniettati]:::pa

    PA --> PA_TELE[📊 Telemetria e Log]:::pa
    PA_TELE --> PA_TELE_VULN[💬 Log di debug dispersi e attivi in produzione<br>Briciole di pane informative per reverse engineering]:::pa

    %% Ramo Architettura Panzer v7.x+
    ROOT --> PZ[🪖 Motore Panzer v7.x+<br>Architettura Zero-Trust Resiliente]:::panzer
    
    PZ --> PZ_MEM[🧠 Gestione Memoria Volatile]:::panzer
    PZ_MEM --> PZ_MEM_SEC[🔐 <b>Zero-Trust Memory:</b> Sovrascrittura dei buffer<br>con fill = 0 e purga atomica ☢️ immediata dei dati]:::panzer
    
    PZ --> PZ_NET[🌐 Resilienza di Rete]:::panzer
    PZ_NET --> PZ_NET_SEC[🛡️ <b>Offline Bunker Mode:</b> Dynamic Adaptive Network Resiliency<br>con UI di fallback e protocollo 🕳️ Black Hole]:::panzer
    
    PZ --> PZ_INTEG[📦 Integrità Applicativa]:::panzer
    PZ_INTEG --> PZ_INTEG_SEC[🔍 <b>Validazione Binaria</b>: Controllo tramite Magic Numbers<br>per impedire la manipolazione della cache]:::panzer

    PZ --> PZ_TELE[📊 Telemetria e Log]:::panzer
    PZ_TELE --> PZ_TELE_SEC[⚙️ <b>Telemetria Forense & Sterilizzazione Log 🕳️🏴‍☠️</b>]:::panzer

Loading

---

⚡ Strategia di Fetch : Regolatore di Flusso 🎭 Polimorfo a 5 Sezioni :

• ⚙️ Il motore adotta un algoritmo dinamico gestito dalla routine
  🔀🎭 assegnaFlussoPolimorfo per scongiurare il blocco dell'interfaccia in caso di connettività degradata ( fenomeno della "Lie-Fi" ), orchestrato dai parametri di CONFIG.networkResilient.profiles e strutturato in 5 Sezioni operative distinte:

🔹 🚥🌐 Profilazione Hardware della Rete ( `assegnaFlussoPolimorfo` ) :

Il sistema calcola in tempo reale un punteggio di efficienza basato sui parametri hardware di navigator.connection ( downlink e RTT ), commutando istantaneamente la strategia di erogazione e mappando i limiti estratti dal dizionario dei profili :

📡 Profilo Rete	📊 Limite Parallelismo (limit)	⏳ Timeout di Connessione (timeout)	🔀🎭 Strategia ed Erogazione Polimorfa
⚡ Ultrafast	📦 12 file	⏱️ 15 secondi	Forza 🌐 Network-First (Massima freschezza asset dal server)
🚀 Fast	📦 8 file	⏱️ 20 secondi	Forza 🌐 Network-First (Massima freschezza asset dal server)
🐢 Medium	📦 4 file	⏱️ 45 secondi	🌐 Network-First se cache vuota, altrimenti commuta su 🔄 SWR
📉 Low	📦 2 file	⏱️ 90 secondi	Forza 🔄 Stale-While-Revalidate (Continuità via stiva locale)
🚨 Verylow	📦 1 file	⏱️ 120 secondi	🚷👮‍♂️ Blocco d'ufficio dello Smart Sync 🔄 / Solo erogazione locale 🗄️

graph TD
    %% Definizione degli stili visivi per massima leggibilità
    classDef inizio fill:#1a1a1a,stroke:#113355,stroke-width:2px,color:#fff;
    classDef sezione fill:#1a1a1a,stroke:#333,stroke-width:2px,color:#fff;
    classDef successo fill:#1a1a1a,stroke:#28a745,stroke-width:2px,color:#fff;
    classDef recupero fill:#1a1a1a,stroke:#ffc107,stroke-width:2px,color:#fff;
    classDef errore fill:#1a1a1a,stroke:#dc3545,stroke-width:2px,color:#fff;

    %% FLUSSO DEL CICLO DELLE 5 SEZIONI
    A[📱 L'utente clicca o chiede una pagina] --> B(🚷 Sezione I: Pulizia del Percorso)
    class A inizio;
    class B sezione;

    B --> C{📡 Sezione II: C'è Internet?}
    class C sezione;

    %% RAMO INTERNET PRESENTE
    C -- ⚡ Sì, Internet Funziona --> D[📥 Scarica i dati freschi dal Server]
    D --> E[🏦 Salva una copia protetta in Cassaforte]
    E --> F[✅ Mostra la pagina aggiornata all'utente]
    class D successo;
    class E successo;
    class F successo;

    %% RAMO INTERNET FALLITO / LIE-FI
    C -- 🐢 No / Internet Troppo Lento --> G(🔀 Sezione III: Fallback in Cassaforte)
    G --> H[🗄️ Prende la copia cifrata dal database locale]
    H --> I[🔐 Decifra i dati in memoria RAM e 🧹 pulisce le tracce]
    I --> J[⚠️ Mostra la pagina salvata all'utente]
    class G recupero;
    class H recupero;
    class I recupero;
    class J recupero;

    %% GESTIONE IMMAGINI (SEZIONE IV)
    A --> K(🖼️ Sezione IV: Controllo Immagini)
    class K sezione;
    
    K --> L{🔬 L'immagine principale si carica?}
    class L sezione;
    
    L -- ❌ No, errore caricamento --> M{📐 Esiste un'immagine alternativa variata?}
    L -- 🎯 Sì --> N[🟢 Mostra l'immagine originale]
    class N successo;
    
    M -- 🎯 Sì --> O[📦 Mostra la variante alternativa]
    M -- 🚯 No --> P[📜 Inietta l'immagine di cortesia standard in Base64]
    class O recupero;
    class P recupero;

    %% AVARIA TOTALE (SEZIONE V)
    J --> Q{🕵️‍♂️ Sia Internet che Cassaforte hanno fallito?}
    F --> Q
    class Q sezione;
    
    Q -- 🚨 Sì, Blocco Totale --> R(🏴 Sezione V: Schermata di Cortesia)
    R --> S[❌ Mostra Pagina d'Errore 503 Sterile con bordo rosso]
    class R errore;
    class S errore;

Loading

---

🔄 Ciclo di Sincronizzazione Intelligente ( sync ) :

• 📣 Attivato tramite messaggistica IPC dall'evento INIT_DB, il motore di sincronizzazione esegue una bonifica e un allineamento predittivo degli asset tramite logiche combinate :

🔹🚦 Controllo dei Vincoli del Profilo :

Il motore interroga `getNetworkProfile`. Se il profilo è *Verylow*, il ciclo impone un blocco preventivo ( `syncAbortController.abort()` ) per non saturare la banda degradata dell'utente.

🔹📥🏭 Download in Parallelo Limitato :

🔹 Se il profilo lo consente, il motore avvia lo scaricamento delle risorse, rispettando il tetto massimo di file simultanei ( limit ).
L'attesa dei download eseguiti a blocchi paralleli, è legata a un dispositivo di sblocco immediato tramite `Promise.race` competitivo agganiato al segnale di abort.
Al minimo comando di annullamento, l'esecuzione si interrompe all'istante, neutralizzando i memory leak e sbloccando i thread su dispositivi mobili datati.

🔹 Qualsiasi interruzione lancia un errore controllato ( throw ) verso un unico catch globale, che si occupa di azzerare in sicurezza lo stato operativo ( isSyncing = false ). Al termine del ciclo, il sistema espone nei log il conteggio reale e veritiero delle sole risorse effettivamente scaricate ex-novo da rete rispetto a quelle lette dalla cache.

---

🔍 Validazione Strict via SW Forensics ( isValidBlob ) :

• ⚔️ Per sventare attacchi di 🍄 Cache Poisoning, iniezioni di vettori malevoli, pagine ingannevoli di captive portal o la corruzione dei flussi telematici, ogni risorsa binaria viene intercettata e sottoposta a una validazione sequenziale e rigorosa ( Strict DNA Check 🧬 ) sui livelli di sicurezza prima dell'ammissione e della cifratura nella stiva del Bunker:

🔹 ⚖️📐 Controllo Dimensionale e Tolleranza :

Verifica in tempo reale della consistenza del file. Il motore computa la dimensione minima richiesta incrociando i dati nominali del server con i parametri di sbarramento e le soglie di tolleranza dinamica definite nella mappatura macroscopica del CONFIG.minSizeMap ( con soglia minima standard fissata a 2 KB / 2048 byte per i documenti PDF e formati correlati ). Se il payload scende sotto il limite assoluto di sicurezza ( minAbsoluteByte ), l'asset viene rigettato d'ufficio prima di allocare RAM per l'analisi binaria.

🔹 🧬 HEAD : Firma Magica di Apertura & Buste Crittografiche ( Magic Numbers & CAdES ):

Ispezione forense del segmento iniziale del file ( estesa fino a 4096 byte ). Tramite l'estrazione dei byte binari convertiti in stringa esadecimale e testuale, il motore verifica la corrispondenza del DNA del file interfacciandosi con il dizionario magicNumbers.header e le firme supportate (supportedSignatures ), garantendo la compatibilità universale con PDF nativi, file firmati in formato CAdES (.p7m / PKCS#7 con sequenze ASN.1 DER 3082/3081) e bloccando istantaneamente tentativi di MIME-sniffing o camuffamento di codice eseguibile.

🔹 ⚓ TAIL : Firma Magica di Chiusura ( Anti-Append Attacks & PAdES ) :

Ispezione forense del segmento terminale del file. Il motore esegue un campionamento chirurgico degli ultimi 4096 byte ( maxFooterBytes ) per intercettare attacchi di sovrascrittura o accodamento di payload arbitrari ( Append Attacks ). Nei formati grafici verifica la presenza dei marcatori standard (es. IEND per PNG, EOI per JPEG), mentre nei documenti digitali analizza la coda per rilevare la firma internazionale %%EOF, garantendo piena compatibilità con i PDF firmati digitalmente in formato PAdES e a incremento strutturale.

🔹 🪵 BODY : Analisi Euristica Anti-Script 📜 & Stream Compressi ( Specifico PDF 📄 ) :

🕵️ Ispezione euristica profonda eseguita sul corpo dei documenti digitali. Qualora il flusso appartenga alla macro-area dei PDF, l'intero buffer viene mappato, scansionato tramite macchina a stati e decodificato ( inclusi gli stream compressi come /flatedecode e /lzwdecode ) alla ricerca di vettori di deviazione la logica e macro-istruzioni eseguibili pericolose definiti in CONFIG.pdf ( es. /JavaScript, /JS, /Launch, /OpenAction ecc... ). Se viene individuato anche un singolo pattern non conforme, l'ammissione viene negata d'autorità.

🔹 ⏳💤 Ottimizzazione Adattiva CPU ( Thermal Shield 🌡️🛡️ ) :

Scudo termico e bilanciamento dei carichi hardware a tutela del thread di rete. Prima di avviare l'elaborazione pesante dell'analisi euristica del corpo dei PDF, la funzione invoca la routine waitTillIdle. Il sistema calcola lo sfasamento reale ( drift ) dell'Event Loop del Service-Worker e introduce una micro-pausa dinamica proporzionale allo stress della CPU, garantendo la fluidità assoluta delle richieste di rete concorrenti e la prevenzione del logoramento hardware.

🔹 🧼 Bonifica Ermetica della Memoria Volatile :

Protocollo di azzeramento anti-ispezione della memoria.
Per prevenire attacchi di Memory Inspection o dump del processo del browser, il ciclo di vita della funzione è blindato da un blocco di chiusura perentorio finally. Indipendentemente dall'esito del controllo o da eventuali eccezioni, tutti i buffer allocati in RAM per l'ispezione ( headBuffer, tailBuffer, fullBuffer ) vengono rasi al suolo e sovrascritti fisicamente tramite l'invocazione nativa del metodo .fill(0).

graph LR
    %% Definizione degli Stili
    classDef startEnd fill:#000000,stroke:#1c7ed6,stroke-width:3px,color:#ffffff,font-weight:bold;
    classDef process fill:#000000,stroke:#868e96,stroke-width:2px,color:#ffffff;
    classDef dsc fill:#000000,stroke:#f59f00,stroke-width:2.5px,color:#ffffff,font-weight:bold;
    classDef active fill:#000000,stroke:#0ca678,stroke-width:3px,color:#ffffff,font-weight:bold;
    classDef err fill:#000000,stroke:#c92a2a,stroke-width:3px,color:#ffffff,font-weight:bold;

    %% COLONNA 1: INIZIO E PRE-PROCESSO
    subgraph COL_1 [1. INPUT & VALUTAZIONE DIMENSIONE]
        A([📥 START: isValidBlob]) --> B{Response?}
        B -- Sì --> C[Estrai Blob / MIME]
        B -- No --> D[Usa Blob / MIME]
        C --> E[Calcola minSize]
        D --> E
        E --> F{Size < minSize?}
        F -- Sì --> H[⚠️ Scarta]
        F -- No --> I[Alloca Buffer RAM]
    end

    %% COLONNA 2: ANALISI STRUTTURALE (HEADER & FOOTER)
    subgraph COL_2 [2. ANALISI STRUTTURALE]
        I --> J{Fase 1: Header?}
        J -- Sì --> K[Verifica Primi 12B]
        J -- No --> N[Fase 2: Footer]
        K --> L{Valid?}
        L -- No --> M[🚨 Err Testa]
        L -- Sì --> N
        N --> O{Fase 2: Footer?}
        O -- Sì --> P[Verifica Ultimi 128B]
        O -- No --> S[Fase 3: Corpo]
        P --> Q{Valid?}
        Q -- No --> R[🚨 Err Coda]
        Q -- Sì --> S
    end

    %% COLONNA 3: CONTROLLO CONTENUTO & SICUREZZA
    subgraph COL_3 [3. CONTROLLO CORPO & PDF]
        S --> T{MIME == PDF?}
        T -- Sì --> U[⏳ waitTillIdle Scudo CPU]
        T -- No --> Y[Test Integrità]
        U --> V[TextDecoder PDF]
        V --> W{Pattern Script?}
        W -- Sì --> X[🚨 Vettore Rilevato]
        W -- No --> Y
        Y --> Z[Slice -5 Check]
        Z --> AA{Leggibile?}
        AA -- No --> AB[valid = false]
        AA -- Sì --> AC[valid = true]
    end

    %% CONFLUENZA ERRORI ED ESITI VERSO IL FINALLY
    M  --> AD
    R  --> AD
    X  --> AD
    AB --> AD
    AC --> AD

    %% COLONNA 4: BONIFICA E USCITA
    subgraph COL_4 [4. BONIFICA & END]
        AD[Ispezione Buffer] --> AE{Presenza Dati?}
        AE -- Sì --> AF[⚡ Uint8Array.fill 0 Bonifica Totale]
        AE -- No --> AG([📤 END: Result])
        AF --> AG
    end

    %% Assegnazione Classi
    class A,AG startEnd;
    class C,D,E,I,K,P,V,Z process;
    class B,F,J,L,O,Q,T,W,AA,AE dsc;
    class H,M,R,X,AB err;
    class U,AF,AC active;

Loading

---

📦 Gestione dei Magazzini e della Memoria ( Crittografia AES-GCM ) :

• ⚙️ Il sistema opera una separazione netta dello storage logico locale, tracciato nei log di console con marcatori dedicati e protetto da crittografia hardware-assisted :

Important

➡️ Sicurezza Volatile in RAM & Protocollo Black-Hole 🕳️ :

• 🔑 La Master Key è un'istanza crittografica non esportabile ( extractable: false ) isolata nello stato di runtime.

• 🕳️ Protocollo Black-Hole ( dalla v7.6+ 🪖 ) : Ogni anomalia runtime viene catturata, sterilizzata.
  Non vengono esposti stack trace o dettagli tecnici nella console : ogni evento critico è anonimizzato in un oggetto SecurityOrchestrationError.

• 🧼 Pacchetti Binari 📦0️⃣1️⃣, i buffer temporanei di transito vengono sovrascritti forzatamente tramite Uint8Array.fill(0) 🧹 per eliminare ogni residuo crittografico o dato in chiaro dalla RAM del browser ( Anti-Memory Inspection 🧼❌🕵️ ).

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

Area protetta per i file core e d'infrastruttura dell'applicazione. Le risorse destinate a questa stiva subiscono una cifratura simmetrica 🔑 AES-GCM a 256 bit. In fase di lettura offline, il Service Worker estrae l'ArrayBuffer, esegue la decrittazione al volo, 🧼 pulisce la RAM e serve il file iniettando l'header personalizzato X-PWA-Source : Bunker-Decrypted.

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

Area sussidiaria per le risorse utente dinamiche, volatili e non cifrate, vincolate a una data di scadenza controllata dal Time-To-Live ( TTL ), definito in CONFIG.userCacheTTL ( pari a 7 giorni 📅 ).

%%{init: { 
  'theme': 'base', 
  'themeVariables': { 
    'pie1': '#0066CC', 
    'pie2': '#768A9E', 
    'pie3': '#A60000',
    'pieTitleTextSize': '18px',
    'pieTitleTextColor': '#FFF',
    'pieSectionTextColor': '#FFF',
    'pieLegendTextColor': '#FFF',
    'pieLegendTextSize': '14px'
  }
}}%%
pie title Allocazione Storage Client ( Quote Indicative )
    "📦🛡️ CONFIG.cacheName (Bunker Cifrato) ~55%" : 55
    "📦🔓 CONFIG.userCacheName (Magazzino Volatili) ~35%" : 35
    "🚨 Buffer di Sicurezza (QuotaExceededError Reserve) ~10%" : 10

Loading

---

🧬 Routine di Factory Reset, Messaggistica Frontend e Re-Installazione Totale (Canary Check)

Il motore implementa una logica di tolleranza ai guasti di tipo distruttivo-rigenerativo interamente sincronizzata con l'interfaccia utente del frontend:

🔹🐤🗄️ Canary Vault Check (`deepVaultValidation`):

All'attivazione del Service Worker, viene eseguito un test crittografico di controllo sul vettore statico binario (Canary Data). Se l'operazione fallisce o le chiavi logiche risultano manomesse, il sistema solleva un blocco di sicurezza immediato (`ACTIVATION_ABORTED_SECURITY_BREACH`) ed esegue un wipe preventivo dell'IndexedDB `PWA_Vault`.

🔹🗄️🔥 Tabula Rasa Immediata:

Se il database del Vault o le chiavi logiche in IndexedDB risultano corrotti durante i cicli operativi, il Service Worker cancella istantaneamente tutte le istanze di cache attive legate a `CONFIG.cacheName` e `CONFIG.userCacheName`.

🔹 🚨📢 Notifica di Emergenza via postMessage:

Il Service Worker invia immediatamente un segnale di notifica broadcast a tutte le finestre aperte del frontend per segnalare lo stato di emergenza.

🔹 🏗️⚙️ Forzatura del Refresh e Re-Installazione:

🔹 Il frontend forza un ricaricamento immediato. Se l'applicazione si satura o solleva un `QuotaExceededError`, si attiva la routine d'emergenza:
🚨 SW: Storage Pieno! - Emergency Clean...
che avvia la pulizia automatica del magazzino volatile (`CONFIG.userCacheName`) per salvaguardare i file vitali custoditi nel Bunker di sistema (`CONFIG.cacheName`).

🔹 In assenza dei prerequisiti minimi di sicurezza o delle chiavi logiche in IndexedDB, il sistema si isola in modalità protetta (**`VAULT_LOCKED_NO_KEY`**), restituendo risposte di errore o intercettando i file multimediali mancanti per sostituirli con il fallback binario configurato in `CONFIG.fallbackImage`.

graph LR
    A[💻 Avvio PWA / ⚙️ SW] --> B(🕵️‍♂️ deepVaultValidation)
    B --> C{🐤🛡️ Canary Check: KANARY}
    
    C -->|🛡️✅ VALIDATO| D[🗄️ Vault Sbloccato]
    D --> E[🔐 Erogazione e Decrittazione AES-GCM]
    
    C -->|❌ FALLITO / MANOMESSO| F[🚨 SECURITY BREACH]
    F --> G[🧹 Wipe di PWA_Vault & Caches]
    G --> H[📢 postMessage Broadcast ai Frontend]
    H --> I[🔄 Forzatura Refresh / 🏗️ Re-Installazione Totale]
    I --> J[📥 Riscaricamento Asset Puliti dal Server]

    style D fill:#70ad47,stroke:#fff,color:#fff
    style F fill:#c00000,stroke:#fff,color:#fff
    style G fill:#ffc000,stroke:#000,color:#000

Loading

---

🛠️ Diagramma Globale (Fetch & Sync Engine)

graph TD
    subgraph FETCH_EVENT ["📡 Evento Fetch: Intercettazione Richiesta Client"]
        A["📱 Richiesta Client (FetchEvent)"] --> B["🔍 Parsing URL & Normalizzazione (cleanPath)"]
        B --> C["🛡️ Filtri di Sicurezza (Schema, Metodo, Origin)"]
        
        C -->|No| D["⏩ Ignora / Delega al Browser"]
        C -->|Sì| E["🛠️ Controllo /favicon.ico"]
        
        E -->|Sì| F["Response 204 (No Content)"]
        E -->|No| G["🗄️ Apertura Cache (Bunker / Magazzino)"]
        
        G --> H["📦 Verifica Esistenza Cache (existsInMain / cached)"]
        
        H --> I["🧬 Valuta assegnaFlussoPolimorfo"]
        
        I --> J["🎯 Strategia Esecutiva Rilevata"]
        
        %% SCENARIO 1: SWR
        J -->|SWR| K["⚡ Attiva SWR_SAVE in background (event.waitUntil)"]
        K --> L["🌐 checkRealOnline fetch"]
        L -->|Sì| M["📥 fetch() di Rete con Timeout & AbortController"]
        M -->|OK 200 | N["💉 injectSecurityHeaders()"]
        N --> O["⚙️ processAndStore() asincrono in background (Valutazione & Cifratura)"]
        M -->|Crash / Timeout| P["Response 504 (Network Error Fallback)"]
        
        %% SCENARIO 2: NETWORK FIRST
        J -->|NetworkFirst| Q["🚧 Controllo Sbarramento (!isLogicEnabled || isSyncing)"]
        Q -->|Sì| R["🌐 Fetch immediato da Web + injectSecurityHeaders"]
        Q -->|No| S["⏳ waitTillIdle() + Esecuzione NetworkFirst & Save Background"]
        S --> M
        
        %% CACHE HIT / FALLBACK LAYER
        I --> T["🗄️ Risorsa Trovata in Cache (cached)"]
        
        T -->|Sì| U["🔐 Verifica X-PWA-Encrypted == true"]
        U -->|Sì| V["🔑 verifyVaultIntegrity() + decryptBuffer()"]
        V -->|Successo| W["🔓 Rilascia Response Decrittata (Bunker-Decrypted)"]
        V -->|Errore| X["🚨 Elimina risorsa corrotta + Response 403/404"]
        U -->|No| Y["📦 Rilascia Cache in chiaro (Magazzino)"]
        
        T -->|No| Z["🛸 Tentativo Ricerca Variante Alt (.webp, .jpg, .png)"]
        Z -->|Trovata| AA["📥 Eroga Risorsa Variante"]
        Z -->|Non Trovata| AB["🖼️ Controllo Tipo (Immagine o HTML)"]
        
        AB -->|Immagine| AC["🖼️ Eroga Placeholder / BROKEN_BLOB"]
        AB -->|HTML| AD["🖥️ generateErrorPage (Pagina 503 Sterile)"]
        AB -->|Altro| AE["📡 checkRealOnline fetch"]
        AE -->|Online| AF["Response 503 (Service Unavailable)"]
        AE -->|Offline| AG["Response 503 (Offline nativo)"]
    end

    style A fill:#1f4e79,stroke:#fff,stroke-width:2px,color:#fff
    style I fill:#2e75b6,stroke:#fff,stroke-width:2px,color:#fff
    style W fill:#70ad47,stroke:#fff,stroke-width:1px,color:#fff
    style X fill:#c00000,stroke:#fff,stroke-width:2px,color:#fff
    style AD fill:#c00000,stroke:#fff,stroke-width:2px,color:#fff

Loading

---

↩ Torna alla Home 🏠

👈 📄 Capitolo 1:
Introduzione alla PWA ed EUPL-1.2

• 👨‍⚖️📜 Analisi dei requisiti legali, conformità al CAD (Art. 68/69) e filosofia dello sviluppo 🍦 Vanilla JS senza framework esterni.

👉 💡 Capitolo 3:
Note Finali ed Esempi di Utilizzo nella PA

• 🏛️📵 Casi d'uso reali per la digitalizzazione degli Enti Locali e gestione dei servizi offline sul territorio.