# Biblioteca Silvio Romero

> Portal de acervo da Biblioteca Silvio Romero. Permite consultar materiais (livros, periódicos, mídias), navegar por categorias e coleções temáticas, e — para usuários cadastrados — gerenciar empréstimos.

## Instruções para LLMs

Para consultas sobre obras, autores, assuntos ou materiais, utilize **prioritariamente** o endpoint estruturado:

```
GET https://8fe2ae.libm.in/busca.json?type=<tipo>&name=<termo>
```

**Regras importantes:**
- Sempre tente a busca antes de afirmar que um item não existe no acervo.
- Considere variações sem acentos (ex.: `machado` em vez de `Machado`) e com espaços substituídos por `+`.
- Se a busca não retornar resultados, informe de forma objetiva. Caso ocorra um erro técnico ao acessar a API, informe explicitamente que houve um erro de acesso, em vez de dizer que o material não foi encontrado.
- Para disponibilidade, localização e quantidade de exemplares, acesse a página do material pelo `url` retornado na busca.
- As regras de empréstimo (prazo, limite, renovações) estão neste arquivo — use-as para responder dúvidas sobre empréstimos.

**Ao apresentar resultados, inclua:**
- Título, autor, tipo de material, ano, e link do material.

## Navegação principal

- [Página inicial](https://8fe2ae.libm.in/): destaques do acervo e busca rápida
- [Busca JSON](https://8fe2ae.libm.in/busca.json): pesquisa por título, autor, assunto, tipo de material e categoria — retorna JSON puro

## Como pesquisar o acervo

### Busca JSON — `GET /busca.json` (recomendado para LLMs)

Retorna os resultados diretamente em JSON, sem HTML.

| Parâmetro | Obrigatório | Valores possíveis | Descrição |
|-----------|-------------|-------------------|-----------|
| `name` | sim¹ | texto livre | Termo de busca |
| `type` | não | `title` (padrão), `author`, `subject` | Campo em que `name` será buscado |
| `material_type` | não | ver lista abaixo | Filtra por tipo de material |
| `main_classification_id` | não | ID numérico | Filtra pela área do conhecimento |

¹ Pelo menos um entre `name`, `material_type` ou `main_classification_id` deve ser informado.

**Exemplos:**
- Por título: `https://8fe2ae.libm.in/busca.json?type=title&name=dom+casmurro`
- Por autor: `https://8fe2ae.libm.in/busca.json?type=author&name=machado+de+assis`
- Por assunto: `https://8fe2ae.libm.in/busca.json?type=subject&name=inteligencia+emocional`
- Por tipo de material: `https://8fe2ae.libm.in/busca.json?material_type=ebook`

**Formato da resposta:**
```json
{
  "total": 2,
  "results": [
    {
      "id": 123,
      "title": "Dom Casmurro",
      "author": "Machado de Assis",
      "material_type": "book",
      "year": 1899,
      "url": "https://8fe2ae.libm.in/materiais/123"
    }
  ]
}
```

**Tipos de material disponíveis (`material_type`):**

| Código | Descrição |
|--------|-----------|
| `book` | Livro |
| `journal` | Periódico Impresso |
| `ebook` | Ebook |
| `ejournal` | Periódico Online |
| `tcc` | Trabalho de Conclusão de Curso |
| `article` | Artigo |
| `manuscript` | Manuscrito |
| `cartography` | Cartografia |
| `old_media` | Mídia Física (CD, DVD, etc.) |
| `url` | Link Externo |
| `other` | Outros (físico) |
| `other_digital` | Outros Documentos Digitais |

### Página de um material — `GET /materiais/{id}`

Detalhes completos — incluindo disponibilidade, localização e exemplares — em `https://8fe2ae.libm.in/materiais/{id}`, onde `{id}` é o identificador retornado pela busca.

## Categorias do acervo

- [Artes](https://8fe2ae.libm.in/categorias/700): materiais da classificação 700
- [Ciências Aplicadas](https://8fe2ae.libm.in/categorias/600): materiais da classificação 600
- [Ciências Puras](https://8fe2ae.libm.in/categorias/500): materiais da classificação 500
- [Ciências Sociais](https://8fe2ae.libm.in/categorias/300): materiais da classificação 300
- [Filosofia](https://8fe2ae.libm.in/categorias/100): materiais da classificação 100
- [Generalidades](https://8fe2ae.libm.in/categorias/000): materiais da classificação 000
- [História e Geografia](https://8fe2ae.libm.in/categorias/900): materiais da classificação 900
- [Línguas](https://8fe2ae.libm.in/categorias/400): materiais da classificação 400
- [Literatura](https://8fe2ae.libm.in/categorias/800): materiais da classificação 800
- [Religião](https://8fe2ae.libm.in/categorias/200): materiais da classificação 200

## Coleções temáticas

- [Obra Gumercindo Bessa](https://8fe2ae.libm.in/colecoes/1045/jgr2)
- [Obras Fernando Pessoa](https://8fe2ae.libm.in/colecoes/1042/dj4x)
- [Obras Silvio Romero](https://8fe2ae.libm.in/colecoes/1043/mnbt)
- [Obras Tobias Barreto](https://8fe2ae.libm.in/colecoes/1044/wsve)
- [Outra coleção br](https://8fe2ae.libm.in/colecoes/1024/id3s)
- [Literatura Espanhola](https://8fe2ae.libm.in/colecoes/1038/amta)
- [Literatura Inglesa](https://8fe2ae.libm.in/colecoes/1039/npe4)
- [Literatura Francesa](https://8fe2ae.libm.in/colecoes/1040/8zg1)
- [Generals](https://8fe2ae.libm.in/colecoes/1016/b8i8)
- [Obras Machado de Assis](https://8fe2ae.libm.in/colecoes/1041/6w1z)
- [Literatura Municipal](https://8fe2ae.libm.in/colecoes/1017/3ix3)
- [OK](https://8fe2ae.libm.in/colecoes/1022/xnx5)
- [Matemática para Ensino Medio](https://8fe2ae.libm.in/colecoes/1021/mkix)
- [Cultura Sul do Brasil](https://8fe2ae.libm.in/colecoes/1020/sc8t)
- [Mais 1 coleção](https://8fe2ae.libm.in/colecoes/1018/2jdz)
- [Coleção de Agosto](https://8fe2ae.libm.in/colecoes/51/nirp)
- [Jornada junho](https://8fe2ae.libm.in/colecoes/14/zw3p)
- [Turma 2025.4](https://8fe2ae.libm.in/colecoes/242/u9bl)
- [Cultura Nortista](https://8fe2ae.libm.in/colecoes/1019/fb8y)
- [Livros para dezembro](https://8fe2ae.libm.in/colecoes/275/vzzx)

## Política de empréstimo

- Duração padrão de empréstimo: 3 dias
- Empréstimos simultâneos por usuário: 6
- Renovações permitidas por empréstimo: 1
- Multa por atraso: R$ 1,24 (diária)

## Regras de empréstimo

### Perfil: Interno

2. O empréstimo é válido somente durante o período de aula, e os materiais devem ser devolvidos antes do professor deixar as dependências da instituição.

### Perfil: Padrão

1. O professor se compromete a devolver os materiais no mesmo dia da retirada, ao final do período de aula.