CASE DE EVIDÊNCIA
Hardening de um provider de tradução após um incidente em produção
Um incidente real do portfólio virou uma correção guiada por regressão que protege a fronteira do Groq contra um override de modelo aposentado sem remover configurações explícitas suportadas.
01
Problema
Um erro em produção mostrou um modelo aposentado do Groq chegando à fronteira de tradução por meio de um override antigo de ambiente. Corrigir o caminho comprovado sem desabilitar overrides legítimos nem alterar o site no ar antes da verificação.
02
Métodos aplicados
- 01Seleção de Métodos de TrabalhoEvita excesso e sobreposição de skills, preservando ownership claro entre descoberta, implementação, verificação, revisão e entrega.
- 02Construção de Testes de RegressãoTorna correções de bugs duráveis e prova que o novo teste realmente detecta o defeito em vez de apenas passar junto com a correção.
- 03Teste de Limites de IntegraçãoEncontra defeitos de serialização, persistência, protocolo e modos de falha que mocks e testes unitários isolados não conseguem provar.
- 04Entrega de Mudanças com GitHub e VercelConduz mudanças do repositório à revisão e à entrega sem misturar trabalhos alheios, duplicar pull requests ou exagerar a prontidão do deploy.
Registro de decisões
- 01
Rotear por ownership
Usar seleção de métodos para manter teste de regressão, verificação da fronteira de integração e entrega como responsabilidades distintas, sem empilhar workflows sobrepostos.
- 02
Reproduzir antes de corrigir
Capturar o modelo realmente enviado ao provider em um teste de fronteira e exigir a falha do override aposentado conhecido antes da implementação.
- 03
Proteger apenas o valor legado comprovado
Mapear o modelo aposentado exato para o default suportado, preservando outros overrides explícitos de modelo.
- 04
Manter produção isolada
Integrar e verificar primeiro na branch de desenvolvimento. Nenhuma promoção para produção é afirmada, e a ausência do deployment de desenvolvimento na Vercel permanece documentada como limitação.
03
Verificação
Trate este relatório como evidência dos métodos e da verificação mostrados aqui. A sobreposição com um pack, sozinha, não prova que o pack foi usado ou validado por completo.
04
Resultado
- 01
161/161 testes passaram no commit integrado à branch de desenvolvimento.
- 02
Lint dos arquivos alterados e typecheck de CI passaram após o merge.
- 03
O override aposentado agora resolve para openai/gpt-oss-20b enquanto outros overrides explícitos continuam configuráveis.
- 04
Nenhum Preview da Vercel foi emitido para o merge em desenvolvimento; portanto, este case não afirma verificação de runtime em produção.