Skip to content

Home

Jump to bottom
Valentino Aglianó edited this page Jun 11, 2026 · 87 revisions

LOGO

Panzer v7 Core Logo

📚 Wiki Ufficiale:
🍕 PWA-Pizza-Engine

  • 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.

📱 Prova la Demo Live

Important

🤝 Contribuire:

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

Note

ℹ️ Stato del Progetto:

  • Stable:

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

  • 📄 Licenza:

  • 🏛️ PA Compliance:

    • 📜 AgID / CAD Art. 68-69.

  • 🔒 Security:

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

Warning

📦🚨 PROTOCOLLO DI BLINDATURA IN PRODUZIONE (OVERRIDE NATIVO DEGLI INTERCETTORI GLOBALI)

Al fine di garantire la massima conformità ai paradigmi di sicurezza logica 🔐 Zero-Trust e impedire operazioni non autorizzate di Reverse Engineering, manipolazione dei flussi o la fuga di informazioni sensibili tramite la 📊🛠️ console del browser in ambiente di produzione:

🏛️ Tale architettura consente all'Istruttore Informatico 🧑‍💻 dell'Amministrazione o ai tecnici ispettivi degli organi preposti (AgID / Developers Italia / ACN) 🏛️
di eseguire il collaudo visivo e l'audit completo nei DevTools 🛠️ e, successivamente, attivare la blindatura nativa dell'applicazione per l'esercizio pubblico.

L'Ente in fase di deployment definitivo deve applicare perentoriamente questo interruttore di inibizione globale. O usare inibitori simili, per la blindatura di sicurezza.

🔹 ⚙️🔨🏛️ Logica di inibizione a carico dell'Ente e dell'Appaltatore (OVERRIDE DEI CANALI DI TELEMETRIA E LOGGING FORENSE): 
// Logiche per il REGISTRO FORENSE !
/**
 * @description 💾 Memorizzazione globale dei descrittori nativi prima di eseguire l'override.
 * Garantisce che le funzioni di rete e di pulizia possano rompere la ricorsione in ogni momento,
 * isolando i flussi diagnostici standard dalle sottomissioni remote verso l'Ente.
 */
const originaleConsoleWarn = console.warn;
const originaleConsoleError = console.error;

/**
 * @fileoverview 📄 REGISTRO DI CONFIGURAZIONE INTERNA E PARAMETRICI DI CONTROLLO
 * @module PA_Audit_Bunker/Config
 * @description Definisce i vincoli strutturali, l'endpoint telematico di destinazione,
 * i tracciati URI fittizi delle risorse in cache ed i profili di tolleranza di rete.
 * Rispetta i dettami di interoperabilità e resilienza richiesti dai capitolati della PA.
 */
const AUDIT_CONFIG = {
    /** * @description Endpoint istituzionale per il conferimento dei tracciati di auditing. */
    endpointTelemetria: "https://sicurezza.comune.local/api/v1/telemetry",

    /** * @description Prefisso fittizio normalizzato per il transito e lo stivaggio molecolare dei log. */
    pathFintoLog: "pa_audit_bunker/log_",

    /** * @description Intestazioni formali per la validazione strict dei payload e dello stato crittografico. */
    headersFormali: {
        origin: "Cache-Bunker-Panzer",
        contentType: "application/json",
        headerCifrato: "X-PWA-Encrypted",
        headerData: "X-PWA-Date",
        headerProvenienza: "X-PA-Audit-Origin"
    }
};

/**
 * @function blindaTelemetriaPA
 * @description ⚙️🔨🏛️ Inibisce i canali di logging ordinari per prevenire l'esposizione di dati 
 * sensibili in ambiente di produzione (Anti-Data-Leakage). Forza l'intercettazione e l'elevazione
 * forense delle anomalie verso la cache e l'endpoint di controllo.
 */
