Skip to content

Latest commit

 

History

History
82 lines (62 loc) · 2.7 KB

README.md

File metadata and controls

82 lines (62 loc) · 2.7 KB

Sistema de Agendamento de Livros

📖 Sobre o Projeto

Esse projeto se trata de uma aplicação Web desenvolvida em PHP, usando o padrão de arquitetura MVC. Seu objetivo é facilitar a gestão de agendamentos de livros em bibliotecas, permitindo que usuários realizem reservas e administradores gerenciem os agendamentos.

🚀 Funcionalidades

📌 Funcionalidades Gerais:

  • Cadastro e login de usuários;
  • Visualização dos livros cadastrados no sistema e suas informações;
  • Realização do agendamento de livros disponíveis e sua devolução;
  • Visualização do histórico de agendamentos;
  • Alterar idioma do sistema entre português e inglês.

📌 Funcionalidades para Administradores:

  • Cadastrar novos gêneros e livros no sistema;
  • Visualizar todos os agendamentos feitos no sistema;
  • Gerenciar todos os usuários cadastrados;
  • Excluir livros que ainda não tenham sido agendados;
  • Excluir gêneros que não possuam livros vinculados;
  • Tornar um livro inativo caso não esteja em agendamento;
  • Modificar o título e o gênero dos livros.

🛠️ Tecnologias Utilizadas

  • Linguagem: PHP e JavaScript
  • Banco de Dados: MySQL
  • Arquitetura: MVC (Model-View-Controller)
  • Containerização: Docker + Docker Compose

📂 Como Executar o Projeto

1️⃣ Clonando o Repositório:

 git clone https://github.com/viniciuscassemira/PHP_MVC_Library.git
 cd PHP_MVC_Library

2️⃣ Executando o Projeto

🔹 Via Docker Compose (Recomendado)

Requisitos:
  • Docker e Docker Compose instalados
Passos:
  1. Navegue até a raiz do projeto (onde está o compose.yaml).
  2. Execute o seguinte comando:
docker-compose up -d --build

Isso iniciará os contêineres da aplicação e do banco de dados automaticamente.

  • Acesse a aplicação em: http://localhost:8080

🔹 Manualmente (Sem Docker)

Requisitos:
  • PHP instalado no servidor/local
  • MySQL ou outro gerenciador de banco de dados compatível
  • Servidor local como XAMPP ou WAMP
Passos:
  1. Crie um banco de dados no MySQL.
  2. Importe e execute o arquivo script.sql localizado na pasta Database.
  3. Configure as credenciais do banco no arquivo de conexão (config.php).
  4. Após configurar a conexão, execute o seguinte comando na pasta App:
php -S localhost:8000
  • Acesse a aplicação em: http://localhost:8000

3️⃣ Acessando com usuário Admin:

O banco de dados criado possui um usuário já cadastrado como Administrador, podendo configurar novos usuários, livros e demais parâmetros com ele.

🤝 Contribuição

Fique à vontade para abrir uma issue ou enviar um pull request com melhorias.