🏛️ DRA. JÚLIA - AGENTE IA ADVOCACIA ⚖️

🎯 Visão Geral

Dra. Júlia é um agente de IA jurídica completo que combina a potência do N8N, GPT-4o e WhatsApp Business para oferecer atendimento jurídico automatizado e inteligente. O sistema processa documentos, transcreve áudios, gera contratos e agenda consultas de forma completamente automática.

v2.0 — Abril 2026: Segurança reforçada (OWASP), guardrails de IA, modelo atualizado para GPT-4o, 9 áreas jurídicas e arquitetura expandida para 35 nós.

🎬 Demo em Ação

👤 Cliente: [Envia foto de contrato]
🤖 Dra. Júlia: "Analisei seu contrato de prestação de serviços. 
                Identifiquei 3 cláusulas que precisam de atenção:
                1. Ausência de prazo para pagamento
                2. Multa desproporcional (50%)
                3. Foro não especificado

                Gostaria que eu gere uma versão corrigida?

                ⚠️ AVISO LEGAL: As informações prestadas têm caráter
                orientativo e não substituem a consulta com advogado."

🆕 O que há de novo na v2.0

🚀 Instalação Rápida

Pré-requisitos

• ✅ N8N (v1.0+)
• ✅ Conta OpenAI (GPT-4o + Whisper)
• ✅ WhatsApp Business API (Graph API v20.0)
• ✅ Google Workspace

1️⃣ Clone e Configure

git clone https://github.com/JeffersonMFti/agente-dra-julia-advocacia.git
cd agente-dra-julia-advocacia

2️⃣ Importe o Workflow

1. Abra seu N8N
2. Vá em Workflows → Import from file
3. Selecione workflows/dra-julia-agente-ia-advocacia.json

3️⃣ Configure as Credenciais

# Configurar como variáveis de ambiente no N8N (Settings → Variables)
OPENAI_API_KEY=sk-sua-chave-aqui
WHATSAPP_TOKEN=seu-token-permanente
PHONE_NUMBER_ID=seu-phone-number-id
WHATSAPP_VERIFY_TOKEN=seu-token-de-verificacao
GOOGLE_SHEETS_ID=id-da-sua-planilha

⚠️ v2.0 BREAKING CHANGE: As credenciais do WhatsApp foram removidas do JSON do workflow e passaram a ser obrigatoriamente configuradas como variáveis de ambiente no N8N. Tokens hardcoded não são mais aceitos.

🎯 Guia Completo de Instalação

🎯 Funcionalidades Principais

🛡️ Segurança e Guardrails (v2.0)

🛠️ Tecnologias Utilizadas

Tecnologia	Função	Versão	Status
	Orquestração de Workflows	v1.0+	✅ Produção
	IA Conversacional & Análise	GPT-4o	✅ Atualizado
	Interface de Comunicação	Graph v20.0	✅ Produção
	Gestão de Dados	—	✅ Produção

📊 Arquitetura do Sistema — v2.0 (35 nós)

