Pular para o conteúdo principal

Glossário

Esta página define os termos canónicos usados em todo o Agon e na sua documentação. Em caso de dúvida, use exatamente estes termos — não sinónimos.

Gestor do estúdio​

O proprietário ou administrador de uma instalação do Agon. O gestor do estúdio cria aulas, gere clientes e instrutores, configura assinaturas e tem acesso total a todas as definições e relatórios.

Não: admin, proprietário, operador.

Cliente​

Uma pessoa que frequenta aulas no estúdio. Os clientes usam a aplicação móvel do Agon para consultar o calendário, reservar aulas e fazer o check-in.

Não: membro, aluno, utilizador, consumidor.

Instrutor​

Um membro do pessoal que dá aulas. Os instrutores são distintos dos gestores do estúdio — podem ver o calendário de aulas e a lista de participantes, mas não podem alterar as definições do estúdio nem aceder a dados financeiros.

Não: professor, coach, treinador, membro do pessoal.

Tipo de aula​

Uma definição reutilizável de um tipo de aula — o seu nome, duração predefinida, capacidade predefinida e instrutor associado. Pense nele como o "tipo" da aula, não uma ocorrência específica.

Exemplo: "Yoga Flow" é um tipo de aula. Cada terça-feira às 9:00 é uma aula agendada separada baseada nesse tipo.

Não: categoria de aula, definição de aula, atividade.

Aula agendada​

Uma ocorrência específica de um tipo de aula numa data e hora específicas, num local específico, com um instrutor confirmado e uma capacidade. Os clientes reservam aulas agendadas, não tipos de aula. Uma aula agendada é uma atividade de grupo com capacidade partilhada — consulte Marcação para o equivalente individual.

Não: sessão de aula, evento, vaga.

Reserva​

A reserva confirmada de um cliente para uma aula agendada específica. Uma reserva deduz um crédito da assinatura ativa do cliente (se aplicável) e concede ao cliente acesso ao check-in.

Não: reservation, registo, inscrição.

Marcação​

A reserva individual confirmada de um cliente com um instrutor específico para um serviço de marcação específico (por exemplo, treino personalizado, massagem ou coaching privado) numa data e hora específicas. Ao contrário de uma aula agendada, uma marcação tem exatamente um cliente e nenhuma capacidade partilhada. Reservar uma marcação deduz um crédito da assinatura ativa do cliente, o mesmo mecanismo de reservar uma aula — não existe um percurso de pagamento separado para marcações. Um gestor do estúdio ou um instrutor pode marcar uma marcação confirmada como concluída ou como não comparência posteriormente, e aplica-se a mesma política de taxa de cancelamento tardio / taxa de não comparecimento das reservas de aulas.

Não: sessão, aula privada, sessão individual, reservation, aula.

Serviço de marcação​

Um tipo de marcação definido pelo gestor do estúdio que os clientes podem reservar (por exemplo, "Treino Personalizado" ou "Massagem de 60 Minutos"), com uma duração fixa e um tempo de intervalo opcional — um espaço imposto após cada marcação antes de a seguinte poder começar para o mesmo instrutor. Desativar um serviço é uma eliminação suave: deixa de aparecer para novas reservas, mas o histórico de marcações que o referencia é preservado. Não existe opção de eliminação definitiva.

Não: tipo de serviço, tipo de sessão, tratamento.

Disponibilidade do instrutor​

As janelas horárias semanais recorrentes durante as quais um instrutor pode ser reservado para marcações (por exemplo, "terças-feiras 09:00–13:00"). A disponibilidade é apenas recorrente numa base semanal — o Agon ainda não suporta exceções para datas específicas nem substituições para feriados. Os horários disponíveis para marcação são calculados a partir destas janelas, menos as marcações já confirmadas do instrutor e o tempo de intervalo do serviço a reservar.

Não: horário de trabalho, agenda, turno.

Lista de espera​

Se uma aula agendada estiver cheia, os clientes podem entrar na lista de espera. Quando uma reserva é cancelada, o primeiro cliente da lista de espera é automaticamente promovido a reserva confirmada e notificado.

Check-in​

Confirmação de que um cliente participou fisicamente numa aula. O check-in pode ser feito pelo cliente (através do código QR na aplicação móvel), pelo instrutor (lendo o código do cliente) ou manualmente pelo gestor do estúdio.

