Armazenamento dos arquivos

Fotos das tentativas, material das provas, regulamentos, modelos de crachá e logos ficam guardados no disco do servidor. O administrador do sistema pode ligar, como opção, uma cópia no R2 da Cloudflare — tudo pela página /admin/storage, no card Armazenamento.

O card mostra, a qualquer momento:

• Lendo de — Disco local (o padrão) ou R2 (Cloudflare), e desde quando.
• R2 — se está configurado, o nome do bucket e o endereço do servidor. As chaves de acesso nunca aparecem na tela.
• No disco e No R2 — quantos arquivos e quanto espaço cada lugar guarda.

Logo abaixo, Uso por organização: só arquivos das edições soma o que pertence às edições de cada organização — envios das equipes, material, downloads, crachá, regulamento e logos da edição e das equipes — e Arquivos por edição leva ao pool de downloads de cada edição. Essa soma é menor que o total do disco de propósito: o que não é de nenhuma edição fica de fora (veja a seção seguinte).

No topo da página, Uso total do armazenamento mostra tudo o que está guardado no disco, de todas as organizações. O número de Arquivos em uso é o mesmo do No disco do card Armazenamento.

Cada categoria aparece com a quantidade de arquivos, o espaço e uma barra, da maior para a menor:

• Envios das equipes, Material das provas, Downloads da edição, Crachá, Regulamento e Logos (de organizações, eventos, edições e equipes) — o que pertence a uma edição ou organização. Se a edição, a prova, a equipe ou a organização de um arquivo não existe mais, ele aparece como sem vínculo. Quando há algo a explicar, a categoria lista o porquê de cada parte: por exemplo, no material das provas, as fotos de lançamentos da Comissão gravadas até 21/07/2026 com o tipo antigo (são de uma tentativa, não material de prova) ou o arquivo de uma prova que foi excluída.
• Fotos de perfil, Biblioteca de provas e Anexos do suporte — gerais, não pertencem a nenhuma edição. É por isso que o uso total costuma ser bem maior que o uso por organização.

O bloco Fora do uso ativo mostra o que ocupa espaço (ou faltaria) sem fazer parte do que o sistema usa hoje:

• Removidos que continuam no disco — o sistema apagou ou trocou o arquivo (uma foto de perfil nova, um logo trocado), mas o arquivo antigo ficou no servidor. Desde 21/10/2026 a troca apaga o arquivo antigo de verdade; o que aparece aqui é de antes.
• Arquivos sem registro — estão no disco, mas nenhum registro do sistema aponta para eles, como um envio que falhou no meio. Aparecem as pastas onde estão. Os de pastas de arquivo saem pela limpeza de órfãos (veja abaixo).
• Registros sem arquivo — o sistema conta com o arquivo, mas ele não está no disco; quem tentar abrir não consegue. Cada um aparece na lista, com o que fazer (veja abaixo).

Em Registros sem arquivo, cada registro aparece com a equipe, a edição, a prova (índice e etapa), a tentativa e a data, como o arquivo chegou (envio da equipe, lançamento da Comissão, envio direto ao R2) e o que o R2 diz dele.

• Está no R2 — use Restaurar do R2 para o disco. O arquivo volta ao disco e abre de novo para quem tem acesso.
• Não está no R2 (ou o R2 não está configurado e não há cópia registrada lá) — o arquivo não existe em lugar nenhum. Use Marcar como removido: o registro passa a removido, com o seu nome e a data, como na limpeza da edição.
• R2 não conferido — não deu para consultar o R2 agora; nenhuma ação aparece. Use Recalcular agora para tentar de novo.

Desde 21/10/2026, quando algo que tem arquivos é excluído, os arquivos dele saem junto — do disco e, se houver cópia, do R2 —, e o registro de cada um passa a removido, com o nome de quem excluiu e a data.

