A clean, fully object-oriented Java console application to manage a library's books, authors, customers, and loans.

🇺🇸 English · 🇧🇷 Português

---

🇺🇸 English Version

📖 About

Digital Library System is a Java console application built from scratch to simulate a real-world library management experience. Designed with clean OOP principles, the project covers class design, object relationships, collections, and user interaction — all through a text-based menu interface.

This project was developed as part of a Java learning journey, focused on applying and expanding core concepts in a practical, real-world scenario.

---

✨ Features

Feature	Description
📚 List Available Books	View all books currently available for borrowing
🔍 Search Books	Find books by title or author
🎭 Filter by Genre	Browse books from a specific genre
🆕 Filter Recent Books	See books added in the last 7 days
🤝 Borrow a Book	Register a loan by linking a book to a customer
👤 Register Customer	Add a new customer with name and email
📋 List Customers	View all registered customers
📜 Loan History	View all loans associated with a specific customer
🚪 Exit	Gracefully close the application

---

🏗️ Project Structure

📦 digital-library
 ┣ 📄 Main.java            → Entry point & interactive console menu
 ┣ 📄 Library.java         → Container holding books, authors, and loans
 ┣ 📄 LibraryService.java  → Business logic (search, filter, borrow, customers)
 ┣ 📄 Book.java            → Book model (id, title, author, genre, dates, availability)
 ┣ 📄 Author.java          → Author model (id, name, birthDate)
 ┣ 📄 Customer.java        → Customer model (id, name, email)
 ┗ 📄 LibraryLoan.java     → Loan model (book ↔ customer, borrow/return dates)

---

🧠 Class Diagram

┌─────────────┐        ┌──────────────┐
│   Library   │◄───────│ LibraryLoan  │
│─────────────│  loans │──────────────│
│ books       │        │ id           │
│ authors     │        │ book ──────────────► Book
│ loans       │        │ customer ──────────► Customer
└─────────────┘        │ borrowDate   │
                       │ returnDate   │
                       └──────────────┘

┌────────────────┐     ┌──────────────┐     ┌──────────────┐
│ LibraryService │     │    Book      │     │   Author     │
│────────────────│     │──────────────│     │──────────────│
│ + searchBooks  │     │ id           │     │ id           │
│ + filterGenre  │     │ title        │     │ name         │
│ + borrowBook   │     │ author       │     │ birthDate    │
│ + getHistory   │     │ genre        │     └──────────────┘
│ + register...  │     │ available    │
└────────────────┘     │ dates        │     ┌──────────────┐
                       └──────────────┘     │  Customer    │
                                            │──────────────│
                                            │ id           │
                                            │ name         │
                                            │ email        │
                                            └──────────────┘

---

🚀 Getting Started

Prerequisites

• Java 17 or higher installed
• A terminal / command prompt

Running the project

# 1. Clone the repository
git clone https://github.com/michellesanseverino/library_practice.git
cd library_practice

# 2. Compile all Java files
javac *.java

# 3. Run the application
java Main

Expected output

╔══════════════════════════════════════╗
║     Welcome to the Digital Library!  ║
╚══════════════════════════════════════╝

══════════════════════════════
  MAIN MENU
══════════════════════════════
  1. List available books
  2. Search books (title/author)
  3. Filter books (genre/recent)
  4. Borrow a book
  5. List all customers
  6. Register new customer
  7. View customer loan history
  0. Exit
══════════════════════════════
>

---

🔧 Concepts Applied

• Object-Oriented Programming — Encapsulation, abstraction, and class responsibility separation
• Collections — List<T> and ArrayList<T> for storing books, authors, customers, and loans
• Java Streams — .stream().filter().collect() for search and filtering logic
• LocalDate API — Date handling for registration, loans, and filtering recent books
• Service Layer Pattern — LibraryService separates business rules from the UI layer
• Console I/O — Scanner for user interaction with proper input validation

---

🌱 Possible Improvements

• Persist data with file I/O or a database (SQLite / H2)
• Add a return book feature with returnDate
• Implement fine calculation for overdue loans
• Add a book registration menu option
• Unit tests with JUnit 5

---

---

🇧🇷 Versão em Português

📖 Sobre

Sistema de Biblioteca Digital é uma aplicação Java de console criada do zero para simular o gerenciamento real de uma biblioteca. Desenvolvida com princípios limpos de POO, o projeto cobre design de classes, relacionamentos entre objetos, coleções e interação com o usuário — tudo por meio de um menu de texto interativo.

Este projeto foi desenvolvido como parte de uma jornada de aprendizado em Java, com foco em aplicar e expandir os conceitos principais em um cenário prático e real.

---

✨ Funcionalidades

Funcionalidade	Descrição
📚 Listar Livros	Veja todos os livros disponíveis para empréstimo
🔍 Buscar Livros	Encontre livros por título ou autor
🎭 Filtrar por Gênero	Navegue por livros de um gênero específico
🆕 Livros Recentes	Veja livros adicionados nos últimos 7 dias
🤝 Realizar Empréstimo	Registre um empréstimo vinculando livro a cliente
👤 Cadastrar Cliente	Adicione um novo cliente com nome e e-mail
📋 Listar Clientes	Visualize todos os clientes cadastrados
📜 Histórico de Empréstimos	Veja todos os empréstimos de um cliente específico
🚪 Sair	Encerra a aplicação com uma mensagem de despedida

---

🏗️ Estrutura do Projeto

📦 digital-library
 ┣ 📄 Main.java            → Ponto de entrada e menu interativo no console
 ┣ 📄 Library.java         → Contêiner com livros, autores e empréstimos
 ┣ 📄 LibraryService.java  → Regras de negócio (busca, filtro, empréstimo, clientes)
 ┣ 📄 Book.java            → Modelo de livro (id, título, autor, gênero, datas, disponibilidade)
 ┣ 📄 Author.java          → Modelo de autor (id, nome, dataNascimento)
 ┣ 📄 Customer.java        → Modelo de cliente (id, nome, email)
 ┗ 📄 LibraryLoan.java     → Modelo de empréstimo (livro ↔ cliente, datas)

---

🚀 Como Executar

Pré-requisitos

• Java 17 ou superior instalado
• Um terminal / prompt de comando

Executando o projeto

# 1. Clone o repositório
git clone https://github.com/michellesanseverino/library_practice.git
cd library_practice

# 2. Compile todos os arquivos Java
javac *.java

# 3. Execute a aplicação
java Main

---

🧠 Conceitos Aplicados

• Programação Orientada a Objetos — Encapsulamento, abstração e separação de responsabilidades entre classes
• Coleções — List<T> e ArrayList<T> para armazenar livros, autores, clientes e empréstimos
• Java Streams — .stream().filter().collect() para lógica de busca e filtragem
• API LocalDate — Manipulação de datas para cadastro, empréstimos e filtro de livros recentes
• Padrão Service Layer — LibraryService separa as regras de negócio da camada de interface
• Console I/O — Scanner para interação com o usuário com validação de entrada

---

🌱 Possíveis Melhorias

• Persistir dados com arquivo ou banco de dados (SQLite / H2)
• Adicionar funcionalidade de devolução de livro com returnDate
• Implementar cálculo de multa para empréstimos em atraso
• Adicionar opção de cadastro de livro pelo menu
• Testes unitários com JUnit 5

---

Made with ☕ and Java