Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Aplicação Laravel para cadastro e organização de livros. Com CRUD, validações e layout responsivo.

Notifications You must be signed in to change notification settings

angelluzk/bookshelf

Repository files navigation

📚 BookShelf (Minha Biblioteca)

Laravel PHP Bootstrap MySQL Blade Composer Laragon

🟡 Um sistema web completo para gerenciamento de acervo bibliográfico pessoal, desenvolvido com Laravel e Bootstrap.

📖 Sobre o Projeto

O BookShelf é uma aplicação web focada nas operações fundamentais de sistemas (CRUD), permitindo ao usuário organizar sua coleção de livros. O projeto foi desenhado para ser responsivo, intuitivo e seguro, aplicando as melhores práticas de desenvolvimento backend e frontend. Este projeto serviu como base de estudos para dominar a arquitetura MVC e o ecossistema Laravel.


🚀 Tecnologias Utilizadas

  • Ambiente de Desenvolvimento: Laragon (Apache + MySQL + PHP 8).
  • Framework Backend: Laravel.
  • Frontend: Bootstrap 5 (Grid System, Cards, Modais e Componentes).
  • Banco de Dados: MySQL.
  • Motor de Templates: Blade.

🎯 O que foi Praticado/Aprendido?

Durante o desenvolvimento deste projeto, foram aplicados os seguintes conceitos técnicos:

  • Arquitetura MVC (Model-View-Controller): Separação clara entre a lógica de negócios, a interface do usuário e o controle de fluxo.
  • Migrations: Versionamento do banco de dados via código PHP, evitando criação manual de tabelas SQL.
  • Route Resource: Utilização de rotas padronizadas RESTful (index, create, store, edit, update, destroy) com uma única linha de código.
  • Route Model Binding: Injeção de dependência automática nos Controllers (ex: Book $book em vez de buscar por $id).
  • Blade Template Inheritance: Criação de um Layout Mestre (app.blade.php) para reutilização de cabeçalhos, menus e rodapés, evitando código duplicado (D.R.Y.).
  • Validação Server-Side: Implementação de regras robustas (required, max, integer) no Controller para proteger o banco de dados.
  • UX/UI: Feedback visual para o usuário (Flash Messages de sucesso e mensagens de erro de validação nos campos).

Funcionalidades

  • Listagem Visual: Exibição dos livros em formato de Cards modernos com "capas" geradas dinamicamente.
  • Cadastro Seguro: Formulário com validação de dados (impedindo títulos vazios ou textos excessivos).
  • Edição Inteligente: Formulários que recuperam os dados antigos (old()) em caso de erro de validação.
  • Exclusão Segura: Confirmação antes de apagar um registro.
  • Responsividade: Layout adaptável para Celulares, Tablets e Desktops.
  • Feedback: Alertas visuais de sucesso ou erro após cada operação.

🛠️ Como Rodar o Projeto Localmente

Pré-requisitos

  • PHP 8.0 ou superior.
  • Composer instalado.
  • Servidor MySQL rodando (Laragon/XAMPP).

Passo a Passo

Clone o repositório (ou baixe os arquivos):

git clone https://github.com/seu-usuario/bookshelf.git
cd bookshelf

Instale as dependências do PHP:

composer install

Configure o ambiente: Duplique o arquivo .env.example e renomeie para .env. Abra o .env e configure seu banco de dados:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bookshelf
DB_USERNAME=root
DB_PASSWORD=

Gere a chave da aplicação:

php artisan key:generate

Crie as tabelas no banco:

php artisan migrate

Inicie o servidor (Opções de Acesso):

Opção A (Servidor Embutido do Laravel):

Rode o comando abaixo e acesse http://127.0.0.1:8000

php artisan serve

Opção B (Via Laragon - Recomendado):

Se você usa Laragon, certifique-se que o Apache/Nginx está rodando e acesse diretamente pelo navegador:


👩‍🎓 Autoria

Foto de Angel Luz

Desenvolvido com 💛 por Angel Luz.

Se quiser conversar, colaborar ou oferecer uma oportunidade:

📬 E-mail: [email protected]
🐙 GitHub: @angelluzk
💼 LinkedIn: linkedin.com/in/angelitaluz
🗂️Website / Portfólio: meu_portfolio/


“Transformando código em fluxo, e ideias em movimento.”