• Prova excluída — todo o material dela.
• Tentativa excluída pela Comissão — a foto do lançamento. A tentativa, o motivo e a resposta continuam registrados; só a foto sai. Ao editar um lançamento com foto nova, a foto antiga sai.
• Edição, evento ou organização removidos — crachá, regulamento, logos, arquivos para download e material das provas.
• Equipe excluída — o logo e os envios que a exclusão leva junto.
• Conta encerrada pela administração — a foto de perfil.

No bloco Fora do uso ativo, o item Órfãos para limpar junta o que ficou para trás antes dessa regra (ou quando um arquivo não pôde sair na hora). Ninguém consegue abrir esses arquivos pelo sistema. Ele mostra, com quantidade, tamanho e exemplos:

• Registros cuja origem não existe — material de uma prova excluída, envio de uma tentativa que não existe mais, arquivo de uma edição, de um evento ou de uma organização que não existem mais. É o mesmo “sem vínculo” do uso total, com o mesmo motivo.
• Arquivos sem registro — arquivos nas pastas de arquivos do sistema (fotos, logos, envios…) sem nenhum registro que aponte para eles, como a foto antiga de uma troca que falhou no meio.

1. 1
   Confira os números e, se quiser, os exemplos de cada grupo (Ver exemplos).
2. 2
   Clique em Limpar órfãos…, digite LIMPAR e confirme. A lista é conferida de novo na hora de apagar; enquanto isso, a janela mostra Limpando….
3. 3
   O resultado diz quantos registros e arquivos saíram e quanto espaço foi liberado. O que não pôde sair continua na lista para a próxima vez; se passar do limite de 500 por vez, o resultado diz quantos faltam — é só limpar de novo.

Antes de os backups do banco terem um lugar próprio no servidor, eles eram guardados junto com os arquivos enviados. Esses arquivos antigos continuam lá: não aparecem em Administração → Backups, a retenção não os apaga e eles contêm dados pessoais (são o banco inteiro). No bloco Fora do uso ativo, o item Backups antigos no volume de arquivos lista cada um, com tamanho, data e o selo da cópia fora do servidor.

1. 1
   Enviar para fora do servidor — manda os antigos para a mesma cópia cifrada dos backups (veja Backups do banco de dados). O selo passa a Pendente e depois Enviado.
2. 2
   Apagar… — abre a confirmação. Os que têm a cópia confirmada já vêm marcados. Um arquivo sem cópia só é apagado se você marcar Não preciso guardar nele. Digite APAGAR e confirme.

O R2 só aparece como opção depois que as chaves forem colocadas no servidor da API. Sem isso, o card diz R2 não configurado e tudo continua no disco, como sempre.

1. 1
   Criar o bucket. No painel da Cloudflare, em R2, crie um bucket privado (por exemplo, logiclab-arquivos). Não ligue acesso público: cada arquivo só sai por um link curto que o sistema gera depois de conferir quem está pedindo.
2. 2
   Criar o token. Em Manage R2 API Tokens, crie um token com permissão Object Read & Write, só para esse bucket. Guarde o Access Key ID e o Secret Access Key (a Cloudflare mostra uma vez só) e anote o Account ID.
3. 3
   Colocar no servidor. As chaves entram nas variáveis de ambiente da API (os nomes exatos estão no card, quando o R2 ainda não está configurado, e na documentação de implantação da API), seguidas de uma atualização do sistema. Elas ficam só ali — nunca no banco de dados, nos backups ou na tela.
4. 4
   Liberar o envio pelo navegador. Nas configurações do bucket, em CORS Policy, cole a regra da documentação de implantação: ela permite que o navegador envie arquivos ao bucket, só a partir do endereço do The Logic Lab. Sem ela, nada quebra — o envio só continua passando pelo servidor, como antes.
5. 5
   Limpar os envios abandonados. Em Object lifecycle rules, crie uma regra que apaga, depois de 1 dia, o que estiver na pasta pendentes/ — envios que começaram e nunca foram concluídos.

Replicar para o R2 copia, em segundo plano, todos os arquivos que já existem e passa a copiar também todo arquivo novo. Enquanto isso, nada muda para quem usa o sistema: os arquivos continuam sendo lidos do disco.

