# ⚖️ Para.AI — Documentação Técnica

**Para.AI Assuntos Jurídicos API** — busca full-text sobre **5.184 assuntos jurídicos**
do CNJ indexados em Elasticsearch 8.12 com analyzer específico para o português jurídico.

---

## 🚀 Quick Start

```bash
curl "https://caarleexx-para-ai-assuntos.hf.space/busca?q=dano+moral&size=3"

curl -X POST "https://caarleexx-para-ai-assuntos.hf.space/busca-q" \
  -d '{"q":"benefício deficiência","retornar":["titulo","introducao","normas"],"topk":3}'
```

---

## 📡 Endpoints

| Endpoint | Método | p50 | Descrição |
|----------|--------|-----|-----------|
| [/busca](/busca?q=aposentadoria) | GET/POST | ~800ms | Full-text + filtros + facets |
| [/busca-q](/docs#/Busca) | GET/POST | ~74ms | Estruturada para LLMs |
| [/autocomplete](/autocomplete?q=furto) | GET | ~45ms | Sugestões por prefixo |
| [/hierarquia](/hierarquia) | GET | ~250ms | Árvore 22 ramos |
| [/grafo/filhos](/grafo/filhos?ancestor=DIREITO+PENAL) | GET | ~100ms | Drill-down |
| [/assuntos/{id}](/docs#/Assuntos) | GET | ~20ms | Documento por ID |
| [/health](/health) | GET | ~10ms | Status ES |

[Swagger UI](/docs) · [ReDoc](/redoc)

---

## 📚 Documentos

| Arquivo | Público | Conteúdo |
|---------|---------|---------|
| [README](README) | Todos | Deploy HF Spaces + Docker |
| [INFO](INFO) | Usuários | O que é, casos de uso |
| [DEV](DEV) | Devs | Stack, estrutura, env vars |
| [MODELCARD](MODELCARD) | LLM devs | Tool calling OpenAI/Anthropic |
| [FLUXOGRAMA](FLUXOGRAMA) | Devs | Fluxo de dados por endpoint |
| [ROADMAP](ROADMAP) | Todos | v1.0 → v2.0 (2027) |
| [fixes](fixes) | Devs | Diário de bordo, FIX #1 |

---

*Para.AI · v1.0.0 · MIT · CNJ dados públicos*