function blindaTelemetriaPA() {
    // ⚠️ Inibizione perentoria dei canali diagnostici standard per prevenire data leakage in locale
    console.log = function() {};
    console.info = function() {};

    /**
     * @method console.warn
     * @description ⚠️ Intercettore globale dei messaggi di avviso e anomalie di transito.
     * Incapsula la traccia sul canale nativo e devia il payload sul buffer criptato di cache.
     */
    console.warn = function(...args) {
        originaleConsoleWarn.apply(console, ["[⚠️ WARNING PA ADAPTER]", ...args]);
        const messaggioWarn = args.join(" ");
        if (typeof spedisciLogAllEnte === "function") {
            spedisciLogAllEnte({
                timestamp: Date.now(),
                livello: "WARN_SECURITY_INSPECTION",
                payload: messaggioWarn
            });
        }
    };

    /**
     * @method console.error
     * @description 🚨 Intercettore globale delle eccezioni fatali e delle violazioni di integrità.
     * Vincola l'Ente alla tracciabilità perentoria dei crash ai fini della responsabilità oggettiva.
     */
    console.error = function(...args) {
        originaleConsoleError.apply(console, ["[🚨 CRITICAL PA ADAPTER]", ...args]);
        const messaggioErrore = args.join(" ");
        if (typeof spedisciLogAllEnte === "function") {
            spedisciLogAllEnte({
                timestamp: Date.now(),
                livello: "FATAL_SECURITY",
                payload: messaggioErrore
            });
        }
    };
}

/**
 * @function spedisciLogAllEnte
 * @async
 * @description 🏛️🔐 Riceve la telemetria forense, eleva il metadato e la blinda d'ufficio
 * all'interno del magazzino cache criptato del Panzer v7.3 prima di ogni transito di rete.
 * @param {Object} logPayload - Oggetto strutturato contenente i metadati dell'evento.
 */
async function spedisciLogAllEnte(logPayload) {
    try {
        // 🔒 Elevazione del livello di sicurezza prima della storicizzazione locale
        logPayload.livello += "_BUNKER_ARMED";

        // 💾 PERSISTENZA BLINDATA IN CACHE D'UFFICIO
        if (typeof stivaLogInCache === "function") {
            await stivaLogInCache(logPayload);
        } else {
            originaleConsoleError.apply(console, [
                "[🚨 PA AUDIT - VAULT LOCKOUT]", 
                "Sottosistema di persistenza volatile in Cache non accessibile!"
            ]);
        }
    } catch (criticalError) {
        // Blocco di emergenza assoluta: usa il descrittore nativo per rompere categoricamente il loop ricorsivo
        originaleConsoleError.apply(console, [
            "[🚨 PA AUDIT - CATASTROPHIC FAILURE]", 
            "Impossibile blindare la telemetria nel bunker criptato:", criticalError.message
        ]);
    }
}

/**
 * @function stivaLogInCache
 * @async
 * @description 🏛️🔐 Salva il log forense cifrato direttamente nella Cache come risorsa volatile.
 * Inserisce il payload sotto forma di Response binaria cifrata (`encryptBlob`) associata ad un URI fittizio,
 * garantendo la persistenza isolata ed effettuando la bonifica perentoria della RAM.
 * @param {Object} logPayload - Dati strutturati di telemetria e audit da blindare in conformità al CAD.
 */
