Skip to content

allanfenelon/juris-ai-engine

Repository files navigation

Juris AI Engine

Hybrid Legal Decision Engine powered by LLMs and Business Rules

Juris AI Engine é um sistema híbrido de decisão jurídica projetado para automatizar a análise de processos judiciais a partir de dados estruturados e documentos textuais.

A solução combina:

  • Política de Negócio estruturada
  • Orquestração com Large Language Models (LLMs)
  • API REST escalável
  • Interface interativa para validação humana
  • Camada de monitoramento e logging

O sistema consolida decisões em três classes:

approved | rejected | incomplete

🏗️ Arquitetura do Sistema

A arquitetura segue o padrão de separação de responsabilidades:

🔹 API Layer

  • Implementada com FastAPI
  • Responsável por validação, exposição de endpoints e padronização de respostas

🔹 Decision Engine

  • Orquestração via LangChain
  • LLM utilizado: Google Gemini
  • Aplicação de regras de política + consolidação da decisão

🔹 Interface de Validação

  • Desenvolvida em Streamlit
  • Permite inspeção de inputs e outputs do modelo

🔹 Observabilidade

  • Logging estruturado
  • Endpoint de health check
  • Monitoramento de status da aplicação

🌐 Deploy Público

A aplicação encontra-se publicada para demonstração:

  • Interface (Streamlit): (DESATIVADO) https://dashboard-juscash.up.railway.app/

  • API – Swagger Docs: (DESATIVADO) https://api-juscash.up.railway.app/docs

  • Health Check: (DESATIVADO) https://api-juscash.up.railway.app/health/


💻 Execução Local

Endpoints locais

  • UI: http://localhost:8501
  • API Docs: http://localhost:8000/docs
  • Health: http://localhost:8000/health

🛠️ Stack Tecnológica

Camada Tecnologia
Backend Python + FastAPI
Interface Streamlit
LLM Google Gemini
Orquestração LangChain
Validação de Dados Pydantic
Containerização Docker
Deploy Railway
Observabilidade Logging customizado

⚙️ Variáveis de Ambiente

Crie um arquivo .env baseado em .env.example:

GOOGLE_API_KEY="SUA_API_KEY_AQUI"
API_BASE_URL="http://localhost:8000"

🚀 Execução com Docker

# Build
docker-compose build

# Run
docker-compose up

Modo detached:

docker-compose up -d

Logs:

docker logs juris-ai-engine

🔗 Endpoints Principais

Health Check

GET /health

Resposta:

{
  "status": "ok",
  "timestamp": "2025-10-24T17:30:00.000Z"
}

Análise de Processo Judicial

POST /processes/analyze

Input (resumido)

{
  "numeroProcesso": "0001234-56.2023.4.05.8100",
  "classe": "...",
  "documentos": [...],
  "movimentos": [...]
}

Output

{
  "decision": "approved",
  "rationale": "Structured justification generated from policy alignment and document analysis.",
  "citacoes": ["POL-1", "POL-2"]
}

🎯 Objetivo Técnico do Projeto

Este projeto demonstra:

  • Integração de LLMs em pipelines de decisão estruturada
  • Design de APIs robustas para sistemas de IA
  • Aplicação de regras de negócio sobre dados jurídicos
  • Estruturação de respostas rastreáveis (justificativa + citações)
  • Deploy containerizado com separação clara de camadas

About

juris-ai-engine é um motor de decisão jurídica que automatiza a análise de processos judiciais por meio da integração entre Large Language Models (LLMs) e regras formais de negócio.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages