🚀 Agrimat API V2.1

Sistema Completo de Contratos com IA, Assinatura Digital e Testemunhas

25+
ContractV2 Endpoints
🤖
IA Integrada
✍️
Assinatura Digital
👥
Testemunhas

👥 Gestão de Usuários

  • Registro e autenticação completa
  • Verificação de email
  • Reset de senha seguro
  • Perfis de usuário personalizáveis
  • Controle de acesso por níveis

📄 Sistema de Documentos

  • Upload e download de arquivos
  • Tipos de documento configuráveis
  • Verificação automática de documentos
  • Integração com Firebase Storage
  • Comparação de documentos

🤖 Contratos Inteligentes V2.1

  • Geração de formulários com IA (OpenAI GPT-3.5)
  • Categorização automática de campos
  • Preview JSON em tempo real
  • Geração PDF com anexos (ConvertAPI)
  • Assinatura sequencial via DocuSeal
  • Testemunhas obrigatórias integradas
  • Webhooks em tempo real

🏗️ Gestão de Obras

  • Cadastro completo de obras
  • Associação com clientes
  • Controle de documentação
  • Timeline de atividades
  • Relatórios personalizados

🔒 Segurança Avançada

  • Autenticação JWT robusta
  • Sistema OTP para verificações
  • Logs detalhados de atividades
  • Validação de dados completa
  • Proteção contra ataques

📈 Dashboard & Analytics

  • Estatísticas em tempo real
  • Gráficos e métricas
  • Relatórios personalizados
  • Autocomplete inteligente
  • Sistema de busca avançado

✍️ Assinatura Digital Sequencial

  • Integração completa com DocuSeal
  • Ordem: Cliente → Testemunhas → Grupo
  • Rastreamento em tempo real via webhook
  • Status automático de assinaturas
  • Timeline completa de eventos
  • URLs de auditoria e documentos finais

🧠 Inteligência Artificial

  • OpenAI GPT-3.5-turbo integrado
  • Análise inteligente de templates DOCX
  • Categorização automática de campos
  • Filtragem de campos preenchidos automaticamente
  • Geração de formulários dinâmicos
  • Validação e tipos de campos inteligentes

🚀 Guia de Integração Rápida

  1. Base URL: Carregando...
  2. Autenticação: Inclua o JWT token nos headers: Authorization: Bearer YOUR_JWT_TOKEN
  3. Content-Type: Use application/json para requisições JSON
  4. Upload: Use multipart/form-data para upload de arquivos
  5. Códigos de resposta: 200/201 (sucesso), 400/401/403/404/500 (erros)
  6. Documentação completa: Acesse o markdown CONTRACTV2_ENDPOINTS_DOCUMENTATION.md

🤖 Fluxo Completo ContractV2 com IA

  1. 1. Criação: POST /contractV2 → Cliente recebe email com token
  2. 2. Documentos: POST /contractV2/:id/documents → Upload via token temporário
  3. 3. Formulário IA: GET /contractV2/:id/form → IA gera campos + testemunhas
  4. 4. Preview: GET /contractV2/:id/preview → JSON para modal frontend
  5. 5. Submit: POST /contractV2/:id/submit → DOCX→PDF + anexos
  6. 6. Assinatura: POST /contractV2/:id/sign → DocuSeal sequencial
  7. 7. Webhook: POST /contractV2/webhook/docuseal → Updates automáticos

🎯 Ordem de Assinatura: Cliente → Testemunhas → Grupo (sequencial)

📋 Resumo dos Endpoints

👥 Usuários (/user)

POST /user/register Registrar usuário
POST /user/login Fazer login
GET /user/profile Obter perfil
PUT /user/profile Atualizar perfil

🏢 Clientes (/client)

GET /client Listar clientes
POST /client Criar cliente
PUT /client/:id Atualizar cliente
DELETE /client/:id Deletar cliente

📄 Documentos (/document)

POST /document Upload documento
GET /document Listar documentos
GET /document/download/:id Download documento

🤖 ContractV2 - IA & Assinatura Digital (/contractV2)

POST /contractV2 Criar contrato
GET /contractV2 Listar todos os contratos
GET /contractV2/:id Buscar contrato por ID
GET /contractV2/:id/client-info Info para cliente (token)
POST /contractV2/:id/documents Upload de documentos
GET /contractV2/:id/form 🤖 Gerar formulário com IA
GET /contractV2/:id/preview Preview do documento (JSON)
POST /contractV2/:id/submit Submit formulário → PDF
POST /contractV2/:id/sign ✍️ Enviar para DocuSeal
GET /contractV2/:id/signature-status Status de assinatura em tempo real
POST /contractV2/webhook/docuseal Webhook DocuSeal (sem auth)

🏗️ Obras (/obra)

GET /obra Listar obras
POST /obra Criar obra

📈 Dashboard & Outros

GET /dashboard/stats Estatísticas
GET /autocomplete/search Busca autocomplete
POST /compare Comparar documentos

🛠️ Stack Tecnológico V2.1

Node.js 18+ Express.js MongoDB Atlas Mongoose JWT Auth 🤖 OpenAI GPT-3.5 ✍️ DocuSeal API 📄 ConvertAPI Firebase Storage Docxtemplater PDF-lib Nodemailer Node-cron