Manual do usuário

O Ágora é a plataforma de aprendizagem gamificada da Neural Thinkers Lab para escolas. Ele organiza o acesso das pessoas da escola por convite, acompanha o tempo de estudo, credita pontos de experiência (XP) por atividade e mostra quem está aprendendo mais na tela de Ranking.

Este manual descreve o que o sistema faz hoje. Quando uma tela existe mas ainda não entrega o que o nome promete, isso está dito de forma explícita, e a última seção reúne esses pontos.

Quem usa o sistema

O perfil de cada pessoa define o menu que ela enxerga:

• Aluno: estuda pelas trilhas, usa o cronômetro do Diário, conversa com o Mentor IA e acompanha a própria pontuação.
• Professor: tudo o que o aluno faz, mais a tela Meus Alunos, onde libera o acesso de quem entrou por convite.
• Coordenador: acessa a área de Administração, com Professores, Alunos e Convites.
• Responsável: existe como tipo de convite e como papel no sistema, mas não há nenhuma tela específica para ele. Veja a última seção.
• Administrador e Desenvolvedor: perfis da própria Neural Thinkers Lab, usados para cadastrar escolas.

Os convites só criam os quatro primeiros papéis. Administrador e Desenvolvedor não são papéis de escola.

Entrar no sistema

O endereço é agora.ntlabs.dev. Na tela de entrada você tem três caminhos:

1. Conta de outro serviço: Google, GitHub, Facebook, LinkedIn, Microsoft ou Banco do Brasil.
2. Sem senha: você recebe um código pelo WhatsApp ou um link de acesso por e-mail.
3. E-mail e senha, inclusive criando a conta ali mesmo.

Depois de entrar por um serviço externo, o sistema mostra "Autenticando..." e leva você adiante sozinho. Se a página parar nesse estado, volte para a tela de entrada e tente de novo.

Entrar por convite

Ninguém se cadastra sozinho dentro de uma escola. O vínculo nasce sempre de um convite gerado pela coordenação.

1. A coordenação gera o convite em Administração > Convites e copia o link.
2. Você abre o link. A tela mostra o nome da escola, a cidade, o papel em Você entrará como e quantas Vagas restantes o convite ainda tem.
3. Se você ainda não estiver conectado, entre por Google ou GitHub. Nessa tela, só esses dois aparecem. O convite fica guardado e é aceito sozinho quando você volta.
4. Clique em Aceitar Convite. O sistema confirma as boas-vindas e leva você ao Onboarding.

Se aparecer "Convite Inválido" ou "Este convite não está mais disponível", o código foi revogado, expirou ou já esgotou as vagas. Peça um link novo à coordenação.

Onboarding

O assistente de primeiro acesso muda conforme o papel do convite:

No passo de boas-vindas você informa o nome completo. O aluno informa também a Série / Turma.

O aluno escolhe pelo menos uma área de interesse entre Frontend, Backend, Inteligência Artificial e DevOps, e depois escolhe a personalidade do mentor entre as opções apresentadas. Esse segundo passo é opcional.

Professor e aluno aceitam os Termos de Uso e o texto de LGPD antes de concluir. O consentimento fica registrado.

Ao concluir, você ganha 100 XP de boas-vindas e cai no Dashboard. Quem concluiu como coordenador cai na área de Administração.

Liberação do acesso

Quem entra por convite como aluno, professor ou responsável fica como Pendente até alguém liberar. Só coordenador entra já liberado.

Enquanto isso, a pessoa vê a tela "Aguardando aprovação" no lugar do painel, com o botão Verificar novamente. Nada mais funciona para ela até a liberação.

• Professor libera aluno em Meus Alunos. O aviso no topo diz quantos alunos aguardam aprovação; o botão da linha alterna entre Aprovar e Desativar.
• Coordenação libera aluno em Administração > Alunos, do mesmo jeito, e libera professor em Administração > Professores, onde o estado é Ativo ou Inativo.

A pessoa não recebe aviso automático da liberação. Combine com ela para clicar em Verificar novamente.

Trilhas

Trilhas lista o conteúdo disponível, com filtro por assunto e por dificuldade (Iniciante, Intermediário, Avançado). Abrindo uma trilha você vê a descrição, a duração estimada, o XP total e a lista de lições em ordem.

• Matricular-se nesta Trilha registra a trilha no seu perfil.
• Cada lição tem o botão Concluir, que credita o XP dela na hora, com a mensagem "+N XP ganhos!". Ao fechar a última lição aparece "Trilha Concluída!".
• O XP de uma lição é creditado uma única vez. Clicar em Concluir de novo na mesma lição não repete o ganho.
• A marca de lição concluída não sobrevive a um recarregar da página. Ao voltar, a lista aparece como se nada tivesse sido feito, mesmo com o XP já creditado e contabilizado.

Duas coisas importantes sobre o conteúdo. Primeiro, uma lição hoje é um título, uma descrição curta e um valor de XP: não há texto, vídeo nem material anexado, e Concluir é uma marcação que você faz por conta própria. Segundo, as trilhas existentes são o material técnico interno da Neural Thinkers Lab (monorepo, ambiente de desenvolvimento, deploy, IA, DevOps), não conteúdo escolar, e não há nenhuma forma de a escola criar ou enviar conteúdo próprio.

Diário de estudo

Apesar do nome, o Diário é um cronômetro de sessões, não um caderno de anotações livres.

1. Escreva o assunto, que é opcional, e clique em Iniciar.
2. O tempo corre na tela enquanto a sessão está ativa.
3. Para fechar, escreva as notas da sessão, também opcionais, dê uma nota de foco de 1 a 5 estrelas e clique em encerrar.

