Quickstart admin

Este guia leva você do convite ao primeiro learner logando na sua academia em aproximadamente 30 minutos. Os passos assumem que você recebeu seu acesso de admin via magic link.

1. Acesse o painel admin

Vá em https://[seu-tenant].skillment.app/admin/dashboard e faça login. Se ainda não tem tenant, recebeu o magic link via e-mail ou WhatsApp do Ivan.

2. Configure sua marca

Acesse /admin/branding. Aqui você escolhe:

• Cor primária, secundária, terciária (HSL triplet)
• Fonte display + fonte body (do Google Fonts)
• Logo + favicon + open graph image
• Raio de borda + espaçamento base

Preview ao vivo no lado direito. Salve e tudo aplica imediatamente, sem deploy.

3. Crie sua primeira trilha

Acesse /admin/trilhas/nova:

1. Defina título, descrição, imagem de capa, carga horária estimada
2. Adicione fases (cards drag-and-drop)
3. Em cada fase, adicione lições (vídeo, texto, link externo)
4. Adicione quiz ao final da fase (6 formatos disponíveis)
5. Configure pré-requisito (fase 2 só desbloqueia após fase 1 completa)
6. Salve como rascunho, depois “Publicar”

4. Configure gamificação

Em /admin/gamification:

• XP por evento (login, lição, quiz, desafio)
• Conquistas (badges) com critérios
• Lojinha de recompensas (opcional)
• Temporadas (opcional)

Recomendação inicial: deixe o default + 3-5 conquistas customizadas nos primeiros marcos da sua trilha.

5. Convide learners

Duas opções:

• CSV upload: em /admin/users/import, suba CSV com colunas email,name,area,turma,localidade,cargo. Cada linha recebe magic link.
• Manual: em /admin/users/new, cadastre um por um. Útil pra primeiros 5-10 alunos.

6. Atribua a trilha

Em /admin/users, selecione learners, “Atribuir trilha”, escolha a trilha. Eles recebem notificação por e-mail (e WhatsApp se configurado).

7. Acompanhe progresso

Em /admin/analytics, veja em tempo real:

• Quantos learners ativos nos últimos 7/30 dias
• Funil de conclusão da trilha (em qual fase travou)
• Ranking por XP, filtrável por área/turma/localidade
• Heatmap de engajamento (dia da semana × hora)
• Conquistas mais desbloqueadas e recompensas mais trocadas

Próximo passo

Quando estiver confortável com a operação manual, veja a API pública pra automatizar cadastros e a SCIM 2.0 pra integrar com Workday/Okta/Azure AD.