From f0e0a468f355a864ba02af2713ee6c96194d2d3c Mon Sep 17 00:00:00 2001 From: Rafael Lopes Date: Wed, 22 Jul 2026 17:20:58 -0300 Subject: [PATCH] DOC: Adiciona envio de midia e regras de perfil por tela Chat-e-WhatsApp: documenta fluxo de send-media (FormData, blob URL, Socket.IO). Telas-e-Modulos: adiciona regras de perfil admin/supervisor/agente no painel e chat. --- Chat-e-WhatsApp.md | 17 ++++++++++++++++- Telas-e-Modulos.md | 8 ++++++++ 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/Chat-e-WhatsApp.md b/Chat-e-WhatsApp.md index 5e08760..97bf9b3 100644 --- a/Chat-e-WhatsApp.md +++ b/Chat-e-WhatsApp.md @@ -99,10 +99,25 @@ Responsavel por: - impedir resposta quando o atendimento nao esta assumido; - impedir nova mensagem quando aguarda resposta do cliente; - orquestrar assumir, liberar, fechar e transferir atendimento; -- hidratar midia sob demanda. +- hidratar midia sob demanda; +- gerenciar envio de midia via FormData. O hook mantem regra de tela e estado local. A borda HTTP fica em `whatsappChatService.js`. +## Envio de midia + +O operador pode enviar imagens, audios, videos e documentos pelo chat. + +Fluxo: + +1. Operador clica no clipe e seleciona o arquivo. +2. Preview aparece instantaneamente via blob URL (sem upload ainda). +3. Ao enviar, `useChat` monta um `FormData` com `file`, `to`, `senderName` e `caption` (opcional). +4. Chamada para `POST /whatsapp/send-media` em `whatsappChatService.js`. +5. Mensagem aparece no chat imediatamente (blob URL); Socket.IO substitui pela URL definitiva do servidor. + +Tipos aceitos: imagem (5 MB), audio/video (16 MB), documento PDF/docx/xlsx (100 MB). + ## Observacao Mesmo com Socket.IO, as acoes sensiveis continuam acontecendo por HTTP protegido com Bearer token. diff --git a/Telas-e-Modulos.md b/Telas-e-Modulos.md index 50c1918..6f20df3 100644 --- a/Telas-e-Modulos.md +++ b/Telas-e-Modulos.md @@ -76,6 +76,14 @@ Inclui: - configuracoes; - WhatsApp QR Code. +Regras de perfil: + +- Admin pode chamar endpoints administrativos completos, incluindo usuarios/acessos, auditoria, conteudos da IA e QR Code. +- Supervisor usa telas operacionais e fluxos permitidos para supervisao. +- Agente nao deve chamar listagens administrativas como usuarios ou presenca geral do time. + +No chat, chamadas compartilhadas respeitam o perfil: agente consulta apenas a propria presenca; supervisor/admin podem consultar presenca geral. + ## Shared Recursos compartilhados entre modulos: