Construindo um portfólio que contrata (além do GitHub)

1. Por que o GitHub não basta mais? A nova régua do recrutamento técnico

O GitHub se tornou o currículo padrão da indústria de tecnologia. Porém, com a popularização da plataforma, surgiu um fenômeno conhecido como "poluição de repositórios": milhares de forks de projetos famosos, tutoriais copiados e CRUDs genéricos que não demonstram capacidade real de resolver problemas. Recrutadores e CTOs já não se impressionam com um repositório cheio de estrelas — eles buscam evidências de impacto.

O que realmente diferencia um candidato é a capacidade de demonstrar resultado. Um portfólio de código mostra que você sabe escrever linhas; um portfólio de impacto mostra que você sabe gerar valor. A diferença está na narrativa: não basta ter um sistema de autenticação funcional, é preciso mostrar que ele reduziu o tempo de login em 40% ou que suportou 10 mil requisições simultâneas.

2. Estruturando um portfólio orientado a problemas reais

O primeiro passo é documentar o problema de negócio antes de mostrar o código. Cada projeto do seu portfólio deve responder a três perguntas: qual era o contexto, qual abordagem foi usada e qual foi o resultado mensurável.

Exemplo de estrutura de README que vende sua solução:

# Sistema de Recomendação para E-commerce

## Problema
A taxa de abandono de carrinho era de 68% e o tempo médio de busca por produto era de 4,2 minutos.

## Abordagem
Implementei um sistema de recomendação baseado em filtragem colaborativa com Spark MLlib, processando 500 mil transações diárias em tempo real.

## Resultados
- Redução de 34% na taxa de abandono de carrinho
- Tempo médio de busca reduzido para 1,1 minuto
- Aumento de 22% no ticket médio

## Evidências técnicas
- Testes de carga: 99,8% de disponibilidade sob 2k req/s
- Logs estruturados no Elasticsearch para debugging
- Pipeline CI/CD com validação automática de precisão do modelo

Inclua sempre testes, logs e evidências de performance. Um repositório com cobertura de testes acima de 85% e um arquivo de logs de execução vale mais que dez repositórios sem nenhuma validação.

3. A linguagem do portfólio: storytelling técnico e comunicação visual

O README é sua página de vendas. Ele deve contar uma história, não apenas listar funcionalidades. Use diagramas para mostrar arquitetura, fluxos de dados e decisões técnicas. Ferramentas como Mermaid.js permitem criar diagramas diretamente no Markdown.

Exemplo de diagrama de arquitetura:

[Cliente] --> [API Gateway] --> [Serviço de Recomendação]
                                       |
                                       v
                              [Redis Cache] --> [Spark Cluster]
                                       |
                                       v
                              [PostgreSQL] --> [Elasticsearch]

Crie um "case study" por projeto seguindo o formato: problema → abordagem → resultado. Screenshots de dashboards, gráficos de performance e prints de logs de execução são evidências visuais que aumentam a credibilidade.

4. Além do código: evidências de colaboração e liderança técnica

Recrutadores querem saber como você trabalha em equipe. Pull requests bem documentados, com comentários que explicam decisões técnicas, são mais valiosos que commits solitários. Contribuições em projetos open source mostram que você sabe lidar com code reviews e padrões de comunidade.

Documente decisões técnicas usando ADRs (Architecture Decision Records). Um ADR simples:

# ADR-001: Escolha do banco de dados

## Contexto
Precisávamos de um banco que suportasse consultas geoespaciais com baixa latência.

## Decisão
Optamos pelo PostgreSQL com extensão PostGIS.

## Consequências
- Aumento de 15% na complexidade de deployment
- Redução de 60% no tempo de consulta geoespacial
- Facilidade de migração futura para TimescaleDB

Demonstrar mentoria — como revisões de código que você fez ou tutoriais que escreveu para o time — é um diferencial enorme. Crie uma seção no portfólio chamada "Contribuições e Liderança" com links para PRs revisados e documentos de arquitetura que você liderou.

5. Portfólio vivo: integração com outras plataformas e formatos

Seu portfólio não deve se limitar ao GitHub. Publique artigos técnicos no Medium ou Dev.to explicando as soluções que você implementou. Um artigo que detalha como você reduziu a latência de um sistema em 40% é mais impactante que um README seco.

No LinkedIn, estruture seus projetos com resultados mensuráveis. Exemplo de descrição:

Liderei a migração de um monolito para microsserviços, resultando em:
- Redução de 70% no tempo de deployment
- Aumento de 300% na frequência de releases
- Economia de $12k/mês em custos de infraestrutura

Crie vídeos de demonstração (2-3 minutos) mostrando o sistema funcionando em cenário real. Ferramentas como OBS Studio ou Loom permitem gravar a tela enquanto você explica a arquitetura. Isso prova que o sistema não é apenas código bonito, mas algo que realmente funciona.

6. Métricas que importam: como quantificar seu impacto no portfólio

Números são a linguagem universal dos recrutadores técnicos. Sempre que possível, quantifique seu impacto:

- Redução de latência: de 450ms para 120ms (73% de melhoria)
- Cobertura de testes: de 23% para 91%
- Custo de infraestrutura: redução de $8.500/mês
- Throughput: de 500 req/s para 4.200 req/s

Para projetos de código aberto ou pessoais, crie dashboards com dados reais. Use ferramentas como Grafana ou Google Data Studio para mostrar métricas de performance. Se você trabalhou em projetos confidenciais, use dados anonimizados ou crie um projeto similar com dados sintéticos que demonstrem as mesmas habilidades.

Exemplo de dashboard fictício:

[Gráfico de Latência]
P95 antes: 450ms
P95 depois: 120ms
Redução: 73%

[Gráfico de Cobertura de Testes]
Antes: 23%
Depois: 91%
Aumento: 295%

7. Curadoria e evolução: mantendo o portfólio relevante ao longo da carreira

Um portfólio parado no tempo é um sinal de alerta para recrutadores. Revise seus projetos a cada trimestre: remova tutoriais antigos, destaque os projetos mais recentes e atualize as tecnologias usadas. Se você aprendeu uma nova stack, crie um projeto que a utilize e substitua um mais antigo.

Para transições de carreira rápidas, adote a estratégia do "portfólio mínimo viável": escolha 3 projetos que demonstrem exatamente as habilidades exigidas pela vaga desejada. Se você está migrando de backend para dados, foque em projetos com pipelines de ETL, modelagem e visualização.

Mantenha um arquivo CHANGELOG no seu portfólio mostrando como ele evoluiu:

## 2024-Q1
- Adicionado projeto de streaming com Kafka e Flink
- Removido projeto de CRUD genérico (substituído por API com GraphQL)
- Atualizado README do sistema de recomendação com novos benchmarks

Referências