# Portfolio para Desenvolvedor: Como Montar Projetos que Impressionam Recrutadores Internacionais A maioria dos desenvolvedores brasileiros que buscam vagas internacionais tem o mesmo problema no portfolio: varios repositorios de projetos de curso, alguns CRUDs e talvez um clone de app famoso. Isso nao e o que vai chamar atencao de um recrutador da Stripe, Shopify ou de uma startup europeia. ## O que Recrutadores Realmente Olham no GitHub Recrutadores nao tem tempo para ler todo o seu codigo. Eles fazem uma avaliacao rapida de sinais. **Primeiro olhar (30 segundos)**: - Quantos repos tem README completo? - Os repos tem estrelas ou contribuicoes de outros? - Ha atividade recente? - O perfil tem foto, bio e link para site/LinkedIn? **Segundo olhar (2-3 minutos em um projeto especifico)**: - O README explica o problema resolvido, nao apenas a stack usada - Ha instrucoes claras para rodar o projeto localmente - Existe algum tipo de teste? - O historico de commits conta uma historia? **Terceiro olhar (voce ja se destacou)**: - Qualidade das decisoes de arquitetura - Como erros e edge cases sao tratados - Presenca de CI/CD, linting, formatacao automatizada ## Projetos que Demonstram Pensamento Senior CRUDs demonstram que voce conhece as ferramentas — nao que voce sabe resolver problemas reais. Projetos que impressionam tem: **Problema real resolvido**: um CLI que automatiza uma tarefa, um scraper que coleta dados para uma analise especifica. **Decisoes explicadas**: por que PostgreSQL em vez de MongoDB? Documentar essas decisoes no README ou em ADRs e o que separa um portfolio de um exercicio academico. **Consciencia de escala**: indexes no banco, paginacao na API, tratamento de erros com retry logic. **Escopo bem definido**: um projeto que faz uma coisa muito bem e mais impressionante do que um projeto que tenta fazer tudo pela metade. ### Ideias de Projetos que Funcionam - API com autenticacao completa: JWT, refresh tokens, rate limiting, documentacao OpenAPI - Crawler ou integrador de APIs com tratamento de erros e logging estruturado - CLI tool para alguma tarefa de desenvolvimento - Sistema de filas simples demonstrando processamento assincrono ## README: Seu Cartao de Visitas Tecnico **Estrutura que funciona**: 1. Uma linha que explica o que e (sem jargao) 2. Screenshot ou GIF se for visual 3. Prerequisitos e instalacao com comandos copiavel-e-executaveis 4. Como usar com exemplo real 5. Decisoes tecnicas principais 6. Status do projeto Escreva o README em ingles. Sempre. ## Testes: O Sinal de Maturidade que Mais Importa Voce nao precisa de 100% de cobertura. Mas ter zero testes e um sinal claro para recrutadores experientes. O que funciona bem: testes unitarios para logica critica, pelo menos 1 teste de integracao para o fluxo principal, e um arquivo de teste bem estruturado. Escrever "testes nao implementados por ora" no README e melhor do que nao mencionar — mostra consciencia. ## CI/CD: Automatizacao que Impressiona Um pipeline basico no GitHub Actions custa zero e leva 30 minutos para configurar: ```yaml name: CI on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: '20' - run: npm ci - run: npm test - run: npm run lint ``` Esse arquivo comunica: "eu me importo com qualidade, eu automatizo o que pode ser automatizado". ## Contribuicoes Open Source Nenhum projeto pessoal comunica o mesmo que uma contribuicao aceita em um projeto real. Voce nao precisa resolver um bug complexo: - Corrigir um typo na documentacao - Melhorar um exemplo de codigo em um README - Adicionar um teste para um caso nao coberto - Abrir uma issue bem documentada com steps to reproduce O processo de interagir com mantenedores reais — comunicar o problema, responder ao code review, iterar — e exatamente o fluxo que empresas internacionais esperam que voce ja conheca. ## Posicionando Seu Portfolio O **VagaNaGringa.dev** e uma referencia para desenvolvedores brasileiros que querem entender como posicionar portfolio, experiencia e habilidades especificamente para o mercado internacional. ## Conclusao Um portfolio forte nao e sobre quantidade de projetos — e sobre qualidade de sinais. README claro, testes presentes, CI configurado, commits coerentes e pelo menos um projeto que resolve um problema real: isso e suficiente para se destacar. Um repositorio excelente supera dez mediocres toda vez.