Atlaz API e Web - Gestão de Biblioteca ✨

🧩 Sobre o Projeto

Este projeto com Back-end e Front-end, se trata de um sistema biblioteca acadêmica. Possui como principal função a gestão de livros e alunos, assim como a gestão de empréstimos desses livros que são realizados pelos alunos.

Important

👉🏻 Repositório do Back: https://github.com/AlianeAmaral/atlaz-biblioteca-API
👉🏻 Repositório do Front: https://github.com/AlianeAmaral/atlaz-biblioteca-web

💡 Sobre o Nome

🪐 O nome "Atlaz" foi escolhido com o final do nome em referência à empresa "AZ", para quem foi desenvolvido este portfólio ✨

💜 Apresentação do Sistema

---

🚀 Tecnologias Utilizadas e Pré-Requisitos

Para rodar o projeto, você precisará utilizar as seguintes tecnologias e versões utilizadas:

• Back-end:

☕ Java (21)
🌱 Spring Boot (3.4.2)
🔹 IDE: IntelliJ Community

• Front-end:

⚡ Vue.js
🎨 Tailwind CSS
🔹 IDE: VS Code

• Bancos de Dados:

🐘 PostgreSQL (dados estruturados)
🍃 MongoDB (metadados)

• Gerenciador de Dependências:

🧱 Maven
📦 NPM

---

🛠️ Técnicas Aplicadas

Este projeto foi desenvolvido com as seguintes características e boas práticas de:

• API REST.
• Arquitetura em Camadas Monolítica com Clean Architecture.
• Princípios de Responsabilidade Única (SOLID).
• Clean Code.
• Conventional Commits.
• Conexão com mais de um banco de dados.
• Configuração com Swagger para testes de back-end.
• Manipulação de arquivos.
• Navegação de telas por rotas.
• CRUDs.
• Aplicação de regras de negócio.
• Manutenibilidade para facilidade com futuras funcionalidades.

🌍 Idiomas

• Idiomas utilizados para uso e orientações no README.md:
• VS Code: Idioma PT-BR.
• IntelliJ: Idioma EN-US.

O código estará completamente em EN-US, mas a apresentação das telas do sistema estarão em PT-BR.

---

👩🏻‍💻 Funcionalidades Desenvolvidas

• Desenvolvimento da página inicial.
• Exibição dos alunos, livros e empréstimos cadastrados com fotos dos alunos e capas dos livros.
• Exbição de telas dinâmicas de mais detalhes de cada aluno ou livro selecionado.
• Possibilidade de upload de imagens e documentos (.jpg .jpeg .png .webp, pdf, entre outros).
• Possibilidade de cadastrar e editar alunos, livros e empréstimos de livros feitos por estes alunos com data de início e devolução.
• Exibição do status dos empréstimos, como: Disponível, Emprestado, Devolvido Dentro do Prazo/Fora do Prazo, Atrasado e Perdido.
• Exibição do status dos livros, como: Disponível, Emprestado, Em Falta.

---

🗄️ Configuração dos Bancos de Dados

🐘 PostgreSQL (Dados Padrão)

• Host: localhost
  
• Porta: 5432
  
• Database: atlaz_biblioteca
  
• Usuário: postgres
  
• Senha: admin12345
  

🔗 URL de Conexão: jdbc:postgresql://localhost:5432/atlaz_biblioteca

---

🍃 MongoDB (Dados Padrão)

• Host: localhost
  
• Porta: 27017
  
• Database: biblioteca_midia
  

🔗 URI de Conexão: mongodb://localhost:27017/biblioteca_midia

---

🚪 Portas da Aplicação

🚀 Execução da API: http://localhost:8081
🚀 Execução da Web: http://localhost:5173

🟢 Swagger: http://localhost:8081/swagger-ui.html

---

▶️ Para Executar o Projeto

1. Tenha as ferramentas instaladas nas versões indicadas.
2. Clone os dois repositórios nas IDEs correspondentes.
3. Para rodar o front-end, pode realizar os comandos:
   

cd atlaz-biblioteca-web
npm run dev

4. Para rodar o back-end API, pode realizar o comando "Run" através da interface.
5. Ou você pode utilizar o Docker com base nas informações acima.