Módulo Opcional — Recursos Avançados
📚

Biblioteca Jurídica

Manual completo para gerenciar o acervo bibliográfico do escritório: cadastro de obras, exemplares, empréstimos, reservas, avaliações e relatórios com inteligência artificial.

🚀

Primeiros Passos — Como Começar do Zero

Siga esta sequência para ter a biblioteca funcionando em poucos minutos

Por onde começar

Se você está abrindo a Biblioteca pela primeira vez, siga estes 5 passos em ordem:

1
Ative o módulo Vá em Configurações → Recursos Avançados e ligue o toggle da Biblioteca. Só precisa fazer isso uma vez.
2
Cadastre sua primeira obra Clique no botão + no canto inferior direito da tela e use o ISBN para preencher automaticamente título, autor, capa e sinopse em segundos.
3
Adicione exemplares físicos Abra a obra cadastrada e, na aba Exemplares, registre cada cópia com seu número de tombo e localização na prateleira.
4
Imprima as etiquetas QR Code Na mesma aba Exemplares, clique em Imprimir etiquetas. Cole as etiquetas nas capas dos livros.
5
Registre o primeiro empréstimo Use o botão Emprestar na lista de obras ou escaneie a etiqueta QR Code do livro para registrar o empréstimo diretamente.
Pronto! Com estes 5 passos o acervo já está operacional. As funcionalidades de IA, relatórios e notificações podem ser exploradas gradualmente, no seu ritmo.
⚙️

1. Ativação do Módulo

Passo obrigatório antes de começar

Pré-requisito

O módulo Biblioteca é um recurso avançado e vem desativado por padrão. Somente administradores podem ativá-lo.

  1. Acesse Configurações → Recursos Avançados no menu lateral.
  2. Localize o card "Biblioteca" e clique no toggle no canto superior direito do card para ativá-lo.
  3. O item Biblioteca aparecerá automaticamente no menu lateral para todos os usuários do escritório.
💡 Ao ativar, todos os usuários já podem acessar o acervo e fazer reservas. Apenas gestores podem cadastrar obras, registrar empréstimos e gerar relatórios.
🗺️

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:

📖 Novo Empréstimo 🔖 Nova Reserva ⭐ Nova Avaliação 📷 Escanear QR Code
💡 O botão Escanear QR Code abre a câmera do dispositivo e identifica automaticamente o exemplar — ideal para registrar empréstimos e devoluções pelo celular sem precisar digitar nada.
Para cadastrar uma nova obra, clique no botão redondo + no canto inferior direito da tela (o mesmo padrão de Despesas, Contratos e outros módulos).
📗

3. Cadastrar Obras

Livros físicos, e-books e periódicos — cada tipo tem seus próprios campos

Gestor

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:

Título Autor(es) Editora Ano Páginas Sinopse Capa Idioma
📷 Você também pode escanear o código de barras do livro com a câmera clicando no ícone de câmera ao lado do campo ISBN. O sistema identifica o ISBN e já busca os dados automaticamente.

3.3 Campos do formulário

Campo Descrição Obrigatório
TipoLivro Físico, E-book ou Periódico
TítuloNome da obra
Autor(es)Separar múltiplos autores por vírgula
ISBNCódigo de identificação (livros físicos e e-books)
EditoraNome da editora
Área JurídicaEx: Direito Civil, Trabalhista, Penal…
Edição / Ano / PáginasInformações bibliográficas
LocalizaçãoCódigo da prateleira (ex: A-12)
SinopseResumo 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:

CampoDescrição
ISSNCódigo de identificação de periódicos (formato: 0000-0000)
PeriodicidadeEx: Mensal, Trimestral, Semestral
Início/Fim da AssinaturaPeríodo de vigência da assinatura
Status da AssinaturaAtiva, Vencida ou Cancelada
⚠️ Se o ISBN já existir no acervo, o sistema avisará com um alerta amarelo e exibirá o link para a obra existente. Você ainda poderá salvar se for uma edição diferente do mesmo livro.

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.

🤖 O assistente de IA é especialmente útil para obras que não têm ISBN (apostilas, compilações internas) ou quando o livro não é encontrado no Google Books.
🏷️

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

Gestor

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

  1. Na lista do acervo, clique sobre a obra desejada para abrir a ficha detalhada.
  2. Acesse a aba Exemplares.
  3. Clique em Adicionar Exemplar.
  4. Informe o Número de Tombo (identificador único do exemplar, ex: 001, 002…).
  5. Informe o Estado da cópia: Novo, Bom, Regular ou Danificado.
  6. Informe a Localização na prateleira (opcional, ex: A-12).
  7. Clique em Salvar.

