Lixeira

Quando você exclui um artigo, uma coleção ou um espaço inteiro, eles não desaparecem imediatamente. Primeiro, vão para a Lixeira, onde são mantidos por um tempo limitado (depende do seu plano). Durante esse período, você pode restaurar algo excluído acidentalmente com um clique ou, ao contrário, apagar tudo permanentemente.

A Lixeira protege você de erros "fatais" como "escolhi a pasta errada e cliquei em Excluir" e, ao mesmo tempo, dá ao admin um ponto único para a limpeza final da organização.

#Onde abri-la

Menu à esquerda → Lixeira (o ícone de lixeira na parte inferior da navegação).

O selo à direita do item mostra quantos objetos estão atualmente na lixeira.

Quem pode ver a seção:

• Owner / Admin da organização — toda a lixeira (artigos + coleções + espaços)
• Editor — apenas os artigos excluídos dos seus próprios espaços
• User e Guest — a seção fica oculta

#O que vai para a lixeira

Excluir qualquer um dos três tipos de objeto é uma exclusão reversível (soft-delete): o registro permanece no banco de dados com uma marca deleted_at, mas fica oculto dos usuários e da busca por IA. Restaurar traz o objeto de volta "como estava".

A exclusão é em cascata: se você excluir uma coleção pai, todas as coleções e artigos aninhados vão para a lixeira junto com ela.

#Período de retenção por plano

Quanto tempo um objeto permanece na lixeira antes da exclusão permanente é determinado pelo seu plano:

Assim que o período expira, um processo em segundo plano apaga permanentemente o objeto do banco de dados — junto com seus chunks associados, embeddings e o cache de respostas de IA. Ele não pode mais ser restaurado.

Dica. Se, por razões de conformidade, você precisar excluir permanentemente um objeto imediatamente, use "Excluir permanentemente" manualmente em vez de esperar pelo cron.

#Como se apresenta um item da lixeira

Cada linha da lixeira é um cartão com o tipo do objeto, nome, breve descrição, quem o excluiu e quando, o tempo restante e os botões de ação:

Indicadores de cor do tempo restante:

• 🟢 Verde — ainda falta mais da metade do período
• 🟡 Amarelo — resta menos de 30% do período (hora de decidir: restaurar ou excluir permanentemente)
• 🔴 Vermelho — restam 1 a 2 dias até a exclusão permanente

#Ações em um único objeto

#Restaurar

Após a restauração, as marcas deleted_at e deletion_scheduled_at do objeto são apagadas — ele fica disponível novamente na interface normal e aparece na busca.

#Excluir permanentemente

Exclusão irreversível agora, ignorando a retenção. Uma confirmação aparece com um aviso explícito de que "esta ação é irreversível". Use-a apenas se tiver certeza — ela não pode ser desfeita.

#Pré-visualizar (apenas artigos)

Abre uma miniatura com o título e os primeiros 800 caracteres do conteúdo. É uma forma rápida de lembrar o que há dentro sem restaurar o artigo.

#Filtros e busca

No topo da página há uma barra de filtros:

• Tipo — artigos, coleções, espaços ou todos juntos
• Busca — por nome (sem distinção entre maiúsculas e minúsculas)
• Apenas os meus — objetos excluídos por você pessoalmente
• Período — um intervalo de datas de exclusão (de/até)
• Paginação — até 50 itens por página

#Operações em lote

Marque as caixas de seleção em vários cartões — uma barra de ações em lote aparece na parte inferior:

Separadamente, no canto superior direito da página, há um botão "Esvaziar lixeira" — ele apaga tudo permanentemente (você pode restringi-lo a um tipo selecionado, por exemplo, "apenas artigos"). Esta ação requer uma confirmação dupla com uma frase digitada.

#O que acontece com a busca e a IA enquanto um objeto está na lixeira

Enquanto um artigo está entre deleted_at e deletion_scheduled_at:

• Nos resultados de busca normais e nas respostas de IA para os usuários, o conteúdo excluído não é exibido
• Os embeddings e as respostas de IA em cache permanecem intocados no banco de dados
• A IA pode citar um artigo excluído nas respostas a partir do cache — se a mesma pergunta foi feita antes da exclusão e a resposta foi armazenada em cache

Este é um trade-off deliberado: permitimos "desfazer" uma exclusão sem uma reindexação completa da organização (o que é lento e caro), enquanto a limpeza da busca pública é garantida pelo filtro deleted_at IS NULL no nível da consulta SQL.

Se você precisar purgar imediatamente um artigo do cache, use "Excluir permanentemente": o cron removerá imediatamente tanto os embeddings quanto os registros de cache associados.

#Privacidade e acesso

• Owner / Admin da organização veem toda a lixeira, exceto o conteúdo dos espaços Personal de outros usuários
• Editor vê apenas os objetos dos espaços onde é membro; User e Guest não veem a lixeira. Os espaços de outras pessoas não são exibidos de forma alguma
• Espaço Personal — mesmo um Admin global não pode ver o conteúdo dos espaços Personal de outros usuários (incluindo os itens excluídos)

Este é o mesmo modelo de privacidade da interface principal — a lixeira não o quebra.

#Quem pode excluir e restaurar o quê

Os direitos de ação são compostos por dois níveis: a função da organização (Owner / Admin / Editor / User / Guest) e a função em um espaço específico (Space Admin / Editor / Viewer). Para a maioria das ações, ambos são verificados.

Regras principais:

• Um Editor pode enviar para a lixeira e restaurar, mas "excluir permanentemente" artigos e coleções é limitado a Space Admin (e superior). Esta é uma salvaguarda contra a perda acidental de dados por um colaborador comum.
• Espaços são a operação mais poderosa: apenas um Owner / Admin da organização pode excluí-los, restaurá-los e excluí-los permanentemente. Um Space Admin de um único espaço não pode excluir o próprio espaço.
• User e Guest não veem a lixeira de forma alguma — e não podem excluir ou restaurar nada.
• Um espaço Personal só é excluído por seu proprietário (ou quando o próprio usuário é excluído).

Importante sobre a restauração entre espaços. Se você restaurar um artigo em um espaço diferente (por exemplo, o original foi excluído), você deve ter uma função de pelo menos Editor no espaço de destino — caso contrário, a restauração será rejeitada com um erro INSUFFICIENT_PERMISSIONS.

#Seções relacionadas

• Log de auditoria — os eventos trashed / restored / permanently_deleted são registrados lá com o iniciador e a hora
• Gestão de artigos — é aqui que ocorre a exclusão normal que envia um artigo para a lixeira
• Espaços — excluir um espaço envia em cascata todo o seu conteúdo para a lixeira