Não: sign-in, presença, marcação de ponto.

Assinatura​

Um pacote que dá a um cliente acesso a aulas durante um período de tempo. Existem dois tipos:

  • Assinatura recorrente — ativa durante um número definido de dias (por exemplo, 30 dias) e renovada automaticamente através do Stripe.
  • Pacote de créditos — um número fixo de créditos consumidos um por reserva, sem limite de tempo.

Não: subscription, plano, pacote, passe.

Crédito​

Uma única unidade de acesso a uma aula, incluída numa assinatura de pacote de créditos. Cada reserva deduz um crédito. Os créditos não expiram, a menos que a própria assinatura tenha uma data de validade.

Não: token, ponto, crédito de sessão, passe de aula.

Crédito acumulado​

Um crédito não utilizado que transita para o período de faturação seguinte do cliente em vez de se perder, quando um tipo de assinatura recorrente tem a acumulação de créditos ativada. Um tipo de assinatura pode, opcionalmente, limitar quantos créditos podem transitar por período.

Não: crédito transferido, crédito depositado.

Oferta introdutória​

Um preço de primeira compra com desconto e/ou uma janela de validade num tipo de assinatura, apresentado automaticamente a um cliente na primeira vez que compra esse tipo de assinatura (ou qualquer outro tipo de assinatura com oferta introdutória no mesmo estúdio). O preço normal aplica-se a todas as compras posteriores.

Não: oferta de experiência, desconto de boas-vindas, desconto de primeira compra.

Taxa de cancelamento tardio / Taxa de não comparecimento​

Um encargo registado contra um cliente quando este cancela uma reserva dentro da janela de cancelamento (um cancelamento tardio, apenas se "o cancelamento deduz crédito" estiver ativado) ou é marcado como não comparência no check-in. Resolvido por cliente da seguinte forma: a substituição do tipo de assinatura do cliente, depois a predefinição a nível do estúdio, depois nenhuma taxa. Registado como uma linha Payment em vez de um débito automático no cartão — o estúdio continua a ter de o cobrar através do seu próprio processo.

Não: penalização, encargo de cancelamento (como conceito distinto da própria taxa).

Código promocional​

Um código que um cliente introduz no pagamento de uma assinatura para receber um desconto percentual ou de valor fixo. Configurado pelo gestor do estúdio com um limite de utilização opcional, uma restrição de uma utilização por cliente e uma janela de validade.

Não: código de desconto, cupão.

Cartão presente​

Um saldo pré-pago identificado por um código (formato GC-XXXXXXXX) que um cliente pode utilizar numa compra de assinatura, ou que um gestor do estúdio emite manualmente para uma venda telefónica ou presencial. Um cliente também pode comprar um cartão presente para si próprio, como prenda para outra pessoa.

Não: voucher, nota de crédito.

Tag​

Uma etiqueta curta e colorida que um gestor do estúdio associa a um cliente para organizar e filtrar a lista de clientes (por exemplo, "VIP", "Risco de lesão"). As tags podem ser atribuídas manualmente ou automaticamente através de uma regra de tag automática. Os clientes veem as suas próprias tags em modo de leitura na aplicação móvel.

Não: rótulo (como conceito distinto), categoria.

Produto​

Um artigo de retalho que um gestor do estúdio mantém no catálogo para venda presencial — por exemplo, uma barra de proteína ou uma garrafa de água — com um nome, um SKU opcional, um preço e uma quantidade de stock acompanhada. Gerido em Produtos no backoffice de secretária; apenas para o gestor, sem interface para o cliente.

Não: artigo, SKU (um SKU é um campo de um produto, não o próprio produto).

Venda de produto​

Um registo de uma venda presencial concluída de um ou mais produtos, registada por um gestor do estúdio depois de o pagamento já ter sido recebido em dinheiro, cartão ou outro método fora do Agon. Opcionalmente associada a um cliente, ou deixada como venda sem cliente. Registar uma venda deduz as quantidades vendidas do stock de cada produto.

Não: encomenda, transação, compra (reservado para compras de assinatura/cartão presente processadas através do Stripe).

Regra de tag automática​

Uma regra que atribui automaticamente uma tag a um cliente sempre que um evento de gatilho escolhido ocorre para ele (por exemplo, uma não comparência ou uma reserva cancelada). Configurada pelo gestor do estúdio; funciona automaticamente sem necessidade de ação manual depois de criada.

