Come funziona Atlas

Gli elementi di base

Concetto	Che cos’è
Organizzazione	La Sua azienda. Possiede siti, persone e il proprio piano.
Sito	Un sito web. Contenuti, media, accessi delle persone e impostazioni non passano mai da un sito all’altro.
Ambiente	Ogni sito ha uno Sviluppo e una Produzione. Si lavora in Sviluppo; la Produzione serve solo un rilascio approvato.
Contratto del sito	Una descrizione JSON del Suo sito web: i suoi componenti e i relativi campi tipizzati, i tipi di pagina, le raccolte, i contenuti globali di intestazione e piè di pagina, i profili media e i design token.
Pagina	Un percorso del Suo sito web (per esempio /about), composto da sezioni. Ogni sezione è uno dei componenti del Suo contratto, con i valori dei suoi campi.
Voce	Un elemento di una raccolta, come un prodotto o un articolo di cronaca.
Contenuto globale	Contenuto condiviso tra le pagine, come l’intestazione e il piè di pagina del sito.
Token di consegna	Un token solo lato server che il Suo sito web usa per leggere i contenuti pubblicati di un ambiente.

Come i contenuti raggiungono il Suo sito web

 Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision
                                                                     │
                       your website server ◀── Delivery API (HTTPS, delivery token)
                               │
                       your components render it ──▶ visitors

1. I Suoi sviluppatori descrivono il sito web nel contratto del sito. Un amministratore del sito lo attiva in Studio.
2. I redattori creano e modificano pagine e voci come bozze. Le bozze non compaiono mai sul sito web pubblico.
3. I redattori vedono l’anteprima di una bozza all’interno del vero design del Suo sito web, poi pubblicano. Ogni pubblicazione è una revisione immutabile, quindi è possibile ripristinare una versione precedente.
4. Il Suo sito web legge i contenuti pubblicati dall’API di consegna con il proprio token di consegna, solo da codice server.
5. Atlas invia un webhook firmato a ogni pubblicazione, così il Suo sito web aggiorna solo le pagine interessate.

Sviluppo e Produzione

• Ogni nuovo sito parte in Sviluppo. I contenuti vengono modificati e pubblicati lì.
• La Produzione resta disattivata finché un amministratore del sito non la attiva, dopo che un rilascio ha superato tutti i controlli e una persona con diritti di approvazione lo ha approvato.
• La Produzione serve solo il proprio rilascio attivo e firmato: un’istantanea congelata dei contenuti approvati. Modificare lo Sviluppo non cambia mai la Produzione fino al successivo rilascio approvato.
• Cambiare ambiente in Studio modifica solo ciò che sta guardando. Non cambia mai i contenuti.

Approfondimento: Sviluppo e Produzione.

Che cosa deve fare il Suo sito web

Atlas non viene eseguito sul Suo sito web. I Suoi sviluppatori aggiungono una piccola quantità di codice:

• un client solo lato server per l’API di consegna;
• il rendering delle sezioni tramite i Suoi componenti esistenti;
• un fallback: se Atlas non è raggiungibile o non ha nulla di pubblicato per una pagina, il sito serve i propri contenuti integrati;
• un percorso per l’anteprima delle bozze, un ricevitore di webhook e un rapporto di build.

La guida alla connessione illustra ciascuno di questi elementi.