Política de Retenção & Carência de 14 Dias
Procedimentos de Quarentena, Verificação e Reversibilidade de File Storage

Versão 1.1 • Outubro de 2026 • Documentação de Governança de Infraestrutura e FinOps

      Princípio Operacional da Carência:

      O Iuba Flow adota uma política intencional de duplo estágio com carência de 14 (quatorze) dias. Nenhum arquivo binário descarregado do Salesforce é destruído imediatamente. Todo arquivo migrado passa obrigatoriamente por um período de segurança na Lixeira do Salesforce (RecycleBin), assegurando janela para auditoria humana e possibilidade de reversão instantânea.

1. O Ciclo de Vida do Arquivo

O gerenciamento do ciclo de vida de arquivos dentro da arquitetura Iuba Flow é subdividido em 4 fases bem definidas:

Fase	Estado do Binário	Salesforce	Storage Nuvem	Disponibilidade
01. Ativo	Original	Presente em ContentVersion	Inexistente	Acesso padrão SFDC
02. Verificado	Sincronizado	Metadado criado em Archived_File__c	Gravado e validado por SHA-256	Preservado em ambos
03. Quarentena	Na Lixeira (14 dias)	Binário em RecycleBin; link via LWC ativo	Ativo e acessível por presigned URL	Restaurável sem perda
04. Consolidado	Expurgado do SFDC	Metadado e ponteiro mantidos; binário liberado	Armazenado no bucket em repouso	Acesso via link assinado

2. Regra de Validação Fail-Closed

Antes do acionamento da exclusão lógica do arquivo no Salesforce, o motor Iuba Flow executa obrigatoriamente uma requisição HeadObject no bucket de destino. O Salesforce apenas autoriza o envio do arquivo para a lixeira se as seguintes condições forem satisfeitas de forma cumulativa:

O objeto existe fisicamente no bucket de destino com status HTTP 200;
O cabeçalho ContentLength corresponde com precisão de byte ao arquivo original registrado no Salesforce;
O hash SHA-256 computado durante a transmissão coincide integralmente com o hash gravado no storage.

Havendo qualquer divergência de tamanho, hash ou falha de conectividade, a operação é sumariamente interrompida (política Fail-Closed), e o arquivo original é mantido intacto no Salesforce.

3. A Janela de Carência de 14 Dias na Lixeira

Após a validação de paridade, o arquivo é movido para a Lixeira do Salesforce (RecycleBin). Durante os 14 dias subsequentes:

O volume do arquivo deixa de consumir cota ativa para fins de alertas imediatos de armazenamento corporativo;
Usuários finais autorizados continuam acessando o documento normalmente por meio do componente LWC Iuba Cloud Manager, que gera links seguros de download sob demanda;
O administrador da organização possui a prerrogativa de efetuar Undelete a qualquer momento durante esse período caso decida reverter a migração.

4. Rotina de Expurgo Definitivo pós-Carência

Após o transcurso integral da janela de 14 dias, o binário presente na lixeira do Salesforce torna-se elegível ao expurgo definitivo (liberando a cota física de File Storage do contrato Salesforce). O metadado correspondente permanece de forma perene no objeto Archived_File__c com todos os relacionamentos de negócio vinculados ao registro pai.

5. Reversão e Saída Estratégica (Restore Drill)