# Sallva.AI — Análise de Processos de Falência

> Front-end Next.js da Sallva.AI (Reasset Capital) para análise, classificação e extração de dados em processos judiciais brasileiros de falência. Plataforma legal-tech focada em oportunidades em processos falimentares. Acesso restrito a usuários autenticados via Stytch B2B.

Este arquivo é um índice de navegação para agentes LLM. As rotas e endpoints abaixo assumem que o agente já está autenticado no Sallva — o cookie de sessão é `stytch_session_jwt_next_b2b_app`. Para o mapa completo, veja [AGENTS_NAVIGATION.md](AGENTS_NAVIGATION.md) no repositório.

## Rotas do front-end

- [/app](/app): Home — busca rápida por número de processo ou nome de parte
- [/app/analise](/app/analise): Processos Cadastrados — lista paginada
- [/app/cadastrar-processos](/app/cadastrar-processos): Cadastra novo processo (TJSP raspado, demais tribunais via upload de PDFs)
- [/app/download-status](/app/download-status): Status das ingestões em fila
- [/app/ranking-processos](/app/ranking-processos): Ranking de processos por score, com filtros e exportação
- [/app/buscar-em-processo](/app/buscar-em-processo): Busca Unificada (precisa de `?numero=&nome=` na query string)
- [/app/caso/{numero}/detalhe-processo](/app/caso/{numero}/detalhe-processo): Hub do caso — metadados, score, anotações
- [/processos/{processId}/autos](/processos/{processId}/autos): Visualizador de Autos — núcleo do produto (PDF + OCR + bounding boxes)
- [/app/classificador](/app/classificador): Classificador de Documentos (tabs: Labels, Dataset, Tags)
- [/app/extratores](/app/extratores): Lista de extratores baseados em LLM por label
- [/app/extratores/editor?labelId={id}](/app/extratores/editor): Editor de extrator (Prompt, Schema, Versões)
- [/app/validacao-documentos](/app/validacao-documentos): Validação humana das classificações
- [/app/favoritos](/app/favoritos): Processos marcados como favoritos
- [/app/transactions](/app/transactions): Pipeline de ingestão (requer role `sallva.full`)
- [/app/dinheiro-em-caixa-execucao](/app/dinheiro-em-caixa-execucao): Execução / caixa (requer role `sallva.full`)

## Endpoints de API (base: `NEXT_PUBLIC_FALENCIAS_API_URL`)

- `GET /api/search/ocr?query={termo}`: busca rápida por número de processo ou nome de parte; aceita frase exata entre aspas duplas
- `GET /api/search?processoNumber={X}&term={Y}`: busca unificada (processo principal + todos os incidentes); aceita frase exata
- `GET /api/document-viewer/{processId}/pages/{pageId}/text`: retorna `{ text }` — texto OCR puro da página. **Sempre prefira isso a screenshots.**
- `GET /api/document-viewer/{processNumber}/pages/{pageNumber}/search?query={termo}`: bounding boxes do termo na página
- `GET /api/processos/{processId}/detalhes`: metadados do processo (CNPJ, vara, juiz, valor da causa, movimentações)
- `GET /api/search/ocr/incidentes?numeroProcesso={N}`: lista os incidentes vinculados ao processo principal

## Convenções importantes

### Busca de termos
- **Frase exata**: envolva com aspas duplas — `"Industria Brasileira"`. Exemplo literal da UI da Home.
- **Tokens livres**: sem aspas (`industria brasileira`) — ranqueamento por relevância.
- Sempre use `"` (U+0022), nunca aspas tipográficas (`"`, `"`).

### Leitura de conteúdo
- Para obter texto de uma página, **chame `/api/document-viewer/{processId}/pages/{pageId}/text`**. Evita re-OCR, evita parsing de DOM, evita screenshot.
- O `pageId` é o `image.id` (não o número visual da página) — vem de `ImageContext.fetchImageIds`.
- A UI também expõe esse texto na aba "OCR" de cada página do viewer.

### Formato de número de processo
- Padrão CNJ: `0000000-00.0000.0.00.0000`.
- Os dígitos `14-15` identificam o tribunal — `8.26` = TJSP, único com raspagem automática. Demais tribunais exigem upload manual de PDFs.

### Roles
- Role padrão: usuário autenticado vê todas as telas listadas (exceto duas).
- Role `sallva.full`: necessária para `/app/transactions` e `/app/dinheiro-em-caixa-execucao`.