Documentos
Um Documento é um arquivo compartilhado entre a MIDDAG e uma organização cliente. Documentos incluem contratos assinados, propostas, relatórios, certificados, especificações técnicas e qualquer outro arquivo que precise ser armazenado com segurança e acessado pelo admin ou pelo portal do cliente.
O que documentos cobrem
O domínio Documento é uma biblioteca de arquivos de propósito geral, separada dos downloads de produtos (que são tratados pelo domínio Licença). Documentos servem a propósitos organizacionais:
| Categoria | Exemplos |
|---|---|
| Propostas | Propostas exportadas como PDF, propostas de projeto |
| Contratos | Acordos assinados, aditivos, declarações de escopo |
| Relatórios | Relatórios mensais de serviço, relatórios de auditoria |
| Certificados | Certificados de conclusão, certificados de conformidade |
| Especificações | Especificações técnicas, diagramas de arquitetura |
Armazenamento
Arquivos são armazenados no Cloudflare R2 com metadados persistidos no banco de dados WordPress:
| Dados | Onde ficam |
|---|---|
| Conteúdo do arquivo (PDF, DOCX, etc.) | Bucket Cloudflare R2 (middag-documents) |
| Metadados (nome, tipo, tamanho, hash) | Tabela customizada WordPress |
| Vínculo com organização | Tabela customizada WordPress |
Arquivos são organizados por organização no R2. Cada arquivo possui um hash SHA-256 armazenado para verificação de integridade.
Tipos de arquivo suportados e limites
| Aspecto | Valor |
|---|---|
| Tipos permitidos | PDF, DOCX, XLSX, PNG, JPG (configurável pelo admin) |
| Tamanho máximo por arquivo | 50 MB |
| Acesso | URLs assinadas com expiração curta (padrão: 5 minutos) |
O admin pode expandir ou restringir os tipos de arquivo permitidos nas configurações.
Controle de acesso
Documentos são privados da sua organização. Um documento pertencente à Organização A nunca é acessível por membros da Organização B.
| Papel | Pode visualizar/baixar | Pode fazer upload |
|---|---|---|
| Owner | Sim | Sim |
| Admin | Sim | Sim |
Member (com escopo documents) | Sim | Sim |
| Guest | Sim | Não |
Uploads requerem o escopo documents. Guests podem visualizar e baixar, mas não fazer upload.
Como documentos são criados
Documentos entram no sistema de duas formas:
- Upload pelo admin — o admin faz upload de arquivos pelo admin do WordPress, selecionando a organização-alvo e preenchendo título, tipo e categoria.
- Upload pelo cliente — colaboradores com permissões apropriadas fazem upload de arquivos pelo portal.
Quando um novo documento é enviado para uma organização, o contato principal é notificado por e-mail.
Entidades vinculadas
Documentos podem ser vinculados a outros registros para rastreabilidade:
| Vínculo | Finalidade |
|---|---|
| Organização | Todo documento pertence a uma organização (obrigatório). |
| Contrato | PDFs de contratos assinados são referenciados a partir do registro do Contrato. |
| Entitlement | Documentos podem ser associados a entitlements específicos para contexto. |
Segurança de download
Downloads utilizam URLs assinadas geradas sob demanda:
- Cliente ou admin clica em "Baixar" no portal ou admin.
- O sistema gera uma URL assinada do R2 com expiração de 5 minutos.
- O navegador redireciona para a URL assinada para o download.
- Se a URL expirar antes do download iniciar, o usuário clica novamente para gerar uma nova.
Isso garante que arquivos nunca sejam expostos por URLs públicas permanentes.
O que os admins veem
No admin do WordPress, a lista de documentos mostra:
- Nome e tipo do arquivo
- Organização
- Categoria (proposta, relatório, certificado, etc.)
- Tamanho do arquivo
- Data de upload
- Quem enviou (admin ou nome do cliente)
Admins podem filtrar por organização, categoria ou tipo de arquivo, e podem fazer upload de documentos em lote.
Páginas relacionadas
- Contratos — acordos assinados armazenados como documentos
- Organizações — a proprietária de todos os documentos
- Licenças — downloads de software (tratados separadamente)
- Entitlements — registros de acesso aos quais documentos podem ser vinculados