The "Online Bookstore" application is a web application for the convenience of selecting and purchasing books online. In the application, you can add, store, select, buy saved books from different categories, which allows you to flexibly make purchases without the user directly visiting the store. The application implements such Java-based server technologies as Spring Framework, JWT, Docker.
The application has USER or ADMIN roles. The USER role is assigned automatically to each new user. You can also view the list of all application endpoints.
Servers http://localhost:8080/api - Generated server url
Authentication management - Endpoints for managing authentication
- POST: /auth/register Register
- POST: /auth/login Login
Order management - Endpoints for managing users orders
- GET: /orders Retrieve user's order history
- POST: /orders Place an order
- PATCH: /orders/{id} Update order status
- GET: /orders/{orderId}/items Retrieve all OrderItems for a specific order
- GET: /orders/{orderId}/items/{itemId} Retrieve a specific OrderItem within an order
Category management - Endpoints for managing categories
- GET: /categories Find all categories
- POST: /categories Save a new category to DB
- GET: /categories/{id} Find category by id
- POST: /categories/{id} Update category data in DB
- DELETE: /categories/{id} Delete category by id
- GET /categories/{id}/books Get all books by category ID
Shopping cart management - Endpoints for shopping cart management
- PUT: /cart/cart-items/{cartItemId} Update quantity of a book in the shopping cart
- DELETE: /cart/cart-items/{cartItemId} Remove a book from the shopping cart
- GET: /cart Retrieve user's shopping cart
- POST: /cart Add book to the shopping cart
Book management - Endpoints for managing books
- GET: /books Find all books
- POST: /books Save a new book to DB
- GET: /books/{id} Find book by id
- POST: /books/{id} Update book data in DB
- DELETE: /books/{id} Delete book by id
- GET: /books/search Search book's by parameters
- Java 17
- Spring Boot, Spring Security, Spring data JPA
- REST, Mapstruct
- MySQL, Liquibase
- Maven, Docker
- Lombok, Swagger
- Junit, Mockito, testcontainers
- Docker must be installed on your system.
- You can configure database parameters in the .env file.
- Open a terminal and navigate to the root directory of your project.
- Run the application using Docker Compose:
docker-compose up - Explore the endpoints using tools like Postman or Swagger