flowchart TB
    subgraph ENTRADA["📥 Entrada — WhatsApp Business"]
        WH[/"Webhook N8N\n(Graph API v20.0)"/]
        WH --> CHK{GET ou POST?}
        CHK -->|GET — Challenge| VER["✅ Webhook Challenge\nVerification (Meta)"]
        CHK -->|POST — Mensagem| AR["⏱️ Anti-Replay\n(descarta > 5 min)"]
    end

    subgraph SEGURANCA["🛡️ Camada de Segurança"]
        AR --> TRUNC["✂️ Truncar Input\n(máx 4.000 chars)"]
        TRUNC --> TIPO{Tipo de\nMensagem?}
        TIPO -->|sticker| SKIP["🚫 Ignorar\nSilenciosamente"]
    end

    subgraph MULTIMODAL["🧠 Processamento Multimodal"]
        TIPO -->|text| GPT["💬 GPT-4o\nConversação"]
        TIPO -->|audio| MEDIA1["📡 Buscar URL\n(Graph API)"]
        TIPO -->|image/doc| MEDIA2["📡 Buscar URL\n(Graph API)"]
        MEDIA1 --> DL1["⬇️ Download Binário"]
        MEDIA2 --> DL2["⬇️ Download Binário"]
        DL1 --> WHISPER["🎙️ Whisper\nTranscrição"]
        DL2 --> VISION["👁️ GPT-4o Vision\nAnálise de Doc"]
        WHISPER --> GPT
        VISION --> GPT
    end

    subgraph JURIDICO["⚖️ Motor Jurídico"]
        GPT --> CLASS["🏛️ Classificar Área\n(9 áreas + Geral)"]
        CLASS --> GUARD["🛡️ 6 Guardrails\nSystem Prompt"]
        GUARD --> ACAO{Ação\nIdentificada?}
        ACAO -->|GERAR_DOCUMENTO| GERAR["📄 Gerar Documento\n+ Aviso Legal ⚠️"]
        ACAO -->|AGENDAR_CONSULTA| AGENDA["📅 Verificar\nDisponibilidade"]
        ACAO -->|Resposta| SANIT["🧹 Sanitizar Saída\n(remove cmd internos)"]
    end

    subgraph INTEGRAÇÕES["🔗 Integrações"]
        GERAR --> SHEETS1["📊 Google Sheets\nRegistrar Documento"]
        AGENDA --> NOWEEK{"📆 Final de\nSemana?"}
        NOWEEK -->|Sim| PROXDIA["➡️ Próximo\nDia Útil"]
        NOWEEK -->|Não| GCAL["🗓️ Google Calendar\nCriar Evento"]
        GCAL --> SHEETS2["📊 Google Sheets\nRegistrar Consulta"]
        SHEETS1 --> SANIT
        SHEETS2 --> SANIT
    end

    subgraph SAIDA["📤 Saída"]
        SANIT --> WA["📱 Enviar WhatsApp\n(Graph API v20.0)"]
        WA --> CLIENTE["👤 Cliente"]
    end

    subgraph LEMBRETES["⏰ Lembretes Automáticos"]
        CRON["🕗 Cron Job Diário"] --> SHEET3["📊 Ler Consultas\nAgendadas"]
        SHEET3 --> E164["✅ Validar E.164"]
        E164 --> WAREM["📱 WhatsApp\nLembrete"]
    end

    subgraph ERROS["🔴 Tratamento de Erros"]
        GPT -.->|onError| ERR["💾 saveDataError\nExecution: all"]
        WA -.->|onError| ERR
        GCAL -.->|onError| ERR
    end

    style ENTRADA fill:#e8f5e9,stroke:#388e3c
    style SEGURANCA fill:#fff3e0,stroke:#f57c00
    style MULTIMODAL fill:#e3f2fd,stroke:#1976d2
    style JURIDICO fill:#f3e5f5,stroke:#7b1fa2
    style INTEGRAÇÕES fill:#e8eaf6,stroke:#3949ab
    style SAIDA fill:#e8f5e9,stroke:#388e3c
    style LEMBRETES fill:#fce4ec,stroke:#c62828
    style ERROS fill:#ffebee,stroke:#b71c1c

📁 Estrutura do Projeto

agente-dra-julia-advocacia/
├── 📋 README.md                          # Este arquivo
├── 📈 CHANGELOG.md                       # Histórico de versões
├── 📄 LICENSE                            # Licença MIT
├── 🤝 CONTRIBUTING.md                    # Guia de contribuição
├── 📂 workflows/
│   ├── dra-julia-agente-ia-advocacia.json        # ⭐ Workflow v2.0 (35 nós)
│   └── dra-julia-agente-ia-advocacia.v1.bak.json # Backup workflow v1.0
├── 📂 scripts/
│   └── build_workflow_v2.py              # Script de build do workflow v2
├── 📂 documentacao/
│   ├── README-DRA-JULIA-ADVOCACIA.md
│   └── GUIA-INSTALACAO.md
├── 📂 config/
│   └── configuracao.md
├── 📂 templates/
│   └── templates-documentos.md
└── 📂 docs/
    ├── CASOS-DE-USO.md
    └── PUBLICACAO-GITHUB.md

📈 Métricas e Performance

📖 Documentação

• 📚 Documentação Completa
• 🛠️ Guia de Instalação
• ⚙️ Configuração
• 📄 Templates
• 📈 Changelog
• 💼 Casos de Uso

🤝 Como Contribuir

Contribuições são muito bem-vindas! Veja nosso Guia de Contribuição para mais detalhes.

1. Faça um Fork do projeto
2. Crie sua Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a Branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🏆 Reconhecimentos

• N8N Community pelo framework de automação incrível
• OpenAI pela tecnologia GPT-4o e Whisper
• Meta / WhatsApp Business pela Graph API v20.0
• Google Workspace pela integração perfeita