L’Architettura DuaForma: Ingegneria d’Élite e Sovranità Tecnologica

Ci sono due modi di costruire una piattaforma digitale. Il primo è impilare plugin, sperare che l’ultimo aggiornamento di WordPress non rompa tutto, e chiamare “stack tecnologico” un ammasso di dipendenze che nessuno ha mai letto riga per riga. Il secondo è DuaForma.

Qui dentro non c’è una singola libreria che non sappiamo spiegare, non un pattern architetturale copiato da un tutorial YouTube, non una chiamata API di cui non conosciamo il costo esatto in millisecondi. Quello che segue non è una brochure. È un atto di trasparenza tecnica per chi ha il coraggio di guardare sotto il cofano — e la competenza per apprezzare cosa trova.

1. L’Era del Bloatware è Finita: Il Design System Raw-Brutalist

Il 99% dei siti web moderni carica mega-ottetti di framework CSS inutilizzati (come Bootstrap o Tailwind) e script Javascript ridondanti solo per mostrare un blocco di testo. Su DuaForma, l’inefficienza è considerata un bug.

Latenza del DOM Vicina allo Zero: abbiamo eliminato ogni singolo framework di terze parti. Il design system poggia su un’architettura Vanilla CSS pura, strutturata con griglie asimmetriche CSS Grid e Flexbox native. Il risultato? Il browser renderizza le nostre pagine in pochi millisecondi, consumando una frazione della CPU del tuo dispositivo.
Estetica Cyber-Brutalista: layout ad alto contrasto, ombre solide con offset matematico (zero sfocature grafiche), bordi spessi e micro-interazioni asincrone. Non cerchiamo di compiacere le masse con grafiche rassicuranti; imponiamo uno stile netto, focalizzato sulla leggibilità assoluta e sulla reattività fulminea del portale.
Zero Cumulative Layout Shift, per Principio: ogni elemento ha dimensioni dichiarate a priori. Non perché Google ce lo chieda per il Core Web Vitals — anche se lo fa — ma perché un layout che “salta” mentre l’utente legge è un insulto all’intelligenza di chi l’ha scritto.

2. DuaForma Brain: Oltre l’AI di Massa (Local RAG & Token-Slicing)

Chiunque è capace di collegare un’API generica inviando un intero database a OpenAI o Google, sprecando banda, accumulando latenza e pagando fatture spropositate. Noi abbiamo fatto di meglio. Abbiamo ingegnerizzato la DuaForma Brain: un motore di RAG (Retrieval-Augmented Generation) locale integrato a livello di kernel del plugin.

La Pipeline Computazionale della DuaForma Brain:

┌────────────────────────────────────────────────────────┐
│             INPUT UTENTE (Domanda Triage)              │
└───────────────────────────┬────────────────────────────┘
                            ▼
┌────────────────────────────────────────────────────────┐
│      TOKENIZZAZIONE & FILTRO SEMANTICO (Stopwords)     │
│       Isolamento e normalizzazione dei lemmi chiave    │
└───────────────────────────┬────────────────────────────┘
                            ▼
┌────────────────────────────────────────────────────────┐
│      PARAGRAPH RANKING ALGORITMICO (TF-IDF-like)       │
│    Scansione dinamica del database di conoscenza local │
└───────────────────────────┬────────────────────────────┘
                            ▼
┌────────────────────────────────────────────────────────┐
│        COMPRESSIONE PROMPT & TOKEN SLICING             │
│        Taglio netto del contesto a <1500 token         │
└───────────────────────────┬────────────────────────────┘
                            ▼
┌────────────────────────────────────────────────────────┐
│        EDGE INFERENCE A LATENZA ZERO (Groq LPU)        │
│    Inference hardware a 700ms con Llama-3.1-8b-instant │
└────────────────────────────────────────────────────────┘

Token-Slicing Algoritmico: quando interroghi il portale, un parser proprietario in PHP analizza la tua domanda, estrae i lemmi chiave ed elimina tutte le congiunzioni, articoli e preposizioni italiane. Il motore esegue poi una scansione della documentazione locale (spesso superiore ai 20.000 token) valutando la pertinenza di ciascun paragrafo.
Iniezione Dinamica del Contesto: invece di intasare i canali di rete, DuaForma Brain seleziona solo i blocchi di testo strettamente rilevanti alla domanda, riducendo le dimensioni del prompt a meno del 10% della taglia originale.
Edge Inference a Costo Zero: il prompt ottimizzato viene inviato direttamente a server a bassissima latenza equipaggiati con chip LPU (Language Processing Unit) di Groq o OpenRouter Free tiers. Questo ci permette di generare risposte ragionate in meno di 700 millisecondi sul modello Llama 3.1 8B, mantenendo l’operatività al 100% gratuita, stabile e protetta da sovraccarichi globali.
Nessuna Dipendenza da Vendor Lock-in: il layer di astrazione della Brain non conosce il concetto di “provider unico”. Se un endpoint LPU satura o degrada in latenza, il motore ruota silenziosamente su un secondo provider compatibile OpenAI-spec, senza che l’utente percepisca la minima discontinuità.

3. Rete Infallibile: Failover Asincrono e Proxy Auto-Sensing

