Impostazioni
Questa pagina spiega ogni impostazione disponibile in Agon e cosa fa ciascuna di esse.
Etichetta di navigazione — Impostazioni: EN: Settings · IT: Impostazioni · FR: Paramètres · DE: Einstellungen · ES: Configuración · PT: Definições · NL: Instellingen · PL: Ustawienia · TR: Ayarlar
Vai su Impostazioni nella barra laterale sinistra. Solo gli studio manager possono accedere alle Impostazioni.
Profilo studio
IT: Studio · FR: Studio · DE: Studio · ES: Estudio · PT: Estúdio
| Impostazione | EN | IT |
|---|---|---|
| Studio name | Studio name | Nome studio |
| Address | Address | Indirizzo |
| Timezone | Timezone | Fuso orario |
Fatturazione
FR: Facturation · DE: Rechnungsstellung · ES: Facturación · PT: Faturação · NL: Facturering
| Impostazione | EN | IT |
|---|---|---|
| Country | Country | Paese |
| Tax ID | Tax ID | Partita IVA / Codice Fiscale |
| Default VAT rate (%) | Default VAT rate | Aliquota IVA Predefinita |
Questi campi determinano quale modello di fattura usa Agon quando genera una fattura per un pagamento, e l'aliquota IVA predefinita viene applicata automaticamente alle nuove fatture UE quando non viene inserita manualmente un'aliquota sulla fattura stessa — si applica solo ai paesi UE. Imposta prima il Paese: determina quale formato di Partita IVA/Codice Fiscale e quali regole di fatturazione si applicano al tuo studio (ad esempio, uno studio con sede in Spagna usa un NIF/numero di IVA spagnolo e le relative regole — questa sezione non presuppone un unico paese o valuta).
Politica di prenotazione
IT: Prenotazioni e cancellazioni · FR: Réservations · DE: Buchungsrichtlinie
Finestra di cancellazione
| Impostazione | EN | IT |
|---|---|---|
| Cancellation window (hours) | Cancellation window | Finestra di cancellazione (ore) |
| Late cancellation deducts credit | Late cancellation deducts credit | La cancellazione scala un credito |
Esempio: con la finestra di cancellazione impostata a 2 ore, un cliente che cancella una lezione delle 10:00 prima delle 8:00 riceve indietro il proprio credito. Cancellare alle 9:30 fa perdere il credito (se la cancellazione tardiva scala un credito è abilitata).
Finestra di check-in
| Impostazione | EN | IT |
|---|---|---|
| Opens before class (minutes) | Check-in opens before | Apertura minuti prima |
| Closes after class (minutes) | Check-in closes after | Chiusura minuti dopo |
Lista d'attesa
| Impostazione | EN | IT |
|---|---|---|
| Waitlist confirmation window (minutes) | Waitlist confirmation window | Finestra conferma lista attesa |
Penali per cancellazione tardiva e mancata presentazione
| Impostazione | EN | IT |
|---|---|---|
| Late cancellation fee | Late cancellation fee | Penale cancellazione tardiva |
| No-show fee | No-show fee | Penale mancata presentazione |
(Chiavi locale: settings.lateCancelFee / settings.noShowFee.)
Questi sono gli importi di penale predefiniti a livello di studio. Si applicano automaticamente solo quando:
- Un cliente cancella una prenotazione all'interno della finestra di cancellazione (una "cancellazione tardiva") e la tua impostazione La cancellazione tardiva scala un credito è abilitata, oppure
- Uno studio manager o un istruttore segna esplicitamente una prenotazione come mancata presentazione al check-in.
Una penale non si attiva mai da sola solo perché impostata qui — richiede sempre uno dei due trigger sopra indicati per attivarsi effettivamente.
Ogni tipo di abbonamento può sovrascrivere entrambe le penali per i propri membri (vedi Abbonamenti — override delle penali). L'ordine di risoluzione è: override del tipo di abbonamento → valore predefinito dello studio (questa sezione) → nessuna penale se nessuno dei due è impostato.
Come viene registrata la penale: una penale non è un addebito automatico su carta. Viene registrata come riga Payment
(provider: "system", notes: "no_show_fee" o "late_cancel_fee") quindi appare nella cronologia
pagamenti del cliente e nelle cifre dei ricavi nei tuoi Report — ma il tuo studio deve comunque
incassarla effettivamente dal cliente (contanti, POS, aggiunta alla prossima fattura, ecc.) tramite il proprio processo.
Accesso clienti
| Impostazione | EN | IT |
|---|---|---|
| Guest bookings | Guest bookings enabled | Prenotazioni ospiti abilitate |
Notifiche
| Impostazione | EN | IT |
|---|---|---|
| Class reminder | Reminder hours before | Ore di promemoria prima della lezione |
Assistente AI
Vai su Impostazioni → Assistente AI (FR: Assistant IA · DE: KI-Assistent · ES: Asistente IA · PT: Assistente de IA · NL: AI-assistent). Solo per lo studio manager.
L'Assistente AI funziona con la chiave del provider AI del tuo studio (Google Gemini o Groq) o con un modello locale. In cima alla scheda vedi il suo stato attuale:
| Stato | Significato |
|---|---|
| Chiave attiva · provider | La chiave del tuo provider è salvata e funziona. |
| Attivo · modello locale | Su questo computer è configurato un modello locale (Ollama). |
| Attivo · chiave dalla configurazione del server | Una chiave è stata impostata nel file di configurazione di Agon invece che qui. |
| Non configurato · modalità base | Nessun provider collegato. L'assistente può solo cercare nella documentazione. |
Per collegare un provider:
- Vai su Impostazioni → Assistente AI.
- Scegli un provider in Provider AI. Usa il link Ottieni una chiave API provider se non hai ancora una chiave.
- Incolla la chiave in Chiave API e clicca Verifica e salva.
Per sostituire la chiave o cambiare provider in seguito, clicca Cambia accanto al badge Chiave attiva. Per smettere di usare l'AI, clicca Rimuovi chiave e conferma: la chiave viene cancellata dal database del tuo studio e l'assistente passa subito alla modalità base. Se la chiave potrebbe essere stata diffusa, revocala anche nella console del tuo provider. La guida completa passo passo, con le note sulla privacy e l'opzione del modello locale, è Come configurare l'Assistente AI.
Cosa fare se qualcosa va storto?
Ricevo un errore che dice che la chiave non è valida Controlla di aver copiato l'intera chiave senza spazi in più e di aver scelto il provider corrispondente, poi riprova. Non cambia nulla finché una chiave non viene accettata.
L'assistente mostra solo articoli di aiuto Nessun provider AI è collegato, quindi l'assistente è in modalità base. Aggiungi una chiave come descritto sopra.
Privacy
Vai su Impostazioni → Privacy (FR: Confidentialité · DE: Datenschutz · ES: Privacidad · PT: Privacidade · NL: Privacy). Solo per lo studio manager.
Segnalazione errori
L'interruttore si chiama Invia segnalazioni di errore per aiutare a correggere i bug.
Quando è attivo e qualcosa si rompe, Agon invia i dettagli tecnici dell'errore (cosa non ha funzionato e in quale punto del codice) allo sviluppatore di Agon, tramite il servizio di tracciamento errori Sentry, ospitato nell'UE. Nomi, indirizzi email, numeri di telefono e altri dati personali vengono rimossi prima che qualsiasi dato lasci il tuo computer. Le segnalazioni non sono anonime: ognuna contiene l'ID del tuo studio e la versione di Agon, così possono essere raggruppate per installazione.
- È disattivato di default. Non viene inviato nulla finché non lo attivi.
- La tua scelta vale anche per l'app mobile del tuo studio e per il tuo widget del sito web: inviano segnalazioni di errore solo se l'hai attivato.
- Puoi disattivarlo in qualsiasi momento, e l'invio si interrompe subito.
Se la scheda indica La segnalazione errori non è disponibile in questa versione., la tua copia di Agon non include la segnalazione errori e l'impostazione non ha alcun effetto.
Consulta la guida GDPR per sapere esattamente cosa viene inviato.
Zona Pericolosa
FR: Zone de danger · DE: Gefahrenzone · ES: Zona de peligro · PT: Zona de Perigo · NL: Gevarenzone
Visibile in fondo alla scheda Studio, in una propria scheda con bordo rosso — solo per un manager con accesso completo (un account manager con accesso completo, non ogni manager o istruttore).
Reimposta Studio
FR: Réinitialiser le studio · DE: Studio zurücksetzen · ES: Restablecer estudio · PT: Redefinir Estúdio · NL: Studio resetten
Questa azione cancella permanentemente ogni cliente, prenotazione, abbonamento, pagamento e ogni altro dato dello studio, e riavvia l'app alla procedura guidata di configurazione iniziale — ad esempio se stai dismettendo uno studio o vuoi ripartire da zero durante dei test.
- Clicca Reimposta Studio.
- Inserisci la tua password attuale.
- Digita il nome esatto dello studio per confermare (mostrato nella finestra di dialogo).
- Clicca Reimposta Studio per confermare.
Agon esegue automaticamente un backup subito prima di cancellare qualsiasi cosa, usando lo stesso meccanismo del backup notturno — quindi un reset fatto per errore può ancora essere recuperato da quel file di backup. Il reset in sé, però, non può essere annullato dall'interno dell'app una volta confermato.
Salvare le impostazioni
Clicca Salva impostazioni per applicare le modifiche.
| Azione | EN | IT |
|---|---|---|
| Save | Save settings | Salva impostazioni |
Cosa fare se qualcosa va storto?
Ho cambiato il fuso orario e ora gli orari delle lezioni sembrano sbagliati Riporta il fuso orario al valore precedente e riavvia il backend.
Non vedo un pulsante "Esegui backup ora" né uno stato dei backup da nessuna parte in Impostazioni È normale — non esiste un controllo manuale dei backup in questa pagina. Agon esegue automaticamente un backup del database ogni notte e subito prima dell'installazione di un aggiornamento automatico, e anche subito prima di un reset dalla Zona Pericolosa. Al momento non c'è modo di avviare un backup extra su richiesta dall'app.