Executando uma migração de ponta a ponta

Buildprint Migration é um recurso avançado que permite tanto a geração automática de código quanto o uso de agentes de IA para migrar seu aplicativo Bubble para código de forma eficaz, confiável e segura.

Este guia explica em detalhes como executar esse processo na prática após receber acesso ao recurso de migração.

Preparação

Há algumas coisas que você pode fazer no seu aplicativo Bubble para garantir que a migração seja o mais simples possível antes de começar:

• tornar não públicos os fluxos de trabalho de backend que não precisam ser públicos

• excluir páginas/elementos reutilizáveis/recursos não utilizados

• excluir tipos de dados, campos e conjuntos/valores de opções não utilizados

Essencialmente, elimine o excesso e torne seu aplicativo o mais simples possível.

Crie as contas da stack tecnológica do seu projeto

Crie contas para os serviços que sua migração usará. Nós teremos recomendado a opção certa para você, mas é possível escolher qualquer uma das opções compatíveis com Buildprint. Elas podem incluir:

• Vercel

• Github

• Supabase

• Trigger.dev

• Convex

Peça ao Buildprint para criar uma migração para seu projeto

Toda a execução da migração acontece por meio da CLI do Buildprint. Ela pode ser monitorada usando o painel no Buildprint Web (ou perguntando ao seu agente).

É altamente recomendável usar o modelo SOTA mais recente para conduzir a migração. No momento, isso seria o Claude Fable 5.1. Ele pode custar mais (seja em assinaturas do Claude ou na cobrança da API), mas proporcionará os melhores resultados.

Peça ao seu agente para criar uma migração para seu projeto. A migração aparecerá no painel do Buildprint, dentro do seu projeto.

Concluir a configuração

Seu agente poderá concluir a configuração. A qualquer momento, ele poderá fazer perguntas (por exemplo, qual stack tecnológica escolher). Você também pode pedir a opinião dele nesse momento.

Ele garantirá que tudo esteja pronto para uma migração completa.

Executar a migração

Uma migração é dividida em uma série de tarefas menores. Essas tarefas são geradas pelo Buildprint. Em termos gerais, uma migração segue este processo:

1. Concluir a configuração

2. O Buildprint executa a geração automática de tarefas e a geração de código

3. Um agente coordenador distribui as tarefas aos agentes de implementação, em paralelo sempre que possível

4. O mesmo agente coordenador distribui as revisões a diferentes agentes, para que eles possam revisar o trabalho uns dos outros

5. Quando tudo estiver concluído, a CLI poderá fazer um backup de dados + arquivos do seu aplicativo Bubble e fazer o upsert desses dados no novo banco de dados, além de gerenciar implantações de ponta a ponta.

Para iniciar o agente coordenador, peça a ele que leia o documento 'orchestrator agent orientation for the migration feature'. Recomendamos evitar o uso de loops/objetivos (qualquer que seja o recurso disponível no ambiente do seu agente), pois isso frequentemente solicitará informações ao agente mesmo enquanto os subagentes estiverem trabalhando.