https://github.com/piotrd22/marketplace

Sample e-commerce app built with Java, Spring, and Vue
https://github.com/piotrd22/marketplace

docker ecommerce java javascript maven postgresql spring vue

Last synced: 7 days ago
JSON representation

Sample e-commerce app built with Java, Spring, and Vue

• Host: GitHub
• URL: https://github.com/piotrd22/marketplace
• Owner: piotrd22
• Created: 2024-01-31T10:10:22.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-03-12T10:40:04.000Z (8 months ago)
• Last Synced: 2024-10-10T19:43:50.950Z (28 days ago)
• Topics: docker, ecommerce, java, javascript, maven, postgresql, spring, vue
• Language: Java
• Homepage:
• Size: 4.26 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# e-commerce app

A basic e-commerce application where you can browse products, add them to the cart and place orders. The frontend application allows you to use only some of the functionalities of the backend rest API, you can search for products, add them to the cart, place an order and view order history. There are also endpoints for adding and editing products, categories, etc., but they are not covered on the frontend.

## Starting the application

To run the application, we first need to turn on the database. To do this, we must have Docker installed on our computer. If we have it installed, just go to the docker folder and type `docker compose up -d` in the terminal.

To run the backend part, we need to open our application in our favorite IDE and run the application. However, if we want to do it from the terminal, just enter the command `mvn spring-boot:run` in the root folder.

To run the frontend part, just go to the frontend folder and enter the command `npm run dev`

We could also build our frontend part and serve it statically through the server, but here we turn on the frontend development server.

If we managed to run the application correctly, we should have 3 things running:

- PostgreSQL on port :5432

- backend server on port :8080

- frontend on port :5173

The application does not use SSL certificates, so everything is simply on http.

To get to the backend documentation just go to `http://localhost:8080/swagger-ui` in your browser, or you can use the included Postman collection.

To get to the app's home page, simply go to `http://localhost:5173/` in your browser.

The application will have data because each time the backend is starting, it feeds the database with dummy data.

The application will also contain one user with credentials: 

- username: piotrd

- password: password

## Technology stack

Database:

- PostgreSQL

Backend:

- Java 17 Adoptium

- Spring

Frontend

- JavaScript

- Vue 3 with Vite