Portfólio auditável: provas reproduzíveis em vez de promessas
Objetivos desta aula
- Construir uma matriz de competências e evidências
- Separar resultados medidos de estimativas
- Criar uma validação reproduzível do projeto
- Preparar demonstração curta com plano alternativo
- Publicar evidências sem expor dados privados
Você já organizou currículo e README; agora precisa demonstrar reprodutibilidade. Um portfólio forte permite a outra pessoa verificar uma afirmação sem depender da sua apresentação. Para cada competência, conecte afirmação → artefato → procedimento de validação → limitação.
Escolha três provas relevantes em vez de multiplicar repositórios. No CloudShop, use uma implantação automatizada, uma recuperação de falha e uma otimização medida. Cada prova deve apontar para um commit ou uma execução específica, e não apenas para um badge passing que muda com o tempo.
Uma comparação exige condições explícitas: versão, tamanho da amostra, máquina, carga e intervalo. Se o build passou de 12 para 5 minutos, informe se o cache estava frio ou quente em cada teste. Registre também a dispersão; n=1 é uma observação, não uma garantia de desempenho.
Separe laboratório e produção sem diminuir a prática. Diga que o projeto usa dados sintéticos e uma carga de 20 req/s, se isso for verdade. Operar um exercício bem documentado demonstra raciocínio; apresentá-lo como operação comercial real compromete sua credibilidade.
A demonstração local deve ter pré-requisitos e uma saída esperada. O script pressupõe um arquivo Compose já existente, aguarda o healthcheck e consulta /health. Adapte o endpoint ao contrato da sua API e documente consumo de memória e portas antes de pedir que alguém execute.
Prepare uma narrativa de cinco minutos: problema, decisão, prova, resultado e limite. Mostre uma execução e uma evidência de recuperação, não todas as telas. Tenha uma gravação curta e resultados sanitizados como plano alternativo se a rede falhar durante a entrevista.
A curadoria pública é uma atividade de segurança. Faça revisão do histórico, capturas e artefatos; um terminal gravado pode revelar tokens ou nomes internos. O arquivo .env.example precisa conter placeholders, nunca credenciais funcionais, mesmo que sejam de laboratório.
Conclua pedindo uma avaliação externa: outra pessoa consegue rodar o projeto com as instruções e explicar o trade-off sem sua ajuda? Registre dificuldades como issues, corrija as mais importantes e marque a versão demonstrada com uma referência como portfolio-v1. Essa validação vale mais que ampliar a lista de ferramentas.
Na prática
Smoke test reproduzível do ambiente local
bash
#!/usr/bin/env bash
set -euo pipefail
# Pré-requisitos: Docker Compose v2, compose.yaml com healthcheck e API em 8080.
# Execute apenas em ambiente local de estudo; remove containers ao terminar.
trap 'docker compose down' EXIT
docker compose up -d --build --wait --wait-timeout 120
# -f faz o teste falhar em respostas HTTP de erro.
curl --fail --silent --show-error --max-time 10 http://localhost:8080/health
printf '\nSmoke test concluído.\n'
# O healthcheck não substitui um teste completo de criação de pedido.Índice de evidências do portfólio
yaml
# Metadados do laboratório: preencha resultados somente após medir.
projeto: CloudShop
contexto: "Laboratório com dados sintéticos, não operação comercial"
evidencias:
- competencia: "Recuperação de falhas"
artefato: "docs/game-day.md"
reproducao: "Seguir cenário autorizado e registrar tempos em UTC"
criterio: "Checkout validado após mitigação"
limite: "Resultado válido para a carga e infraestrutura descritas"
- competencia: "Entrega automatizada"
artefato: ".github/workflows/ci.yml"
reproducao: "Consultar execução vinculada ao commit demonstrado"
criterio: "Build e testes aprovados sem credenciais no log"Por que isso importa
Evidências reproduzíveis permitem avaliar competência aplicada, mesmo quando sua experiência é de laboratório.
Erro comum
Copiar números de exemplos para o currículo sem executar a medição correspondente.
Dica de produção
Mantenha uma versão de demonstração estável e valide as instruções em ambiente limpo antes de cada apresentação.
Alerta de segurança
Nunca publique ativos ou incidentes do empregador sem autorização; remova dados pessoais e revogue qualquer credencial exposta.
Pergunta de entrevista
Como outra pessoa verificaria um resultado que você apresenta no portfólio e quais são os limites dessa medição?
Glossário
- Reprodutibilidade
- Possibilidade de repetir um procedimento sob condições documentadas.
- Artefato
- Arquivo ou resultado concreto que sustenta uma afirmação.
- Linha de base
- Medição inicial usada como referência de comparação.
- Smoke test
- Verificação curta de funcionamento essencial.
- Curadoria
- Seleção e revisão de evidências relevantes para um público.
Conexão com o CloudShop
Publicar uma versão auditável do CloudShop com matriz de evidências, smoke test local e demonstração curta sanitizada.
Quiz da aula
1. Qual evidência sustenta melhor uma melhoria de build?
2. Como descrever uma recuperação feita em laboratório?
3. Qual o objetivo principal do smoke test?
Minhas anotações
Salvo automaticamente neste navegador.