4.3 Status de cada exemplar

Disponível Emprestado Reservado Manutenção

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.

  1. Na aba Exemplares da obra, selecione os exemplares desejados (marque as caixas à esquerda de cada linha).
  2. Clique em Imprimir etiquetas selecionadas (ou selecione todos com o checkbox do cabeçalho).
  3. O sistema abre uma janela de impressão com as etiquetas prontas, incluindo título, tombo e QR Code.
  4. Escolha o número de colunas por página (2, 3 ou 4) para otimizar o papel.
  5. Imprima e cole a etiqueta na contracapa do livro.
💡 Cada QR Code contém o ID único do exemplar no formato 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:

📥 Buscar pelo ISBN (automático) 🔗 Informar URL de imagem 📤 Fazer upload de arquivo

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

Gestor

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

CampoDescrição
ObraBusque pelo título ou nome do autor
ExemplarSelecione qual cópia física será emprestada (tombo e prateleira)
DestinatárioUsuário do escritório que está levando o livro
Data de EmpréstimoPreenchida automaticamente com a data de hoje
Data de DevoluçãoPreenchida automaticamente (14 dias à frente). Pode ser ajustada.
ObservaçõesCampo livre para anotações (opcional)
💡 O prazo padrão de devolução é de 14 dias a partir da data do empréstimo. Você pode alterar essa data no momento do registro.

5.3 Acompanhando empréstimos ativos

Na aba Empréstimos, você vê todos os empréstimos com filtros por status:

Todos Ativos Atrasados Devolvidos

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

Gestor

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.

  1. Abra a ficha do livro clicando sobre ele no acervo.
  2. Acesse a aba Exemplares.
  3. Na linha do exemplar com status Emprestado, clique no botão Devolver.
  4. Confirme a ação na caixa de confirmação.
  5. O exemplar volta automaticamente ao status Disponível.
Após a devolução, o sistema verifica automaticamente se há alguma reserva pendente para aquele livro. Se houver, o próximo usuário da fila será notificado que o exemplar está 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:

  1. Localize a obra no acervo e clique sobre ela.
  2. Na ficha da obra, clique em Reservar.
  3. Opcionalmente, informe uma data de expiração para a reserva (se não informar, a reserva fica ativa sem prazo definido).
  4. Clique em Reservar.
💡 Você também pode usar o botão "Nova Reserva" no topo da tela para fazer reservas sem precisar abrir a ficha de cada obra.

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:

Pendente — aguardando exemplar disponível Confirmada — exemplar separado Cancelada / Expirada

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

  1. Clique em Nova Avaliação no topo da tela (ou abra a ficha do livro).
  2. Busque e selecione a obra desejada.
  3. Clique em 1 a 5 estrelas para indicar sua nota.
  4. Escreva um comentário (opcional) no campo de texto.
  5. Clique em Enviar Avaliação.
Avaliações de usuários comuns ficam aguardando moderação antes de aparecer publicamente. Gestores podem aprovar imediatamente marcando a opção "Aprovar imediatamente" ao enviar.

8.2 Escala de avaliação

EstrelasSignificado
⭐ 1 estrelaMuito ruim
⭐⭐ 2 estrelasRuim
⭐⭐⭐ 3 estrelasRegular
⭐⭐⭐⭐ 4 estrelasBom
⭐⭐⭐⭐⭐ 5 estrelasExcelente

8.3 Onde as avaliações aparecem

As avaliações aprovadas aparecem em dois lugares:

Na ficha detalhada de cada obra Como estrelas na listagem do acervo

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

🤖 IA

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

  1. Acesse a aba Pesquisa IA no topo da tela.
  2. Digite o que você está procurando em linguagem natural.
  3. 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
🤖 Para a pesquisa semântica funcionar bem, é recomendável que as obras tenham sinopse preenchida e, idealmente, um índice extraído por OCR. Quanto mais informações a obra tiver, mais preciso o resultado.

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:

Você: "Esse livro tem capítulo sobre responsabilidade civil objetiva?"
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

