BK-23 - Planejar integração do OpenGravity no LegalizaRJ para Gmail, Agenda e Docs

Status

Pendente.

Objetivo

Mapear e documentar como o OpenGravity deve entrar no LegalizaRJ para integrar:

• Gmail
• Google Agenda
• Google Docs

sem quebrar o fluxo atual do CRM e da troca de mensagens via helper de WhatsApp.

Leitura atual do projeto

O LegalizaRJ é um CRM administrativo com:

• gestão de clientes
• financeiro
• notas/timeline por cliente
• painel de conversas WhatsApp
• agenda local (agenda_compromissos)
• superfícies já existentes de Gmail e Google Agenda no admin

Arquivos centrais já identificados:

• admin/gmail.php
• admin/agenda_google.php
• admin/agenda.php
• admin/api/agenda_action.php
• admin/api/agenda_export.php
• admin/whatsapp.php
• admin/api/whatsapp_send.php
• admin/api/whatsapp_ingest.php
• admin/cliente_ver.php
• admin/includes/bootstrap.php

Diagnóstico atual

Hoje o projeto já usa Google, mas de forma acoplada:

• admin/gmail.php chama gog diretamente via shell_exec
• admin/agenda_google.php chama gog diretamente via shell_exec
• não existe ainda superfície equivalente para Google Docs
• não existe uma camada central de integração reaproveitável dentro do projeto

Direção proposta

Integrar o OpenGravity no LegalizaRJ como camada comum de Google Workspace, priorizando:

1. Gmail dentro do fluxo do CRM

• leitura de e-mails operacionais relevantes
• filtros úteis por cliente/processo

1. Google Agenda integrada ao admin

• criar/atualizar compromisso no admin
• opcionalmente espelhar no Google Agenda
• registrar nota/timeline no cliente relacionado
• preparar o caminho para aviso por WhatsApp

1. Google Docs integrado ao admin

• criar documento de atendimento por cliente
• gerar link reutilizável para o processo
• preparar compartilhamento do link por WhatsApp

Exemplo de caso de uso prioritário

Caso de uso validado como prioritário:

• o operador cria um compromisso/prazo no admin do LegalizaRJ;
• o evento entra na timeline/notas do cliente;
• o mesmo evento pode ser refletido na Google Agenda;
• depois o fluxo pode evoluir para enviar confirmação ou resumo pelo helper de WhatsApp.

Escopo recomendado para implementação futura

Fase 1

• centralizar Gmail e Google Agenda em helper próprio do projeto usando contrato do OpenGravity
• remover shell_exec espalhado em páginas

Fase 2

• criar superfície de Google Docs no admin
• associar documento ao cliente

Fase 3

• conectar Agenda/Docs ao fluxo de WhatsApp
• permitir notificação ou compartilhamento controlado ao cliente

Observações

• Nesta rodada houve apenas mapeamento e documentação.
• Não implementar código agora.
• Não atualizar docs/CHANGELOG.md enquanto a integração não for entregue de fato.