async function stivaLogInCache(logPayload) {
    try {
        // ⚓ APERTURA DEL MAGAZZINO CACHE NATIVO DEL 🪖 PANZER v7.3+
        const cache = await caches.open(CONFIG.cacheName);
        const timestamp = Date.now();
        
        // 🔗 GENERAZIONE E NORMALIZZAZIONE STRICT DELL'URI VIRTUALIZZATO
        const logUri = normalize(`${CONFIG.ROOT}${AUDIT_CONFIG.pathFintoLog}${timestamp}.json`);

        // 🧠 ENCODING DEL PAYLOAD IN STREAM BINARIO PER PREVENIRE TRACCIABILITÀ IN CHIARO IN RAM
        const stringaLog = JSON.stringify(logPayload);
        const encoder = new TextEncoder();
        const bufferGrezzo = encoder.encode(stringaLog);
        const blobGrezzo = new Blob([bufferGrezzo], { type: AUDIT_CONFIG.headersFormali.contentType });

        // 🔐 CIFRATURA MOLECOLARE AES-GCM 256-BIT (FUNZIONE NATIVA CORE PANZER)
        const blobCifrato = await encryptBlob(blobGrezzo);

        // 📜 INIEZIONE METADATI E INTESTAZIONI FORMALI DI TRACCIABILITÀ
        const nuoveHeaders = new Headers();
        nuoveHeaders.set('Content-Type', AUDIT_CONFIG.headersFormali.contentType);
        nuoveHeaders.set(AUDIT_CONFIG.headersFormali.headerCifrato, 'true');
        nuoveHeaders.set(AUDIT_CONFIG.headersFormali.headerData, timestamp.toString());

        const rispostaLog = new Response(blobCifrato, { status: 200, headers: nuoveHeaders });

        // 📥 STIVAGGIO ATOMICO NELLA CACHE COMO RISORSA DI TRANSITO
        await cache.put(logUri, rispostaLog);

        // 🧹 BONIFICA PERENTORIA DELLA RAM (Anti-Memory Inspection Protection)
        bufferGrezzo.fill(0);

        // 📡 TELEMETRIA DI RETE ADATTIVA: Innesco automatico immediato dello svuotamento della coda
        await svuotaCodaLogDallaCache();

    } catch (errore) {
        originaleConsoleError.apply(console, ["[🚨 PA AUDIT - CACHE STOWAGE FAULT]", errore.message]);
    }
}

/**
 * @function svuotaCodaLogDallaCache
 * @async
 * @description 📡🔄 Scansiona le risorse di log salvate nella cache, le decifra a runtime,
 * le trasmette all'Ente e le ELIMINA dalla cache solo ed esclusivamente se l'invio ha successo.
 * Sfrutta ESCLUSIVAMENTE la profilazione dinamica interna del Panzer per determinare lo stato online reale.
 */
