owaresabd / elibrary

E-Library. Final project from IT-Academy course 'Enterprise Software Development with Java' by SENLA

E-Library

E-Library - the user-friendly general reference tool—delivers designed to support every range of user, including elementary students, college-prep and college-level researchers, and professional educators.

Using this web-application you can/be able to:

• Check all books available in the library now, look for necessary book using category, author or title and immediately book it
• Then you can to get selected book pick it up at the real library
• Track the status of your booking (reading)
• In case you have forgotten to return the book to the library you will get email, just as kind reminder.

The E-Library application does reading simple!

Installing / Getting started

mvn spring-boot:run

When you execute the code above the application will run.

Api code-contract (generated with swagger framework)

/v2/api-docs

Using docker

Simple docker

1. Create a docker container for MySQL

docker run --name mysql-docker-container -e MYSQL_ROOT_PASSWORD=1234 -d mysql:8.0.22

2. Building the docker image from project

docker build -f Dockerfile -t elibrary-spring-boot .

3. Running the built docker image

docker run -t --name elibrary-spring-boot-container --link mysql-docker-container:mysql -p 8080:8080 elibrary-spring-boot

Using docker compose

docker-compose up

Api code-contract (generated with swagger framework)

/v2/api-docs

Using docker

Simple docker

1. Create a docker container for MySQL

docker run --name mysql-docker-container -e MYSQL_ROOT_PASSWORD=1234 -d mysql:8.0.22

2. Building the docker image from project

docker build -f Dockerfile -t elibrary-spring-boot .

3. Running the built docker image

docker run -t --name elibrary-spring-boot-container --link mysql-docker-container:mysql -p 8080:8080 elibrary-spring-boot

Using docker compose

docker-compose up

Developing

Modules

• elibrary-main
• elibrary-entity
• elibrary-service
• elibrary-api
• elibrary-controller
• elibrary-rest
• elibrary-web
• elibrary-utils
• elibrary-entity-metadata

Built With

• Java 1.8
• Spring Boot 2.4.2
• Spring Data JPA
• Spring Web
• OAuth2 Client
• ModelMapper 2.3.9
• Hibernate Types 52 2.10.4
• H2 Database Engine 1.4.200
• Thymeleaf 3.0.12
• Mockito 3.6.28
• Lombok 1.18.16
• Liquibase 3.10.3

Versioning

• 0.0.1-SNAPSHOT

Tests

There is test some JpaRepositories and AuthorService

mvn test

Style guide

Google Java Style Guide

Database

Has been used MySQL Community Server 8.0.25

Track, version, and deploy database changes with Liquibase

Data base diagram, SQL scripts

Licensing

No license

OAuth2 debug stack

• OAuth2AuthorizationRequestRedirectFilter -> (endpoint: /oauth2/authorization/{provider} ex. /oauth2/authorization/google) redirect to provider's authorization page;
• Some unknown class whose receive authorization_code and exchange it to access_token. Maybe it DefaultAuthorizationCodeTokenResponseClient;
• DefaultOAuth2UserService -> load user using OAuth2AccessToken (exchange it to data);