Documentação
Tutoriais do Agenda Capoeiragem
Guias passo a passo para alunos, viajantes e educadores. Aprenda a usar cada função com os textos exatos que você verá no app.
Geral
Primeiros passos
Como criar sua conta, completar seu perfil e entrar na sua comunidade.
Instale o app ou use como app web
Baixe na Google Play no Android, ou acesse agendacapoeiragem.com no navegador e adicione à tela inicial para usar como app web (PWA). As duas opções funcionam igual.
Crie sua conta
Preencha nome, sobrenome, apelido (opcional), país (detectado automaticamente), seu papel (Praticante ou Educador — é mais um campo do mesmo formulário), e-mail e senha.
Complete o onboarding
Após o cadastro, um assistente te guia passo a passo. Se você é aluno: complete seu perfil, busque seu grupo e escolha seu núcleo. Se é educador: complete seu perfil, escolha entrar em um grupo existente ou criar o seu, e termine criando seu núcleo.
Vincule seu grupo
Se você terminou o onboarding sem entrar em um grupo, verá na tela de Início o cartão "Você ainda não pertence a um grupo" com os botões "Buscar grupo" e "Solicitação guiada" (e "Criar grupo" se for educador).
Geral
Início e exploração
Como navegar a tela principal e encontrar o que você precisa rapidamente.
A tela de Início
A aba "Início" mostra uma saudação personalizada com seu nome e a seção "Próximos eventos" com os eventos da sua comunidade em ordem cronológica. Se houver notificações pendentes, aparece um badge vermelho na aba "Perfil".
Filtre os próximos eventos
Na seção "Próximos eventos" você encontrará chips de filtro: "Todos", "Hoje", "Esta semana" e "Este mês". Toque neles para refinar a visualização.
Busca global
Toque na barra de busca na tela de Início para abrir a busca global. Digite qualquer termo e verá resultados em quatro seções: Eventos, Grupos, Núcleos e Usuários.
Cartões e avisos da Início
Acima de "Próximos eventos" podem aparecer cartões conforme sua situação: uma solicitação sua pendente de aprovação, sua próxima aula (se você treina em um núcleo) com sua sequência de presença, ou — se você é educador — um acesso direto para registrar a presença de hoje.
Acessos rápidos de educador
Se você administra apenas um núcleo, verá dois chips fixos abaixo dos filtros: "Painel do núcleo" e "Registrar aula", para entrar direto nessas telas.
Geral
Grupos e comunidade
Como descobrir grupos, entrar em um e explorar a hierarquia da sua comunidade.
O que é um grupo e o que é um núcleo?
Um **grupo** é a organização de capoeira (a "escola" no sentido amplo, ex: Abadá Capoeira, Cordão de Ouro). Um **núcleo** é o local físico específico onde se treina dentro desse grupo — pode haver vários núcleos em cidades ou países diferentes. Você pertence a um grupo e treina em um núcleo.
Explore os grupos
A aba "Grupos" mostra todos os grupos públicos registrados. Use a barra de busca ("Buscar grupo...") para filtrar por nome, e os menus de "País de presença" e "Estilo de capoeira" para refinar.
O perfil de um grupo
Toque em qualquer grupo para ver seu perfil. É uma única tela com rolagem: descrição, seção recolhível "Sistema de graduações", um cartão "Hierarquia" (abre a árvore de educadores em uma tela separada) e os próximos eventos do grupo.
Solicitar entrada em um grupo
O botão "Solicitar entrada no grupo" aparece no perfil só se você for educador (ou tiver graduação de educador) sem grupo ainda. Sua solicitação fica com o badge "Solicitação pendente de aprovação".
Ver a hierarquia do grupo
Toque no cartão "Hierarquia" no perfil do grupo para abrir a árvore completa de educadores, com busca por nome. Toque em qualquer educador para ver seu perfil público.
Ver o perfil de um membro
Toque no nome de qualquer educador ou membro para ver seu perfil: nome, apelido, grupo, corda atual e núcleos onde ensina ou treina.
Geral
Eventos
Como descobrir, filtrar e confirmar seu interesse em batizados, rodas e mais.
Explore o calendário de eventos
A aba "Eventos" mostra um calendário interativo no topo e a lista de eventos abaixo. Toque em qualquer data para ver os eventos daquele dia, ou alterne entre visão de calendário e de lista com o botão no canto.
Filtre por categoria e mais
Ao lado do botão de alternar visão há 3 chips rápidos: "Grátis", "Online" e "Este fim de semana". Para mais opções, toque em "Filtros": categoria (batizado, roda, roda aberta, troca de corda, curso, workshop, seminário, festival, encontro, intensivo, treino, ou uma categoria personalizada), preço, formato, datas, grupo e localização.
Detalhes de um evento
Toque em qualquer evento para ver descrição completa, data e hora, localização no mapa, organizadores e o pôster. Você verá quantas pessoas vão ("Vou") e quantas marcaram interesse ("Tenho interesse"), com uma fileira de avatares de quem vai.
Confirmar "Vou" ou "Tenho interesse"
No detalhe do evento, toque "Tenho interesse" para salvá-lo na sua lista, ou "Vou" para confirmar presença. Tocar novamente no mesmo botão remove sua confirmação.
Compartilhar um evento
Use o botão compartilhar no detalhe do evento para enviá-lo pelo WhatsApp, Instagram ou outros apps.
Geral
Seu perfil
Como gerenciar sua identidade, notificações e acessar as configurações.
Como seu perfil está organizado
A aba "Perfil" é uma única tela (sem abas internas): no topo sua foto, papel e grupo; depois um botão de "Atividade"; e mais abaixo as seções conforme seu papel — "Gestão" (educadores, seus núcleos) ou "Onde treino" (alunos, presença e pagamentos).
Editar seu perfil
Toque no ícone de editar (lápis) sobre sua foto ou nome. Você pode mudar foto, nome, sobrenome, apelido, uma breve bio, país, data de nascimento, gênero (obrigatório) e links das suas redes sociais (Instagram, Facebook, WhatsApp, YouTube, TikTok e site). Salve tocando "Salvar".
Sua corda
Sua corda atual aparece com cor e nome abaixo do seu nome no perfil. Tocar nela leva ao sistema de graduação completo do seu grupo (todos os níveis), não a um histórico pessoal das suas próprias promoções.
Configurações: idioma e tema
Em "Perfil", toque "Configurações". Lá você muda o idioma (espanhol, português, inglês, francês, alemão, italiano) e o tema visual (claro ou escuro). As mudanças se aplicam imediatamente.
Notificações push: escolha o que quer receber
Em "Configurações → Notificações" ative ou desative cada tipo separadamente: lembretes de evento, novos eventos do seu grupo, eventos perto de você, resumo semanal e novidades da sua comunidade.
Atividade: solicitações e próximos eventos
Toque no botão "Atividade" no seu perfil para ver seus próximos eventos confirmados e suas solicitações pendentes: de grupo, de núcleo, de educador, de transferência de núcleo e de colaboração em eventos. O badge vermelho na aba "Perfil" indica quantas você tem sem revisar.
Reportar um problema
Vá em "Perfil" → "Configurações" → "Reportar um problema". Seu relato vai diretamente à equipe de desenvolvimento.
Praticantes
Entrar em um núcleo
Como encontrar um núcleo, enviar uma solicitação e o que acontece depois.
Busque seu núcleo
Vá à aba "Grupos", busque seu grupo pelo nome (ou filtre por país/estilo) e entre no perfil dele. De lá você pode chegar ao núcleo onde treina.
Entre no núcleo
No perfil do núcleo, toque "Entrar". Sua solicitação fica pendente até o educador aprovar.
Aguarde a aprovação
Sua solicitação fica como "Pendente" até o educador aprovar ou rejeitar. Você receberá uma notificação quando houver resposta.
Acesse sua atividade
Após a aprovação, o núcleo aparece no seu perfil, na seção "Onde treino" — com seu status de pagamento e acesso às suas estatísticas de treino.
Praticantes
Seu histórico pessoal
Como ver sua presença, sua sequência de treino e o status dos seus pagamentos.
Onde treino
No seu perfil, a seção "Onde treino" lista cada núcleo ao qual você pertence com um badge de status de pagamento (Pago, Pendente, Vencido, Gratuito...) e, se tiver um pagamento pendente, um botão "Reportar pagamento".
Minha atividade
Toque em "Ver estatísticas" em qualquer um dos seus núcleos para abrir "Minha atividade": sua sequência de aulas seguidas, quantas aulas você fez este mês / nos últimos 30 dias / no ano, um gráfico de frequência, suas sessões recentes e seu histórico de pagamentos. Você pode compartilhar suas estatísticas com o botão dedicado.
Sua corda
Sua corda atual aparece no seu perfil. Tocar nela leva ao sistema de graduação completo do seu grupo — não existe um histórico pessoal separado das suas próprias promoções, mas sua corda vigente está sempre visível ali.
Eventos confirmados
Toque em "Atividade" no seu perfil para ver os próximos eventos nos quais confirmou "Vou".
Educadores
Criar seu grupo
Como registrar seu grupo de capoeira na plataforma e configurar suas informações.
Acessar o formulário de criação
Se você é educador e ainda não tem grupo, verá um banner "Criar grupo" na Início ou "Criar novo grupo" na aba "Grupos". Toque para abrir o formulário.
Nome e descrição
Insira o nome oficial do seu grupo e uma descrição. Ambos são obrigatórios. O nome aparecerá no diretório, nos perfis dos membros e nos seus eventos.
Estilo de capoeira (obrigatório)
No campo "Estilo de capoeira *" escreva o estilo que você pratica (ex: Mista, Benguela, Angola, Regional). É texto livre e obrigatório — usado como nome do seu sistema de graduação.
Logo do grupo (opcional)
Envie o logo da galeria. Aparecerá no perfil do grupo, nos núcleos e no cartão que seus alunos veem na Início.
Criar o grupo
Toque "Criar". Se o nome não estiver duplicado, o grupo é criado imediatamente e você entra direto no perfil dele.
Convidar membros
Não há código de convite. Compartilhe o nome do seu grupo com seus alunos: eles buscam na aba "Grupos" e solicitam entrada. Você também pode adicioná-los diretamente pelo painel do seu núcleo.
Educadores
Administrar seu grupo
Como gerenciar solicitações, papéis de administrador e as informações do grupo.
Aprovar ou rejeitar solicitações de entrada no grupo
As solicitações de entrada no grupo são respondidas em "Atividade" no seu perfil, junto com as demais notificações. Toque na solicitação para aprovar ou rejeitar.
Atribuir papéis: admin e co-admin
No perfil do grupo, entre no painel de administração (visível apenas para administradores e co-administradores). Lá você pode ativar ou remover o papel "Administrador" ou "Co-administrador" de qualquer membro, ou remover o seu próprio com "Deixar admin".
Editar as informações do grupo
Vá ao perfil do grupo → ícone de editar. Você pode mudar o logo, nome, descrição e estilo de capoeira. As mudanças refletem imediatamente no diretório público.
Educadores
Supervisão educativa
Como atribuir um educador supervisor para os alunos do seu núcleo.
O que é a supervisão educativa
A supervisão educativa é a relação hierárquica entre educadores de um mesmo grupo. Um educador mais experiente pode supervisionar o progresso dos alunos de outro educador, especialmente útil quando estão em cidades ou países diferentes.
Supervisão automática (mesmo núcleo)
Se o supervisor e os alunos compartilham o mesmo núcleo, a supervisão é automática — você verá o badge "Compartilha núcleo" no perfil do aluno.
Supervisão manual (fora do núcleo)
Se você não tem núcleo próprio, escolha supervisores manualmente: na tela de supervisão, toque diretamente no educador na lista de "Supervisores sugeridos" e depois em "Salvar alterações". Os alunos supervisionados assim aparecem com o badge "Fora do seu núcleo".
Ver a árvore de supervisão
No perfil do grupo, toque no cartão "Hierarquia" para abrir a árvore completa de educadores e quem supervisiona quem.
Educadores
Criar seu núcleo
Como criar seu núcleo, posicioná-lo no mapa e configurar os horários de treino.
Acessar o formulário de criação
Vá em "Perfil" → seção "Gestão" → botão "Criar núcleo". Se você estiver criando seu primeiro grupo, essa etapa também aparece dentro do assistente de configuração inicial.
Preencha nome e localização
Complete "Nome do núcleo" (ex: Núcleo Centro), "Localização" (endereço completo), "País" e "Cidade". Todos são obrigatórios.
Adicione os horários de treino
Em "Horários de treinamento", toque "Adicionar horário": dia da semana, hora de início e hora de fim. Pelo menos um horário é obrigatório.
Crie o núcleo
Toque "Criar núcleo". Se todos os campos estão preenchidos, o núcleo é criado e fica visível no diretório.
Editar ou excluir o núcleo
Para editar nome, endereço ou horários, vá ao perfil do núcleo → ícone de editar. "Excluir núcleo" é uma exclusão permanente, disponível apenas para o educador responsável — não existe uma opção para apenas ocultá-lo do diretório.
Configurar o sistema de cobrança
Dentro de "Editar núcleo" você encontra a seção de cobrança. Ative "Aulas gratuitas" se não cobra mensalidade. Se cobra, insira o valor mensal, a moeda e o dia do mês em que vence o pagamento.
Educadores
Co-educadores
Como adicionar co-educadores ao seu núcleo e gerenciar suas permissões.
O que é um co-educador
Um co-educador é um educador do mesmo grupo que ajuda a gerenciar seu núcleo: registra aulas, marca presença, registra pagamentos e pode editar os dados do núcleo. Apenas excluir o núcleo ou transferir a responsabilidade ficam reservados ao educador responsável.
Adicionar um co-educador
Vá ao painel administrativo do seu núcleo → aba "Equipe" (visível apenas para o educador responsável). Escolha na lista de educadores do grupo e confirme.
Remover um co-educador
Na aba "Equipe", toque no nome do co-educador e escolha "Remover co-educador".
Sair do papel de co-educador
Se você é co-educador de um núcleo e não quer mais ser, vá ao perfil público do núcleo e toque "Sair do papel".
Transferir a responsabilidade do núcleo
Pela aba "Equipe", o educador responsável pode transferir a responsabilidade para um co-educador ativo. Quem transfere fica como co-educador do núcleo.
Educadores
Solicitações ao núcleo
Como gerenciar as solicitações de entrada no núcleo pelo painel administrativo.
Ver as solicitações pendentes
Vá ao painel administrativo do seu núcleo → aba "Solicitações". Você verá todas as solicitações de entrada pendentes, com o nome do solicitante, sua foto e a data.
Aprovar ou rejeitar uma solicitação
Em cada cartão, toque no ícone ✓ para aprovar ou no ícone ✕ para rejeitar. O solicitante recebe uma notificação com a resposta, e se você aprovar, ele aparece imediatamente na sua lista de alunos.
Educadores
Alunos e turmas
Como ver seus alunos e adicionar membros sem conta no app.
Painel administrativo do núcleo
Acesse em "Perfil" → seção "Gestão" → seu núcleo, ou pelo perfil do núcleo tocando o botão de administração. Você encontrará as abas "Presença" (a que abre por padrão), "Alunos", "Pagamentos" e "Relatórios".
Ver a lista de alunos
Na aba "Alunos" você verá todos os membros vinculados ao seu núcleo, com nome, corda atual e porcentual de presença do mês.
Adicionar um aluno sem conta (ghost member)
Na aba "Alunos", toque no ícone "+" para registrar manualmente um aluno que não usa o app. Insira o nome e os dados básicos.
Turmas
As turmas (grupos de alunos por horário) são definidas uma única vez, ao criar o núcleo — não há uma tela para adicionar turmas novas depois.
Ver o perfil individual de um aluno
Toque no nome de qualquer aluno para ver sua ficha: corda, porcentual de presença do mês, histórico de presença e registro de pagamentos.
Educadores
Controle de presença
Como registrar uma aula, marcar presentes e revisar o histórico.
Registrar uma aula
No painel do núcleo → aba "Presença", toque "Registrar aula de hoje". Você pode mudar a data no formulário para registrar uma aula de outro dia — o app ajusta os horários disponíveis conforme a data escolhida.
Selecionar horário e turma
No formulário de sessão, selecione o horário correspondente. O app carrega automaticamente a lista de alunos daquela turma.
Marcar presentes e ausentes
Toque no nome de cada aluno para alternar entre presente e ausente.
Suspender uma aula
Se a aula não aconteceu (feriado, chuva, etc.), ative "Suspender aula" antes de salvar. Ela fica registrada com o badge "Suspensa" e não conta na presença nem nas cobranças.
Salvar a aula
Toque "Salvar aula". O app mostra um diálogo com o total de presentes e ausentes — toque "Confirmar" para registrar a sessão.
Revisar sessões anteriores
Na aba "Presença", as aulas aparecem em ordem cronológica. Toque em qualquer sessão passada para ver o detalhe ou editá-la.
Educadores
Pagamentos e tesouraria
Como registrar mensalidades, controlar quem deve e exportar relatórios.
A aba "Pagamentos"
No painel administrativo do núcleo, vá à aba "Pagamentos". Cada aluno aparece com seu status do mês: Pendente, Pago, Pago (atrasado), Vencido, Gratuito, Reportado (o aluno avisou que pagou) ou Duplicado.
Registrar o pagamento de um aluno
Toque no nome do aluno na aba "Pagamentos" e depois em "Registrar pagamento". Insira o valor, o mês correspondente e, se aplicável, um desconto (valor fixo ou porcentagem) — útil para bolsas.
Revisar um pagamento reportado pelo aluno
Quando um aluno reporta seu pagamento pelo próprio perfil, ele aparece na sua aba "Pagamentos" com a etiqueta "Reportado". Toque e edite como qualquer outro pagamento para mudar o status para "Pago".
Ver quem tem pagamentos pendentes ou vencidos
Na lista da aba "Pagamentos" você vê de uma vez o status de todos os alunos, incluindo o dia limite de pagamento configurado.
Gerar e exportar o relatório mensal
Vá à aba "Relatórios" do painel do núcleo. Selecione o formato (CSV ou PDF) e toque "Gerar relatório". Inclui o resumo de pagamentos e presença do mês.
Educadores
Sistema de graduação
Como configurar as cordas do seu grupo e registrar mudanças de nível.
Acessar o sistema de graduação
Vá ao perfil do seu grupo → seção recolhível "Sistema de graduações" → "Gerenciar sistema completo" (ou "Configurar sistema agora" se ainda não tiver níveis).
Criar um nível de corda
Toque "Adicionar nível". Insira o nome da corda, selecione as cores que a compõem, e indique se tem pontas pintadas e quantas.
Organizar por categoria
Os níveis se organizam em seções: adultos, juvenis, infantis, estagiários e níveis especiais. Atribua a categoria correta ao criar ou editar cada nível.
Definir o nível de educador
Você pode marcar a partir de qual corda um aluno é considerado "educador" no grupo — isso determina quem tem acesso a criar núcleos e às ferramentas de gestão.
Atribuir uma graduação
Na tela do sistema de graduação, toque "Atribuir graduação aos membros". Busque o aluno, selecione o novo nível e a data. A mudança aparece imediatamente no perfil dele.
Ver a corda de um aluno
Toque no nome de qualquer aluno do seu grupo para ver sua corda atual com a cor.
Educadores
Criar e gerenciar eventos
Como publicar um batizado, roda ou oficina para que a comunidade veja.
Criar um evento
Vá à aba "Eventos" e toque no botão flutuante "+".
Preencha os dados básicos
Insira o nome do evento, a descrição e a categoria (batizado, roda, roda aberta, troca de corda, curso, workshop, seminário, festival, encontro, intensivo, treino, ou uma categoria personalizada).
Data, pôster e documentos
Defina data de início e fim (com opção de recorrência), envie uma imagem de capa (pôster) e, se precisar compartilhar regras ou regulamentos, anexe um PDF de até 10MB.
Preço e cronograma
Se o evento tiver custo, insira o preço e os métodos de pagamento aceitos (transferência, dinheiro, Mercado Pago, PayPal ou outro). Se o evento tiver várias atividades, adicione-as em "Agenda" — cada bloco com seu próprio horário, descrição e local.
Localização
Se você não usou o cronograma com locais por bloco, insira o endereço do evento no final do formulário. O app abre o seletor de mapa para posicionar o marcador exato.
Editar um evento já criado
Vá ao detalhe do evento → ícone de editar (disponível para o organizador e co-organizadores). As mudanças aparecem imediatamente para todos.
Gerencie co-organizadores e convidados especiais
No menu de edição do evento toque "Colaboradores". Escolha o papel antes de convidar: "Co-organizador" (pode editar o evento) ou "Convidado especial" (aparece em destaque, sem permissão de edição). Busque pelo nome e envie o convite.
Educadores
Relatórios e KPIs
Como revisar as métricas do núcleo e exportar dados para análise externa.
As métricas rápidas do painel
Na parte superior do painel administrativo do núcleo você verá uma faixa com 3 dados: quantidade de alunos, porcentual médio de presença e alunos pagos sobre o total.
Saltar para outro mês pelo KPI
Toque na etiqueta do mês nessa faixa para abrir um seletor e saltar direto para qualquer mês anterior.
A aba "Relatórios"
Vá ao painel do núcleo → aba "Relatórios". Se você tiver turmas configuradas, pode filtrar todo o relatório por uma turma específica usando os chips no topo.
Escolha o formato e exporte
Selecione "CSV" (para abrir no Excel ou Google Sheets) ou "PDF" (para compartilhar ou imprimir) e toque "Gerar relatório". Inclui alunos ativos, sessões realizadas, porcentual de presença e status de pagamentos por aluno.