Items marketplace

Marketplace with orderbooks, buy/sell items platform.

🟢 Code Status • ✨ Features • 🏛️ Architecture • 📦 Installation • 📱 Technologies Stack • 📷 Screenshots • 📃 Docs

🟢 Code Status

✨ Features

• Easily view and search market items

• Automaticly make trades on one click

• Manage inventory and wallet funds

• Track personal order history

• Fast load public images and secured user images

🏛️ Architecture

📦 Installation

Backend

1. Clone the repository.

2. Make sure you have Terraform installed and provided IAM credentials to authenticate the Terraform AWS provider.

3. Change directory to infrastructure/aws_resorces/.

4. Run next two commands to generate required Cloudfront key group keys.

  openssl genrsa -out private_key.pem 2048

  openssl rsa -pubout -in private_key.pem -out public_key.pem

5. Run terraform init then terraform apply --auto-aprove to provision S3 and Cloudfronts on AWS.

Docker

6. Make sure you have docker installed and running. You will also need docker-compose.

7. Change directory to infrastructure/

8. Fill out the values in the .env file with outputs from terraform provisioned resorces.

9. Run docker-compose up. This should build the docker image and start the container and Postgres DB running.

10. Head over to http://localhost:8080/docs (or a different port if you changed it) to make sure that backend Spring Boot application is running.

IDE

6. Open Spring Boot application in your IDE located in items-marketplace/

7. Set environment variables:

   • APP_PORT
   • HTTP_PORT
   • SSL_PASSWORD
   • POSTGRES_DB_URL
   • POSTGRES_DB_USERNAME
   • POSTGRES_DB_PASSWORD
   • FRONTEND_URL
   • STRIPE_SECRET_KEY
   • STRIPE_ENDPOINT_SECRET
   • JWT_SECRET (generate encryption key)
   • S3_BUCKET_NAME (terraform output)
   • CLOUDFRONT_DOMAIN_PUBLIC (terraform output)
   • CLOUDFRONT_DOMAIN_PRIVATE (terraform output)
   • KEY_PAIR_ID (terraform output)
   • PRIVATE_KEY_NAME (terraform output)

8. Execute the main method in the me.darkovrbaski.items.marketplace.ItemsMarketplaceApplication class.

9. Head over to http://localhost:8080/docs (or a different port if you changed it) to make sure that backend Spring Boot application is running.

Frontend

1. Change directory to angular-app/.

2. Install the dependencies npm install.

3. Run the Angular application npm start.

4. Head over to http://localhost:4200/ and feel free to register and explore the application.

📱 Technologies Stack

📷 Screenshots

Login Page

Market Page

Orderbook Page

Place Buy Order

Inventory Page

Place Sell Order

Wallet Page

Orders Page

Order Page

Profile Page

📃 Docs

Class Diagram

---

🔼 Back to top