Idioma: Português brasileiro com acentuação correta. "eh" em vez de "é" é inaceitável.
Plataforma de automação jurídica brasileira. Extração de documentos PDF, análise com LLM, e organização de dados jurídicos.
Nota: O diretório
legal-workbench/é o nome de código interno do projeto Lex-Vector.
| Camada | Tecnologia |
|---|---|
| Frontend | Next.js 15, React 19, TypeScript, Tailwind, Shadcn/UI |
| Backend | Python 3.12, FastAPI |
| PDF Extraction | Marker (deep learning), pdfplumber (fallback) |
| Busca Vetorial | Rust (stj-vec), SQLite + sqlite-vec, BGE-M3 (1024d) |
| Embedding | Modal (TEI/FlagEmbedding em GPU), Ollama (local) |
| LLM | Google Gemini |
| Database | PostgreSQL (Supabase), SQLite (stj-vec) |
| Package Managers | Bun (frontend), uv (backend) |
| Containers | Docker, Docker Compose |
legal-workbench/
├── frontend/ # Next.js SPA
├── ferramentas/ # Python backends e tools
│ └── legal-text-extractor/ # LTE (Marker + Gemini)
├── docker/ # Serviços Docker
└── docs/ # Documentação
stj-vec/ # Busca vetorial sobre jurisprudência STJ
├── crates/ # Rust workspace (core, ingest, server)
├── modal/ # Scripts Modal (embedding GPU em cloud)
├── scripts/ # Utilitários Python
├── db/ # SQLite com chunks + embeddings
└── config.toml # Configuração
| Serviço | Porta | Propósito |
|---|---|---|
| legal-frontend | 3000 | Interface Next.js |
| legal-api | 8000 | API principal |
| stj-vec-server | 8421 | Busca vetorial STJ (Rust/Axum) |
# Subir ambiente
cd legal-workbench && docker compose up -d
# Frontend dev
cd legal-workbench/frontend && bun install && bun run dev
# LTE dev
cd legal-workbench/ferramentas/legal-text-extractor && source .venv/bin/activate && python main.py| Arquivo | Conteúdo |
|---|---|
CLAUDE.md |
Regras operacionais para Claude Code |
ARCHITECTURE.md |
North Star (princípios invioláveis) |
legal-workbench/CLAUDE.md |
Regras específicas do LV |
- Swarm: Tarefas médio-complexas com subagentes paralelos
- Breakdown: Decompor tarefas grandes em unidades atômicas antes da execução
Terminologia: "Subagentes" são Task tools (
.claude/agents/*.md) executados via Claude Code. "Agentes" ADK autônomos estão em repositório separado.
OBRIGATÓRIO:
- Branch para alterações significativas — >3 arquivos OU mudança estrutural = criar branch
- Pull antes de trabalhar —
git pull origin main - Commit ao finalizar — Nunca deixar trabalho não commitado
- Deletar branch após merge — Local e remota
Projetos experimentais foram migrados para claude-experiments.