Sistema-Biblioteca

---

1. Sobre
2. Funcionalidades
3. Tecnologias usadas
4. Banco de dados
5. End-points da api
6. Testes
7. Instalação
8. Licensa

Sobre

Este projeto tem como objetivo criar uma aplicação web completa para gerenciar o acervo, empréstimos e devoluções de livros em uma biblioteca. A aplicação conta com funcionalidades de login cadastro de usuários, cadastro de livros e bibliotecários.

Durante o meu aprendizado em Vue.js, percebi que o Vue.js carrega a página em branco antes de carregar o JavaScript e, consequentemente, o conteúdo da página. Após pesquisar sobre soluções para este problema, descobri o Server Side Rendering (SSR). Decidi utilizar o Nuxt, um framework baseado em Vue, para facilitar a renderização no lado do servidor e aplicar meus novos conhecimentos.

Funcionalidades

• Cadastro de usuários e bibliotecários
• Autenticação de usuários e bibliotecários com JWT (JSON Web Token)
• Gerenciamento de livros (adicionar, remover, editar e visualizar)
• Gerenciamento de empréstimos (adicionar, remover, editar e visualizar)
• Gerenciamento de arquivos de imagens para livros e fotos de usuários
• Hierarquia de funcionalidades: a edição de livros e empréstimos é permitida apenas para administradores, enquanto os usuários comuns têm acesso a requisições seguras, como GET, HEAD e OPTIONS.
• Responsividade
• Pesquisa de livros e empréstimos

Tecnologias usadas

• Front-End
  • Nuxt
  • Vue.js
  • Javascript
  • Html
  • CSS
  • Pinia
• Back-End
  • Python
  • Django rest framework
  • uWsgi
  • Nginx
  • SqlLite (Pretendo trocar no futuro para o Postgresql)

Banco de dados

Diagrama do banco de dados relacional

End-points da Api

Cadastro de usuario

• POST /cadastro/ End-poit para cadastro de usuario

Autenticação JWT(JSON Web Token)

• POST /token/ Para efetuar o login
• POST /token/refresh/ End-point para renovar o tokens
• POST /VerifyAuthenticated/ End-point para verificar se o usuarios está autenticado

User autenticado

Permissões: Apenas usuarios autenticados.

• GET /user/ Retorna dados do usuario autenticado do request
• PUT /user/{id}/ Para editar dados do usuario autenticado do resquest
• PATCH /user/{id}/Para editar parcialmente dados do usario autenticado do resquest
• DELETE /user/{id}/ Para deletar usuario logado

Gerenciamento de usuarios

Permissões: Apenas usuarios admins tem acesso.

• GET /all_users/ Para visualizar todos os usuarios do sistema
• POST /all_users/ Para cadastro de um novo usuario
• GET /all_users/{id}/ Para recuperar um usuario pelo id
• PUT /all_users/{id}/ Para alterar dados de um usuario
• PATCH /all_users/{id}/ Para alterar parcialmente dados de um usuario
• DELETE /all_users/{id}/ Para deletar um usuario

Livros

Permissões: Cadastro, editar, excluir permitido apenas para admins. Usuarios comum permitdo apenas visualização.

• GET /livros/ Para visualizar todos os livros
• POST /livros/ Para cadastrar um novo livro
• GET /livros/{id}/ Para recuperar um livro pelo id
• PUT /livros/{id}/ Para editar dados de um livro
• PATCH /livros/{id}/ Para editar parcialmente dados de um livro
• DELETE /livros/{id}/ Para deletar um livro
• GET /novoslivros/ Retorna os cinco ultimos livros retornado pelo sistema
• GET /recomendacao/ Retorna cinco livros aleatorios

Empréstimo

Permissões: Cadastro, editar, excluir permitido apenas para admins. Usuarios comum permitdo apenas visualização.

• GET /emprestimos/ Para todos visualizar emprestimos do sistema
• POST /emprestimos/ Para cadastrar um novo emprestimo
• GET /emprestimos/{id}/ Para recuperar um emprestimo especifico
• PUT /emprestimos/{id}/ Para editar um emprestimo
• PATCH /emprestimos/{id}/ Para editar parciamente um emprestimo
• DELETE /emprestimos/{id}/ Para deletar em emprestimo
• GET /usuarios/{id}/emprestimos/ Retorna todos os emprestimos relacionado ao usuario

Estrutura do servidor / Projeto

Em andamento

Testes

Para executar testes unitários entre na pasta ApiBiblioteca e digite o comando:python manage.py test

Instalação

Requisitos

• Python 3.11.4
• Venv
• Pip
• Node 18.16.0

Instalação Front-End

1. Entre na pasta biblioteca pelo terminal.
2. Instale as dependências com o comando npm install .
3. Crie um arquivo .env para configurar a url do servidor, e adicione a seguinte linha no arquivo. NUXT_PUBLIC_API_BASE_URL = "http://127.0.0.1:8000/" Essa linha poderá mudar dependendo do seu computador.
4. Para inciar o servidor: npm run dev.

Instalação Back-end

1. Entre na pasta ApiBiblioteca pelo terminal
2. Digite: python -m venv env, para criar um ambiente virtual para instalar as bibliotecas
3. Ative o ambiente virtual: source env/bin/activate
4. Agora digite: pip install -r requirements.txt, para instalar as bibliotecas
5. E finalmente rode o projeto:python manage.py runserver
6. Para cadastrar 55 livros apartir do backup python manage.py loaddata livros_backup.json

Licensa

MIT