CommitWorth

1. Descrição Geral
2. Funcionamento
3. Métricas do Dashboard
4. Análise de Stack & Senioridade
5. Distintivos de Conquista
6. Geração de Card Personalizado
7. Contribuição

O CommitWorth é uma plataforma gamificada que calcula o "valor agregado" do trabalho de desenvolvedores utilizando dados públicos do GitHub. Basta informar um username válido para acessar um dashboard exclusivo com diversas métricas, análise de stack tecnológica, detecção de senioridade e conquistas.

✨ Principais Funcionalidades:

• 📊 Análise completa de repositórios e atividade no GitHub

• 🎯 Detecção automática da stack principal do desenvolvedor

• 🏆 Classificação de senioridade em 4 níveis (Junior → Tech Lead)

• 💰 Cálculo de valor agregado baseado em contribuições

• 🏅 Sistema de achievements com distintivos exclusivos

• 🖼️ Geração de cards personalizados para compartilhamento

• Entrada: Username do GitHub.

• Redirecionamento:

  • Username válido: /dashboard/<usernick>
  • Username inválido/inexistente: Página not-found com formulário para correção.

1. O usuário informa seu username do GitHub.
2. O sistema coleta dados públicos via API do GitHub.
3. As métricas são processadas e a análise de stack é realizada:
   • Identificação da linguagem/stack principal
   • Cálculo do score de senioridade
   • Análise de indicadores de complexidade
   • Determinação do nível de experiência
4. Os dados são exibidos no dashboard com métricas, gráficos e análises.
5. O usuário pode gerar um card personalizado com suas conquistas e stack.
6. Caso o username não exista, o usuário pode corrigir e tentar novamente.

O dashboard apresenta as seguintes métricas:

• Total de Estrelas: Soma das estrelas em todos os repositórios públicos.
• Total de Repositórios: Quantidade de repositórios públicos.
• Total de Commits: Total de commits somados de todos os repositórios.
• Valor Agregado: Valor fictício calculado com base na atividade no GitHub.

• Linguagens mais utilizadas: Linguagens predominantes nos repositórios.
• Pontos do usuário: Calculados conforme critérios abaixo:

• Repositórios bem estruturados: Repositórios que possuem descrição, página inicial e issues habilitadas.
• Total de Forks: Soma dos forks dos repositórios públicos.

O CommitWorth possui um sistema inteligente de análise que determina automaticamente a stack principal do desenvolvedor e seu nível de senioridade baseado em múltiplos fatores.

O sistema analisa todos os repositórios públicos e identifica a linguagem mais utilizada, mapeando-a para categorias de stack:

O sistema classifica desenvolvedores em 4 níveis baseado em um score de 0-100:

• Menos de 3 anos de experiência
• Poucos projetos ou sem indicadores de complexidade
• Foco em aprendizado e projetos pessoais

• 3-5 anos de experiência
• Projetos com alguma complexidade
• Início de contribuições colaborativas

• 5-8 anos de experiência
• Projetos complexos e bem documentados
• Colaboração ativa e projetos populares

• 8+ anos de experiência
• Múltiplos projetos complexos e populares
• Liderança técnica evidente pelos projetos

O score é calculado através de uma fórmula ponderada considerando:

O sistema identifica automaticamente:

• Projetos Complexos: Repositórios com 10+ estrelas ou 5+ colaboradores
• Projetos Colaborativos: Repositórios com múltiplos contributors
• Projetos Bem Documentados: Repos com descrição detalhada, homepage e issues habilitadas

No dashboard, você visualiza:

• Stack Principal: Categoria dominante baseada na linguagem mais usada
• Nível de Senioridade: Classificação com score detalhado
• Tempo de Experiência: Faixa de experiência calculada
• Top 3 Linguagens: Ranking com anos de experiência em cada uma
• Linguagens Dominadas: Total de linguagens utilizadas

Os distintivos são desbloqueados conforme critérios específicos:

• Code Warrior: Mais de 1.000 commits.
• Império do Código: Mais de 50 repositórios.
• Arquiteto do GitHub: 10 ou mais linguagens diferentes utilizadas.
• Estrela do GitHub: Mais de 100 estrelas.
• Projeto de Ouro: Possuir ao menos 1 repositório com mais de 500 estrelas.
• Veterano do Código: Conta com mais de 10 anos de GitHub.
• GitHub Old School: Conta com mais de 5 anos de existência.

• Especialista de Stack: Score de senioridade 70+ na stack principal.
• Líder Técnico: Atingir o nível Tech Lead de senioridade.
• Desenvolvedor Sênior: Alcançar o nível Sênior ou superior.
• Poliglota: Dominar 15 ou mais linguagens de programação.

Na parte inferior do dashboard, há um botão para gerar uma imagem personalizada contendo:

• Nome do usuário
• Username
• Foto do GitHub
• Valor agregado
• Total de commits
• Total de pontos
• Distintivos conquistados
• Stack principal
• Nível de senioridade com score
• Tempo de experiência
• Número de linguagens dominadas

Funcionalidades:

• Download automático da imagem.
• Compartilhamento direto no LinkedIn via modal com botão.
• Novo: Informações de stack e senioridade para destacar expertise técnica.

Para testar o projeto localmente:

1. Clone o repositório:

   git clone https://github.com/leticiaviana/CommitWorth.git
   cd CommitWorth

2. Instale as dependências:

   npm install

3. Configure o token do GitHub:

   • Crie um arquivo .env.local
   • Adicione: GITHUB_TOKEN_FOR_REQUESTS=seu_token_aqui
   • Obtenha seu token em: https://github.com/settings/tokens

4. Execute o projeto:

   npm run dev

5. Acesse: http://localhost:3000

• Frontend: Next.js 15 + React 19 + TypeScript
• Styling: TailwindCSS 4 + CSS personalizado
• API: GraphQL + GitHub API
• Gráficos: Recharts
• UI Components: Radix UI + Lucide React
• 3D Effects: OGL
• Geração de Imagens: html-to-image

Qualquer desenvolvedor pode contribuir com o projeto. Para isso:

1. Faça um fork do repositório.
2. Crie uma branch para sua feature ou correção.
3. Envie um pull request detalhando sua proposta.

Sugestões de melhoria, correções e novas métricas são bem-vindas!

Este projeto está sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.