ArquiteturaDemonstração
Diário de desenvolvimento: migrando uma API PHP legada para NestJS
Registro de decisões, atritos e aprendizados durante a migração incremental de uma API PHP legada para NestJS, sem parar o sistema em produção.
Devnático1 min de leitura
Conteúdo de demonstração. Este é um exemplo do formato “diário de desenvolvimento”, ligado ao projeto de laboratório correspondente, e será substituído por um registro real.
Por que migrar em vez de reescrever do zero
A API PHP legada ainda processa pagamentos em produção. Parar tudo para reescrever do zero era um risco alto demais. A estratégia escolhida foi migração incremental: rotas novas nascem em NestJS, rotas antigas continuam em PHP até serem substituídas uma a uma.
O que já funcionou
- Um proxy simples decide, por rota, se a requisição vai para o PHP antigo ou para a API NestJS nova.
- As rotas migradas ganharam testes automatizados que o sistema antigo nunca teve.
O que ainda é incerto
- Como migrar as rotinas de job/cron do PHP sem duplicar execução durante a transição.
- Se vale manter um pacote de tipos compartilhado entre o “novo” backend e o frontend, ou se isso é otimização prematura neste estágio.
Esse artigo será atualizado conforme a migração avança no Devnático Lab.