Passa al contenuto principale

Glossario

Questa pagina definisce i termini canonici usati in tutta la documentazione di Agon. In caso di dubbio, usa esattamente questi termini — non i sinonimi.

Studio manager​

Il proprietario o amministratore di un'installazione Agon. Il studio manager crea le lezioni, gestisce clienti e istruttori, configura gli abbonamenti e ha accesso completo a tutte le impostazioni e i report.

Non: admin, proprietario, operatore.

Cliente​

Una persona che frequenta le lezioni presso lo studio. I clienti usano l'app mobile Agon per consultare il calendario, prenotare le lezioni ed effettuare il check-in.

Non: membro, studente, utente, cliente abbonato.

Istruttore​

Un membro dello staff che tiene le lezioni. Gli istruttori sono distinti dagli studio manager — possono vedere il calendario delle lezioni e la lista partecipanti ma non possono modificare le impostazioni dello studio né accedere ai dati finanziari.

Non: insegnante, coach, allenatore, membro dello staff.

Tipo di lezione​

Una definizione riutilizzabile di un tipo di lezione — nome, durata predefinita, capienza predefinita e istruttore associato. Pensalo come il "modello" della lezione, non una singola occorrenza.

Esempio: "Vinyasa Flow" è un tipo di lezione. Ogni martedì alle 9:00 è una lezione pianificata separata basata su quel tipo.

Non: categoria di lezione, definizione di lezione, attività.

Lezione pianificata​

Un'occorrenza specifica di un tipo di lezione in una data e un orario specifici, in una sede specifica, con un istruttore confermato e una capienza. I clienti prenotano lezioni pianificate, non tipi di lezione. Una lezione pianificata è un'attività di gruppo con capienza condivisa — vedi Appuntamento per l'equivalente 1-a-1.

Non: sessione di lezione, evento, slot.

Prenotazione​

La riservazione confermata di un cliente per una specifica lezione pianificata. Una prenotazione scala un credito dall'abbonamento attivo del cliente (se applicabile) e concede al cliente l'accesso al check-in.

Non: reservation, registrazione, iscrizione.

Appuntamento​

La prenotazione confermata 1-a-1 di un cliente con un istruttore specifico per un determinato servizio di appuntamento (ad esempio personal training, massaggio o coaching privato) in una data e un orario specifici. A differenza di una lezione pianificata, un appuntamento ha esattamente un cliente e nessuna capienza condivisa. Prenotare un appuntamento scala un credito dall'abbonamento attivo del cliente, lo stesso meccanismo usato per la prenotazione delle lezioni — non esiste un percorso di pagamento separato per gli appuntamenti. Uno studio manager o un istruttore può segnare un appuntamento confermato come completato o come mancata presentazione in seguito, e si applica la stessa politica di penale per cancellazione tardiva / mancata presentazione delle prenotazioni delle lezioni.

Non: sessione, lezione privata, sessione 1-a-1, reservation, lezione.

Servizio di appuntamento​

Un tipo di appuntamento definito dallo studio manager che i clienti possono prenotare (ad esempio "Personal Training" o "Massaggio 60 minuti"), con una durata fissa e un tempo cuscinetto opzionale — un intervallo imposto dopo ogni appuntamento prima che possa iniziare il successivo per lo stesso istruttore. Disattivare un servizio è un'eliminazione soft: smette di comparire per le nuove prenotazioni, ma la cronologia degli appuntamenti che lo referenziano viene preservata. Non esiste un'opzione di eliminazione definitiva.

Non: tipo di servizio, tipo di sessione, trattamento.

Disponibilità istruttore​

Le fasce orarie settimanali ricorrenti durante le quali un istruttore può essere prenotato per appuntamenti (ad esempio "martedì 09:00–13:00"). La disponibilità è solo ricorrente su base settimanale — Agon non supporta ancora eccezioni per date specifiche o sostituzioni per festività. Gli slot orari disponibili per l'appuntamento vengono calcolati a partire da queste fasce, sottraendo gli appuntamenti già confermati dell'istruttore e il tempo cuscinetto del servizio da prenotare.

