Checkpoints e Rollbacks

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Com o Replit, você nunca precisa se preocupar em perder seu trabalho. O sistema de checkpoint e rollback do Replit fornece controle de versão abrangente e gerenciamento de estado para todo o seu ambiente de desenvolvimento. Quando você usa o Replit Agent, os checkpoints capturam automaticamente o estado completo do seu projeto. Isso inclui não apenas as alterações de código, mas também os arquivos do projeto, o contexto da conversa com a IA e os bancos de dados conectados.

​

O que são checkpoints?

Um checkpoint é um snapshot completo do estado do seu Replit App criado automaticamente pelo Agent em marcos chave do desenvolvimento. Diferente do controle de versão tradicional que rastreia apenas alterações de código, os checkpoints do Replit capturam todo o seu contexto de desenvolvimento. Pense nos checkpoints como pontos de salvamento em um videogame — você sempre pode voltar a uma versão funcional do seu app.

​

Captura de estado completo

Cada checkpoint preserva:

• Arquivos do projeto: Todos os arquivos, diretórios, pacotes instalados e configuração do projeto
• Contexto da conversa com a IA: O histórico completo da conversa e o contexto que levou ao estado atual
• Configuração do ambiente: Configurações de runtime e configurações de publicação
• Memória do Agent: O entendimento da IA sobre a arquitetura do seu projeto, preferências e padrões
• Conteúdo do banco de dados: Os dados e o esquema do seu banco de dados no momento da criação do checkpoint

Essa abordagem abrangente significa que você pode experimentar com confiança, sabendo que pode restaurar não apenas seu código, mas todo o seu contexto de desenvolvimento.

​

Como funcionam os rollbacks

A funcionalidade de rollback permite restaurar seu Replit App a qualquer estado de checkpoint anterior com um único clique. Isso é muito mais poderoso do que as operações tradicionais de git revert. Os rollbacks foram projetados para ser seguros e previsíveis:

• Visualização não destrutiva: Algumas interfaces permitem que você visualize os estados de checkpoint antes de fazer o rollback
• Limites claros: Cada checkpoint representa um marco lógico de desenvolvimento
• Continuidade da conversa: O contexto da IA é preservado, para que você possa continuar construindo a partir do estado restaurado
• Efeito imediato: Os rollbacks são aplicados instantaneamente em todo o seu ambiente de desenvolvimento

​

Executar um rollback

Quando você faz rollback para um checkpoint anterior, seu projeto retorna àquele estado anterior, incluindo:

1. Estado completo do projeto: Todos os arquivos do projeto retornam ao estado exato no checkpoint selecionado
2. Contexto da conversa com o Agent: As conversas do Agent são restauradas até o ponto do checkpoint, mantendo a continuidade do contexto
3. Configuração do projeto: Dependências, pacotes e configurações de runtime
4. Ambiente de desenvolvimento: Configurações de ferramentas e do Project Editor
5. Conteúdo do banco de dados (opcional): Quando selecionado, seu banco de dados será restaurado ao estado em que estava no momento do checkpoint

​

Avançar no histórico

Os checkpoints no Replit funcionam bidirecionalmente — você pode se mover tanto para trás quanto para frente no histórico do seu projeto. Isso oferece flexibilidade completa para navegar pela sua linha do tempo de desenvolvimento sem medo de perder trabalho. Se você fez um rollback demais ou quer recuperar alterações de um checkpoint posterior, você pode avançar para se mover adiante no histórico de checkpoints. Isso permite que você navegue livremente pela linha do tempo do seu projeto sem perder trabalho. Para avançar, acesse a visualização de histórico na aba do Agent clicando no ícone de histórico e selecione um checkpoint que ocorra após sua posição atual. Essa navegação bidirecional dá controle completo sobre a linha do tempo do seu projeto, garantindo que seu trabalho seja sempre recuperável.

​

Criação de checkpoints

Os checkpoints são criados automaticamente pelas ferramentas de IA do Replit em momentos estratégicos durante o desenvolvimento.

​

Checkpoints do Agent

O Replit Agent cria checkpoints quando:

• Conclusão de funcionalidade: Após implementar com sucesso uma funcionalidade ou funcionalidade solicitada
• Marcos importantes: Quando progresso significativo é feito em tarefas complexas
• Estados estáveis: Após testes e validação das alterações implementadas
• Recuperação de erros: Antes de tentar correções para problemas críticos

​

Características dos checkpoints

Cada checkpoint inclui:

• Descrições geradas por IA: Resumos claros e descritivos do que foi realizado
• Informações de timestamp: Horário preciso de criação para fácil identificação
• Escopo das alterações: Indicação de arquivos, funcionalidades ou sistemas modificados
• Informações de faturamento: Para o Agent, rastreamento transparente de custos por checkpoint

