Isaque Victor cursos gratuitosNesta aula
Portfólio é prova, não promessa.
Aqui você pega os projetos do curso e os transforma em provas. Uma prova é algo que uma pessoa cética consegue verificar em dez minutos.
- Montar um repositório que explica como rodar e como medir
- Mostrar resultados com número de exemplos e linha de base
- Contar um projeto em cinco minutos
O que a prova precisa ter
Quem avalia faz uma pergunta para cada item: o que eu consigo verificar aqui? Pense num comprador que pede a nota fiscal de cada afirmação.
- "Precisão de 94 por cento". Só vale com o script que calcula o número e o conjunto de teste guardado no repositório.
- "Zero incidentes de viés". Zero sem medição quer dizer que ninguém procurou. Vale um relatório com os grupos analisados.
- "Milhares de reais gerados". Projeto pessoal não tem esse valor medido. O único número financeiro honesto é o custo real por requisição.
A regra é simples: todo número do portfólio tem um script que o reproduz. O que não tem, sai.
Repositório que roda em dez minutos
O teste é físico: uma pessoa que nunca viu o projeto clona, segue o README, instala e roda os testes, com o relógio na mão. O README responde, nesta ordem: o que o projeto faz, por que existe, como rodar, como medir e o que não faz.
| Arquivo | Para que serve |
|---|---|
| README.md | A página de apresentação |
| requirements.txt com hashes | Lista exata das bibliotecas, com uma impressão digital de cada uma |
| LICENSE | Diz o que os outros podem fazer. Sem ele, ninguém pode copiar |
| .gitignore | Lista o que fica de fora, como o arquivo de chaves |
Coisa de profissional
O GitHub já ajuda, mas não perdoa tudo. A proteção de push, que impede o envio de segredos a repositórios públicos, vem ligada por padrão para o usuário. Só que ela não resolve o que já entrou: a documentação do GitHub diz que, se o dado é um segredo, é preciso revogá-lo ou trocá-lo, e que depois disso ele não dá mais acesso. Reescrever o histórico tem risco alto de contaminação, porque você não consegue limpar os clones dos outros, e um clone antigo pode trazer o valor de volta. Quem faz portfólio sério troca a chave primeiro e limpa depois.
Resultado honesto
Um acerto medido em poucos e-mails é uma estimativa. O intervalo de confiança é a faixa em que o valor real provavelmente está, e o bootstrap a calcula: o computador sorteia os exemplos de novo, com reposição, milhares de vezes, como tirar bolinhas de uma urna e devolvê-las. A variação dos resultados vira a faixa.
A linha de base é o resultado de um método simples, que serve de régua. Se sempre escolher a categoria mais comum já acertasse quase tudo, o modelo valeria pouco. E uma versão nova com nota ligeiramente maior, dentro da faixa, é indistinguível da anterior.
Teste automático que prova
Afirmar que o projeto tem testes não convence ninguém. O CI, integração contínua, é um robô que roda os testes a cada mudança, como um inspetor que confere cada peça da linha. Ele usa respostas gravadas, sem a sua chave e sem internet, e um dos testes exige que o acerto nunca caia abaixo do limite aceito.
Quem avalia costuma abrir o histórico antes do código. Na mensagem de cada commit, o assunto é curto e o corpo explica o porquê.
O texto e a entrevista
Um texto curto sobre cada projeto vale mais que qualquer medalha. A ordem que quem avalia espera:
- O problema, e quem sofria com ele.
- A decisão, e a alternativa descartada, com o motivo.
- A medição: métrica, número de exemplos, linha de base.
- O que falhou e o que você fez a respeito.
- O que faria em seguida.
O que falhou é a parte que revisores experientes leem primeiro: ninguém consegue fingi-la. Treine a mesma história em voz alta, em cinco minutos, com relógio.
Para falar de mercado, meça: abra vinte vagas reais da área que você quer, anote os requisitos numa planilha e conte. O resultado descreve essas vinte vagas, e não o mercado inteiro, mas basta para decidir o que vai no topo do portfólio.
Cuidado
Nunca publique chave de API, dado real de cliente nem prompts internos num portfólio. Use dados fictícios e uma chave de demonstração separada, com teto diário de gasto.
Prática · 5 min
- Escreva um README curto para um dos seus projetos: o que é, por que existe, como rodar e como medir.
- Para cada número do README, pergunte onde está o script que o calcula. Tire o que não tiver resposta.
- Peça a alguém que nunca viu o projeto para seguir o README, cronometrado. Corrija onde ela travou.
Resumo
- Todo número do portfólio tem um script que o reproduz.
- O repositório precisa rodar em dez minutos para quem nunca o viu.
- Segredo vazado: troque a chave primeiro.
- Conte o que falhou. É a parte que mais convence.
Fontes
Lidas em 30 de outubro de 2026.
- GitHub. About push protection: proteção ligada por padrão para usuários.
- GitHub. Removing sensitive data from a repository: revogar primeiro.
- SciPy. scipy.stats.bootstrap: intervalo de confiança por bootstrap.
Quiz da aula
Três situações para aplicar o que viu.