Termo de responsabilidade​

Um documento (por exemplo, uma renúncia de responsabilidade ou o regulamento do estúdio) que um gestor do estúdio redige e pode exigir que os clientes assinem digitalmente antes de reservar. Editar o corpo de um termo de responsabilidade cria uma nova versão e exige que todos os clientes voltem a assinar, mesmo os que assinaram uma versão anterior. A assinatura é sempre feita pelo próprio cliente — não há forma de um gestor do estúdio ou um instrutor assinar em nome de um cliente.

Não: formulário de consentimento (usar apenas ao referir o registo de consentimento RGPD separado), renúncia, acordo.

Token de sincronização de calendário​

Um segredo de longa duração incorporado no URL do feed de calendário pessoal de um cliente, usado porque as aplicações de calendário (Google, Apple, Outlook) consultam periodicamente um URL estático e não conseguem efetuar um início de sessão na aplicação. O token no URL é, ele próprio, a credencial. Um cliente ou um gestor do estúdio pode regenerá-lo, o que invalida a ligação antiga e exige uma nova subscrição.

Local​

Um lugar físico onde as aulas são realizadas. Na V1, o Agon suporta um único local. O suporte multi-local está planeado para a V2. O campo location_id já está presente no esquema da base de dados.

Não: filial, recinto, estúdio (usar "estúdio" apenas para referir todo o negócio, não uma sala ou edifício específico).

Túnel​

Um URL HTTPS público e seguro criado através do Cloudflare Tunnel que permite aos seus clientes ligar a aplicação móvel à sua instância do Agon a partir de qualquer lugar, sem expor a sua rede local.

Não: URL, ligação, link, proxy.

Código QR do estúdio​

Um código QR apresentado em Configurações → Conetividade que codifica o URL do Túnel. Os clientes leem este código uma vez, ao configurar a aplicação móvel, para se ligarem ao seu estúdio.

Widget do site​

Um painel incorporável e apenas de leitura do calendário de aulas que um gestor do estúdio cola no seu próprio site público como um <iframe> (o trecho de incorporação encontra-se em Configurações → Widget do site). Mostra as próximas aulas agendadas com instrutor e lugares disponíveis, usando as cores da marca do próprio estúdio — nunca preços, assinaturas, listas de clientes ou contactos dos instrutores. Atualmente, não suporta a reserva de uma aula a partir do interior do widget; os clientes continuam a reservar através da aplicação móvel. O widget é servido a partir do URL do Túnel do próprio estúdio, pelo que o seu trecho de incorporação tem de ser copiado de novo sempre que o endereço do túnel mudar (por exemplo, após um reinício do backend do Agon).

Não: widget de calendário, widget de reservas, embed, iframe.

Token de convite​

Um token com tempo limitado enviado por e-mail a um cliente recém-criado. O cliente segue a ligação para definir a sua palavra-passe e ativar a conta. Expira ao fim de 7 dias.

Token de redefinição​

Um token com tempo limitado enviado por e-mail quando um cliente solicita a redefinição da palavra-passe. Expira ao fim de 2 horas.

Lista inteligente​

Um filtro guardado que identifica um subconjunto de clientes com base no estado da assinatura, na recência das reservas, na data de adesão ou no tipo de assinatura. Usado para enviar e-mails segmentados.

Bloco​

Um único elemento na tela do Editor Visual de E-mail — texto, imagem, botão, divisor, espaçador ou HTML — que o gestor do estúdio adiciona, organiza e configura para construir um modelo de e-mail. Os blocos empilham-se de cima para baixo e cada um tem os seus próprios controlos (alinhamento, cor, tamanho, etc.), mostrados quando o bloco está selecionado; a tela apresenta o e-mail exatamente como será enviado, em tempo real, sem um passo de pré-visualização separado. Um modelo criado ou editado antes desta funcionalidade não tem blocos — ao abri-lo, é proposto "Converter para tela", que envolve o HTML existente num único bloco inicial para que nada se perca.

Não: elemento, componente, widget, módulo.

Atribuição de evento​

Uma configuração que associa um evento do Agon (por exemplo, "novo cliente convidado", "reserva confirmada") a um modelo de e-mail ou SMS específico. Quando o evento ocorre, o modelo atribuído é enviado automaticamente — desde que esse evento esteja efetivamente ligado ao envio de mensagens (atualmente, apenas "novo cliente convidado" e "redefinição de palavra-passe" acionam um envio, tanto para e-mail como para SMS).

