IA aplicada · Análise de documentosProjeto 02 / 06

Lince

PDF vira dados estruturados e respostas.

O Lince recebe um PDF, extrai o conteúdo, usa IA para identificar tipo, partes, valores, datas e riscos, grava tudo em PostgreSQL e permite fazer perguntas sobre o documento em linguagem natural.

  • Node.js
  • TypeScript
  • Express 5
  • IA · Groq
  • Zod
  • PostgreSQL

Case demonstrativo. Os PDFs analisados nas telas foram gerados com empresas e dados fictícios.

01 · Do PDF aos dados

Um contrato entra. Dados saem.

contrato-prestacao-servicos.pdf

Contrato de prestação de serviços nº 2026/0147

Contratante: EMPRESA XYZ COMÉRCIO E SERVIÇOS LTDA

Contratada: NOVA ROTA TECNOLOGIA LTDA

Valor total: R$ 18.500,00

Emissão: 25/06/2026

Vigência até: 30/11/2026

Cláusula de rescisão: multa de 30% sobre o saldo remanescente

  1. Extrai o texto
  2. IA analisa
  3. Estrutura os dados
  4. Salva no PostgreSQL
Documento analisado
Tipo
Contrato
Cliente
EMPRESA XYZ COMÉRCIO E SERVIÇOS LTDA
Fornecedor
NOVA ROTA TECNOLOGIA LTDA
Valor
R$ 18.500,00
Emissão
25/06/2026
Vencimento
30/11/2026
Status
Ativocalculado pelo sistema

Multa de 30% sobre saldo remanescente em caso de rescisão imotivada pode ser alta.

Resultado exibido pelo Lince para o PDF de exemplo da demonstração. Empresas e valores são fictícios.

02Solução

Um pipeline que lê, entende e organiza.

Cada etapa aparece em tempo real na interface. Ao final, os dados estruturados ficam salvos e o documento pode ser consultado com perguntas, com respostas baseadas somente no conteúdo do arquivo.

  1. 01PDFUpload por arrastar e soltar
  2. 02ExtraçãoTexto lido com pdf.js
  3. 03Análise por IATipo, partes, valores, datas e riscos
  4. 04EstruturaçãoJSON validado e normalizado
  5. 05PostgreSQLDados prontos para busca e indicadores
  6. 06PerguntasChat com o documento
03O resultado na tela

Tudo o que importa, sem abrir o PDF.

Os campos extraídos, a confiança da extração, os pontos de atenção e o campo para perguntar ao documento.

Tabela de dados extraídos do contrato com confiança da extração
Extração estruturada
Pontos de atenção destacados e campo para perguntar ao documento
Pontos de atenção e perguntas

Nove tipos de documento, um único fluxo.

  • Contrato
  • Nota fiscal
  • Boleto
  • Proposta
  • Orçamento
  • Recibo
  • Fatura
  • Aditivo
  • Laudo
Análise de uma nota fiscal de serviços com status vencido
04A IA não trabalha sozinha

A IA interpreta. O código garante.

A saída de um modelo de linguagem não é confiável por padrão. Por isso, o que é regra fica fora da IA.

Ponto sensívelComo o sistema trata
Status de vencimentoCalculado em código, no fuso de São Paulo, a cada leitura.
Saída do modeloTodo JSON é validado com Zod e normalizado antes de gravar.
Texto do PDFVai delimitado como dado; instruções dentro dele são ignoradas.
Arquivo originalFica só em memória; vão ao banco o texto e os dados estruturados.
Documento repetidoHash SHA-256 impede reprocessar o mesmo PDF.
PDF escaneadoRecusado com mensagem clara: OCR é um módulo futuro.
05Tecnologia

Como o sistema é construído.

Frontend
HTML · CSS · JavaScript
Backend
Node.js · TypeScript · Express 5
Extração
unpdf (pdf.js)
IA
Groq (modelo configurável) · saída validada com Zod
Banco
PostgreSQL · PGlite na demonstração ou Postgres/Supabase
Arquitetura
  1. 01Navegador
  2. 02API · Express
  3. 03Extração do PDF
  4. 04Módulo de IA · Groq + Zod
  5. 05PostgreSQL

Decisões técnicas

  • IA como módulo isolado: trocar de provedor exige mudar um único arquivo.
  • Regras de negócio determinísticas ficam fora da IA.
  • PDFs escaneados, sem texto, são recusados com uma mensagem clara.
06Roadmap

Próximos passos.

Evoluções previstas na documentação do projeto. Nenhuma delas está implementada.

  • Planejado · não implementadoOCR para PDFs digitalizados
  • Planejado · não implementadoAutenticação e separação por empresa (multi-tenant com RLS no Supabase)
  • Planejado · não implementadoAlertas automáticos de vencimento via n8n (e-mail / WhatsApp)
  • Planejado · não implementadoExportação para planilha e integração com ERP

Seu processopode ser um sistema.

A CLV cria sistemas sob medida para transformar processos complexos em operações mais simples, organizadas e escaláveis.