O XP da sessão é de 1 ponto por minuto, com um mínimo de 5 pontos e um teto para sessões deixadas abertas por muito tempo. A duração real continua registrada inteira nas estatísticas, mesmo quando passa do teto.

O resumo mostra horas, sessões, XP e foco médio dos últimos 7 dias, e abaixo fica o histórico agrupado por data. Vários rótulos dessa tela aparecem sem acentuação.

XP, nível e sequência

Todo ganho de XP fica registrado no seu Histórico de XP, no Perfil, com a origem de cada crédito. Nada é apagado dali.

Nível. Sair do nível 1 custa 100 XP. Cada nível seguinte fica 15% mais caro que o anterior, ou seja, o nível n custa 100 × 1,15^(n-1) pontos. O topo é o nível 100. A barra de progresso mostrada no Dashboard e no Perfil não corresponde ao avanço real dentro do nível; use o número do nível e o XP total.

Bônus Diário. O botão Bônus Diário aparece no Dashboard e no Perfil e pode ser coletado uma vez por dia. Ele vale 50 pontos mais um bônus de sequência de 10 pontos por dia de sequência, limitado a 100 pontos de bônus. Depois de coletar, o botão mostra o valor ganho e passa a "Coletado".

Sequência (streak). A sequência sobe em um dia quando você coleta o bônus no dia seguinte ao da última coleta. Se passar um dia sem coletar, ela volta para

1. Vale insistir neste ponto: a sequência avança pela coleta do bônus, não pelo estudo. Quem estuda todos os dias e não clica em Bônus Diário perde a sequência.

Ranking

Ranking lista as pessoas por XP total, com pódio para as três primeiras e tabela para as demais, mostrando nível, badges e sequência. Sua linha aparece marcada com "(Você)" e o cartão Sua Posição repete os seus números.

Este ranking é global: ele compara todas as pessoas de todas as escolas cadastradas no Ágora, não apenas a sua. Trate a posição como um número da plataforma inteira.

Mentor IA

Chat IA abre a conversa com o Mentor IA. Ele cumprimenta pelo seu nome e oferece quatro atalhos: Explicar matéria, Tirar dúvida, Resumir conteúdo e Sugerir trilha. A resposta aparece conforme é escrita, e Shift+Enter quebra linha sem enviar.

O que você precisa saber antes de usar:

• A conversa vive apenas na aba aberta. Recarregar a página, clicar em Nova conversa ou voltar outro dia começa do zero, e não há histórico para consultar depois.
• O mentor não foi alimentado com o material da sua escola, apesar do texto que aparece na tela. Ele responde com conhecimento geral, orientado a estudo.
• Conversar com o mentor não gera XP.

Por isso, o que for importante para você, copie para fora antes de fechar a página.

Perfil

Perfil mostra o seu avatar, o e-mail, o papel, o XP total, o nível, a sequência, o botão de bônus diário, a galeria de Badges e o Histórico de XP com cada crédito e sua origem.

A galeria de badges permanece vazia, com a mensagem "Nenhum badge conquistado ainda". O catálogo de badges existe no sistema, mas nenhum deles é concedido automaticamente por sequência, por XP acumulado ou por trilha concluída.

Convites, para quem administra

Em Administração > Convites a coordenação cria e controla os links de entrada. Ao gerar um convite, você escolhe:

• o Tipo de convite: Aluno, Professor, Coordenador ou Responsável;
• o Limite de usos, um número que você define ali;
• a Validade em dias, escolhida na lista da tela.

Cada convite da lista mostra o código, o papel, quantos usos já teve, a data de expiração, um botão para copiar o link e o botão Revogar. Convites saem de circulação quando são revogados, quando expiram ou quando esgotam as vagas, e a lista indica o estado de cada um.

O professor gera um convite de alunos durante o próprio onboarding, e esse é o único momento em que ele consegue fazer isso: a tela de Convites fica na área de Administração, que o professor não abre. Depois do onboarding, peça os links à coordenação.

Seus dados

O Ágora atende escolas e trata dados de menores de idade. Você aceita os Termos de Uso e o aviso de LGPD (Lei 13.709/2018) no onboarding, e esse consentimento fica registrado com data. Para menores de 18 anos, o consentimento do responsável é necessário.

A política de privacidade completa e o canal do encarregado de proteção de dados ficam em www.ntlabs.dev.

O que ainda não funciona

Estas telas existem no menu, mas não entregam o que o nome sugere. Saber disso evita que você conclua que o problema é seu.

• Leituras sempre aparece vazia. A lista de lições que ela deveria mostrar não chega até a tela.
• Vídeos não reproduz vídeo nenhum. Ela apenas repete as trilhas e leva de volta para a página da trilha.
• Suas Trilhas, no Dashboard, fica em 0% mesmo depois de você concluir lições. O XP é creditado, o percentual não acompanha.
• Badges nunca são concedidos automaticamente, então o contador fica em zero.
• O Responsável pode aceitar um convite, mas não existe tela que ligue um responsável a um aluno nem que mostre os filhos. Quem entra com esse papel cai no mesmo painel de aluno, sem nada específico.
• Turmas, na área de Administração, está desligada na própria tela.
• O botão Exportar, em Relatórios, não faz nada ao ser clicado.
• Alguns itens de menu levam a páginas que não existem, entre eles Configurações da área de Administração, Sobre e o botão Acessar Sistema da página inicial. Use o menu lateral para navegar dentro do sistema.
• A grafia do produto oscila entre "Ágora" e "Agora" conforme a tela, e algumas telas mostram rótulos sem acentuação. É a mesma plataforma.