Guia de Administração
Introdução
Hypatia é uma plataforma web desenvolvida para auxiliar no gerenciamento, catalogação e uso avanç...
O que é Hypatia?
Inspirado na tradição intelectual da figura histórica de Hipátia de Alexandria, o sistema busc...
Como me registrar?
A primeira vez que o sistema Hypatia é executado em um novo ambiente, ele automaticamente cria um...
Criação automática do Administrador
Ao rodar o sistema pela primeira vez, o Hypatia detecta a ausência de usuários no banco de dados ...
Primeiro Acesso
Ao acessar a plataforma com esse usuário padrão, o sistema automaticamente detecta que a senha ai...
⚠️ Importante
O administrador inicial terá acesso a todos os módulos do sistema: gerenciamento de usuários,...
Instalação
O sistema Hypatia pode ser instalado de forma simples tanto em ambientes locais (para testes e de...
Instalação Manual (modo local)
Este método é recomendado para testes, desenvolvimento ou uso em máquinas pessoais. O sistema é e...
Instalação Automática (Deploy com Nginx + Gunicorn)
Para ambientes de produção (como VPS Ubuntu), a instalação pode ser automatizada com o script set...
Requisitos do sistema
Python 3.8 ou superior Pip e venv instalados Git (para clonar o repositório) S...
Configuração
O sistema Hypatia utiliza envio de e-mails para funções essenciais como: Confirmação de cada...
Acessando o painel de configuração
No menu superior, clique em Administração ▾ Selecione a opção Configurações Você se...
Configuração de E-mail (SMTP)
Servidor SMTP: o endereço do servidor de envio (ex: smtp.titan.email, smtp.gmail.com) Po...
🔐 Segurança e boas práticas
A senha SMTP é armazenada de forma segura na base de dados e não é exibida depois de salva. ...
Testando o envio
Você pode testar a configuração de e-mail ao: Registrar uma nova conta (se o registro estive...
Gerenciando Usuários
O sistema Hypatia possui um painel dedicado ao gerenciamento de usuários, acessível exclusivament...
Acessando o painel de usuários
No menu superior, clique em Administração ▾ Selecione Gerenciar Usuários Você será ...
Aprovação de novos registros
Se o sistema estiver com o registro automático ativado, novos usuários poderão se registrar diret...
Atribuindo papéis
Cada usuário possui um campo chamado “papel”, que define seu nível de acesso: usuario: acess...
Editando e excluindo usuários
Além de aprovar ou alterar o papel, o administrador pode: Atualizar dados de um usuário (nom...
🔒 Segurança
Apenas administradores têm acesso à gestão de usuários. A senha dos usuários é armazenad...
Gestão do Acervo
O módulo de Administração do Acervo do Hypatia permite que os administradores gerenciem o conjunt...
Acessando o painel administrativo
No menu superior, clique em Administração ▾ Selecione a opção Administração de Catálogo ...
Adicionando novos livros
No menu superior, clique em Administração ▾ → Adicionar Livros No campo ISBN, digite ou ...
Adicionando Livros Sem ISBN
No menu superior, clique em Administração ▾ → Adicionar Livros Deixe o campo ISBN em bra...
Como funciona a busca por ISBN
Ao informar um ISBN e acionar a busca, o sistema executa uma função que: Limpa e normaliza o...
Importar ISBNs em Lote
A funcionalidade de importação em lote por ISBN permite ao administrador adicionar rapidamente vá...
Importando Catálogo por CSV
Para facilitar a catalogação em massa de obras, o Hypatia permite que administradores importem li...
Exportação de Catálogo e Relatórios
O Hypatia oferece aos administradores duas ferramentas essenciais para a gestão e documentação do...
Gerando relatórios em PDF
Além do CSV, o Hypatia permite que você gere um relatório em PDF com todos os livros registrados ...
📌 Observações
Ambos os formatos refletem o estado atual do acervo no momento da exportação. As exporta...
Gestão de Empréstimos
O módulo de Empréstimos do Hypatia oferece aos administradores controle total sobre o fluxo de ci...
Acessando o painel de empréstimos
No menu superior, clique em Administração ▾ → Gerenciar Empréstimos Você será direcionad...
Solicitando e aprovando empréstimos
Usuários autenticados podem solicitar o empréstimo de livros disponíveis diretamente na página da...
Devolvendo obras
Ao receber o livro de volta, o administrador pode: Acessar o painel de empréstimos Loca...
Informações exibidas por empréstimo:
Título da obra Nome do usuário solicitante Data da solicitação Status atual (p...
🔐 Controle de acesso
Apenas administradores têm acesso ao painel completo de empréstimos Usuários comuns pode...
📌 Boas práticas
Realize auditorias regulares no painel para manter a lista de empréstimos atualizada Uti...