• O card mostra o progresso (x de y arquivos) e se atualiza sozinho enquanto a cópia anda. Pode fechar a tela: a cópia continua no servidor e retoma de onde parou depois de uma atualização do sistema.
• Pausar a cópia para a cópia dos arquivos antigos. Os arquivos novos continuam indo para o R2. Para retomar, clique de novo em Replicar para o R2.
• O envio de uma foto ou documento nunca espera pelo R2 nem falha por causa dele: o arquivo é guardado no disco na hora e copiado logo depois. (Com o R2 já em uso, a foto da resposta vai direto para a Cloudflare — veja abaixo.)

Usar o R2 só acende quando a cópia inicial terminou, sem falhas. A partir daí, os arquivos passam a ser lidos do R2.

• Os arquivos continuam sendo gravados também no disco. Se o R2 ficar fora do ar, o sistema lê do disco sem ninguém perceber.
• Voltar para o local está sempre disponível e vale na hora. Nada é apagado do R2, e a cópia dos arquivos novos continua.
• Baixar um arquivo continua exigindo o mesmo acesso de hoje — o bucket nunca fica exposto na internet. A diferença é o caminho do arquivo, explicada logo abaixo.

As fotos de perfil novas já são guardadas leves: até 512 pixels (e uma miniatura de 128 para as listas), de pé e sem os dados escondidos da câmera. As listas de integrantes e o menu do topo não carregam mais as fotos junto com os dados — cada foto chega sozinha, só quando aparece na tela, e o navegador guarda para a próxima vez.

As fotos enviadas antes disso continuam no tamanho original (em média 600 KB cada). O card Fotos de perfil, no Storage, mostra quantas pessoas ainda têm foto antiga, quanto elas ocupam e quanto a conversão deve liberar.

1. 1
   Converter fotos reduz as fotos antigas aos poucos, em segundo plano. Ninguém precisa enviar a foto de novo, e quem está usando o sistema não percebe. Se houver edição ao vivo, a conversão espera o evento acabar.
2. 2
   Pausar para a conversão onde está; Retomar a conversão continua de onde parou. Uma foto que não pôde ser convertida (arquivo corrompido ou sumido do disco) continua como estava, e o card mostra quantas foram.
3. 3
   Cada foto original fica guardada à parte até você decidir. Confira algumas fotos convertidas nas listas de integrantes e, com a conversão pausada ou concluída, use Apagar originais para liberar o espaço.

Com Usar o R2 ligado, os arquivos passam a ir e vir direto da Cloudflare, sem atravessar o servidor do The Logic Lab. Isso deixa o envio de fotos e o download de arquivos mais rápidos — principalmente na noite do evento, quando muitas equipes enviam ao mesmo tempo.

Para baixar (o arquivo de uma resposta, o material de uma prova, o regulamento, o modelo do crachá, os arquivos da edição, os logos e as fotos de perfil): o sistema confere, como sempre, se você pode ver aquele arquivo. Se pode, entrega um link curto que abre só aquele arquivo e vale poucos minutos. Ninguém consegue usar o link para chegar a outro arquivo, e depois de alguns minutos ele não abre mais nada. Nos logos e nas fotos, cada vez que a tela pede a imagem o sistema entrega um link da hora (o navegador só reaproveita o anterior enquanto ele ainda tem, no mínimo, um minuto de validade), e a imagem em si fica guardada no navegador. Se mesmo assim uma imagem falhar, a tela pede um link novo uma vez antes de mostrar as iniciais.

Para enviar a foto ou o arquivo da resposta de uma prova:

1. 1
   O próprio navegador apaga da foto os dados escondidos — como o lugar onde ela foi tirada e o modelo do celular — sem mexer na imagem.
2. 2
   O sistema confere as regras da prova (prazo, tentativas, tipo e tamanho do arquivo) e libera um link de envio que serve só para aquele arquivo, com aquele tamanho.
3. 3
   O arquivo sobe direto para a Cloudflare, com a barra mostrando quanto já foi. No fim, o sistema confere o arquivo e registra a resposta, exatamente como antes.