async function svuotaCodaLogDallaCache() {
    // 📊 PROFILAZIONE FISICA DEL CANALE INTERNO DEL PANZER
    const profile = getNetworkProfile(self.navigator);
    
    // 🚫 CONTROLLO DETERMINISTICO NATIVO: Se il profilo non esiste o coincide con i parametri hardware 
    // del blocco radio 'Verylow' (ovvero quando il sistema rileva lo stato offline reale), abortisce istantaneamente.
    if (!profile || profile.limit === CONFIG.networkResilient.profiles['Verylow'].limit) {
        return;
    }

    try {
        // 📥 ACCESSO AL SEGMENTO DI CACHE CERTIFICATO
        const cache = await caches.open(CONFIG.cacheName);
        const chiaviInCache = await cache.keys();

        // 🕵️‍♂️ SCANSIONE CICLICA PER L'ISOLAMENTO DEGLI ASSET COMPATIBILI COI LOG TELEMETRICI
        const logPendenti = chiaviInCache.filter(req => req.url.includes(`/${AUDIT_CONFIG.pathFintoLog}`));

        // 🏁 ZERO LOG CORRISPONDENTI: RILASCIO IMMEDIATO DEL THREAD LOCK
        if (logPendenti.length === 0) return;

        for (const richiesta of logPendenti) {
            // 🌐 AGGIORNAMENTO RUNTIME PROFILO: Verifica se la rete è precipitata nel frattempo
            const controlloProfiloCorrente = getNetworkProfile(self.navigator);
            if (!controlloProfiloCorrente || controlloProfiloCorrente.limit === CONFIG.networkResilient.profiles['Verylow'].limit) {
                break;
            }

            const rispostaCifrata = await cache.match(richiesta);
            if (!rispostaCifrata) continue;

            // 📦 ESTRAZIONE BLOB CRITTOGRAFATO DALLA RISORSA DI TRANSITO
            const blobCifrato = await rispostaCifrata.blob();
            
            // 🔓 DECIFRATURA:
            let blobDecifrato = await decryptBlob(blobCifrato);
            const bufferDecifrato = await blobDecifrato.arrayBuffer();
            
            const decoder = new TextEncoder();
            const stringaLog = new TextDecoder().decode(bufferDecifrato);
            const oggettoLog = JSON.parse(stringaLog);

            // ✍️ MARCATURA FORENSE: Tracciabilità delle transizioni di stato del pacchetto
            oggettoLog.livello += "_RETRANSMITTED_FROM_CACHE_RESOURCE";

            // ⏱️ RESILIENZA: Gestione del timeout adattivo ricavato dal profilo reale
            const controller = new AbortController();
            const timeoutId = setTimeout(() => controller.abort(), profile.timeout * 1000);

            try {
                // 📡 TRASMISSIONE VERSO L'ENDPOINT DELL'ENTE PUBBLICO
                const rispostaRete = await fetch(AUDIT_CONFIG.endpointTelemetria, {
                    method: "POST",
                    headers: {
                        "Content-Type": AUDIT_CONFIG.headersFormali.contentType,
                        [AUDIT_CONFIG.headersFormali.headerProvenienza]: AUDIT_CONFIG.headersFormali.origin
                    },
                    body: JSON.stringify(oggettoLog),
                    signal: controller.signal
                });

                // 🔥 CONDIZIONE IMPERATIVA DI BONIFICA DELLE RISORSE LOCALI
                if (rispostaRete.ok) {
                    // ELIMINAZIONE DEFINITIVA DALLA CACHE: Avviene SOLO dopo la certezza matematica del 200 OK
                    await cache.delete(richiesta);
                }
            } catch (erroreInvio) {
                // 🚨 SE CEDE LA RETE DURANTE IL TRANSITO, IL LOG RIMANE SALVO E PROTETTO NELLA RISORSA CACHE
                originaleConsoleError.apply(console, ["[🚨 PA AUDIT - RETRANSMIT NETWORK INTERRUPTED]", errorelnvio.message]);
                break; 
            } finally {
                // 🧹 DISATTIVAZIONE MONITOR DI TIMEOUT E DISTRUZIONE MEMORIA RESIDUA
                clearTimeout(timeoutId);

                // 🧯 PULIZIA MOLECOLARE (Previene attacchi di Cold Boot e ispezione dei segmenti di memoria volatili)
                new Uint8Array(bufferDecifrato).fill(0);
                blobDecifrato = null;
            }
        }
    } catch (erroreGenerale) {
        originaleConsoleError.apply(console, ["[🚨 PA AUDIT - CACHE ENGINE CRITICAL]", erroreGenerale.message]);
    }
}

// self.addEventListener('fetch', (event) => { ...
// 🌐 SEZIONE II: FLUSSO DI INSTRADAMENTO RETE ATTIVA (ONLINE GATEWAY)
		// const finalStrategy = assegnaFlussoPolimorfo(cached, self.navigator);
		// const isOnline = await checkRealOnline('fetch');
		// if (isOnline) {
			
			// 🏛️ INNESTO FORMALE DEL CODICE: SVUOTAMENTO CODA LOG IN BACKGROUND
			// Sfrutta la portante della rete reale confermata da checkRealOnline
			if (typeof svuotaCodaLogDallaCache === "function") {
				/**
				 * @description event.waitUntil estende il ciclo di vita del fetch event,
				 * consentendo la trasmissione asincrona e la bonifica dei log protetti
				 * in cache senza causare latenza sul thread di instradamento primario.
				 */
				event.waitUntil(svuotaCodaLogDallaCache());
			}

			// ⚙️ DA QUI IN POI PROSEGUE INALTERATO IL CODICE ORIGINALE...

Tip

➡️ Benvenuto!

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

⚖️ Licenza della: 📚 Wiki

Caution

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.

  • Dalla v7.3+ del Panzer 🪖, 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:

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

👉 🧞 Capitolo 7:
Estensione Architetturale Zero-Trust

  • Concept architetturale e framework di sicurezza per le Pubbliche Amministrazioni intenzionate ad adottare il modello.

👉 🏛️🚨 Capitolo 8: Protezione PA

  • Disciplinare Tecnico di Tutela dell'Ente con linee guida per Affidamenti Esterni.

🗂️ Indice Rapido Wiki

LOGO

Clone this wiki locally