Glossario

Astro — framework che genera siti statici e idrata solo le parti interattive.

Base path — prefisso URL quando il sito non sta sulla radice del dominio (es. GitHub Pages project site: /JEVIS-Headless-Site-Template).

Build — processo che legge i contenuti, valida, renderizza e produce dist/.

CI — automazione che esegue test e build a ogni push/PR (qui GitHub Actions).

CMS headless — CMS senza frontend: espone contenuti via API e non genera pagine. Qui è WordPress.

Collection — gruppo di contenuti in Astro (una per CPT), definita in src/content.config.ts.

Content Layer — sistema di Astro che popola le collezioni tramite loader.

CPT (Custom Post Type) — tipo di contenuto personalizzato in WordPress (evento, tariffa, FAQ…).

Debounce — attesa che accorpa eventi ravvicinati in una sola azione (qui 60 secondi sul webhook).

Domain model — il tipo pulito usato dai componenti (Evento, Tariffa), separato dal JSON del CMS.

Fallback — comportamento di ripiego quando WordPress non risponde (ENABLE_HTML_FALLBACK): collezioni vuote invece di build rossa. Solo in locale.

FTPS — FTP su TLS: protocollo usato dal workflow di deploy verso hosting tradizionali.

Isola (island) — componente interattivo idratato nel browser, isolato dal resto della pagina statica.

Loader — funzione che scarica e valida i contenuti di una collezione.

Mapper — funzione che converte il dato WordPress nel domain model.

mu-plugin — plugin WordPress sempre attivo, caricato prima dei plugin normali. Qui registra CPT, meta e impostazioni.

Preview — anteprima di una modifica prima della pubblicazione. Non è disponibile in questo template (conseguenza dello statico).

repository_dispatch — evento GitHub inviato via API per far partire un workflow. È il meccanismo del rebuild automatico.

REST API — API HTTP di WordPress (/wp-json/...) da cui la build legge i contenuti.

Schema (Zod) — descrizione runtime della forma attesa di un dato; se non combacia, la build fallisce.

SSG — Static Site Generation: le pagine sono generate in build, non a richiesta.

Starlight — tema Astro per documentazione; è usato per questa guida.

Token (design token) — variabile semantica di stile (--color-accent) usata al posto di colori hardcoded.

Webhook — notifica HTTP che WordPress manda a GitHub quando un contenuto cambia.

concurrency (GitHub Actions) — regola che serializza i workflow con lo stesso group; qui evita deploy sovrapposti.