Registro de versoes e alteracoes.
| Data | Versao | Descricao | Autor |
|---|
| 02/04/2026 | 1.0 | Versao inicial do documento de analise de requisitos. | Gustavo Canofre |
Contexto, objetivo e escopo do projeto.
O Ecossistema de IA Rangel de Miranda e uma plataforma integrada que centraliza dados de clientes, processos e documentos do escritorio em um unico painel inteligente, conectando os sistemas existentes (CPJ, Planner, OneDrive). O sistema inclui dois agentes de IA: um Assistente WhatsApp que responde consultas da equipe interna com dados reais dos sistemas juridicos, e um Leitor de Conversas que monitora o WhatsApp da equipe de pos-vendas, identifica demandas de clientes e cria tarefas automaticamente no Planner e CPJ. Todas as tarefas criadas pela IA passam por aprovacao humana antes de execucao. O projeto resolve a fragmentacao de informacoes entre CPJ (contencioso) e Planner (consultivo), unificando a visao operacional e estrategica do escritorio.
Funcionalidades que o sistema deve prover.
RF001
Painel Dashboard com Dados Centralizados
Essencial
Painel web que exibe em tempo real: total de clientes ativos, processos em andamento, tarefas pendentes, faturas em aberto, timeline de atividades recentes e alertas de prazos proximos. Dados sincronizados do CPJ e Planner.
- Dados do CPJ (processos, movimentacoes)
- Dados do Planner (tarefas consultivo)
- Dados financeiros (Auddora/banco)
- Dashboard com cards de resumo
- Timeline de atividades
- Alertas de prazos e audiencias
RF002
Gestao de Clientes
Essencial
Tela de clientes com busca, filtros (area, status, tipo PF/PJ) e ficha detalhada contendo: dados cadastrais, processos vinculados, contratos no OneDrive, historico de conversas, faturas e status do onboarding.
- Filtros de busca (nome, area, status)
- ID do cliente para detalhe
- Lista paginada de clientes
- Ficha completa do cliente
- Links para documentos no OneDrive
RF003
Visualizacao de Processos
Essencial
Tela de processos com dados espelhados do CPJ. Filtros por area, advogado responsavel e status. Detalhes incluem movimentacoes processuais, prazos e documentos vinculados.
- Dados do CPJ via API
- Filtros de busca
- Lista de processos com filtros
- Movimentacoes e prazos
RF004
Agente Assistente WhatsApp
Essencial
Agente de IA no WhatsApp (numero dedicado) que responde consultas da equipe interna. Processa texto, audio (Whisper) e imagens (GPT-4o Vision). Consulta CPJ, OneDrive e Planner em tempo real. Acesso restrito por whitelist de telefones.
- Mensagem WhatsApp (texto/audio/imagem)
- Webhook Z-API
- Resposta com dados reais dos sistemas
- Links de documentos
- Resumos de processos
RF005
Agente Leitor de Conversas
Essencial
IA que monitora conversas do WhatsApp da Lucia com clientes em tempo real. Classifica mensagens como demandas, enriquece com contexto do cliente e cria tarefas estruturadas no banco. As tarefas ficam pendentes de aprovacao da Lucia no painel.
- Mensagens de clientes via Z-API
- Contexto do cliente (banco + CPJ)
- Mapa de equipe e areas
- Task classificada com responsavel sugerido
- Prioridade e destino (Planner/CPJ)
- Trecho da conversa como contexto
RF006
Aprovacao de Tarefas da IA
Essencial
Tela no painel onde Lucia visualiza tarefas criadas pelo Agente Leitor. Cada tarefa mostra: cliente, demanda, responsavel sugerido, prioridade e trecho da conversa. Lucia pode aprovar (envia para Planner/CPJ), editar ou rejeitar com 1 clique.
- Tarefas com status aguardando_aprovacao
- Acao de Lucia (aprovar/editar/rejeitar)
- Task enviada ao Planner ou CPJ via API
- Status atualizado no banco
RF007
Chat IA Integrado ao Painel
Importante
Interface de chat dentro do painel web com o mesmo agente IA do WhatsApp. Socios e Lucia podem fazer consultas de dados sem sair do navegador. Historico de conversa persistido por sessao.
- Mensagem de texto do usuario
- Resposta do agente com dados reais
RF008
Sincronizacao Periodica CPJ/Planner
Essencial
Servico em background que sincroniza dados do CPJ (clientes, processos, movimentacoes, audiencias) e Planner (tarefas) para o banco local a cada 15 minutos. Usa upsert para evitar duplicatas.
- API do CPJ
- Microsoft Graph API (Planner)
- Banco local atualizado
- Logs de sincronizacao
RF009
Indexacao de Documentos com Busca Semantica
Importante
Indexacao de documentos do OneDrive usando embeddings (text-embedding-3-small) armazenados em pgvector. Permite busca semantica por conteudo dos documentos, nao apenas por nome de arquivo.
- Documentos do OneDrive (PDF, DOCX)
- API de embeddings OpenAI
- Embeddings armazenados em pgvector
- Busca semantica disponivel nas tools
RF010
Autenticacao e Controle de Acesso
Essencial
Login por email/senha com JWT no painel web. Dois perfis: admin (socios, acesso total) e operacional (Lucia, acesso operacional). No WhatsApp, whitelist de telefones com niveis de visibilidade por cargo.
- Email e senha (painel)
- Numero de telefone (WhatsApp)
- Token JWT (painel)
- Acesso autorizado ou bloqueado
05
Requisitos Nao Funcionais
Qualidade, restricoes e padroes obrigatorios.
Seguranca
NF001Protecao de Dados SenssiveisEssencial
Dados de processos judiciais e clientes devem trafegar sobre HTTPS. Credenciais armazenadas em variaveis de ambiente, nunca em codigo. Logs sem dados pessoais (CPF/telefone mascarados).
NF002Autenticacao JWTEssencial
Tokens JWT com expiracao de 8 horas. Renovacao por re-login. Sem armazenamento de sessao no servidor.
Desempenho
NF003Tempo de RespostaImportante
Agente WhatsApp deve responder em ate 15 segundos. Painel deve carregar em ate 3 segundos. Sync nao deve impactar performance das consultas.
Confiabilidade
NF004Deduplicacao de WebhooksEssencial
Redis com TTL de 60s para evitar processamento duplicado de webhooks Z-API. Chave: phone + momment.
NF005Aprovacao Humana ObrigatoriaEssencial
Nenhuma tarefa criada pela IA e executada automaticamente no MVP. Toda acao passa por aprovacao da Lucia no painel.
Usabilidade
NF006Interface SimplesImportante
Painel otimizado para 3-5 usuarios. Interface limpa, sem complexidade desnecessaria. Aprovacao de tasks com 1 clique.
Padroes Tecnicos
NF007Arquitetura ModularEssencial
Monolito modular com separacao clara entre modulos (core, painel, assistente, leitor, integracoes). Cada modulo isolado com suas rotas, services e models.
Infraestrutura
NF008ContainerizacaoEssencial
Aplicacao containerizada com Docker e docker-compose. Banco PostgreSQL via Supabase (gerenciado). Redis local ou gerenciado.
07
Roadmap de Desenvolvimento
Fases de entrega do projeto.
Fase 1
Centralizacao e Agentes Core
Setup do projeto, integracoes (CPJ, Graph, Z-API), banco de dados, sync periodico, indexacao de documentos. Agente Assistente WhatsApp com 7 tools de consulta. Agente Leitor de Conversas com classificador e criacao de tasks. Painel web com dashboard, clientes, processos, tarefas IA e chat integrado.
4 semanas
Fase 2
Automacao de Processos
Onboarding automatizado (procuracao, grupo WhatsApp, boas vindas). Geracao automatica de comunicados de audiencia. Relatorio mensal unificado (contencioso + consultivo). Automacao de cobranca via Sicredi. Refinamento dos agentes baseado em uso real.
4 semanas
Fase 3
Chat Juridico e Contato com Cliente
Chat IA juridico completo: consulta de jurisprudencia, rascunho de pecas, resumos de processos. Calculos judiciais e trabalhistas. Analise de debitos fiscais e nulidades em CDAs. Atualizacoes proativas para clientes. Agendamento inteligente. Estabilizacao e go-live.
4 semanas