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
Ao abrir o app, você verá a tela "Criar conta — Junte-se à comunidade de capoeira". Preencha nome, sobrenome, apelido (opcional) e e-mail. Você também pode se registrar com o Google.
Complete o onboarding
Após o cadastro, a tela de onboarding vai guiá-lo para adicionar sua foto de perfil e encontrar seu grupo ou núcleo. Você pode pular essa etapa e fazer depois, mas vincular-se desde o início ativa todas as funções comunitárias.
Vincule seu grupo
Na tela inicial você verá o cartão "Sem grupo atribuído" com o botão "Buscar grupos". Procure seu grupo no diretório e envie uma solicitação de entrada. Você também pode pedir ao seu educador para te adicionar diretamente pelo painel do núcleo.
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, o cartão do seu grupo 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: "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.
O botão "+" (Educadores)
Se você é educador, verá um botão flutuante "+" na tela de Início. Toque para abrir um menu com três opções: "Novo evento", "Criar grupo" e "Criar núcleo".
Mapa global de núcleos
Na aba "Grupos" você encontrará um mapa interativo com todos os núcleos registrados no mundo. Toque em qualquer marcador para ver o nome do núcleo, grupo e horários. Útil para encontrar onde treinar quando você viaja.
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. Os educadores criam núcleos dentro do seu grupo.
Explore os grupos
A aba "Grupos" mostra todos os grupos públicos registrados na plataforma. 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 completo em abas: "Resumo" (descrição e dados), "Eventos" (próximos eventos do grupo), "Hierarquia" (árvore de educadores), "Núcleos" (lista de núcleos ativos) e "Graduações" (sistema de cordas).
Solicitar entrada em um grupo
No perfil do grupo, toque "Solicitar entrada no grupo". Sua solicitação ficará com o badge "Solicitação pendente" até o administrador aprovar. Você receberá uma notificação em "Perfil → Notificações" quando for aceito.
Ver a hierarquia do grupo
Na aba "Hierarquia" do perfil do grupo você encontrará a árvore completa de educadores. Pode buscar por nome dentro da hierarquia. 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. O histórico de graduações também é visível publicamente.
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. Você pode alternar entre visão de calendário e visão de lista com o botão no canto.
Filtre por categoria e mais
Toque em "Filtros" para abrir as opções avançadas: Categoria (batizado, roda, roda aberta, troca de corda, curso, aula, workshop, seminário, festival, encontro, intensivo, treino), Preço (grátis ou pagos), Formato (presencial ou online), 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, tipo de evento, organizadores e o pôster. Você verá quantas pessoas vão ("Vou") e quantas marcaram interesse ("Tenho interesse").
Confirmar "Vou" ou "Tenho interesse"
No detalhe do evento, toque "Tenho interesse" para salvá-lo na sua lista, ou "Vou" para confirmar presença. Os organizadores podem ver o total de ambas as confirmações.
Compartilhar um evento
Use o botão compartilhar no detalhe do evento para enviá-lo pelo WhatsApp, Instagram ou outros apps. É compartilhado o nome, a data e um link direto para o evento.
Geral
Seu perfil
Como gerenciar sua identidade, notificações e acessar as configurações.
As três abas do perfil
A aba "Perfil" tem três seções: "Resumo" (seus próximos eventos e bio), "Notificações" (solicitações pendentes de grupo, núcleo ou educador) e "Gestão" (se educador, acesso aos seus núcleos; se aluno, os núcleos onde treina).
Editar seu perfil
Toque no ícone de editar (lápis) sobre sua foto ou nome para abrir o formulário de edição. Você pode mudar foto, nome, sobrenome e apelido. Salve tocando "Salvar".
Sua corda e graduações
Sua corda atual aparece com cor e nome abaixo do seu nome no perfil. Se tiver mais de uma graduação registrada, toque na corda para ver o histórico completo com a data de cada mudança de nível.
Configurações: idioma e tema
Em "Perfil", toque "Configurações". Lá você pode mudar o idioma (português, espanhol, inglês) em "Idioma", e o tema visual (claro ou escuro) em "Modo do aplicativo". As mudanças se aplicam imediatamente.
Notificações pendentes
Na aba "Notificações" do perfil você verá cinco tipos de solicitações: "Solicitação de entrada no grupo" (alguém quer entrar no seu grupo), "Solicitação de educador" (pedido de relação educador-aluno), "Solicitação ao núcleo" (alguém quer entrar no seu núcleo), "Solicitação de transferência de núcleo" (transferência de administração pendente) e "Solicitação de colaboração" (convite para co-organizar um evento). 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 com informações técnicas do seu dispositivo anexadas automaticamente.
Praticantes
Entrar em um núcleo
Como encontrar um núcleo perto de você, enviar uma solicitação e o que acontece depois.
Busque um núcleo no mapa
Vá à aba "Grupos" e use o mapa interativo para explorar os núcleos perto de você. Toque em qualquer marcador para ver o nome, grupo, horários e a opção de ver o perfil completo.
Solicite entrar com "Solicitar entrada guiada"
No perfil do núcleo, toque "Solicitar entrada guiada". Você pode incluir uma mensagem para se apresentar ao educador. Sua solicitação aparecerá na seção "Solicitações" do painel do núcleo.
Aguarde a aprovação
Sua solicitação fica como "Pendente" até o educador aprovar ou rejeitar. Você receberá uma notificação em "Perfil → Notificações" quando houver uma resposta.
Acesse suas aulas e acompanhamento
Após a aprovação, o núcleo aparece em "Perfil" → aba "Gestão". Lá você verá seu histórico de presença mês a mês e o status dos seus pagamentos se o núcleo gerencia mensalidades.
Praticantes
Seu histórico pessoal
Como ver sua presença mensal, suas graduações e os eventos em que você participou.
Presença do mês
Vá em "Perfil" → aba "Gestão" → seu núcleo. Você verá seu porcentual de presença do mês atual e a lista de aulas com indicador de presença ou ausência.
Histórico de graduações
No seu perfil, toque na sua corda atual para ver o histórico completo com a data de cada mudança de nível. O registro é permanente e visível publicamente no seu perfil.
Status de pagamentos
Se o seu núcleo gerencia pagamentos, na aba "Gestão" você verá o status do seu pagamento do mês: "Pendente", "Pago" ou "Vencido". Só o educador pode registrar seus pagamentos.
Eventos confirmados
Na aba "Resumo" do seu perfil você verá os próximos eventos nos quais confirmou "Vou". Pode ver o detalhe de cada um tocando o nome diretamente do perfil.
Educadores
Criar seu grupo
Como registrar seu grupo de capoeira na plataforma e configurar suas informações.
Acessar o formulário de criação
Toque no botão flutuante "+" na tela de Início → "Criar grupo". Você também pode ir à aba "Grupos" e tocar o botão "Criar grupo" no canto superior.
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 global, nos perfis dos membros e em todos os eventos que você organizar.
Estilo de capoeira (obrigatório)
No campo "Estilo de capoeira *" escreva o estilo que você pratica (ex: Mista, Benguela, Angola, Regional). É um campo de texto livre e obrigatório. Esse texto serve como nome do seu sistema de graduação e influencia como as cordas são chamadas no grupo.
Logo do grupo (opcional)
Envie o logo do seu grupo da galeria. Aparecerá no perfil do grupo, nos núcleos e no cartão do grupo que seus alunos veem na tela de Início.
Criar o grupo
Toque "Criar". Se o nome não estiver duplicado, o grupo é criado imediatamente. O app perguntará se você quer configurar o sistema de graduação agora ou depois.
Convidar membros
Após criar o grupo, compartilhe o nome com seus alunos. Eles buscam na aba "Grupos" → diretório e solicitam entrada. Você também pode adicioná-los diretamente pelo painel do seu núcleo ou eles se vinculam durante o próprio onboarding.
Educadores
Administrar seu grupo
Como gerenciar membros, papéis de administrador e as informações do grupo.
Painel de administração do grupo
Vá ao perfil do seu grupo e toque o botão de administração (visível apenas para administradores e co-administradores). Você acessará as opções de gerenciamento de membros, papéis e configuração.
Aprovar ou rejeitar solicitações de entrada
Em "Solicitações" do painel do grupo você verá as solicitações pendentes com o nome do solicitante e sua mensagem se usou a solicitação guiada. Toque "Aprovar" ou "Rejeitar" para responder cada uma.
Atribuir papéis: admin e co-admin
No perfil de um membro no painel do grupo, você pode atribuir o papel de "Co-administrador" (acesso ao painel) ou promovê-lo a "Administrador". Você também pode usar a opção "Deixar admin" para remover o papel.
Editar as informações do grupo
Vá ao perfil do grupo → ícone de editar. Você pode mudar nome, descrição, logo, estilo de capoeira e cidade. As mudanças se aplicam imediatamente e refletem no diretório público.
Remover um membro
Na lista de membros do painel, toque no nome de um membro e escolha "Remover do grupo". O membro perde acesso aos conteúdos do grupo, mas mantém seu histórico de graduações.
Educadores
Supervisão educativa
Como atribuir um educador supervisor para os alunos do seu núcleo e como funciona a hierarquia.
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. O app mostrará o badge "Compartilha núcleo" no perfil do aluno dentro do painel do supervisor.
Supervisão manual (fora do núcleo)
Se o supervisor está em um núcleo diferente, você pode atribuí-lo manualmente. Na tela de supervisão, toque "Selecionar educador supervisor" e busque o educador pelo nome. Os alunos supervisionados aparecerão com o badge "Fora do seu núcleo".
Ver a árvore de supervisão
A árvore de supervisão é visível na aba "Hierarquia" do perfil do grupo. Ela mostra as relações entre educadores e quais alunos estão sob supervisão de cada um — a árvore de "mestre a aprendiz" do seu grupo.
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
Toque no botão flutuante "+" na tela de Início → "Criar núcleo". Você também pode ir à aba "Grupos" → perfil do seu grupo → aba "Núcleos" → botão "Criar núcleo".
Preencha nome e localização
Complete os campos: "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
Na seção "Horários de treinamento", toque "Adicionar horário". Selecione o dia da semana, hora de início e hora de fim. Adicione quantos horários precisar. Pelo menos um horário é obrigatório para criar o núcleo.
Crie o núcleo
Toque "Criar núcleo". Se todos os campos estão preenchidos, o núcleo é criado e aparecerá no mapa global e no diretório. Você será levado automaticamente ao painel administrativo do núcleo.
Editar ou desativar o núcleo
Para editar nome, endereço ou horários, vá ao perfil do núcleo → ícone de editar. Se parar de treinar naquele local, pode desativar o núcleo para que não apareça no diretório sem perder o histórico.
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. Tem acesso ao painel administrativo: pode registrar aulas, marcar presença e registrar pagamentos, mas não pode alterar a configuração do núcleo nem transferir a administração.
Adicionar um co-educador
Vá ao perfil do seu núcleo → seção "Co-educadores" → toque "Agregar co-educador". Busque o educador pelo nome (deve ser membro do mesmo grupo com papel de Educador). Toque no nome e confirme.
Remover um co-educador
Na seção "Co-educadores" do perfil do núcleo, toque no nome do co-educador e escolha "Quitar co-educador". A ação é imediata e o educador perde acesso ao painel do núcleo.
Sair do papel de co-educador
Se você é co-educador de um núcleo e não quer mais ser, vá ao perfil do núcleo → seção "Co-educadores" → "Salir del rol de co-educador". Você também pode fazer isso em "Perfil → Gestão → [nome do núcleo]" → "Salir del rol".
Transferir a administração do núcleo
Para passar o controle total do núcleo a outro educador, vá ao perfil do núcleo → "Transferir administração". O receptor deve ser co-educador ativo 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 perfil do seu núcleo → botão "Gerenciar" → aba "Solicitações". Você verá todas as solicitações de entrada pendentes. Cada cartão mostra o nome do solicitante, sua foto, a data e a mensagem enviada (se usou a solicitação guiada).
Aprovar uma solicitação
Toque "Aprovar" no cartão do solicitante. O aluno receberá uma notificação de que foi aceito e começará a aparecer na sua lista de alunos. Você pode atribuí-lo a uma turma imediatamente na aba "Alunos".
Rejeitar uma solicitação
Toque "Rejeitar" no cartão do solicitante. O aluno receberá uma notificação indicando que sua solicitação não foi aprovada.
Histórico de solicitações processadas
Abaixo das solicitações pendentes você encontrará o histórico de solicitações já processadas: aprovadas (badge "Aceita") e rejeitadas (badge "Rejeitada"). As solicitações processadas ficam no histórico e não podem ser excluídas.
Educadores
Alunos e turmas
Como ver seus alunos, adicionar membros sem conta e organizá-los por turma.
Painel administrativo do núcleo
Acesse em "Perfil" → aba "Gestão" → seu núcleo, ou pelo perfil do núcleo tocando o botão de administração. Você encontrará quatro abas: "Alunos", "Presença", "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. Se não houver membros, o app mostra "Não há membros".
Adicionar um aluno sem conta (ghost member)
Role para baixo na aba "Alunos" até a seção "Alunos sem conta". Toque "Adicionar aluno" para registrar manualmente um aluno que não usa o app. Insira o nome e os dados básicos.
Criar e gerenciar turmas
Acesse a gestão do núcleo (ícone de engrenagem ou botão "Gerenciar"). Lá você pode criar turmas — grupos de alunos organizados por horário. Crie uma turma por horário de aula (ex: "Segunda e Quarta 19h") e atribua os alunos.
Ver o perfil individual de um aluno
Toque no nome de qualquer aluno para ver sua ficha: nome, corda, porcentual de presença do mês, histórico de presença mês a mês e registro de pagamentos.
Educadores
Controle de presença
Como registrar a aula de hoje, marcar presentes e revisar o histórico.
Registrar a aula de hoje
No painel do núcleo → aba "Presença", você verá a mensagem "Ainda não há aulas este mês" se for a primeira. Toque o botão "Registrar aula de hoje" para abrir o formulário de sessão.
Selecionar horário e turma
No formulário de sessão, selecione o horário de hoje (um dos que você configurou ao criar o núcleo) e a turma correspondente. O app carregará automaticamente a lista de alunos daquela turma.
Marcar presentes e ausentes
Toque no nome de cada aluno para alternar entre presente (✓ verde) e ausente. A lista mostra primeiro os alunos da turma selecionada e depois o restante do núcleo, para não misturar grupos.
Salvar a aula
Toque "Salvar aula". O app mostra um diálogo de confirmação com o total de presentes e ausentes. Toque "Confirmar" para registrar a sessão na nuvem. O porcentual de presença de cada aluno é atualizado automaticamente.
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 completo: quem esteve presente, quem faltou e a data e hora do registro.
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 de pagamento do mês: "Pendente", "Pago", "Pago (atrasado)", "Vencido" ou "Gratuito". Os status são calculados automaticamente por data.
Registrar o pagamento de um aluno
Toque no nome do aluno na aba "Pagamentos" e depois em "Registrar pagamento". Insira o valor e selecione o mês correspondente. O status do aluno muda para "Pago" imediatamente.
Ver quem tem pagamentos pendentes ou vencidos
Na lista da aba "Pagamentos" você vê de uma vez o status de todos os alunos. Os status "Pendente" e "Vencido" aparecem em destaque. Você também verá 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 para Excel ou Google Sheets, ou PDF para imprimir ou compartilhar) e toque "Gerar relatório".
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 → aba "Graduações". Se ainda não tiver níveis configurados, você verá "Não há níveis de graduação definidos" e o botão "Configurar sistema agora".
Criar um nível de corda
Toque "Adicionar nível" ou "Criar Nível". Insira o nome da corda (ex: "Corda Verde-Amarela"), selecione as cores que a compõem, e indique se tem pontas pintadas e quantas. Salve o nível.
Organizar por categoria
Os níveis se organizam em seções: "Sistema Adulto", "Sistema Juvenil", "Sistema Infantil", "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
No perfil do grupo → "Graduações" → "Atribuir graduação". Busque o aluno, selecione o novo nível e a data. A mudança fica registrada no histórico permanente do aluno e a nova corda aparece no seu perfil imediatamente.
Ver o histórico de graduação de um aluno
Toque no nome de qualquer aluno do seu grupo. No seu perfil você verá a corda atual com sua cor. Toque na corda para ver o histórico completo: todas as mudanças de nível com data. O histórico não pode ser excluído.
Educadores
Criar e gerenciar eventos
Como publicar um batizado, roda ou oficina para que a comunidade veja.
Criar um evento
Toque o botão flutuante "+" na tela de Início → "Novo evento". Também pode ir à aba "Eventos" e tocar o botão "Novo Evento" no canto superior.
Preencha os dados do evento
O formulário inclui: nome do evento, categoria (batizado, roda, roda aberta, troca de corda, curso, aula, workshop, seminário, festival, encontro, intensivo ou treino), data, hora de início e hora de fim.
Adicione descrição e pôster
Insira a descrição com todos os detalhes relevantes (preço, requisitos, o que levar, etc.). Envie uma imagem de capa (pôster) da sua galeria para dar visibilidade ao evento.
Fixe a localização no mapa
Insira o endereço do evento. O app abrirá o seletor de mapa onde você pode mover o marcador para localizar exatamente o lugar. Os participantes verão a localização e poderão abrir a navegação diretamente do evento.
Gerencie co-organizadores e participantes
Após criar o evento, você pode adicionar co-organizadores no menu de edição → "Colaboradores". Eles podem editar o evento e ver a lista de quem marcou "Vou" ou "Tenho interesse".
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 de KPIs: número de alunos, quantidade de aulas do mês, porcentual médio de presença, quantidade de alunos pagos e quantidade de vencidos.
A aba "Relatórios"
Vá ao painel do núcleo → aba "Relatórios". O subtítulo é "Presença, pagamentos e estatísticas do núcleo". Daqui você gera o relatório mensal com todas as informações consolidadas.
Escolha o formato do relatório
Selecione o formato que precisa: "CSV" para abrir no Excel ou Google Sheets, ou "PDF" para um documento pronto para compartilhar ou imprimir.
Gerar e exportar
Toque "Gerar relatório". O app gera o arquivo com o resumo do mês: alunos ativos, sessões realizadas, porcentual de presença geral e status de pagamentos por aluno. Você pode compartilhá-lo diretamente da tela de exportação.