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.

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 → Connettività 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.

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).

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 dati clienti e cronologia prenotazioni da altre piattaforme di gestione fitness (esportazione CSV, BSport, Momence). Accessibile da Impostazioni → Importa dati.