Passa al contenuto principale

Cos’è Webround

Webround è una piattaforma per la creazione di siti web ed e-commerce che elimina la necessità di gestire codice, infrastrutture, hosting o processi applicativi.

La piattaforma opera attraverso un disaccoppiamento esplicito tra:

  • Struttura e design
  • Contenuto
  • Logica e-commerce e servizi di backend

Questa separazione consente di lavorare sul progetto in modo modulare e controllato, riducendo drasticamente la complessità operativa e il rischio di errori.

Webround è progettata per essere accessibile anche senza competenze di sviluppo: le funzionalità sono gestite tramite interfacce guidate e ogni operazione critica viene orchestrata dalla piattaforma. L’obiettivo è fornire un sistema solido per gestire una presenza online professionale, eliminando i costi delle soluzioni custom e garantendo affidabilità in contesti di produzione.

Allo stesso tempo, il supporto nativo per l'iniezione di codice React trasforma la piattaforma in uno strumento avanzato per sviluppatori e agenzie. Puoi integrare strumenti custom, widget complessi o intere logiche front-end mantenendo il 100% del lavoro fatto dal backend Webround.

Combiniamo il meglio dei tre mondi:

  • No-code: Gestione senza competenze tecniche tramite editor visuale.
  • React Developers: Libertà totale di inserimento e override di componenti personalizzati.
  • Tutti i Developers: Grazie all'approccio API-First e ai Webhook, è possibile integrare virtualmente qualsiasi cosa.

Come funziona​

Nella sua configurazione standard, Webround è composto da tre componenti principali:

Editor dei siti web​

L’editor genera i file di configurazione JSON di un sito Webround, che definiscono:

  • Pagine e layout
  • Componenti e stili
  • Contenuti
  • Traduzioni
  • Iniezioni di codice personalizzato

La gestione di questi file non richiede scrittura di codice, ma segue un approccio no-code estendibile. Attraverso l'editor, l'utente crea configurazioni pronte per essere trasformate in siti web performanti.

Runtime​

Il runtime è l'applicazione finale e rappresenta il cuore logico della piattaforma. Trasforma le configurazioni JSON in:

  • Build statiche ottimizzate (React + Vite)
  • Siti pubblici distribuiti tramite CDN

Webround fornisce un ecosistema di React App preconfigurate il cui compito è interpretare i JSON specifici del sito. Il runtime è autonomo, non necessita di componenti esterni ed è pronto all'uso su qualsiasi configurazione compatibile.

Commerce​

Webround Commerce gestisce l'intero stack e-commerce: prodotti, varianti, carrello, checkout, ordini, tasse e spedizioni.

I pagamenti sono orchestrati tramite Stripe. Webround funge da layer tecnologico per l'integrazione trasparente tra il sito e il gateway di pagamento. Essendo un sistema indipendente, offre un'elevata flessibilità: l'integrazione con Webround Sites è solo uno dei possibili scenari; grazie alle API pubbliche, Webround Commerce può essere utilizzato come motore e-commerce in qualsiasi sistema esterno, sia esso del codice personalizzato, un'app mobile, un sito indipendente da Webround, un sistema legacy e qualsiasi altro dispositivo programmabile in grado di comunicare su internet.

Store e Draft​

Questi sono i "building blocks" fondamentali della piattaforma.

Un Draft rappresenta un progetto Webround:

  • È una versione di lavoro che permette modifiche senza impattare il sito live.
  • La pubblicazione richiede un abbonamento valido e trasforma il draft in sito pubblico.
  • Ogni draft appartiene a un singolo utente ed è isolato: non condivide dati con altri progetti.

Uno Store rappresenta un progetto Webround Commerce:

  • È l'unità fondamentale per la gestione della logica di vendita.
  • Agisce come contenitore e filtro per prodotti, categorie e dati transazionali.
  • È isolato dagli altri store e garantisce la segregazione dei dati.
  • Uno store è sempre logicamente legato a un draft per questioni di integrazioni fondamentali come i servizi email.

La differenza è sia funzionale che infrastrutturale. Tuttavia, i sistemi sono pensati per lavorare insieme: un draft può evolvere in un sito pubblico collegato a un dominio, integrando le funzionalità del relativo store, come il checkout con Stripe o il filtraggio del catalogo gestito tramite Webround Commerce.

È importante notare che uno store non è un sito web in sé, ma un'entità "headless" che abilita la vendita. I dati dello store sono accessibili da qualsiasi sistema esterno che rispetti i contratti delle API di Webround Commerce. Il draft è nativamente configurato per rispettare questi contratti.

React custom code​

L'editor Webround e il suo runtime sono normali React App. Grazie all'integrazione dei Web Components, è possibile inserire codice React personalizzato, installare qualsiasi dipendenza npm tramite package.json e renderizzare componenti personalizzati all'interno dell'editor e del sito pubblicato, sfruttando la prop wr, che funge da vera e propria SDK per la gestione dello stato dell'app. Questo semplifica drasticamente l'integrazione di codice personalizzato all'interno di un framework e-commerce pronto all'uso.

Webhook ed eventi​

Per facilitare l'integrazione con ecosistemi di terze parti, Webround permette la registrazione di Webhook. Un webhook è un dispatcher di eventi che riguardano il tuo store e vengono comunicati a sistemi di tua gestione.

Questa soluzione offre diversi vantaggi:

  • Integrazione nativa con sistemi custom, SaaS o soluzioni proprietarie.
  • Configurazione di endpoint specifici per eventi determinati, come l'acquisto di prodotti o la registrazione di utenti sul tuo sito.
  • Creazione di flussi di lavoro su infrastrutture parallele gestite dal cliente.

Ogni evento viene consegnato solo se la configurazione è valida. La sicurezza è garantita da un segreto di autenticazione con cui Webround firma i payload, assicurando l'integrità e l'origine dei dati ricevuti.

Webround Documents​

Webround include una suite di creazione grafica per supportare la strategia di contenuto:

  • Creazione di documenti esportabili in formati PDF, PNG e WebP.
  • Automazione di flussi di lavoro (es. documenti personalizzati per ogni cliente).
  • Integrazione dinamica dei dati dei prodotti da Webround Commerce.

I documenti possono essere creati da zero o tramite template per casi d'uso come fatture, grafiche social o piani personalizzati.

Obiettivo​

Webround nasce per:

  • Consentire la creazione di siti senza boilerplate infrastrutturale.
  • Vendere online senza gestire backend o infrastrutture complesse.
  • Garantire il controllo totale su dati e flussi operativi.

La piattaforma è uno strumento versatile: il programmatore può usarla per risparmiare tempo sullo stack e-commerce tramite codice personalizzato, API e webhook; l'agenzia può sfruttare l'editor drag-and-drop per landing page e siti vetrina; l'azienda può scalare le vendite gestendo logiche di business complesse in totale autonomia.

Questa documentazione descrive il funzionamento tecnico e i flussi supportati della piattaforma.