⚖️ PocketMKT – Painel (MVP WhatsApp)

📚 Guia de Testes do Assistente Modular

📚 GUIA DE TESTES DO ASSISTENTE (MVP)

Este guia resume os principais fluxos implementados no backend (atendimento.py) e como validar cada um antes do MVP com os advogados.

Conecte seu Google (Sheets/Drive/Calendar/Gmail) pelo botão “Conectar Google”. Depois, use o WhatsApp (Twilio Sandbox) para conversar com o assistente. O painel mostra status e logs no Debug.

O que o assistente faz por trás (quando Google está conectado):
• CRM (Google Sheets): cria/garante planilhas por escritório e registra Casos, Tarefas, Clientes e Documentos.
• Drive: cria pastas por cliente (ex.: “Jorge Caldas”) e salva documentos na pasta correta; registra na aba Documentos do CRM.
• Calendar: cria eventos de consulta após aprovação do advogado.
• Gmail: envia emails (quando implementado em certos fluxos).
• Twilio (Sandbox): recebe mensagens do WhatsApp; webhook do backend processa o fluxo.

FLUXOS DO CLIENTE (tipo_usuario=cliente)
1) Saudação inicial
   - Ex.: “Olá, tudo bem?”
   - Esperado: resposta cordial e convite à triagem (“nome completo” e motivo).

2) Relato de caso (registra no CRM)
   - Ex.: “Fui demitido sem justa causa e preciso entender meus direitos.”
   - Esperado: registra o relato na planilha do escritório, aba principal (com data, nome, telefone, área, urgência, resumo).

3) Consulta de andamento do processo
   - Com número: “Quero o andamento do processo 0000000-00.0000.0.00.0000”
     • Tenta encontrar no CRM e retorna o status.
   - Sem número: “Quero saber o andamento do meu processo”
     • Abre automaticamente uma tarefa no CRM para o advogado retornar.

4) Enviar documento (Drive + CRM)
   - Ex.: “Segue anexo meu RG e comprovante de endereço.”
   - Esperado: cria/usa a pasta do cliente no Drive e salva o documento; registra na aba Documentos da planilha.
   - Observação: o backend também aceita upload binário via campo arquivo_base64/media_url no JSON (para testes automatizados/E2E).

5) Atualizar cadastro (Clientes)
   - Ex.: “Troquei de telefone: (11) 99999-1234 e meu e-mail é teste@exemplo.com”
   - Esperado: insere/atualiza linha na aba Clientes (telefone/email e marcação “Atualização”).

6) Follow-up automático (quando disponível)
   - Ex.: “Poderia me lembrar amanhã?”
   - Esperado: registra uma tarefa “Follow-up automático” no CRM.

FLUXOS DO ADVOGADO (tipo_usuario=advogado)
A) Aprovar/Recusar/Sugerir horário de agendamento
   - Ex.: “Pode aprovar o pedido do cliente C5”
     • Esperado: o assistente prepara preview e, após “confirmar”, cria evento no Calendar e marca a tarefa como “Aprovado”.
   - Ex.: “Sem agenda essa semana, melhor recusar”
     • Esperado: marca como “Recusado”.
   - Ex.: “Prefiro amanhã às 10h”
     • Esperado: sugere horário; ao confirmar, cria evento.

B) Onboarding e preparação de CRM
   - Ex.: “Quero configurar meu CRM (onboarding)”
     • Esperado: prepara/garante planilha CRM com abas (Clientes, Casos, Tarefas, Financeiro, Documentos, Parceiros).

C) Lembretes de prazos/audiências (Tarefas)
   - Ex.: “Preciso registrar um lembrete de prazo para amanhã às 14h”
     • Esperado: cria tarefa no CRM (“Lembrete de prazo/audiência”).

D) Documento/Modelo jurídico
   - Ex.: “Preciso de um modelo de contrato de prestação de serviços”
     • Esperado: cria arquivo no Drive e registra na aba Documentos (quando aplicável).

E) Outros fluxos suportados
   - Honorários, revisão de documento, documento pendente, sumiço de cliente, notificação ao cliente, alterar/cancelar agendamento, resumo/estatísticas etc. (respostas polidas; quando aplicável, registram Tarefas/Documentos).

Como testar
1) Conecte o Google e valide o status no painel (Debug → Atualizar).
2) Envie mensagens pelo WhatsApp (Twilio Sandbox) simulando os exemplos acima.
3) Verifique efeitos no CRM (Sheets), arquivos no Drive (pasta do cliente) e eventos no Calendar.
4) Exporte o JSON de debug pelo painel ao final e envie para a equipe.

Observações
• O assistente evita aconselhamento jurídico. Ele organiza, agenda e encaminha.
• Upload binário real pode ser feito via arquivo_base64/media_url (testes automáticos/integração).
• Se algo não funcionar, verifique as permissões do Google e o status do backend no painel.