Persistência de Configurações da Plataforma

Nada mina mais a confiança numa plataforma do que configurar tudo com capricho — contextos, prompts, matriz de visibilidade — e ver o trabalho sumir depois de uma atualização. No DATTA isso não acontece: toda configuração de execução feita pela interface é gravada em armazenamento durável e sobrevive a reinícios, atualizações e até à reinstalação da plataforma, sem nenhuma ação sua.

Desde 8 de maio de 2026, a configuração de execução e os prompts ficam em um volume dedicado da instalação. Antes disso eles moravam em uma área temporária (/tmp/datta-runtime-config.json) e os domínios cadastrados pela interface sumiam a cada reinício — o problema que esta mudança encerrou.

O que é preservado

• Contextos e domínios de dados cadastrados pela interface, em Sistema›Contextos.
• Prompts por contexto, guardados na pasta de prompts do mesmo volume.
• Demais configurações de execução ajustadas pelo console.

A gravação é imediata: salvou na interface, está persistido. Não existe um passo extra de "aplicar" ou "publicar".

Como o armazenamento é dimensionado

Os parâmetros abaixo fazem parte da instalação da plataforma e raramente precisam de ajuste:

O volume é criado pela própria instalação com política de retenção: ele é preservado mesmo quando a plataforma é desinstalada. Uma reinstalação encontra contextos e prompts exatamente onde estavam — reinstalar nunca custa a configuração.

Backup e restauração

Mesmo com persistência automática, mantenha cópias de segurança: elas cobrem perda de disco e erro humano (por exemplo, a exclusão indevida de um contexto).

• Instantâneos do volume — o ambiente de armazenamento permite tirar snapshots do volume de configuração. O agendamento automático desses instantâneos ainda não está entregue; hoje eles são disparados sob demanda.
• Restauração manual — o procedimento é: copiar o arquivo runtime-config.json do volume para fora, guardá-lo como backup e, na hora de restaurar, devolvê-lo ao mesmo caminho e reiniciar o módulo de configuração da plataforma. Tudo isso é feito pelo console de administração, sem acesso direto à infraestrutura.

Voltar a plataforma para uma versão anterior

Desde 2 de setembro de 2026 a gravação da configuração preserva o que a versão em execução não conhece. Cada versão nova da plataforma pode acrescentar campos à configuração (a escolha de modelo do assistente Captain, por exemplo, chegou em agosto de 2026). Se a plataforma for revertida para uma versão que ainda não tinha um campo, essa versão continua gravando a configuração normalmente — e o campo que ela não conhece fica no arquivo, intacto, esperando a próxima atualização.

Dois detalhes que valem saber:

• Limpar de propósito é diferente de não conhecer. Quando você apaga uma escolha pela interface (por exemplo, volta o modelo do Captain para o padrão), a gravação registra explicitamente "sem valor". Isso não é confundido com "campo desconhecido" e não é restaurado por engano.
• A garantia vale para versões a partir de 2 de setembro de 2026. Reverter para uma versão anterior a essa data ainda descarta, na próxima gravação, os campos que ela não conhecia — em especial a escolha de modelo do Captain, que precisaria ser refeita. Antes de uma reversão dessas, guarde uma cópia do arquivo de configuração (seção anterior) e prefira corrigir para frente.

Migração de instalações antigas

Instalações anteriores a essa mudança, que ainda gravavam na área temporária, perdem a configuração ao atualizar — ela não é migrada automaticamente. Nesse caso:

1. Recadastre os domínios pela interface em Sistema›Contextos ou com o script scripts/recreate-domains.sh.
2. Não é preciso mais nada: a catalogação automática dispara para cada domínio novo e repovoa o Knowledge Catalog em segundo plano.

Boas práticas

• Não tente contornar a persistência apontando as configurações de volta para áreas temporárias "para desenvolvimento". O armazenamento durável é provisionado na hora, mesmo em instalação local, e não tem custo extra — a área temporária apenas devolve o problema original.
• O armazenamento de configuração tem um único escritor. Por isso o módulo de configuração roda em instância única; múltiplas réplicas simultâneas não são suportadas na versão atual. Uma configuração de alta disponibilidade exigiria armazenamento compartilhado com escrita concorrente ou mover a configuração para o cache compartilhado da plataforma.
• Backups periódicos da configuração junto com os dados, na mesma rotina da equipe de operações.