🤖 IA Vision

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

  1. Abra a ficha detalhada de uma obra clicando sobre ela no acervo.
  2. Acesse a aba Índice / OCR.
  3. Clique em Selecionar imagem e escolha uma foto do sumário do livro (pode tirar direto pelo celular).
  4. Clique em Extrair com IA e aguarde alguns segundos.
  5. Revise os tópicos extraídos — você pode editar manualmente se necessário.
  6. Clique em Salvar Índice para confirmar.
🤖 A IA consegue ler tabelas de conteúdo em português e outros idiomas, reconhecendo capítulos, seções, subseções e os números de página correspondentes. Imagens com boa iluminação geram resultados mais precisos.

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.

📸 Dicas para uma boa foto: use luz natural ou artificial uniforme, mantenha o livro aberto e plano, evite sombras sobre o texto e mantenha distância suficiente para que todos os textos fiquem nítidos.
💡

11. Sugestão de Livros por Caso (IA)

A IA analisa o caso jurídico e recomenda obras relevantes do acervo

🤖 IA

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

  1. Abra a ficha de qualquer obra no acervo.
  2. No painel lateral de IA, descreva o tipo de caso ou área jurídica em que está trabalhando.
  3. A IA analisa o acervo e retorna as obras mais relevantes, explicando por que cada uma foi recomendada.
🤖 Quanto mais obras tiverem sinopse e índice cadastrados, mais precisa será a sugestão da IA. Recomenda-se preencher a área jurídica de cada obra para melhorar as recomendações.
💡 As sugestões levam em conta apenas obras disponíveis no acervo. Obras sem exemplares disponíveis (todas emprestadas) também são sugeridas, pois o usuário pode fazer uma reserva.
🔔

12. Notificações de Atraso

O sistema alerta automaticamente sobre empréstimos vencidos

🛡️ Gestor

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:

Status: Atrasado Linha destacada em vermelho Dias em atraso informados

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.

⚠️ Recomenda-se consultar a aba de empréstimos ou o relatório de atrasos regularmente — pelo menos uma vez por semana — para manter o controle do acervo.

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

🛡️ Gestor

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

  1. Acesse a aba Relatórios.
  2. Clique no botão do relatório desejado (Circulação, Em Atraso, Acervo, Mais Populares ou Assinaturas).
  3. Os dados são carregados automaticamente na tabela abaixo.
  4. Para exportar, clique em HTML, Word ou PDF conforme necessário.
💡 O relatório HTML abre em uma nova aba para visualização e impressão. O Word é ideal para editar antes de enviar. O PDF é recomendado para arquivamento e compartilhamento formal.
🛡️

14. Moderação de Avaliações

Gestores aprovam ou rejeitam resenhas antes da publicação

🛡️ Somente Gestores

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

  1. Acesse a aba Avaliações da Biblioteca.
  2. Clique em Moderação (ou veja o contador de pendentes no topo).
  3. Para cada avaliação, leia o texto e a nota.
  4. Clique em Aprovar para publicar ou Rejeitar para remover.
AçãoResultado
AprovarA avaliação aparece publicamente na ficha do livro e conta para a média de estrelas.
RejeitarA avaliação é removida e não aparece para nenhum usuário.
💡 Gestores podem aprovar imediatamente sua própria avaliação ao enviá-la, marcando a opção "Aprovar imediatamente" no formulário de avaliação.
👥

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.

💡 A definição de "gestor" é automática: usuários com perfil de administrador da organização têm acesso completo ao módulo. Usuários padrão têm acesso restrito às funcionalidades de leitura e reserva.

Referência Rápida — Fluxo Completo

Do cadastro ao relatório em um só lugar

1
Ativar módulo Configurações → Recursos Avançados → Biblioteca (toggle ligado)
2
Cadastrar obras Botão + (canto inferior direito) → informe ISBN → busca automática via Google Books → Salvar
3
Registrar exemplares Abra a obra → aba Exemplares → Adicionar Exemplar → informe tombo e estado
4
Imprimir etiquetas QR Code Aba Exemplares → selecione exemplares → Imprimir etiquetas → cole nas capas
5
Enriquecer com IA (opcional mas recomendado) Aba Índice/OCR → foto do sumário → Extrair com IA → Salvar Índice
6
Registrar empréstimo Botão "Novo Empréstimo" (ou escanear QR) → selecionar exemplar e usuário → Registrar
7
Registrar devolução Ficha da obra → aba Exemplares → botão Devolver (ou escanear QR)
8
Acompanhar e gerar relatórios Aba Relatórios → escolher tipo → exportar em HTML, Word ou PDF