Automação de marketing​

Uma sequência de vários passos, com atrasos, de e-mails e/ou mensagens de texto que um gestor do estúdio cria uma vez e nunca mais envia manualmente — por exemplo, "esperar 3 dias após a inscrição, enviar um e-mail; esperar mais 7 dias e, se o cliente ainda não tiver reservado, enviar outro". Construída a partir de um gatilho (um evento, como uma nova inscrição ou reserva, ou uma condição recorrente, como "não reservou há 30 dias"), uma lista ordenada de passos (cada um com um atraso, um canal e um modelo) e uma condição de paragem opcional. Um cliente é inscrito automaticamente quando o gatilho corresponde e é inscrito no máximo uma vez por automação, para sempre. Ao contrário de uma Atribuição de evento, que envia uma única mensagem no instante em que um evento ocorre, uma Automação de marketing distribui várias mensagens ao longo do tempo.

Não: campanha gota a gota, fluxo de trabalho, sequência (isolada, sem "automação").

Aula online​

Uma aula agendada que o gestor do estúdio marcou como "Online (Zoom)", para a qual o Agon cria e gere automaticamente uma reunião Zoom real através da conta Zoom ligada do próprio gestor do estúdio. Apenas uma aula única (não recorrente) pode ser marcada como online. Os clientes veem uma ligação de acesso virada para o cliente ("Aceder no Zoom") na aula e na sua reserva; o gestor do estúdio e o instrutor veem separadamente uma ligação de início exclusiva do anfitrião ("iniciar reunião"), que nunca é mostrada aos clientes. Disponível em qualquer plano Zoom, incluindo o gratuito.

Não: aula virtual, aula Zoom, aula transmitida em direto.

Assistente de migração​

A ferramenta integrada para importar os seus clientes, assinaturas e aulas para o Agon a partir de uma exportação CSV, Excel ou JSON da sua plataforma atual. Acedida a partir de Configurações → Migração e disponível apenas para os Managers. Cada tipo de dados é importado em separado, um de cada vez. O Agon nunca se liga à sua plataforma antiga nem pede as respetivas credenciais: é você que exporta os seus próprios dados e carrega o ficheiro.

Componente de pagamento​

Uma única regra que define como um membro do pessoal ganha remuneração — À hora, Por aula, Comissão ou Salário Fixo. Um membro do pessoal pode ter vários componentes de pagamento ativos de tipos diferentes ao mesmo tempo (por exemplo, uma tarifa horária e uma comissão em conjunto), mas nunca dois componentes ativos do mesmo tipo. Gerido em Folha de Pagamento; apenas para o gestor, sem interface para o cliente.

Não: tarifa de pagamento, linha salarial, regra de compensação.

Processamento de folha de pagamento​

Um cálculo gerado pelo gestor do estúdio do que cada membro do pessoal tem a receber num intervalo de datas escolhido, calculado a partir dos seus componentes de pagamento ativos. Um processamento começa como rascunho, que pode ser regenerado livremente, e passa a finalizado quando o gestor do estúdio o bloqueia — os valores de um processamento finalizado nunca mudam. Marcar as linhas de um processamento finalizado como pagas regista que o gestor do estúdio pagou ao membro do pessoal fora do Agon; nenhum dinheiro se move dentro do Agon.

Não: período de folha de pagamento, ciclo de pagamento, recibo de vencimento.

Função​

Um conjunto de permissões nomeado atribuído a exatamente uma conta de pessoal, que determina o que essa conta pode ver e fazer na aplicação de secretária. Gestor e Instrutor são funções integradas que existem sempre e não podem ser renomeadas nem eliminadas. Um gestor do estúdio também pode definir qualquer número de funções personalizadas (por exemplo, "Receção"), cada uma concedendo Ver e/ou Gerir sobre alguma combinação de cinco áreas: Aulas, Membros, Reservas, Check-ins e Assinaturas. Gerido em Equipa e Funções; apenas para o gestor, sem interface para o cliente.

Não: grupo de permissões, nível de acesso, tipo de utilizador.

Permissão​