​

Usando checkpoints e rollbacks

​

Encontrar checkpoints

Os checkpoints aparecem em vários locais no Project Editor: Aba Agent: Visualize todos os checkpoints criados pelo Agent com descrições e opções de rollback Painel do Git: Veja os checkpoints como commits do Git com integração completa de controle de versão Visualização de histórico: No chat do Agent, clique no ícone de histórico para acessar uma linha do tempo completa de todos os checkpoints e sua progressão

​

Executar rollbacks

O processo de rollback varia ligeiramente dependendo de onde você o inicia:

​

Na aba Agent

​

Melhores práticas

Use checkpoints estrategicamente:

• Teste seu app após cada checkpoint importante para garantir estabilidade
• Crie commits manuais no Git para rastreamento de versão a longo prazo ao lado dos checkpoints automáticos
• Revise as descrições dos checkpoints para entender o que mudou

Considerações sobre rollback:

• Sempre verifique o escopo das alterações antes de fazer um rollback
• Considere o impacto no seu banco de dados e integrações externas
• Comunique os rollbacks aos colaboradores para manter a consciência da equipe

Desenvolvimento iterativo:

• Construa incrementalmente para aproveitar os checkpoints frequentes
• Use rollbacks para explorar diferentes abordagens de implementação com segurança
• Aproveite a preservação do contexto da IA para continuar conversas após rollbacks

​

Integração com controle de versão

Os checkpoints funcionam perfeitamente com o ecossistema mais amplo de controle de versão do Replit:

​

Integração com Git

• Geração de commits Git: Cada checkpoint cria um commit Git correspondente
• Compatibilidade com branches: Os checkpoints respeitam a estrutura de branches e os fluxos de trabalho de merge
• Sincronização remota: A integração com o GitHub mantém a sincronização dos checkpoints
• Acesso à linha de comando: Toda a funcionalidade do Git permanece disponível ao lado dos checkpoints

​

Recursos de colaboração

• Visibilidade da equipe: Os checkpoints são visíveis para todos os colaboradores do projeto
• Prevenção de conflitos de merge: O timing dos checkpoints reduz a probabilidade de conflitos
• Contexto compartilhado: O contexto da conversa com a IA ajuda os membros da equipe a entender as alterações
• Atualizações em tempo real: Os colaboradores veem a criação de checkpoints em tempo real

​

Recursos avançados

​

Visualizações de checkpoint

Algumas interfaces suportam a funcionalidade de visualização de checkpoint:

• Comparação visual: Veja a aparência do seu app em diferentes estados de checkpoint
• Exploração não destrutiva: Visualize sem realmente fazer rollback
• Rastreamento de progresso: Entenda como seu app evoluiu ao longo do tempo
• Comparação de iterações: Compare diferentes abordagens de implementação

​

Rollbacks entre sessões

Para construtores avançados e administradores de equipe:

• Histórico estendido: Acesse checkpoints em várias sessões de desenvolvimento
• Controle administrativo: Administradores de equipe podem executar rollbacks entre sessões de usuário
• Trilhas de auditoria: Histórico completo de criação de checkpoints e ações de rollback

​

Casos de uso

​

Desenvolvimento experimental

Os checkpoints permitem experimentação sem medo:

• Experimente novos recursos sabendo que pode reverter facilmente
• Teste diferentes abordagens arquiteturais
• Explore designs de interface alternativos ou fluxos de usuário
• Implemente integrações complexas com redes de segurança

​

Depuração e recuperação

Quando surgem problemas, os checkpoints fornecem recuperação confiável:

• Faça rollback para estados funcionais quando bugs são introduzidos
• Isole problemas comparando estados de checkpoint
• Restaure a integridade do banco de dados após corrupção de dados
• Recupere-se de exclusões ou modificações acidentais

​

Aprendizado e iteração

Os checkpoints apoiam o desenvolvimento educacional:

• Compare diferentes estratégias de implementação
• Aprenda com o processo de tomada de decisão da IA através da progressão dos checkpoints
• Construa compreensão explorando como as funcionalidades evoluíram
• Pratique novas técnicas com a segurança do rollback

​

Próximos passos

Para saber mais sobre os recursos relacionados do Replit, explore:

• Replit Agent: Aprenda sobre o desenvolvimento de apps com IA e a criação de checkpoints
• Modos do Agent: Descubra os modos Lite, Economy, Power e Turbo para builds direcionadas ou maiores
• Controle de Versão: Entenda a integração com Git e as opções mais amplas de controle de versão
• Histórico de Arquivo: Explore o rastreamento granular de alterações no nível de arquivo
• Prompting Eficaz: Domine técnicas para desenvolvimento orientado a checkpoints