Home

---

📚 Wiki Ufficiale:
🍕 PWA-Pizza-Engine

📱 Prova la Demo Live

Note

ℹ️ Stato del Progetto:

• Stable:

  • Service Worker:
    • ⚙️ CORE:
      • 🪖 Panzer v7.3

• 📄 Licenza:

  • 🇪🇺📜 👉 EUPL-1.2

• 🏛️ PA Compliance:

  • 📜 AgID / CAD Art. 68-69.

• 🔒 Security:

  • 🔑 AES-GCM 256-bit
  • 🧹 RAM Isolation
  • 🐤 Canary String 💎

Benvenuti nella documentazione tecnica ufficiale. Questo motore applica la filosofia 🔐 Zero Trust e di SW Forensics alla connettività di rete, garantendo l'isolamento dei flussi e la continuità in contesti isolati.

Tip

➡️ Benvenuto!

• Se riscontri crash...
  • pulisci la cache o forza l'aggiornamento dei Service Worker per riallineare la stiva alla v7.3.

Important

🤝 Contribuire:

• Per bug o migliorie CAD
  apri una Issue o una Pull Request.

---

⚖️ Licenza della Documentazione

Il codice sorgente di PWA Pizza Engine è rilasciato sotto licenza [EUPL-1.2]. I testi e i diagrammi contenuti in questa Wiki sono distribuiti in modalità aperta secondo le linee guida nazionali per il riuso della Pubblica Amministrazione.

---

timeline
    title ⚡ Ciclo Operativo di 🍕 PWA-Pizza-Engine (⚙️ Core: 🪖 panzer v7) 📦
    Fase 1 : 🌐 Caricamento della Root : ⚙️ Identificazione di CONFIG.ROOT : 🚷 Intercettazione Proxy Globale
    Fase 2 : 🔄 Attivazione del SW : 🔬 deepVaultValidation : 🛡️ Canary Check (Vettore KANARY) : 🔐 Sblocco Master Key AES-GCM
    Fase 3 : 📱 Navigazione Utente : 🚥 getNetworkProfile (Analisi RTT/Downlink) : 🏎️ Fetch asincrona parallela
    Fase 4 : 🏭 Operazioni di Sfondo : 🎯 Validazione isValidBlob : 🔑 Cifratura Hardware : ⏳ Hot Update / TTL 7d
    Fase 5 : 🪨 Scenario d'Emergenza : 🏦 Bunker Mode immediato : 📜 Decrittazione ArrayBuffer : ❌ Fallback su Error Page 503

Loading

🛡️ Modulo di Sicurezza Avanzata e Conformità AgID.

A partire dalla versione 7.3, l'engine introduce la protezione dei dati a livello locale ai massimi standard previsti dal CAD e dall'AgID per la gestione delle informazioni nei servizi pubblici digitali:

• 🔐 Isolamento dei Flussi (Zero-Trust): Separazione netta tra il magazzino di cache utente volatile in chiaro e il Bunker Core cifrato.

• 🇪🇺📜 Licenza EUPL 1.2: Il codice è interamente conforme al modello di riuso software (Art. 69 CAD), garantendo la massima interoperabilità e la tracciabilità delle modifiche.

⚙️ I Tre Pilastri Tecnologici

🔹📱💻 Progressive Web App (PWA) Nativa

* Sviluppo puro (Vanilla JavaScript) da zero, senza l'ausilio di framework di terze parti, per garantire il massimo controllo del ciclo di vita del software, assenza di debito tecnologico e prestazioni ottimali anche su dispositivi datati.

🔹 Installazione nativa cross-platform senza intermediazione o dipendenza dagli store proprietari.

🔹 📦🛡️ Bunker Mode (Resilienza Network-First con Profilazione Dinamica e SW Forensics)

🔹 🌐🏎️ Network-First con Race Condition: Massima freschezza dei dati in tempo reale, regolata da timeout dinamici (da 15 a 120 secondi) calcolati dall'algoritmo `getNetworkProfile` in base alla qualità della connessione (RTT e downlink).

🔹 🕵️‍♂️🔬 SW Forensics & Validazione Strict: Controllo dimensionale preventivo e analisi binaria dei file (*Magic Numbers*) tramite la routine `isValidBlob` per bloccare sul nascere attacchi di Cache Poisoning o corruzioni da captive portal.

🔹 🗄️ Separazione dei Magazzini: Isolamento logico stringente tra l'area protetta dei file di sistema (`📦🛡️ Bunker`) e quella volatile delle risorse utente (`📦🔓 Magazzino`), con routine automatiche di auto-rigenerazione e tabula rasa controllata via `postMessage` in caso di corruzione del Vault.

🔹Conformità e Riuso Open Source

🔹 🇪🇺📜 Rilascio sotto licenza [EUPL-1.2], che garantisce la libera condivisione, la modifica e il riuso del codice da parte di qualsiasi altro Ente o Pubblica Amministrazione, azzerando i costi di licensing e promuovendo la sovranità tecnologica digitale.

🔹 🏷️ Metadati nativi integrati tramite file `publiccode.yml` per l'indicizzazione automatica nei motori di ricerca AgID.

mindmap
  root((⚙️ Core: 🪖 Panzer v7.3))
    🌐 Scope Globale
      ⚙️ CONFIG.ROOT
      🚷 Intercettazione Proxy
    🔄 Network Resilient
      🧬 assegnaFlussoPolimorfo
      ⏳ Timeout Profili Hardware
      📥 Smart Sync Differito
    🕵️‍♂️ SW Forensics
      🔬🛡️ DNA Check
      📊 CONFIG.minSizeMap
      📜 Magic Numbers Hex
    🏦 Vault Sec
      🔑 AES GCM 256 bit RAM
      🧹 Bonifica fill(0)
      🐤🛡️ Canary Check KANARY
    Storage Logico
      📦🛡️ Bunker Core
      📦🔓 Magazzino Volatile

Loading

---

📊 Stato del Progetto e Inserimento a Catalogo

Il monitoraggio dell'indicizzazione e l'evoluzione dei requisiti sono tracciati pubblicamente:

• 🔀 Repository Sorgente: Ospitato su GitHub con pipeline pronte per il deployment.

• 📣 Canale di Validazione: Tracciato tramite la Issue ufficiale di inserimento nel catalogo di Developers Italia.

---

🗂️ Indice Rapido delle Pagine

👉 📄 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 2:
Architettura e Funzionamento (Bunker Mode)

• Flussi logici di intercettazione, crittografia AES-GCM del Vault e logica dei timeout di rete.

👉 💡 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.

👉 🏛️ Perché la PA deve adottare l'Architettura Panzer v7

• Studio comparativo sul risparmio economico, indipendenza tecnologica (No Vendor Lock-in) e sicurezza dei dati dei cittadini.

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

• Telemetria di console, log (📦🛡️, 📦🔓, ... ) e diagrammi di sequenza per la gestione delle emergenze.

👉 🛡️ Capitolo 5:
Paradigma Difensivo Avanzato e Logiche di Autodifesa

• Ingegneria inversa del rischio applicata al web. Analisi dei vettori d'attacco client-side, mitigazione del tampering e protocolli di Zeroization (Purga Atomica).

👉 📑 Capitolo 6:
Determina di Adozione Immediata

• Modello documentale pronto ed esecutivo per i dirigenti della Pubblica Amministrazione.