smithros / booknet

My bachelor's diploma work. Stack: Spring Boot, Hibernate, JPA, Spring Data, Angular, PostgreSQL

booknet

This project supposed to be my bachelor course work.
It's a free online library of books that will allow users to read books, write review on them, rate them, search books, create own books collections with favourite, read and so on. It also proposes different announcements, notifications, achievements about books.

Link: booknet.

Inspired by this project.

Stack

• Spring Framework
• Angular
• PostgreSQL
• Hibernate

Requirements

For building and running the application you need:

• JDK 1.8
• Maven 4
• NodeJS
• NPM
• Docker

To build the project simply run this command in the root directory:

mvn clean install 

Running the application locally

This project is a Maven multimodule project with two submodules:

• backend
• frontend

There are several ways to run a Spring Boot application on your local machine. One way is to execute the main method in the BookNetApplication class from your IDE and go to http://localhost:8080.

Alternatively you can use the Spring Boot Maven plugin like so:

mvn spring-boot:run

To run Angular application on your local machine you can go to the Angular root directory and run:

ng serve --open

This will automatically open http://localhost:4200 in your browser.

Docker

To run the app in container in detached mode use next command:

docker compose up -d

Deploy

For application deployment free cloud application platform Heroku is used.