Como entregar uma aplicação para outra equipe sem depender do desenvolvedor
Publicado em 2026-11-14 por frfrand
Checklist de repositórios, documentação, segredos, infraestrutura, CI/CD, acesso e testes para uma transferência de software.
# Como entregar uma aplicação a outra equipe sem depender do desenvolvedor
Um projeto não está completamente entregue se o cliente tiver uma URL funcionando, mas não conseguir recuperar o código, alterar credenciais ou reconstruir o deploy. A transferência deve demonstrar que uma equipe diferente pode operar e manter o sistema sem depender da memória do autor.
1. Propriedade e repositórios
Entregue acesso apropriado ao repositório Git sob uma organização controlada pelo proprietário. Identifique o branch de produção, versão/tag entregue, licenças e dependências. Inclua instruções de git clone, instalação, execução de testes e build. Confirme que o histórico não contenha segredos; se houver vazamentos, rotacione credenciais, não basta excluir o último commit.
2. Documentação mínima
| Documento | Conteúdo | | --- | --- | | README | Objetivo, inicialização local, comandos, testes | | Arquitetura | Serviços, API, DB, filas e dependências | | Infraestrutura | Domínios, DNS, VPS, proxy e armazenamento | | Runbook | Deploy, reinicialização, verificações de integridade, rollback | | Dados | Esquemas, migrações, backups e restauração | | Operação | Incidentes conhecidos, alertas e contatos |
Documente decisões difíceis e limitações conhecidas; não transforme o README em um manual enorme impossível de atualizar.
3. Acessos sem compartilhar senhas
Use funções por pessoa e credenciais individuais no GitHub, hospedagem, DNS, banco de dados, provedor de e-mail e serviços de terceiros. Um gerenciador de segredos facilita transferências; não entregue um arquivo .env real por e-mail ou chat. Aplique o princípio do mínimo privilégio, rotacione credenciais após a transição e revogue tokens da equipe saiente assim que a nova tiver controle verificado.
4. Transferência de dados e implantação
Prepare um backup recuperável e um procedimento testado de restauração. Documente como implantar uma nova versão a partir do Git, executar migrações, verificar integridade, consultar logs e retornar a uma versão compatível. Se o sistema processar pagamentos ou dados pessoais, defina uma janela de transição e tarefas de supervisão. Evite transferir dados desnecessários ou sensíveis sem autorização.
5. Prova de independência
A nova equipe deve ser capaz, por conta própria: 1. Clonar, instalar dependências e executar testes. 2. Implantar uma correção pequena em staging. 3. Localizar logs e métricas de um incidente simulado. 4. Restaurar uma cópia em infraestrutura de teste.
Registre evidências de cada etapa e anote bloqueios. A entrega é aceita quando essas provas são superadas e o proprietário confirma o recebimento dos recursos essenciais.
6. Transição e encerramento
Defina período de suporte, responsabilidades e procedimentos para perguntas posteriores. Transfira contas de faturamento e titularidade de domínios quando aplicável. Entregue inventário final de componentes, licenças, custos recorrentes, riscos pendentes e documentação. Desative acessos antigos somente após verificar que a operação não depende deles.
Relacionados: o que é CI/CD e migrações de banco de dados.
Perguntas frequentes
Basta entregar um ZIP? Não. É obrigatório entregar segredos em texto simples? Não, são transferidos controles de acesso seguros. Como verifico a entrega? Com um teste operativo executado pela nova equipe.