Home

---

🌐 Wiki Ufficiale: PWA-Pizza-Engine (Core: Panzer v7.3)

📱 Prova la Demo Live

Note

ℹ️ Stato Progetto:
Stable Engine v7.3 (U-Boot - Stealth Edition)

• 📄 Licenza:
  EUPL-1.2 Compliance.
• 🏛️ PA Compliance:
  AgID / CAD Art. 68-69.
• 🔒 Security:
  AES-GCM 256-bit Certified (RAM Isolation).

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

🔹1. 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.

🔹2. 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.

🔹3. 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((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, tassonomia dei log (📦🛡️, 📦🔓, ⚙️, 🟢) e diagrammi di sequenza per la gestione delle emergenze.

👉 📑 Capitolo 5:
Determina di Adozione Immediata

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