Uma única capacidade concedida dentro de uma Função — uma área (Aulas, Membros, Reservas, Check-ins ou Assinaturas) a um nível (Ver ou Gerir). O conjunto completo de permissões de uma função determina que itens da barra lateral esquerda uma conta de pessoal vê e o que pode fazer sobre eles. Todas as áreas do Agon fora dessas cinco (pagamentos, relatórios, marketing, definições, pessoal/folha de pagamento, ponto de venda, e assim por diante) não têm nenhuma permissão que as possa conceder — permanecem exclusivas do Gestor, independentemente das permissões de uma função.

Não: âmbito, direito, concessão de acesso.

Jurisdição​

Que modelo de fatura o Agon usa numa fatura gerada — eu_vat, us_sales_tax ou generic — decidido pelo país configurado do estúdio nas Configurações no momento em que a fatura é gerada. Uma jurisdição da UE produz uma fatura com IVA, com os números de IVA do vendedor/comprador e uma discriminação do IVA; a jurisdição dos EUA produz uma discriminação do imposto sobre vendas sem campos de número de IVA; qualquer outro país produz uma fatura genérica sem qualquer discriminação de imposto declarada. Consulte Fatura.

Não: região, zona fiscal, país (o país é a definição do estúdio que determina a jurisdição, não a própria jurisdição).

Fatura​

Um documento PDF numerado sequencialmente, gerado para um pagamento de assinatura concluído ou para uma venda de produto registada, redigido e estruturado para a jurisdição do estúdio. Só pode existir uma fatura por pagamento ou por venda. A faturação do Agon é um gerador de documentos, não um serviço automatizado de conformidade fiscal — as taxas de imposto são sempre introduzidas pelo gestor do estúdio (ou, para estúdios da UE, uma taxa de IVA predefinida configurada), e nenhuma fatura é submetida à rede de faturação eletrónica de uma autoridade tributária. Gerido em Faturas; apenas para o gestor, sem interface para o cliente.

Não: recibo, conta, extrato.

Feedback​

Um relatório de erro, uma pergunta ou uma sugestão que um membro da equipa envia por e-mail ao programador do Agon, a partir do ecrã Feedback da aplicação de secretária (o botão abre um rascunho para support@agon-studio.dev) ou de qualquer conta de e-mail. O rascunho inclui apenas a versão da aplicação e o sistema operativo; nada sobre o estúdio ou os seus clientes é adicionado automaticamente.

Não: ticket de suporte, ticket de erro, reclamação.

Chave de provedor de IA​

Uma chave de API que pertence ao estúdio, criada junto de um provedor de IA (Google Gemini ou Groq) e guardada pelo gestor do estúdio em Configurações → Assistente de IA. O Assistente de IA utiliza-a para comunicar com esse provedor diretamente a partir do computador do estúdio. É guardada encriptada na base de dados local, nunca volta a ser mostrada depois de guardada e é apagada com Remover chave no mesmo separador. Em alternativa, o assistente pode usar um modelo local (Ollama). Ver Modo básico.

Não: chave de licença, chave do Agon, token.

Modo básico​

Como o Assistente de IA funciona quando não está configurada nenhuma chave de provedor de IA nem nenhum modelo local: uma pesquisa por palavras-chave na documentação do Agon que funciona inteiramente no computador do estúdio, sem IA e sem ligação à rede. Não consegue responder a perguntas livres, executar ações de IA nem dar conselhos de negócio.

Não: modo offline, modo gratuito, modo lite.

Relatórios de erros​

Uma opção facultativa em Configurações → Privacidade, desativada por predefinição, que permite ao Agon enviar detalhes técnicos dos erros (sem dados pessoais) ao programador do Agon através do Sentry (UE) para ajudar a corrigir falhas. Cada relatório contém o ID do estúdio. A escolha do gestor do estúdio aplica-se também à aplicação móvel e ao widget do site do estúdio.

Não: telemetria, analítica, registos de falhas.

Coorte de maiores gastadores​

O grupo de clientes pagantes com a maior despesa total num determinado período — os 20% de clientes pagantes com maior despesa, ou os 5 primeiros se 20% forem menos do que isso. Usado na página Insights e pelas perguntas de consultor de negócio do assistente de IA para comparar como os seus clientes com maior despesa se comportam face a todos os outros. Sempre reportado como contagens e médias ao nível do grupo — o Agon nunca identifica quais os clientes específicos que integram a coorte.

Não: clientes VIP, clientes de topo, melhores clientes (usar apenas em conversa corrente, não como termo técnico para este grupo específico).