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.
Rafael Alves Lopes 2026-07-22 17:20:58 -03:00
parent abb90be652
commit f0e0a468f3
2 changed files with 24 additions and 1 deletions

@ -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.

@ -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: