Quando um fornecedor ou um desenvolvedor entrega uma parte do sistema, alguém precisa aceitar a entrega. Aceitar sem conferir empurra o problema para a próxima versão.
Antes de aceitar, confira os 11 itens abaixo. Confira cada item pelo que as partes combinaram no início: o contrato e os padrões da empresa ou do projeto.
1. Documentação
Confira se a documentação veio e está atualizada: diagramas, especificações, documentação de API e o que mais ajude a entender e manter o código.
2. Evidência de teste
A entrega deve trazer evidência de que quem desenvolveu testou: relatório de testes, capturas de tela ou vídeos. Os testes precisam cobrir o uso normal, os limites e as exceções.
3. Definição de pronto
A definição de pronto é a lista de critérios que uma entrega precisa cumprir para ser considerada pronta. Verifique se a entrega cumpre todos os critérios da lista combinada.
4. Senhas e dados sensíveis
O código não pode conter senha, chave de API ou outro dado sensível escrito nele. Esses valores ficam fora do código, em local protegido.
5. Padrões de codificação
O código precisa seguir os padrões combinados de nomes, estrutura e organização.
6. Leitura rápida do código
Uma leitura rápida já revela problemas óbvios: blocos comentados esquecidos, trechos fora do lugar e arquivos que não deveriam estar ali.
7. Revisão de código
Se possível, revise o código junto com quem entregou. A conversa esclarece dúvidas e alinha o entendimento das duas partes.
8. Dependências
Verifique se as bibliotecas e os frameworks estão documentados, atualizados e vêm de fontes confiáveis.
9. Desempenho
Confira se houve teste de desempenho e se o resultado atende ao requisito combinado.
10. Segurança
O código não pode ter falha de segurança conhecida, como a injeção de SQL. As bibliotecas usadas também não podem ter vulnerabilidade já divulgada.
11. Rastreabilidade
Cada requisito precisa levar ao código e ao teste correspondentes. Só assim você confirma que a entrega atendeu a todos os requisitos.
Quando parte do código foi escrita com IA
Hoje, parte do código entregue pode ter sido escrita com assistente de IA. Os 11 itens continuam valendo, e alguns pesam mais.
O assistente pode sugerir uma dependência que não existe ou que está desatualizada. Ele também pode repetir um padrão inseguro. Por isso, dependências, segurança e revisão de código merecem atenção redobrada.
Combine por escrito com o fornecedor ou o desenvolvedor se o uso de IA é permitido e como ele revisa o código gerado antes da entrega.
Para ver como a CTGF conduz esse tipo de projeto, veja a página Consultoria.