/docs
Filosofia de Design
Qualidade sobre Quantidade
Contribuições significativas valem mais que spam de commits.
Anti-Cheat
Sistema com caps diários e penalidades para prevenir exploração.
Diversidade
Incentiva diferentes tipos de atividades: commits, PRs, reviews, etc.
Progressão Satisfatória
Sistema inspirado em Pokémon mantém engajamento a longo prazo.
Bônus de XP por Classe
Cada classe tem multiplicadores únicos de XP baseados em seu estilo de desenvolvimento.
Sistema Implementado
- Commits - 10 XP base × multiplicador de classe
- Pull Requests (criados por você) - 25 XP base × multiplicador de classe
- Issues Resolvidas - 35 XP base × multiplicador de classe
Em Desenvolvimento
- Code Reviews - Aguardando API do GitHub
- Large Commits (>100 linhas) - Bônus extra para commits grandes
- Stars/Forks nos seus repos - Reconhecimento da comunidade
- Releases - XP por publicar versões
Ogro
Brute Force Developer
Desenvolvedores que preferem ação direta, commits frequentes e entregas rápidas. Gostam de XGH.
Bônus Ativos:
Em Desenvolvimento:
Estilo: Agressivo, direto, produtividade bruta
Guerreiro
Full-Stack Warrior
Guerreiros colaborativos que lutam em múltiplas frentes. Mestres em pull requests e trabalho em equipe.
Bônus Ativos:
Em Desenvolvimento:
Estilo: Colaborativo, versátil, trabalho em equipe
Mago
Code Architect/Wizard
Arquitetos estratégicos que preferem impacto e qualidade. Mestres em problemas complexos.
Bônus Ativos:
Em Desenvolvimento:
Estilo: Estratégico, impacto e qualidade
Como funcionam os multiplicadores:
- Os bônus são aplicados APÓS o cálculo base de XP
- Multiplicadores acima de 1.0 aumentam o XP ganho
- Multiplicadores abaixo de 1.0 reduzem o XP ganho
- Escolha a classe que combina com seu estilo de desenvolvimento!
- XP Base Atual: 10 XP/commit, 25 XP/PR, 35 XP/issue
Progressão de Níveis
| Nível | XP Total | XP Necessário | Dias (~10 commits/dia) | Equivalente |
|---|---|---|---|---|
| 1 | 0 | 60 | 0 | Começando |
| 2 | 60 | 75 | 1 | Primeiros commits |
| 3 | 135 | 240 | 2 | Contribuidor ativo |
| 5 | 375 | 1,125 | 4 | Dev consistente |
| 10 | 1,500 | 1,875 | 15 | Desenvolvedor experiente |
| 15 | 3,375 | 2,625 | 34 | Senior developer |
| 20 | 6,000 | 7,500 | 60 | Expert developer |
| 30 | 13,500 | 24,000 | 135 | Tech lead |
| 50 | 37,500 | - | 375 | Coding deity |
Fórmula Acelerada (v3.0): XP = Level² × 15
Progressão rápida: Level 10 em 15 dias (~10 commits/dia)
Commits
Cada commit conta igualmente. Multiplicado pela classe do personagem.
Exemplo com Ogro (+25%):
1 commit = 10 × 1.25 = 12.5 XP
Pull Requests
Cada PR criado/aberto por você (não conta quem aprova ou faz merge). Multiplicado pela classe do personagem.
Exemplo com Guerreiro (+25%):
1 PR = 25 × 1.25 = 31.25 XP
Issues Resolvidas
Cada issue fechada. Multiplicado pela classe do personagem.
Exemplo com Mago (+30%):
1 issue = 35 × 1.3 = 45.5 XP
Sistema de Baseline (XP Inicial)
Como Funciona
- Primeira sincronização: Você recebe XP pelas atividades dos últimos 7 dias
- Histórico anterior: Tudo antes dos últimos 7 dias vira "baseline" (não gera XP)
- Syncs seguintes: Apenas atividades NOVAS após entrar na plataforma geram XP
- Exemplo: Se você tem 500 commits totais e 10 nos últimos 7 dias, recebe XP pelos 10 commits. Os 490 anteriores viram baseline
- Justo: Você começa com algum XP se foi ativo recentemente, mas não se beneficia de todo o histórico
Sincronização Automática
Auto-Sync
- Intervalo: A cada 10 minutos em background
- Silencioso: Não interrompe seu fluxo de trabalho
- Eficiente: Só sincroniza se houver novas atividades
- Cooldown: Previne spam de requisições ao GitHub
Funcionalidades Futuras
Em Desenvolvimento
- Code Reviews: XP por revisar PRs de outros devs
- Large Commits: Bônus extra para commits grandes (>100 linhas)
- Stars/Forks: Reconhecimento da comunidade nos seus repos
- Releases: XP por publicar versões de projetos
- Guilds: Sistema de grupos e competições entre times
- Achievements: Conquistas especiais e badges
Bônus de Streak (Em Desenvolvimento)
+10%
7 dias consecutivos
+25%
30 dias consecutivos
+50%
100 dias consecutivos
+100%
365 dias consecutivos
Sistema Anti-Exploit v2.0
Caps inteligentes por tipo de atividade previnem farming e mantém competição justa
Cap Geral Diário
500 XP
Reduzido de 1000 XP (-50%)
Commits
200 XP/dia
40% do cap total
Pull Requests
150 XP/dia
30% do cap total
Code Reviews
100 XP/dia
20% do cap total
Issues
100 XP/dia
20% do cap total
Stars/Forks
50 XP/dia
10% do cap total
Sistema Anti-Exploit
- Commit SHA único (anti-duplicação)
- PR número único (anti-duplicação)
- Multiplicadores não acumulam
- Caps por tipo de atividade
- Validação em sync e webhook
- Detecção de atividades duplicadas
Sistema de Multiplicadores v2.0
Mudança Importante:
A fórmula foi simplificada drasticamente. Agora é Level² × 15 ao invés de Level² × 100 + Level × 50. Isso permite alcançar Level 10 em apenas 15 dias de atividade consistente (~10 commits/dia ou 2 PRs/dia).
Exemplo: Commit externo com bônus de classe usa o MAIOR entre 1.5x (externo) ou 1.3x (classe), não 1.95x (1.5 × 1.3).
Ritmo de Progressão Esperado (v3.0 ACELERADO)
Progressão rápida baseada em ~100 XP/dia (~10 commits diários)
Usuário Casual
~50 XP/dia
Level 10 em ~30 dias
5 commits/dia
Usuário Ativo
~100 XP/dia
Level 10 em ~15 dias
10 commits/dia
Power User
~200 XP/dia
Level 20 em ~30 dias
20 commits/dia + PRs
Marcos de Progressão Acelerada:
- • Level 5: ~4 dias (375 XP) - Contribuidor ativo
- • Level 10: ~15 dias (1.500 XP) - Desenvolvedor experiente
- • Level 20: ~60 dias (6.000 XP) - Expert developer
- • Level 50: ~1 ano (37.500 XP) - Coding deity
As atividades do GitHub são sincronizadas automaticamente quando você acessa o leaderboard.
Cooldown de 5 minutos entre syncs. Sistema anti-duplicação e caps inteligentes ativos.