Primeiros Passos — Como Começar do Zero
Siga esta sequência para ter a biblioteca funcionando em poucos minutos
Se você está abrindo a Biblioteca pela primeira vez, siga estes 5 passos em ordem:
1. Ativação do Módulo
Passo obrigatório antes de começar
O módulo Biblioteca é um recurso avançado e vem desativado por padrão. Somente administradores podem ativá-lo.
- Acesse Configurações → Recursos Avançados no menu lateral.
- Localize o card "Biblioteca" e clique no toggle no canto superior direito do card para ativá-lo.
- O item Biblioteca aparecerá automaticamente no menu lateral para todos os usuários do escritório.
2. Visão Geral da Tela
Entenda a estrutura do módulo antes de começar a usar
Ao acessar Biblioteca pelo menu lateral, você verá a tela principal dividida em abas:
| Aba | O que mostra | Quem acessa |
|---|---|---|
| 📚 Acervo | Todos os livros, e-books e periódicos cadastrados, com capa, disponibilidade e avaliação. | Todos os usuários |
| 📖 Empréstimos | Lista de empréstimos ativos (e histórico), com filtros por status. | Gestores |
| 🔖 Reservas | Reservas pendentes e confirmadas, com opção de convertê-las em empréstimo. | Gestores |
| ⭐ Avaliações | Resenhas públicas e fila de moderação das avaliações pendentes. | Gestores (moderação) |
| 🔍 Pesquisa IA | Busca semântica por conteúdo: encontra obras por tema, não apenas por título. | Todos os usuários |
| 📊 Relatórios | Circulação, acervo, livros mais populares, periódicos e empréstimos em atraso. | Gestores |
Barra superior de ações rápidas
No topo da tela, você encontra os botões principais:
3. Cadastrar Obras
Livros físicos, e-books e periódicos — cada tipo tem seus próprios campos
3.1 Como acessar
Clique no botão flutuante + no canto inferior direito da tela para abrir o formulário de cadastro.
3.2 Buscando pelo ISBN automaticamente
O campo ISBN é a forma mais rápida de cadastrar um livro. Ao digitar o número e clicar no ícone de código de barras ao lado do campo, o sistema consulta o Google Books e preenche automaticamente:
3.3 Campos do formulário
| Campo | Descrição | Obrigatório |
|---|---|---|
| Tipo | Livro Físico, E-book ou Periódico | ✓ |
| Título | Nome da obra | ✓ |
| Autor(es) | Separar múltiplos autores por vírgula | — |
| ISBN | Código de identificação (livros físicos e e-books) | — |
| Editora | Nome da editora | — |
| Área Jurídica | Ex: Direito Civil, Trabalhista, Penal… | — |
| Edição / Ano / Páginas | Informações bibliográficas | — |
| Localização | Código da prateleira (ex: A-12) | — |
| Sinopse | Resumo da obra | — |
3.4 Campos exclusivos por tipo de obra
E-book: além dos campos padrão, informe a URL ou caminho do arquivo para acesso digital.
Periódico: aparecem campos adicionais para controle de assinatura:
| Campo | Descrição |
|---|---|
| ISSN | Código de identificação de periódicos (formato: 0000-0000) |
| Periodicidade | Ex: Mensal, Trimestral, Semestral |
| Início/Fim da Assinatura | Período de vigência da assinatura |
| Status da Assinatura | Ativa, Vencida ou Cancelada |
3.5 Assistente de IA para preenchimento
No formulário de cadastro há um botão de IA (ícone de estrela/faísca) que permite descrever o livro em linguagem natural. Por exemplo: "Livro de Direito do Trabalho, 3ª edição, de Maurício Godinho" — e a IA extrai e preenche os campos automaticamente.
4. Exemplares Físicos e Etiquetas QR Code
Cada cópia física de um livro é um exemplar independente com seu próprio número de tombo
4.1 O que é um exemplar?
Uma obra pode ter várias cópias físicas. Por exemplo, o livro "Código Civil Comentado" pode ter 3 exemplares no acervo. Cada exemplar é registrado separadamente, com seu próprio número de tombo e localização.
4.2 Adicionando exemplares a uma obra
- Na lista do acervo, clique sobre a obra desejada para abrir a ficha detalhada.
- Acesse a aba Exemplares.
- Clique em Adicionar Exemplar.
- Informe o Número de Tombo (identificador único do exemplar, ex: 001, 002…).
- Informe o Estado da cópia: Novo, Bom, Regular ou Danificado.
- Informe a Localização na prateleira (opcional, ex: A-12).
- Clique em Salvar.
4.3 Status de cada exemplar
O status é atualizado automaticamente quando um empréstimo é registrado ou uma devolução é confirmada. Não é necessário alterar manualmente.
4.4 Imprimindo etiquetas QR Code
As etiquetas são geradas automaticamente para cada exemplar e permitem identificar o livro rapidamente com a câmera do celular.
- Na aba Exemplares da obra, selecione os exemplares desejados (marque as caixas à esquerda de cada linha).
- Clique em Imprimir etiquetas selecionadas (ou selecione todos com o checkbox do cabeçalho).
- O sistema abre uma janela de impressão com as etiquetas prontas, incluindo título, tombo e QR Code.
- Escolha o número de colunas por página (2, 3 ou 4) para otimizar o papel.
- Imprima e cole a etiqueta na contracapa do livro.
biblioteca:copy:{id}. Ao escanear, o sistema identifica automaticamente de qual livro se trata e qual cópia específica está sendo emprestada ou devolvida.
4.5 Atualizando a capa do livro
Na ficha detalhada de uma obra, é possível atualizar a imagem da capa de três formas:
Clique no ícone de lápis que aparece ao passar o mouse sobre a capa para acessar essas opções.
5. Registrar Empréstimos
Três formas de registrar um empréstimo: pelo acervo, pelo botão de ação ou pelo QR Code
5.1 Formas de registrar um empréstimo
Há três caminhos para registrar um empréstimo no sistema:
Pela ficha da obra
Abra o livro no acervo e clique em Emprestar. O exemplar já fica pré-selecionado.
Pelo botão de ação rápida
Clique em "Novo Empréstimo" no topo da tela e busque o livro pelo título ou autor.
Pelo QR Code
Clique em Escanear QR Code e aponte a câmera para a etiqueta do livro — o empréstimo é iniciado automaticamente.
5.2 Preenchendo o formulário de empréstimo
| Campo | Descrição |
|---|---|
| Obra | Busque pelo título ou nome do autor |
| Exemplar | Selecione qual cópia física será emprestada (tombo e prateleira) |
| Destinatário | Usuário do escritório que está levando o livro |
| Data de Empréstimo | Preenchida automaticamente com a data de hoje |
| Data de Devolução | Preenchida automaticamente (14 dias à frente). Pode ser ajustada. |
| Observações | Campo livre para anotações (opcional) |
5.3 Acompanhando empréstimos ativos
Na aba Empréstimos, você vê todos os empréstimos com filtros por status:
Empréstimos em atraso são marcados automaticamente com destaque vermelho para facilitar a identificação.
6. Registrar Devoluções
Confirme a devolução pela ficha do livro ou escaneando a etiqueta
6.1 Como registrar uma devolução
Há duas formas principais:
Pela ficha da obra
Abra o livro no acervo → aba Exemplares → localize o empréstimo ativo → clique em Registrar Devolução.
Pelo QR Code
Clique em Escanear QR Code e aponte para a etiqueta do livro. O sistema identifica o exemplar e pergunta se deseja registrar a devolução.
- Abra a ficha do livro clicando sobre ele no acervo.
- Acesse a aba Exemplares.
- Na linha do exemplar com status Emprestado, clique no botão Devolver.
- Confirme a ação na caixa de confirmação.
- O exemplar volta automaticamente ao status Disponível.
7. Reservas de Obras
Usuários podem reservar livros emprestados para serem avisados quando ficarem disponíveis
7.1 Como fazer uma reserva (usuário comum)
Qualquer usuário pode reservar uma obra, mesmo que ela esteja disponível:
- Localize a obra no acervo e clique sobre ela.
- Na ficha da obra, clique em Reservar.
- Opcionalmente, informe uma data de expiração para a reserva (se não informar, a reserva fica ativa sem prazo definido).
- Clique em Reservar.
7.2 Gestores podem reservar em nome de outros
Gestores veem um campo adicional "Usuário" no formulário de reserva, o que permite criar reservas em nome de qualquer usuário do escritório.
7.3 Acompanhando reservas
Na aba Reservas, os gestores veem todas as reservas do escritório com status:
7.4 Convertendo reserva em empréstimo
Quando o exemplar ficar disponível e o usuário for buscar o livro, o gestor pode converter a reserva diretamente em empréstimo sem precisar criar um novo registro.
8. Avaliações e Resenhas
Usuários compartilham suas opiniões sobre as obras — com moderação antes da publicação
8.1 Como avaliar uma obra
- Clique em Nova Avaliação no topo da tela (ou abra a ficha do livro).
- Busque e selecione a obra desejada.
- Clique em 1 a 5 estrelas para indicar sua nota.
- Escreva um comentário (opcional) no campo de texto.
- Clique em Enviar Avaliação.
8.2 Escala de avaliação
| Estrelas | Significado |
|---|---|
| ⭐ 1 estrela | Muito ruim |
| ⭐⭐ 2 estrelas | Ruim |
| ⭐⭐⭐ 3 estrelas | Regular |
| ⭐⭐⭐⭐ 4 estrelas | Bom |
| ⭐⭐⭐⭐⭐ 5 estrelas | Excelente |
8.3 Onde as avaliações aparecem
As avaliações aprovadas aparecem em dois lugares:
A nota exibida nos cards do acervo é a média das avaliações aprovadas.
9. Pesquisa Semântica com IA
Encontre obras pelo conteúdo, não apenas pelo título — a IA entende o que você quer dizer
A pesquisa semântica usa inteligência artificial para entender o significado da sua busca, não apenas as palavras exatas. Isso permite encontrar obras mesmo sem lembrar o título correto.
9.1 Como usar
- Acesse a aba Pesquisa IA no topo da tela.
- Digite o que você está procurando em linguagem natural.
- Clique em Buscar e aguarde o resultado.
9.2 Exemplos de buscas que funcionam
| Você digita… | O sistema encontra… |
|---|---|
| "livros sobre rescisão de contrato de trabalho" | Obras de Direito Trabalhista com tópicos sobre rescisão |
| "jurisprudência STJ família" | Periódicos e coletâneas sobre Direito de Família |
| "indenização por danos morais" | Obras de Direito Civil e Responsabilidade Civil |
| "processo penal prisão preventiva" | Livros de Direito Processual Penal |
9.3 Chat com o livro
Na ficha detalhada de uma obra, há um painel de chat com a IA. Você pode fazer perguntas como:
IA: "Sim, o Capítulo 7 (p. 183) trata especificamente de responsabilidade civil objetiva..."
Você: "Quais são os principais temas abordados?"
IA: "O livro aborda: contratos, obrigações, responsabilidade civil..."
Esse chat utiliza o índice da obra (se extraído por OCR) para dar respostas precisas sobre o conteúdo.
10. Extração de Índice por OCR (IA Vision)
Fotografe o sumário do livro e a IA extrai os tópicos e páginas automaticamente
Esta funcionalidade usa visão computacional (GPT-4o Vision) para ler a imagem do sumário ou índice de um livro e gerar automaticamente uma lista estruturada de tópicos com suas páginas correspondentes.
10.1 Como extrair o índice
- Abra a ficha detalhada de uma obra clicando sobre ela no acervo.
- Acesse a aba Índice / OCR.
- Clique em Selecionar imagem e escolha uma foto do sumário do livro (pode tirar direto pelo celular).
- Clique em Extrair com IA e aguarde alguns segundos.
- Revise os tópicos extraídos — você pode editar manualmente se necessário.
- Clique em Salvar Índice para confirmar.
10.2 Para que serve o índice extraído?
Pesquisa semântica mais precisa
O índice enriquece o perfil da obra, tornando as buscas por conteúdo muito mais eficientes.
Chat com o livro
O assistente de IA usa o índice para responder perguntas sobre quais tópicos estão no livro e em quais páginas.
Sugestão por caso
A IA consegue sugerir obras relevantes para um caso jurídico com base nos tópicos do índice.
11. Sugestão de Livros por Caso (IA)
A IA analisa o caso jurídico e recomenda obras relevantes do acervo
Na ficha detalhada de uma obra, o painel de IA de Sugestões permite que você informe um caso jurídico e receba recomendações de leitura personalizadas com base no acervo disponível.
11.1 Como funciona
- Abra a ficha de qualquer obra no acervo.
- No painel lateral de IA, descreva o tipo de caso ou área jurídica em que está trabalhando.
- A IA analisa o acervo e retorna as obras mais relevantes, explicando por que cada uma foi recomendada.
12. Notificações de Atraso
O sistema alerta automaticamente sobre empréstimos vencidos
O sistema monitora automaticamente os prazos de devolução e identifica empréstimos em atraso. Há dois mecanismos de alerta:
12.1 Destaque visual na interface
Na aba Empréstimos, todos os empréstimos com prazo vencido aparecem com:
12.2 Relatório de atrasos
Na aba Relatórios, o relatório "Empréstimos em Atraso" lista todos os casos com o nome do usuário, data de vencimento e quantidade de dias em atraso — facilitando o acompanhamento e a cobrança.
12.3 Acompanhamento de assinaturas de periódicos
Para periódicos com data de assinatura cadastrada, o sistema exibe um relatório "Assinaturas" que informa quantos dias restam até o vencimento. Assinaturas com menos de 30 dias são destacadas em laranja para chamar atenção.
13. Relatórios
Cinco relatórios para acompanhar e gerenciar o acervo com precisão
Os relatórios estão na aba Relatórios da Biblioteca. Cada relatório pode ser exportado em HTML, Word ou PDF.
| Relatório | O que mostra | Uso principal |
|---|---|---|
| 📋 Circulação | Histórico de todos os empréstimos: obra, usuário, prazo e status (ativo, devolvido, atrasado). | Auditoria e controle geral |
| 🚨 Em Atraso | Empréstimos vencidos com nome do usuário, data de vencimento e dias em atraso. | Cobrança de devoluções |
| 📚 Acervo | Todas as obras com total de exemplares, exemplares disponíveis e quem está com cada cópia emprestada. | Inventário do acervo |
| 🏆 Mais Populares | Obras ordenadas pelo número de empréstimos, com o último leitor. | Análise de uso do acervo |
| 📰 Assinaturas | Periódicos com periodicidade, data de vencimento e dias restantes de assinatura. | Renovação de assinaturas |
Como gerar um relatório
- Acesse a aba Relatórios.
- Clique no botão do relatório desejado (Circulação, Em Atraso, Acervo, Mais Populares ou Assinaturas).
- Os dados são carregados automaticamente na tabela abaixo.
- Para exportar, clique em HTML, Word ou PDF conforme necessário.
14. Moderação de Avaliações
Gestores aprovam ou rejeitam resenhas antes da publicação
Toda avaliação enviada por um usuário comum fica em fila de moderação. Gestores recebem o contador de avaliações pendentes na interface e podem aprovar ou rejeitar cada uma.
Como moderar avaliações
- Acesse a aba Avaliações da Biblioteca.
- Clique em Moderação (ou veja o contador de pendentes no topo).
- Para cada avaliação, leia o texto e a nota.
- Clique em Aprovar para publicar ou Rejeitar para remover.
| Ação | Resultado |
|---|---|
| Aprovar | A avaliação aparece publicamente na ficha do livro e conta para a média de estrelas. |
| Rejeitar | A avaliação é removida e não aparece para nenhum usuário. |
15. Perfis de Usuário e Permissões
O que cada perfil pode fazer no módulo Biblioteca
Usuário Comum
Consulta o acervo, faz reservas, envia avaliações (com moderação), usa a pesquisa semântica e acessa o chat com IA.
Gestor / Administrador
Acesso total: cadastra obras, gerencia exemplares, registra e finaliza empréstimos, modera avaliações e gera relatórios.
Tabela detalhada de permissões
| Funcionalidade | Usuário | Gestor |
|---|---|---|
| Visualizar acervo | ✓ | ✓ |
| Pesquisa semântica (IA) | ✓ | ✓ |
| Chat com o livro (IA) | ✓ | ✓ |
| Fazer reservas | ✓ | ✓ |
| Enviar avaliações | ✓ * | ✓ |
| Cadastrar novas obras | ✗ | ✓ |
| Gerenciar exemplares | ✗ | ✓ |
| Registrar empréstimos | ✗ | ✓ |
| Registrar devoluções | ✗ | ✓ |
| Gerar etiquetas QR Code | ✗ | ✓ |
| Extrair índice por OCR | ✗ | ✓ |
| Moderar avaliações | ✗ | ✓ |
| Reservar para outro usuário | ✗ | ✓ |
| Gerar relatórios | ✗ | ✓ |
* Avaliações de usuários comuns aguardam aprovação do gestor antes de serem publicadas.
Referência Rápida — Fluxo Completo
Do cadastro ao relatório em um só lugar