Anexos do Paciente

Anexe, organize e baixe arquivos do paciente com categorias, quota por plano, lixeira de 30 dias e compartilhamento no portal.

Os anexos do paciente permitem guardar arquivos (PDFs, imagens e documentos do Office) diretamente na ficha de cada paciente, com categorias, descrição, busca, lixeira de 30 dias e controle de quota de armazenamento por plano. Arquivos marcados como compartilhados também aparecem no portal do paciente.

Pré-requisitos

Armazenamento configurado (produção): defina STORAGE_PROVIDER=vercel-blob e BLOB_READ_WRITE_TOKEN. Sem isso o sistema cai no provider de disco (fs), que não funciona em produção e faz o upload falhar com mensagem genérica. Em desenvolvimento o provider fs (pasta .storage/) funciona sem configuração.
Anexar / editar / remover / restaurar / esvaziar lixeira: exige Documentos = Escrita. Por padrão tanto o administrador quanto o profissional têm esse acesso, então os dois conseguem anexar. Uma clínica mais restritiva pode tirar isso de um usuário com um override de Documentos = Nenhum em Configurações → Permissões.
Ver / baixar anexos: exige Pacientes = Leitura (todo administrador e profissional têm por padrão).
Ver o consumo de armazenamento (Configurações → Armazenamento): o item Configurações no menu exige Usuários = Escrita (administrador por padrão).
Quota: vem do plano (maxStorageMb); clínicas sem plano/trial recebem 1024 MB; -1 significa ilimitado.

Para o administrador

Anexar um arquivo

Abra Pacientes no menu, clique no paciente e vá na aba Anexos.
Em cima da lista, escolha a Categoria e, opcionalmente, preencha Descrição (opcional) (ex.: "exame de sangue"). Marque Compartilhar com paciente se o arquivo deve aparecer no portal do paciente.
Arraste arquivos para a área tracejada "Arraste arquivos aqui ou clique para selecionar" (PDF, imagens e documentos do Office). Ao concluir aparece o toast "Documento anexado".
O arquivo entra na lista mostrando ícone do tipo, categoria, tamanho, data e quem enviou.

Encontrar, visualizar e baixar

Use os chips de categoria ("Todas" / "Exame" / etc.) e o campo Buscar por nome/descrição para filtrar. Dica: se não achar um arquivo antigo, clique em Carregar mais primeiro.
No menu ⋮ do arquivo, use Visualizar (abre o preview de PDF/imagem) ou Baixar.

Editar metadados e remover

Para corrigir metadados: menu ⋮ → Editar, altere Categoria/Descrição no modal e clique em Salvar ("Documento atualizado").
Para excluir: menu ⋮ → Remover e confirme; o arquivo vai para a lixeira por 30 dias.
Para ver/recuperar itens removidos: marque Mostrar lixeira; cada item mostra "exclui definitivamente em {data}". Clique em Restaurar para trazê-lo de volta.
Documentos gerados pelo sistema (GERADO/ASSINADO) aparecem sem a opção Editar e com Remover desabilitado (tooltip explicando a retenção) — isso é esperado.

Acompanhar o armazenamento

Acesse o menu → Configurações → aba Armazenamento. Você vê "X de Y" com barra (azul/âmbar/vermelho conforme o uso) e quanto está "na lixeira". Se o uso estiver alto, remova arquivos grandes nos pacientes ou faça upgrade de plano.
Se um upload for bloqueado, aparece um banner âmbar "Limite de armazenamento do seu plano atingido… Faça upgrade…" com o link Ver plano e armazenamento (leva a Configurações; clique na aba Armazenamento para confirmar).

Para o profissional

Abra Pacientes → paciente → aba Anexos.
Você pode consultar os anexos: filtrar por categoria, buscar por nome/descrição e, no menu ⋮, usar Visualizar (preview) e Baixar. O download é sempre feito de forma autenticada e auditada.
Você também pode anexar, editar e remover arquivos: essas ações usam a permissão Documentos = Escrita, que o perfil de profissional já tem por padrão — a zona de upload e os botões de Editar/Remover aparecem normalmente. Se a sua clínica tiver removido esse acesso com um override de Documentos = Nenhum, as ações de escrita ficam ocultas; nesse caso, peça a um administrador para reativar.

Para o paciente (Portal)

Anexos marcados como Compartilhar com paciente ficam disponíveis no portal do paciente. O upload e a gestão são sempre feitos pela clínica; o paciente apenas visualiza e baixa os arquivos compartilhados.

Atenção

Em produção, se STORAGE_PROVIDER e BLOB_READ_WRITE_TOKEN não estiverem configurados, o sistema usa o provider de disco (fs) e os uploads falham com uma mensagem genérica. Configure o armazenamento antes de liberar os anexos para a equipe.