Passa al contenuto principale

Panoramica Concettuale

In questa sezione esploreremo l'architettura di Webround e come i diversi moduli interagiscono tra loro per trasformare una configurazione astratta in un ecosistema digitale performante e altamente estensibile.

Architettura disaccoppiata​

Webround opera secondo un modello Headless-first, basato sulla separazione netta tra definizione, esecuzione e dati:

  1. Configuration Layer (Editor): È l'ambiente di progettazione. Qui si definisce la struttura visiva e logica. Il risultato non è un codice statico "chiuso", ma uno Schema JSON descrittivo che governa il comportamento del sito.
  2. Execution Layer (Runtime): L'applicazione React che interpreta lo schema JSON. Il runtime è un'entità dinamica: non contiene dati fissi, ma instanzia l'interfaccia e la logica in tempo reale, permettendo l'iniezione di codice React custom o l'interazione con API esterne.
  3. Data Layer (Commerce & API): La sorgente della verità per le entità dinamiche (prezzi, inventario, ordini, metadati). È il motore che abilita la logica di business indipendentemente dal livello di presentazione.

Ciclo di vita di un progetto​

Il flusso di lavoro in Webround è progettato per garantire sicurezza operativa senza sacrificare la libertà implementativa:

1. Drafting e Staging Permanente​

Ogni progetto nasce come Draft. In questa fase, la configurazione è privata e isolata. Le modifiche risiedono nel browser fino al salvataggio, momento in cui vengono persistite su storage distribuito crittografato. Questo garantisce un ambiente di staging costante: puoi testare logiche React complesse o nuovi Hook senza alcun impatto sul sito pubblico, con la garanzia di essere l'unico ad avere permessi di lettura e scrittura.

2. Commerce Orchestration (Store)​

L'abilitazione delle funzioni e-commerce avviene tramite la creazione di uno Store. Architetturalmente, lo Store è un'entità indipendente dal Draft. Questa separazione è fondamentale: puoi avere un Draft che consuma dati da uno Store, ma puoi anche avere uno Store che serve dati a sistemi esterni (App mobile, POS, siti legacy) tramite API, mentre il Draft funge solo da interfaccia amministrativa o sito vetrina.

3. Edge Deployment​

La pubblicazione (Deploy) innesca un processo di build che valida gli schemi, ottimizza gli asset statici e distribuisce il tutto sulla Edge Network di Webround. Grazie alla presenza globale del runtime sui nodi edge, il sito beneficia di latenze minime e della capacità di eseguire logica middleware tramite gli Hook prima che la pagina raggiunga l'utente. Questo ti consente un approccio server-side a un'app statica React + Vite.

Open Logic e Libertà di Integrazione​

Webround non è un sistema chiuso. La sua architettura "Open-Logic" permette di superare i limiti del no-code tradizionale attraverso tre direttrici di estendibilità:

  • Custom React Injections: Grazie alla SDK di Webround, puoi inserire componenti React personalizzati direttamente nel runtime. Puoi installare librerie npm, gestire stati globali o creare widget complessi che interagiscono nativamente con il carrello e il catalogo.
  • Server-Side Hooks: Puoi intercettare le richieste a livello Edge per modificare il comportamento del checkout o del rendering. Questo permette di implementare logiche di pricing dinamico, restrizioni d'accesso o integrazioni B2B che richiedono calcoli server-side sicuri.
  • Ecosistema Headless: Webround Commerce può essere utilizzato come motore puro. Attraverso le API e i Webhook, puoi:
    • Sincronizzare il magazzino con ERP o gestionali on-premise.
    • Usare Webround come layer di autenticazione per applicazioni terze.
    • Creare flussi di automazione post-vendita (invio documenti, trigger CRM).
    • Sviluppare interfacce di amministrazione custom su misura per il tuo workflow.

Prossimi passi​

Per approfondire la configurazione tecnica e l'estensione della piattaforma: