Configurações
Esta página explica todas as definições disponíveis no Agon e o que cada uma faz.
Rótulo de navegação — Configurações: EN: Settings · IT: Impostazioni · FR: Paramètres · DE: Einstellungen · ES: Configuración · PT: Configurações · NL: Instellingen · PL: Ustawienia · TR: Ayarlar
Aceda a Configurações (IT: Impostazioni) na barra lateral esquerda. Apenas os gestores do estúdio podem aceder às Configurações.
Perfil do estúdio
IT: Studio · FR: Studio · DE: Studio · ES: Estudio · PT: Estúdio
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Studio name | Studio name | Nome studio | Nom du studio | Studioname | Nombre del estudio |
| Address | Address | Indirizzo | Adresse | Adresse | Dirección |
| Timezone | Timezone | Fuso orario | Fuseau horaire | Zeitzone | Zona horaria |
Faturação
IT: Fatturazione · FR: Facturation · DE: Rechnungsstellung · ES: Facturación · NL: Facturering
| Definição | EN | PT |
|---|---|---|
| Country | Country | País |
| Tax ID | Tax ID | NIF / Número de IVA |
| Default VAT rate (%) | Default VAT rate | Taxa de IVA Predefinida |
Estes campos determinam o modelo de fatura que o Agon usa ao gerar uma fatura para um pagamento, e a taxa de IVA predefinida é aplicada automaticamente a novas faturas da UE quando nenhuma taxa é introduzida manualmente na própria fatura — aplica-se apenas a países da UE. Defina primeiro o seu País; é ele que determina o formato de NIF/IVA e as regras de faturação aplicáveis ao seu estúdio (por exemplo, um estúdio estabelecido em Espanha usa um NIF/número de IVA espanhol e as regras de faturação espanholas — esta secção não pressupõe nenhum país ou moeda em particular).
Política de reservas
IT: Prenotazioni e cancellazioni · FR: Réservations · DE: Buchungsrichtlinie
Janela de cancelamento
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Cancellation window (hours) | Cancellation window | Finestra di cancellazione (ore) | Délai d'annulation (heures) | Stornierungsfenster (Stunden) | Ventana de cancelación (horas) |
| Late cancellation deducts credit | Late cancellation deducts credit | La cancellazione scala un credito | L'annulation tardive déduit un crédit | Späte Stornierung zieht Guthaben ab | La cancelación tardía deduce crédito |
Exemplo: Com a janela de cancelamento definida como 2 horas, um cliente que cancele uma aula das 10:00 antes das 08:00 recebe o crédito de volta. Cancelar às 09:30 perde o crédito (se "cancelamento tardio deduz crédito" estiver ativado).
Janela de check-in
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Opens before class (minutes) | Check-in opens before | Apertura minuti prima | Ouverture avant le cours | Öffnet vor Kurs (Min.) | Apertura antes de clase (min) |
| Closes after class (minutes) | Check-in closes after | Chiusura minuti dopo | Fermeture après le cours | Schließt nach Kurs (Min.) | Cierre después de clase (min) |
Lista de espera
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Waitlist confirmation window (minutes) | Waitlist confirmation window | Finestra conferma lista attesa | Délai de confirmation liste d'attente | Wartelistenbestätigungsfenster | Ventana de confirmación lista de espera |
Taxas de cancelamento tardio e de não comparecimento
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Late cancellation fee | Late cancellation fee | Penale cancellazione tardiva | Frais d'annulation tardive | Gebühr für späte Stornierung | Tarifa de cancelación tardía |
| No-show fee | No-show fee | Penale mancata presentazione | Frais d'absence | No-Show-Gebühr | Tarifa por inasistencia |
(Chaves de idioma: settings.lateCancelFee / settings.noShowFee.)
Estes são os valores de taxa predefinidos a nível do estúdio. Só se aplicam automaticamente quando:
- Um cliente cancela uma reserva dentro da janela de cancelamento (um "cancelamento tardio") e a sua definição Cancelamento tardio deduz crédito está ativada, ou
- Um gestor do estúdio ou instrutor marca explicitamente uma reserva como não comparência no check-in.
Uma taxa nunca é acionada por si só apenas por estar definida aqui — requer sempre um dos dois acionadores acima para ser efetivamente aplicada.
Cada tipo de assinatura pode substituir qualquer uma das taxas para os seus próprios membros (consulte Assinaturas — substituições de taxas). A ordem de resolução é: substituição do tipo de assinatura → predefinição do estúdio (esta secção) → nenhuma taxa se nenhuma estiver definida.
Como a taxa é registada: uma taxa não é uma cobrança automática de cartão. É registada como uma linha de Payment
(provider: "system", notes: "no_show_fee" ou "late_cancel_fee") para aparecer no histórico de pagamentos
do cliente e nos números de receita dos seus Relatórios — mas o seu estúdio ainda precisa de a
cobrar efetivamente ao cliente (numerário, terminal de cartão, adicionada à próxima fatura, etc.) através do seu próprio
processo.
Acesso do cliente
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Guest bookings | Guest bookings enabled | Prenotazioni ospiti abilitate | Réservations invités activées | Gastbuchungen aktiviert | Reservas de invitados habilitadas |
Notificações
| Definição | EN | IT | FR | DE | ES |
|---|---|---|---|---|---|
| Class reminder | Reminder hours before | Ore di promemoria prima della lezione | Heures de rappel avant le cours | Erinnerungsstunden vor dem Kurs | Horas de recordatorio antes de la clase |
Assistente de IA
Aceda a Configurações → Assistente de IA (IT: Assistente AI · FR: Assistant IA · DE: KI-Assistent · ES: Asistente IA · PT: Assistente de IA · NL: AI-assistent). Apenas gestor.
O Assistente de IA funciona com a chave de provedor de IA do seu próprio estúdio (Google Gemini ou Groq) ou com um modelo local. O topo do separador mostra o estado atual:
| Estado | Significado |
|---|---|
| Chave ativa · provedor | A sua própria chave de provedor está guardada e a funcionar. |
| Ativo · modelo local | Está configurado um modelo local (Ollama) neste computador. |
| Ativo · chave da configuração do servidor | Foi definida uma chave no ficheiro de configuração do Agon em vez de aqui. |
| Não configurado · modo básico | Nenhum provedor está ligado. O assistente só pode pesquisar na documentação. |
Para ligar um provedor:
- Aceda a Configurações → Assistente de IA.
- Escolha um provedor em Provedor de IA. Utilize a ligação Obter uma chave de API do provedor se ainda não tiver uma chave.
- Cole a chave em Chave de API e clique em Verificar e salvar.
Para substituir a chave ou mudar de provedor mais tarde, clique em Alterar junto ao distintivo Chave ativa. Para deixar de usar a IA, clique em Remover chave e confirme: a chave é apagada da base de dados do seu estúdio e o assistente passa de imediato para o modo básico. Se a chave puder ter sido divulgada, revogue-a também na consola do seu provedor. O guia completo passo a passo, incluindo as notas de privacidade e a opção de modelo local, está em Como configurar o Assistente de IA.
E se algo correr mal?
Recebo um erro a dizer que a chave não é válida Verifique se copiou a chave completa sem espaços a mais e se escolheu o provedor correspondente, e depois tente novamente. Nada muda até uma chave ser aceite.
O assistente só mostra artigos de ajuda Nenhum provedor de IA está ligado, por isso o assistente está em modo básico. Adicione uma chave como descrito acima.
Privacidade
Aceda a Configurações → Privacidade (IT: Privacy · FR: Confidentialité · DE: Datenschutz · ES: Privacidad · PT: Privacidade · NL: Privacy). Apenas gestor.
Relatórios de erros
O interruptor chama-se Enviar relatórios de erros para ajudar a corrigir falhas.
Quando está ativado e algo falha, o Agon envia os detalhes técnicos do erro (o que falhou e em que ponto do código) ao programador do Agon, através do serviço de monitorização de erros Sentry, alojado na UE. Nomes, endereços de e-mail, números de telefone e outros dados pessoais são removidos antes de qualquer coisa sair do seu computador. Os relatórios não são anónimos: cada um contém o ID do seu estúdio e a versão do Agon, para que possam ser agrupados por instalação.
- Está desativado por predefinição. Nada é enviado a menos que o ative.
- A sua escolha aplica-se também à aplicação móvel do seu estúdio e ao seu widget do site: só enviam relatórios de erros se o tiver ativado.
- Pode desativá-lo a qualquer momento, e o envio para de imediato.
Se o separador indicar Os relatórios de erros não estão disponíveis nesta versão., a sua cópia do Agon não inclui relatórios de erros e a opção não tem qualquer efeito.
Consulte o guia do RGPD para saber exatamente o que é enviado.
Zona de Perigo
IT: Zona Pericolosa · FR: Zone de danger · DE: Gefahrenzone · ES: Zona de peligro · NL: Gevarenzone
Aparece na parte inferior do separador Estúdio, no seu próprio cartão com borda vermelha — apenas para um gestor com acesso total (uma conta de gestor com acesso total, não qualquer gestor ou instrutor).
Redefinir Estúdio
IT: Reimposta Studio · FR: Réinitialiser le studio · DE: Studio zurücksetzen · ES: Restablecer estudio · NL: Studio resetten
Esta ação apaga permanentemente todos os clientes, reservas, assinaturas, pagamentos e qualquer outro registo do estúdio, e reinicia a aplicação no assistente de configuração inicial — por exemplo, se estiver a encerrar um estúdio ou quiser recomeçar do zero durante testes.
- Clique em Redefinir Estúdio.
- Introduza a sua palavra-passe atual.
- Escreva o nome exato do estúdio para confirmar (mostrado na caixa de diálogo).
- Clique em Redefinir Estúdio para confirmar.
O Agon faz automaticamente uma cópia de segurança imediatamente antes de apagar o que quer que seja, usando o mesmo mecanismo da cópia de segurança noturna — por isso, uma redefinição feita por erro ainda pode ser recuperada a partir dessa cópia de segurança. No entanto, a redefinição em si não pode ser desfeita a partir da aplicação depois de confirmada.
Salvar configurações
Clique em Salvar configurações para aplicar as suas alterações.
| Ação | EN | IT | FR | DE | ES | PT | NL | PL | TR |
|---|---|---|---|---|---|---|---|---|---|
| Save | Save settings | Salva impostazioni | Enregistrer paramètres | Einstellungen speichern | Guardar configuración | Salvar configurações | Instellingen opslaan | Zapisz ustawienia | Ayarları kaydet |
E se algo correr mal?
Alterei o fuso horário e agora as horas das aulas parecem erradas Volte a alterar o fuso horário para o seu valor anterior e reinicie o backend.
Não vejo nenhum botão "Fazer cópia de segurança agora" nem um estado de cópias de segurança em Definições É normal — não existe nenhum controlo manual de cópias de segurança nesta página. O Agon faz automaticamente uma cópia de segurança da base de dados todas as noites e imediatamente antes de instalar uma atualização automática, e também imediatamente antes de uma redefinição a partir da Zona de Perigo. Atualmente não há forma de iniciar uma cópia de segurança extra a pedido a partir da aplicação.