Un software d’élite deve essere in grado di funzionare in qualsiasi condizione ambientale. I server locali e aziendali sono spesso ostacolati da configurazioni di rete stringenti, proxy interni o blocchi cURL diretti sulla porta 443. DuaForma ha superato questo limite con una rete corazzata a doppio livello:

Proxy Auto-Sensing: durante l’inizializzazione della chiamata API, il nostro handler PHP scansiona le costanti globali di sistema (WP_PROXY_HOST, WP_PROXY_PORT, ecc.). Se rileva la presenza di un proxy, riconfigura istantaneamente i descrittori cURL per incanalare il traffico in sicurezza.
WordPress HTTP API Backup Handler: se il canale cURL fallisce o va in timeout per problemi di handshake SSL o restrizioni firewall, il plugin intercetta silente l’evento e lancia una chiamata di backup tramite il wrapper HTTP nativo di WordPress (wp_remote_post). Se c’è una via d’uscita verso internet, DuaForma la trova.
Retry Esponenziale con Circuit Breaker: ogni chiamata fallita non viene semplicemente ritentata a raffica — sarebbe amatoriale. Un backoff esponenziale distanzia i tentativi, e dopo una soglia di errori consecutivi il circuito si apre da solo, evitando di martellare un endpoint già in sofferenza. Si richiude automaticamente al primo segnale di salute.

4. Handover Asincrono e State Machine Tracking

Cosa succede quando la DuaForma Brain capisce che è giunto il momento di passare la palla a un operatore umano? Il portale attiva un flusso di orchestrazione automatizzato:

State Machine CPT: la richiesta dell’utente e la trascrizione del triage AI vengono registrate nel database di WordPress sotto forma di Custom Post Type (df_ticket) con stato iniziale Aperto.
Make Webhook Dispatch: il server lancia un webhook asincrono assecondando il protocollo POST per notificare le piattaforme esterne degli operatori umani (Make.com).
Secure Check AJAX: l’utente non ha bisogno di account complessi. Grazie a transazioni asincrone protette da token di sicurezza WP Nonce, può consultare in tempo reale lo stato di lavorazione del ticket digitando semplicemente il suo Ticket ID ed Email.
Transizioni di Stato Immutabili: ogni cambio di stato (Aperto → In carico → Risolto → Archiviato) viene loggato con timestamp e attore, così la cronologia del ticket è un audit trail vero, non un campo testo sovrascritto a ogni aggiornamento.

5. Sicurezza by Design, Non by Afterthought

La maggior parte dei siti tratta la sicurezza come una toppa da applicare dopo un data breach. DuaForma la tratta come un vincolo architetturale non negoziabile, presente dal primo commit.

Sanitizzazione a Doppio Strato: ogni input utente viene sanificato lato client per l’esperienza d’uso e ri-sanificato lato server perché, diciamocelo, il client non è mai una fonte affidabile.
Nonce su Ogni Superficie di Scrittura: nessuna azione che modifica lo stato del sistema — apertura ticket, invio dati, aggiornamento profilo — viaggia senza un token di verifica legato alla sessione.
Principio del Privilegio Minimo: ogni ruolo, dal volontario all’amministratore di rete, opera con l’insieme minimo di permessi necessario. Non esistono account “superuser per comodità”: la comodità non è un criterio di sicurezza.
Logging Strutturato senza Esporre Dati Sensibili: gli errori vengono tracciati con contesto tecnico completo per il debug, ma senza mai scrivere in chiaro dati personali o credenziali nei log — perché un log leggibile da un ingegnere non deve essere leggibile da chiunque altro.

6. Performance come Filosofia, non come Metrica da Cruscotto

Chiunque può mostrare un punteggio verde su un tool di audit dopo aver ottimizzato la pagina che gli hanno chiesto di controllare. Noi ottimizziamo perché un millisecondo sprecato è un millisecondo rubato a chi sta cercando aiuto, o a chi sta cercando di darlo.

Caching Stratificato: cache oggetto a livello di database, cache di pagina a livello di edge, invalidazione mirata e chirurgica — mai un flush all che azzera settimane di lavoro di ottimizzazione in un secondo.
Query Database Chirurgiche: nessuna query N+1, nessun SELECT * lasciato lì per pigrizia. Ogni interrogazione al database è scritta per restituire esattamente ciò che serve, né un byte in più.
Asset Critici Inline, il Resto Differito: il CSS critical-path viene inlineato per il primo rendering; tutto il resto — font, script non essenziali, immagini sotto la piega — viene caricato in modo asincrono e differito, senza bloccare mai il thread principale.

Conclusione: Non Chiediamo Fiducia, la Dimostriamo

Il web del terzo settore è pieno di piattaforme costruite in fretta, vendute con slide patinate e sostenute da infrastrutture che nessuno ha davvero controllato. DuaForma ha scelto la strada più lunga e più scomoda: capire ogni riga, ottimizzare ogni chiamata, blindare ogni superficie d’attacco.

Non è marketing. È l’unico modo in cui sappiamo costruire software che deve reggere il peso di storie vere, dati sensibili e persone che si affidano a noi nel momento del bisogno.

Questa è l’architettura. Il resto, ve lo raccontano i risultati.

Manifesto tecnologico