Non: orario di lavoro, programma, turno.

Lista d'attesa​

Se una lezione pianificata è al completo, i clienti possono iscriversi alla lista d'attesa. Quando una prenotazione viene cancellata, il primo cliente in lista d'attesa viene promosso automaticamente a prenotazione confermata e notificato.

Check-in​

Conferma che un cliente ha fisicamente partecipato a una lezione. Il check-in può essere effettuato dal cliente (tramite codice QR nell'app mobile), dall'istruttore (scansionando il codice del cliente) o manualmente dallo studio manager.

Non: sign-in, presenza, timbratura.

Abbonamento​

Un pacchetto che dà a un cliente accesso alle lezioni per un periodo di tempo. Esistono due tipi:

  • Abbonamento ricorrente — attivo per un numero fissato di giorni (es. 30 giorni) e rinnovato automaticamente tramite Stripe.
  • Pacchetto crediti — un numero fisso di crediti consumati uno per prenotazione, senza limite di tempo.

Non: subscription, piano, pacchetto (come sinonimo di abbonamento), pass.

Credito​

Un'unità singola di accesso a una lezione, inclusa in un abbonamento a pacchetto crediti. Ogni prenotazione scala un credito. I crediti non scadono a meno che l'abbonamento stesso non abbia una data di scadenza.

Non: token, punto, credito sessione, class pass.

Credito riportato​

Un credito non utilizzato che viene riportato nel periodo di fatturazione successivo del cliente invece di andare perso, quando un tipo di abbonamento ricorrente ha il riporto crediti abilitato. Un tipo di abbonamento può opzionalmente limitare quanti crediti possono essere riportati per periodo.

Non: credito trasferito, credito accumulato.

Offerta di benvenuto​

Un prezzo scontato per il primo acquisto e/o una finestra di validità su un tipo di abbonamento, mostrato automaticamente a un cliente la prima volta che acquista quel tipo di abbonamento (o un altro tipo con offerta di benvenuto presso lo stesso studio). Il prezzo regolare si applica a tutti gli acquisti successivi.

Non: offerta di prova, sconto di benvenuto, sconto per nuovi clienti.

Penale cancellazione tardiva / Penale mancata presentazione​

Un addebito registrato a carico di un cliente quando cancella una prenotazione all'interno della finestra di cancellazione (una cancellazione tardiva, solo se "la cancellazione scala un credito" è abilitato) oppure viene segnato come mancata presentazione al check-in. Risolto per ciascun cliente secondo quest'ordine: l'override del tipo di abbonamento del cliente, poi il valore predefinito a livello di studio, poi nessuna penale. Registrato come riga Payment piuttosto che come addebito automatico su carta — lo studio deve comunque incassarlo tramite il proprio processo.

Non: penalty, addebito di cancellazione (come concetto distinto dalla penale stessa).

Codice promozionale​

Un codice che un cliente inserisce al momento del pagamento di un abbonamento per ricevere uno sconto percentuale o a importo fisso. Configurato dallo studio manager con un limite di utilizzo opzionale, una restrizione di un utilizzo per cliente e una finestra di validità.

Non: codice sconto, coupon.

Carta regalo​

Un saldo prepagato identificato da un codice (formato GC-XXXXXXXX) che un cliente può utilizzare per un acquisto di abbonamento, oppure che uno studio manager emette manualmente per una vendita telefonica o di persona. Un cliente può anche acquistare una carta regalo per farne dono a qualcun altro.

Non: voucher, nota di credito.

Etichetta​

Un'etichetta breve e colorata che uno studio manager assegna a un cliente per organizzare e filtrare la lista clienti (ad es. "VIP", "Rischio infortunio"). Le etichette possono essere assegnate manualmente o automaticamente tramite una regola di etichettatura automatica. I clienti vedono le proprie etichette in sola lettura nell'app mobile.

Non: label (come concetto distinto), categoria.

Prodotto​

Un articolo che lo studio manager gestisce nel catalogo per la vendita in sede — ad esempio una barretta proteica o una borraccia — con nome, SKU facoltativo, prezzo e quantità in magazzino tracciata. Si gestisce in Prodotti nel backoffice desktop; solo per lo studio manager, senza visibilità per i clienti.

Non: articolo, SKU (lo SKU è un campo del prodotto, non il prodotto stesso).

Vendita di prodotto​

La registrazione di una vendita in sede completata di uno o più prodotti, inserita dallo studio manager dopo che il pagamento è già stato incassato in contanti, con carta o con un altro metodo esterno ad Agon. Può essere collegata a un cliente o restare una vendita a un cliente occasionale. Registrare una vendita scala le quantità vendute dal magazzino di ciascun prodotto.

Non: ordine, transazione, acquisto (riservato agli acquisti di abbonamenti e carte regalo elaborati tramite Stripe).

Regola di etichettatura automatica​

Una regola che assegna automaticamente un'etichetta a un cliente ogni volta che si verifica un evento scatenante scelto (ad esempio, una mancata presentazione o una prenotazione cancellata). Configurata dallo studio manager; funziona automaticamente senza alcuna azione manuale una volta creata.

Modulo di consenso​

Un documento (ad esempio una liberatoria di responsabilità o un regolamento dello studio) che uno studio manager redige e può richiedere ai clienti di firmare digitalmente prima di prenotare. Modificare il testo di un modulo di consenso crea una nuova versione e richiede a ogni cliente di firmare nuovamente, anche a chi aveva firmato una versione precedente. La firma è sempre a cura del cliente stesso — non esiste un modo per uno studio manager o un istruttore di firmare per conto di un cliente.

Non: consent form (usare solo per il registro di consenso GDPR separato), liberatoria (come sinonimo distinto), accordo.

Token di sincronizzazione calendario​

Un segreto a lunga durata incorporato nell'URL del feed calendario personale di un cliente, necessario perché le app di calendario (Google, Apple, Outlook) interrogano periodicamente un URL statico e non possono effettuare un login applicativo. Il token nell'URL è esso stesso la credenziale. Un cliente o uno studio manager può rigenerarlo, invalidando il vecchio link e richiedendo una nuova sottoscrizione.

Sede​

Un luogo fisico in cui si svolgono le lezioni. Nella V1, Agon supporta una sola sede. Il supporto multi-sede è previsto per la V2. Il campo location_id è già presente nello schema del database.

Non: filiale, venue, studio (usare "studio" solo per riferirsi all'intera attività, non a una sede o edificio specifico).

Tunnel​

Un URL HTTPS pubblico e sicuro creato tramite Cloudflare Tunnel che consente ai tuoi clienti di collegare l'app mobile alla tua istanza Agon da qualsiasi luogo, senza esporre la tua rete locale.

Non: URL, connessione, link, proxy.

Codice QR dello studio​

Un codice QR mostrato in Impostazioni → App Mobile che codifica l'URL del Tunnel. I clienti scansionano questo codice una volta, durante la configurazione dell'app mobile, per collegarsi al tuo studio.

Widget del sito web​

Un pannello incorporabile e in sola lettura del calendario lezioni che uno studio manager incolla sul proprio sito web pubblico come <iframe> (snippet di incorporamento disponibile in Impostazioni → Widget del sito web). Mostra le lezioni programmate in arrivo con istruttore e posti disponibili, usando i colori del brand dello studio — mai prezzi, abbonamenti, elenchi clienti o contatti degli istruttori. Non supporta ancora la prenotazione di una lezione dall'interno del widget; i clienti prenotano ancora tramite l'app mobile. Il widget viene servito dall'URL del Tunnel dello studio, quindi il suo snippet di incorporamento va ricopiato ogni volta che l'indirizzo del tunnel cambia (per esempio dopo un riavvio del backend Agon).

Non: widget del calendario, widget di prenotazione, embed, iframe.

Token di invito​

Un token a tempo limitato inviato via email a un cliente appena creato. Il cliente segue il link per impostare la propria password e attivare l'account. Scade dopo 7 giorni.

Token di reset​

Un token a tempo limitato inviato via email quando un cliente richiede il reset della password. Scade dopo 2 ore.

Smart List​

Un filtro salvato che identifica un sottoinsieme di clienti in base allo stato dell'abbonamento, alla recenza delle prenotazioni, alla data di iscrizione o al tipo di abbonamento. Utilizzato per inviare email mirate.

Blocco​

Un singolo elemento nel canvas dell'Editor email visuale — testo, immagine, pulsante, divisore, spaziatore o HTML — che lo studio manager aggiunge, dispone e configura per costruire un modello email. I blocchi si impilano dall'alto verso il basso e ognuno ha i propri controlli (allineamento, colore, dimensione e così via) mostrati quando il blocco è selezionato; il canvas mostra l'email esattamente come verrà inviata, in tempo reale, senza un passaggio di anteprima separato. Un modello creato o modificato prima di questa funzione non ha blocchi: quando lo apri viene proposto "Converti in canvas", che racchiude l'HTML esistente in un unico blocco iniziale così nulla va perso.

Non: elemento, componente, widget, modulo.

Assegnazione evento​

Una configurazione che collega un evento Agon (ad es. "nuovo cliente invitato", "prenotazione confermata") a un modello email o SMS specifico. Quando l'evento si verifica, il modello assegnato viene inviato automaticamente — a condizione che quell'evento sia effettivamente collegato all'invio di messaggi (attualmente solo "nuovo cliente invitato" e "reset password" attivano un invio, sia per email che per SMS).

Automazione di marketing​

Una sequenza di email e/o SMS in più passaggi e con ritardi, che lo studio manager costruisce una volta e non invia mai più a mano — ad esempio "3 giorni dopo l'iscrizione invia un'email; dopo altri 7 giorni, se il cliente non ha ancora prenotato, inviane un'altra". È composta da un trigger (un evento come una nuova iscrizione o prenotazione, oppure una condizione ricorrente come "non prenota da 30 giorni"), da un elenco ordinato di passaggi (ciascuno con un ritardo, un canale e un modello) e da una condizione di arresto facoltativa. Un cliente viene iscritto automaticamente quando il trigger corrisponde, e al massimo una volta per automazione. A differenza di un'assegnazione evento, che invia un solo messaggio nell'istante in cui si verifica un evento, un'automazione di marketing distribuisce più messaggi nel tempo.

Non: campagna drip, workflow, sequenza (da sola, senza "automazione").

Lezione Online​

Una lezione pianificata che il gestore dello studio ha contrassegnato come "Online (Zoom)", per la quale Agon crea e gestisce automaticamente una vera riunione Zoom tramite l'account Zoom collegato del gestore dello studio. Può essere contrassegnata come online solo una lezione singola (non ricorrente). I clienti vedono un link per partecipare rivolto ai clienti ("Partecipa su Zoom") sulla lezione e sulla loro prenotazione; il gestore dello studio e l'istruttore vedono separatamente un link di avvio riservato all'host ("avvia riunione"), che non viene mai mostrato ai clienti. Disponibile con qualsiasi piano Zoom, incluso quello gratuito.

Non: lezione virtuale, lezione Zoom, lezione in streaming.

Assistente di migrazione​

Lo strumento integrato per importare in Agon i tuoi clienti, abbonamenti e lezioni da un'esportazione CSV, Excel o JSON della tua piattaforma attuale. Accessibile da Impostazioni → Migrazione e disponibile solo per i Manager. Ogni tipo di dato si importa separatamente, uno alla volta. Agon non si collega mai alla tua vecchia piattaforma e non ne chiede le credenziali: esporti tu stesso i tuoi dati e carichi il file.

Componente retributiva​

Una singola regola che definisce come viene pagato un membro dello staff — Oraria, Per lezione, Commissione o Stipendio fisso. Un membro dello staff può avere contemporaneamente più componenti attive di tipo diverso (ad esempio una tariffa oraria e una commissione), ma mai due componenti attive dello stesso tipo. Si gestisce in Buste Paga; solo per lo studio manager, senza visibilità per i clienti.

Non: tariffa, voce di stipendio, regola di compenso.

Ciclo di buste paga​

Il calcolo, generato dallo studio manager, di quanto spetta a ogni membro dello staff per un intervallo di date scelto, a partire dalle sue componenti retributive attive. Un ciclo nasce come bozza, che si può rigenerare liberamente, e diventa finalizzato quando lo studio manager lo blocca: gli importi di un ciclo finalizzato non cambiano più. Segnare come pagate le voci di un ciclo finalizzato registra che lo studio manager ha pagato il membro dello staff al di fuori di Agon; in Agon non si muove denaro.

Non: periodo di paga, cedolino.

Ruolo​

Un insieme di permessi con un nome, assegnato a un solo account dello staff, che determina cosa quell'account può vedere e fare nell'app desktop. Manager e Istruttore sono ruoli predefiniti che esistono sempre e non si possono rinominare né eliminare. Lo studio manager può anche definire un numero qualsiasi di ruoli personalizzati (ad esempio "Reception"), ciascuno con permessi di Visualizzazione e/o Gestione su una combinazione di cinque aree: Lezioni, Membri, Prenotazioni, Check-in e Abbonamenti. Si gestisce in Personale e Ruoli; solo per lo studio manager, senza visibilità per i clienti.

Non: gruppo di permessi, livello di accesso, tipo di utente.

Permesso​

Una singola capacità concessa all'interno di un ruolo — un'area (Lezioni, Membri, Prenotazioni, Check-in o Abbonamenti) a un livello (Visualizzazione o Gestione). L'insieme dei permessi di un ruolo determina quali voci della barra laterale sinistra vede un account dello staff e cosa può farci. Ogni area di Agon al di fuori di queste cinque (pagamenti, report, marketing, impostazioni, personale/buste paga, punto vendita e così via) non ha un permesso che possa concederla: resta riservata al Manager indipendentemente dai permessi del ruolo.

Non: ambito, diritto, autorizzazione.

Giurisdizione​

Il modello di fattura che Agon usa per una fattura generata — eu_vat, us_sales_tax o generic — determinato dal paese configurato nelle Impostazioni dello studio al momento della generazione. Una giurisdizione UE produce una fattura IVA con partite IVA di venditore e acquirente e il riepilogo IVA; la giurisdizione USA produce un riepilogo della sales tax senza campi per la partita IVA; qualsiasi altro paese produce una fattura generica senza alcun riepilogo fiscale. Vedi Fattura.

Non: regione, zona fiscale, paese (il paese è l'impostazione dello studio che determina la giurisdizione, non la giurisdizione stessa).

Fattura​

Un documento PDF con numerazione progressiva, generato per un pagamento di abbonamento completato o per una vendita di prodotto registrata, con testo e struttura adatti alla giurisdizione dello studio. Per ogni pagamento o vendita può esistere una sola fattura. La fatturazione di Agon è un generatore di documenti, non un servizio automatico di conformità fiscale: le aliquote sono sempre inserite dallo studio manager (o, per gli studi UE, un'aliquota IVA predefinita configurata) e nessuna fattura viene mai trasmessa al sistema di fatturazione elettronica di un'autorità fiscale. Si gestisce in Fatture; solo per lo studio manager, senza visibilità per i clienti.

Non: ricevuta, scontrino, estratto conto.

Feedback​

Una segnalazione di bug, una domanda o una richiesta di funzionalità che un membro dello staff invia dalla schermata Feedback dell'app desktop: scegli Bug o Funzionalità, aggiungi un titolo e una descrizione in rich text, e allega facoltativamente fino a 3 file. L'invio lo manda direttamente ad Agon; l'email dell'account di chi lo invia viene allegata automaticamente e non può essere modificata o rimossa. Aprire un client email, pre-compilato verso support@agon-studio.dev, è disponibile come opzione secondaria — ed è ciò a cui ricorre il modulo se l'invio fallisce. Disponibile per ogni ruolo dello staff, senza visibilità per i clienti.

Non: ticket di supporto, ticket di bug, reclamo.

Chiave del provider AI​

Una chiave API che appartiene allo studio, creata presso un provider AI (Google Gemini o Groq) e salvata dallo studio manager in Impostazioni → Assistente AI. L'Assistente AI la usa per raggiungere quel provider direttamente dal computer dello studio. È conservata cifrata nel database locale, non viene più mostrata dopo il salvataggio e si cancella con Rimuovi chiave nella stessa scheda. In alternativa, l'assistente può usare un modello locale (Ollama). Vedi Modalità base.

Non: chiave di licenza, chiave Agon, token.

Modalità base​

Come funziona l'Assistente AI quando non sono configurati né una chiave del provider AI né un modello locale: una ricerca per parole chiave nella documentazione di Agon che funziona interamente sul computer dello studio, senza AI e senza connessioni di rete. Non può rispondere a domande libere, eseguire azioni AI o dare consigli sul business. Se una ricerca non trova nulla, offre un navigatore di argomenti a più livelli (categoria → sottocategoria → pagina → sezione) in cui scendere, invece di un semplice elenco di pagine.

Non: modalità offline, modalità gratuita, modalità lite.

Segnalazione errori​

Un'impostazione facoltativa in Impostazioni → Privacy, disattivata di default, che consente ad Agon di inviare i dettagli tecnici degli errori (senza dati personali) allo sviluppatore di Agon tramite Sentry (UE) per aiutare a correggere i bug. Ogni segnalazione contiene l'ID dello studio. La scelta dello studio manager vale anche per l'app mobile e il widget del sito web dello studio.

Non: telemetria, analytics, log dei crash.

Coorte dei clienti che spendono di più​

Il gruppo dei clienti paganti con la spesa totale più alta in un dato periodo — il 20% più alto dei clienti paganti per spesa, oppure i primi 5 se il 20% fosse meno di così. È usata nella pagina Approfondimenti e dalle domande da consulente di business dell'assistente AI per confrontare il comportamento dei clienti che spendono di più con quello di tutti gli altri. È sempre riportata con conteggi e medie di gruppo: Agon non indica mai quali clienti specifici fanno parte della coorte.

Non: clienti VIP, clienti top, clienti migliori (da usare solo in una conversazione informale, non come termine tecnico per questo gruppo specifico).

Licenza​

Il resoconto dello stato dell'Abbonamento Agon di uno studio, mostrato in Impostazioni → Licenza: se una Chiave di licenza è configurata, l'esito dell'ultimo controllo in background (active, problem o unchecked) e — solo mentre bloccato — quando termina il periodo di tolleranza di 72 ore. Controllato automaticamente ogni circa 8 ore, e di nuovo immediatamente dopo che un manager salva una nuova chiave.

Non: chiave di licenza (la stringa incollata in sé — vedi Chiave di licenza), abbonamento senza qualificazione (vedi la nota di disambiguazione sotto Abbonamento Agon).

Chiave di licenza​

La stringa opaca che uno studio riceve al checkout per avviare o rinnovare il proprio Abbonamento Agon, incollata in Impostazioni → Licenza per mantenere l'installazione sbloccata. Non viene più mostrata una volta salvata — Agon indica solo se una è configurata, mai la chiave stessa.

Non: chiave API, token, Chiave del provider AI (una chiave distinta, di proprietà dello studio, usata dall'assistente AI — non ha alcun legame con questa).

Abbonamento Agon​

Il piano a pagamento ricorrente dello studio stesso con Agon — pay-what-you-want, a partire da 1 €/mese — mantenuto attivo dalla sua Chiave di licenza.

Da non confondere con l'Abbonamento definito più sopra in questo glossario, che è l'iscrizione a pagamento del cliente alle lezioni del tuo studio — un concetto completamente diverso. L'abbonamento di Agon stesso viene sempre indicato nel contesto di Impostazioni → Licenza / licenza a pagamento per-studio, mai come sinonimo generico di "abbonamento" senza quel contesto. La pagina Benvenuto in Agon usa la stessa parola "abbonamento" per questo concetto; è il contesto — Impostazioni → Licenza — a disambiguarla dalla Membership del cliente, non una parola diversa.

Non: Abbonamento (riservato all'iscrizione a pagamento del cliente alle lezioni — vedi la voce Abbonamento più sopra in questo glossario), Licenza (quello è il resoconto di stato dello studio — vedi Licenza).