Plano de Implementacao — Documentos & Arquivos

Modulo completo: upload, templates, geracao PDF, assinatura eletronica, portal do paciente, auditoria
AgenciaPsi v5 Vue 3 + Supabase 2026-03-30 Status: em andamento
6
Tabelas
2
Buckets
7
Services
3
Composables
~10
Componentes
5
Feature flags
1
Banco de Dados — Migrations
Tabelas, RLS policies, indexes, triggers
Migration Tabela / Objeto O que faz Campos principais
005_create_documents_tables.sql documents Arquivo vinculado a paciente. Path no Supabase Storage, tipo/categoria, visibilidade, tags, soft delete com retencao LGPD. Tabela central do modulo. O campo storage_bucket indica qual bucket do Storage contem o arquivo (documents ou generated-docs), permitindo que PDFs gerados aparecam na mesma listagem.
id patient_id tenant_id owner_id bucket_path storage_bucket nome_original mime_type tamanho_bytes tipo_documento categoria descricao tags[] visibilidade compartilhado_portal compartilhado_supervisor agenda_evento_id session_note_id enviado_pelo_paciente status_revisao revisado_por revisado_em uploaded_by uploaded_at deleted_at deleted_by retencao_ate
document_access_logs Log imutavel de quem visualizou ou baixou cada arquivo. Conformidade CFP e LGPD. Sem UPDATE/DELETE — somente INSERT e SELECT.
id documento_id acao user_id ip user_agent acessado_em
document_signatures Assinaturas eletronicas. Cada signatario (paciente, responsavel, terapeuta) tem seu registro com IP, timestamp e hash do documento.
id documento_id signatario_tipo signatario_id ordem status ip user_agent assinado_em hash_documento
document_share_links Links temporarios assinados para compartilhar documento com profissional externo sem conta no sistema. Prazo e limite de usos.
id documento_id token expira_em usos_max usos criado_por criado_em
006_create_document_templates.sql document_templates Templates de documentos (declaracao de comparecimento, atestado, recibo etc.). Corpo HTML com variaveis. Templates globais do sistema + personalizados por tenant com logo/cabecalho.
id tenant_id nome_template tipo corpo_html variaveis[] is_global owner_id logo_url cabecalho_html rodape_html ativo
document_generated Cada PDF gerado a partir de um template. Guarda os dados usados no preenchimento e o path do PDF resultante no Storage.
id template_id patient_id tenant_id dados_preenchidos pdf_path gerado_em gerado_por
2
Supabase Storage — Buckets
Bucket Uso Path pattern
documents Arquivos enviados por terapeuta ou paciente (PDF, imagem, DOCX, etc.) {tenant_id}/{patient_id}/{timestamp}-{filename}
generated-docs PDFs gerados pelo sistema a partir de templates. Referenciado tanto por document_generated (snapshot) quanto por documents (listagem do paciente) via campo storage_bucket. {tenant_id}/{patient_id}/{template_nome_sanitizado}_{timestamp}.pdf
3
Services — Camada de dados
src/services/ — seguem o padrao Medicos.service.js (getOwnerId + getActiveTenantId + CRUD)
Arquivo O que faz
Documents.service.js CRUD completo de documentos: upload ao Storage + insert no banco, listagem por paciente com filtros (tipo, categoria, tags), soft delete com retencao, restauracao, download com URL assinada
DocumentTemplates.service.js CRUD de templates: criar/editar templates (globais e por tenant), listar variaveis disponiveis, duplicar template, ativar/desativar
DocumentGenerate.service.js Gerar PDF a partir de template: preencher variaveis com dados do paciente/sessao, renderizar HTML para PDF via pdf.service.js (jsPDF + html2canvas-pro), salvar no bucket generated-docs, registrar em document_generated E automaticamente na tabela documents (para aparecer na listagem do paciente). Nomes de arquivo sanitizados (sem acentos) para compatibilidade com Supabase Storage.
pdf.service.js Servico de geracao de PDF client-side usando jsPDF + html2canvas-pro. Substitui pdfmake que apresenta incompatibilidade com Vite (UMD vs ESM — getBlob/getBuffer travam silenciosamente). Recebe HTML completo, renderiza em canvas oculto (scale 1.5, JPEG 85%), gera PDF A4 com paginacao automatica. Retorna Blob para upload/download.
DocumentSignatures.service.js Criar solicitacao de assinatura, registrar assinatura (IP, hash, timestamp, user_agent), consultar status de cada signatario, verificar integridade via hash
DocumentShareLinks.service.js Gerar link temporario com token, validar token no acesso, registrar uso, expirar link
DocumentAuditLog.service.js Registrar log de acesso (visualizacao/download) e consultar historico de acessos por documento
4
Composables — Logica reativa
src/features/documents/composables/
Arquivo O que faz
useDocuments.js State reativo: lista de documentos do paciente, loading, filtros ativos (tipo, categoria, tags), operacoes CRUD, refresh automatico apos upload/delete
useDocumentTemplates.js State reativo: lista de templates disponiveis (globais + tenant), preview com dados ficticios, variaveis extraidas do corpo HTML
useDocumentGenerate.js Logica de geracao: carregar dados do paciente/sessao, mapear variaveis, chamar servico de geracao, retornar URL do PDF
5
Paginas & Componentes Vue
src/features/documents/
Arquivo Tipo O que faz
DocumentsListPage.vue Pagina Pagina principal — lista todos os documentos do paciente com DataTable, filtros (tipo, categoria, tags), botoes de upload, preview, download. Hero header sticky com stats rapidos.
DocumentUploadDialog.vue Dialog Upload de arquivo — drag & drop ou seletor, campos: tipo do documento, categoria, descricao, tags, vinculo com sessao (opcional), visibilidade. Validacao de tamanho e tipo de arquivo.
DocumentPreviewDialog.vue Dialog Preview inline — renderiza PDF/imagem no dialog. Botoes: download, compartilhar, solicitar assinatura, excluir. Exibe metadados (tipo, tags, quem enviou, data).
DocumentTemplatesPage.vue Pagina Gestao de templates — lista templates disponiveis (globais + do tenant), criar novo, editar, duplicar, ativar/desativar. Cards com preview do template.
DocumentTemplateEditor.vue Componente Editor de template — edicao do corpo HTML (editor rich text), insercao de variaveis via dropdown, preview ao vivo com dados ficticios, config de cabecalho/rodape/logo.
DocumentGenerateDialog.vue Dialog Gerar documento — selecionar template, campos preenchidos automaticamente com dados do paciente/sessao, edicao manual se necessario, preview final via iframe sandbox, botao "Salvar documento" (salva online, sem download automatico). Botao "So baixar" gera PDF local sem salvar no banco.
DocumentSignatureDialog.vue Dialog Solicitar assinatura — adicionar signatarios (paciente, responsavel, terapeuta), definir ordem, enviar link por email/whatsapp, acompanhar status de cada signatario.
DocumentShareDialog.vue Dialog Compartilhar — gerar link temporario com prazo (24h, 48h, 7d) e limite de usos, copiar link, enviar por email. Exibe links ja criados com status.
components/DocumentCard.vue Componente Card reutilizavel de documento — thumbnail (icone por tipo ou preview de imagem), nome, tipo, data, tags, menu de acoes (3 dots).
components/DocumentTagsInput.vue Componente Input de tags livres — chips editaveis com autocomplete baseado em tags ja usadas pelo terapeuta. Criacao de novas tags inline.
6
Integracao com Prontuario (arquivo existente)
Arquivo existente Alteracao
src/features/patients/prontuario/PatientProntuario.vue Adicionar aba/secao "Documentos" que renderiza DocumentsListPage filtrada pelo patient_id atual. Botao rapido de upload direto do prontuario.
7
Rotas
Adicionadas em routes.therapist.js e routes.clinic.js
Rota Pagina Descricao
/therapist/documents DocumentsListPage.vue Lista geral de documentos (todos os pacientes do terapeuta)
/therapist/documents/templates DocumentTemplatesPage.vue Gestao de templates do terapeuta
/therapist/patients/:id/documents DocumentsListPage.vue Documentos de um paciente especifico (via props)
/clinic/documents/templates DocumentTemplatesPage.vue Templates da clinica (admin configura templates compartilhados)
8
Menus de Navegacao
Arquivo Item adicionado Onde no menu
therapist.menu.js "Documentos" — icon: pi-file, to: /therapist/documents Grupo "Pacientes", abaixo de "Tags"
therapist.menu.js "Templates" — icon: pi-file-edit, to: /therapist/documents/templates Sub-item de Documentos
clinic.menu.js "Templates de Documentos" — icon: pi-file-edit, to: /clinic/documents/templates Grupo "Configuracoes"
9
SaaS — Feature Flags
Inseridas em saas_features e vinculadas aos planos via plan_features
Feature key Descricao Planos
documents.upload Upload de arquivos a pacientes — funcionalidade base Free + Pro
documents.templates Templates de documentos (declaracao, atestado, recibo etc.) Pro
documents.signatures Assinatura eletronica (TCLE, consentimentos) Pro
documents.share_links Links temporarios para compartilhamento externo Pro
documents.patient_portal Paciente visualiza e envia documentos pelo portal Pro
10
Seed Data — Templates Padrao
Arquivo O que insere
seed_015_document_templates.sql 4 templates globais (is_global = true) com corpo HTML e variaveis mapeadas:
Declaracao de Comparecimento Atestado Psicologico Relatorio de Acompanhamento Recibo de Pagamento
Variaveis dos templates: {{paciente_nome}}, {{paciente_cpf}}, {{data_sessao}}, {{hora_inicio}}, {{hora_fim}}, {{terapeuta_nome}}, {{terapeuta_crp}}, {{clinica_nome}}, {{clinica_endereco}}, {{valor}}, {{data_atual}}, entre outras. Cada template define quais variaveis utiliza no campo variaveis[].
Decisao tecnica — Motor PDF: pdfmake foi substituido por jsPDF + html2canvas-pro. O pdfmake (UMD) trava silenciosamente com Vite (ESM) — createPdf().getBlob()/getBuffer() nunca retornam, mesmo com optimizeDeps configurado. A solucao final usa html2canvas-pro (fork com suporte a cores oklch do PrimeVue/Tailwind) para renderizar o HTML preenchido em canvas, e jsPDF para converter em PDF A4 com paginacao. Resultado: ~200-400KB por documento (JPEG 85%, scale 1.5).
!
Ordem de Execucao Sugerida
Fase O que Depende de
1 Migrations (tabelas, RLS, triggers, indexes) —
2 Buckets no Supabase Storage Fase 1
3 Services (camada de dados) Fase 1 + 2
4 Composables (logica reativa) Fase 3
5 Componentes e Paginas Vue Fase 4
6 Rotas, menus, feature flags Fase 5
7 Integracao com Prontuario Fase 5
8 Seed data (templates padrao) Fase 1