Arquivos (Documentos)

O gerenciador de Documentos é o centro de downloads do Chinaski: qualquer arquivo que um site oferece aos visitantes. PDFs, relatórios, arquivos ZIP, catálogos, enviado uma vez, gerido com seu próprio metadata, e entregue pelo CMS com rastreamento. Fica em Documents na área admin (apenas admin).

Enviando arquivos

Da tela Documents → New:

Qualquer tipo de arquivo até 50 MB. PDF, ZIP, DOCX, imagens, arquivos; múltiplos arquivos podem ser enviados de uma vez.
Cada documento carrega um título, slug e idioma, mais uma descrição e pasta; o slug se torna seu URL público de download (/documents/<slug>).
Publicação: documentos têm como padrão não publicados; publicar (ou agendar uma janela de publicação) deixa o download ao vivo. Documentos não publicados retornam 404 aos visitantes.
Metadata capturado por documento: contagem de páginas, data de criação, dimensões e modo de cor (preenchidos quando extraíveis), campos de autor, tags (com um conjunto opcional de tags de documento com código de cores), e descrições, notas internas versus descrições públicas.

Pastas e organização

Documentos pertencem a pastas (uma faceta de listagem pela qual você filtra), e a view de listagem suporta filtros por idioma e por status (publicado/não publicado), além de busca livre em títulos, slugs e descrições. Ordenável por nome, slug, tamanho, data de criação, ou contagem de downloads. 50 itens por página.

Substituição e duplicação

Substituir arquivo - envie uma nova versão no lugar da atual: o slug e o URL público permanecem exatamente como eram, então links embutidos em páginas construídas continuam funcionando após uma atualização. Arquivos de substituição seguem o mesmo limite de 50 MB.
Duplicar - faz uma cópia nova do título/arquivo/metadata sob um documento novo, para casos em que um arquivo similar precisa de seu próprio URL e ciclo de vida. A duplicação é auditada.
Todo salvamento de um documento (incluindo substituição de arquivo) faz um snapshot de revisão, o painel de versões mostra cada salvamento.

Servindo e rastreando

Quando publicado, um documento é baixável em /documents/<slug>; cada download incrementa o contador de downloads do documento (visível na ordenação da listagem).
Documentos são servidos pelo CMS, nunca pelo fio estático. Seu reverse proxy ou host estático encaminha /documents/<slug> ao CMS (os exemplos nginx/Caddy distribuídos incluem essa rota; sem ela, toda URL de documento dá 404 aos visitantes).
O link do site estático vem do tipo de bloco de documento: põe um bloco de documento em um corpo de página ({{document:slug}}}) e o builder embute a referência; substitua o arquivo depois, e o link construído continua funcionando porque o slug nunca muda.

Trabalhos de rotina

Excluir move um documento para a Trash, restaure ou destrua permanentemente a partir daí.
Operações em massa (exclusão/estado de publicação) rodam sobre documentos selecionados.
Uma exportação (incluindo uma variante CSV) e uma importação JSON existem para a lista de documentos.
O editor de blocos tem um seletor de documento para arrastar um doc para um corpo de página.