• Português

      • Controle de versão

      No NocoBase, Controle de versão permite salvar uma versão restaurável da aplicação atual. Você pode criar versões manualmente, restaurar uma versão salva quando precisar e permitir que o AI Builder salve versões automaticamente após marcos significativos.

      O controle de versão depende de Gerenciamento de backups para salvar e restaurar estados da aplicação. Antes de usar o controle de versão, habilite primeiro o Gerenciamento de backups.

      Atenção

      As edições Community e Standard não incluem o plugin de controle de versão. Se você precisa salvar um estado restaurável da aplicação, use Gerenciamento de backups: crie um backup manual antes de mudanças importantes e restaure o backup correspondente quando precisar voltar atrás.

      Versões automáticas com IA

      Depois que o plugin de controle de versão é habilitado, o AI Builder ganha uma camada extra de recuperação. Quando um AI Agent começa a trabalhar em uma solicitação, ele verifica as NocoBase Skills disponíveis para a aplicação atual. Se encontrar a skill nocobase-revision, pode salvar marcos importantes de criação como versões restauráveis.

      A IA detecta a skill nocobase-revision ao iniciar a criação

      Quando a IA conclui uma parte que pode ser revisada separadamente, como montar uma página, criar um conjunto de coleções ou configurar um workflow, ela executa nb revision create por meio do NocoBase CLI. Você não precisa clicar manualmente em 「Create version」 a cada vez, e pequenos ajustes não geram registros de versão em excesso.

      A IA cria uma versão após a criação

      Essas versões aparecem na lista de versões. Se as alterações seguintes não ficarem como esperado, você pode restaurar o marco anterior e continuar ajustando a partir dele.

      Abrir o plugin

      Depois de habilitar o plugin, o menu 「Version control」 aparece na barra superior. A partir dele, você pode criar uma versão diretamente ou ir para a lista de versões.

      Você também pode abrir a página do plugin em 「System settings / Version control」. O atalho padrão para criar uma versão é Ctrl + K, e você pode alterá-lo na aba de configurações.

      Menu Version control

      Criar uma versão

      Clique em 「Create version」, preencha uma descrição e salve. A descrição pode ter até 2000 caracteres. Ela é útil para registrar o contexto da alteração, como “Ajuste dos campos e permissões do fluxo de aprovação”.

      Criar uma versão

      Depois de clicar em salvar, a lista mostra primeiro um item temporário em estado “Saving”. Quando termina, a versão salva aparece na lista.

      Pontos principais:

      • O nome da versão é gerado automaticamente
      • Criar pela barra superior, pelo atalho ou pela página da lista produz o mesmo resultado
      • A lista mostra nome da versão, descrição, tamanho do arquivo, hora de criação, criador e ações disponíveis

      Gerenciar e restaurar versões

      A lista de versões oferece principalmente estas ações:

      • 「Refresh」 recarrega a lista atual
      • 「Delete」 remove uma versão ou várias versões selecionadas
      • 「Restore」 restaura a aplicação para o estado salvo naquela versão
      Atenção

      Restaurar uma versão sobrescreve a configuração atual da aplicação e os dados incluídos naquela versão. Recomenda-se criar antes uma versão do estado atual, para que você possa voltar atrás se precisar.

      Depois de clicar em 「Restore」, a aplicação entra em modo de manutenção por um curto período enquanto a restauração é executada. Não envie outra restauração durante esse processo. Se a restauração falhar, a interface mostrará uma notificação de erro.

      Configurar as regras de versão

      Abra a aba 「Settings」 para controlar retenção e conteúdo de cada versão.

      As configurações incluem:

      • Versions to keep: número máximo de versões salvas. As versões mais antigas são removidas automaticamente quando o limite é excedido
      • Shortcut: create version: atalho para criar uma versão. Pressione Ctrl + uma letra para definir e Backspace para limpar
      • User collections: escolha quais dados de coleções criadas por usuários devem ser incluídos nas versões salvas
      Tip

      Por padrão, as versões salvas não incluem dados de coleções criadas por usuários. Você só precisa selecionar coleções aqui quando quiser restaurar também parte dos dados de negócio.

      Se você incluir uma coleção de usuário, o NocoBase também incluirá automaticamente as coleções relacionadas, então a restauração costuma ficar mais completa.