Home

🗺️ Mappa di Navigazione del Progetto

---

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

Benvenuti nella documentazione tecnica ufficiale del progetto. Questo motore è stato sviluppato applicando la filosofia Zero Trust alla connettività di rete, garantendo la continuità operativa dei servizi anche in contesti totalmente isolati o degradati.

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.

---

🗺️ Struttura della Documentazione e Indice di Navigazione

Usa questo schema logico per esplorare tutti i moduli della Wiki ufficiale:

graph LR
    W["📖 Wiki Core"] --> C1["📄 Cap 1: Introduzione ed EUPL"]
    W --> C2["⚙️ Cap 2: Architettura e Bunker Mode"]
    W --> C3["💡 Cap 3: Note ed Esempi PA"]
    W --> C4["🏛️ Perché la PA deve adottare Panzer v7"]
    W --> C5["🔥 Cap 4: Debug & Logistica dei Log"]
    W --> C6["📑 Cap 5: Determina di Adozione"]

    click C1 "1 introduzione" "Vai al Capitolo 1"
    click C2 "2 funzionamento" "Vai al Capitolo 2"
    click C3 "3 utilizzo" "Vai al Capitolo 3"
    click C4 "4 vantaggi-pa" "Vai alla sezione PA"
    click C5 "5 collaudo-devtools" "Vai al Capitolo 4"
    click C6 "6 determina" "Vai alla Determina"

    style W fill:#1f4e79,stroke:#112e47,color:#fff,stroke-width:2px
    style C1 fill:#f5f5f5,stroke:#ccc,color:#000
    style C2 fill:#f5f5f5,stroke:#ccc,color:#000
    style C3 fill:#f5f5f5,stroke:#ccc,color:#000
    style C4 fill:#f5f5f5,stroke:#ccc,color:#000
    style C5 fill:#f5f5f5,stroke:#ccc,color:#000
    style C6 fill:#f5f5f5,stroke:#ccc,color:#000

Loading

---

🗂️ 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.