Home

---

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

Note

ℹ️ Stato Progetto:
Stable Engine v7.1

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

Benvenuti nella documentazione tecnica ufficiale. Questo motore applica la filosofia Zero Trust alla connettività di rete, garantendo continuità in contesti isolati.

Tip

➡️ Benvenuto! Se riscontri crash, pulisci la cache o forza l'aggiornamento dei Service Worker.

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

⚙️ 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))
    Scope Globale
      CONFIG.ROOT
      Intercettazione Proxy
    Network Resilient
      getNetworkProfile
      Timeout Dinamici
      Asincronia Background
    SW Forensics
      isValidBlob
      CONFIG.minSizeMap
      Magic Numbers DNA
    Vault Sec
      AES GCM 256 bit
      IndexedDB PWA Vault
      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 reali (📦🛡️, 📦🔓, ⚙️, 🟢) 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.