https://github.com/ath31st/market_palace

Market Palace is an online marketplace application where users can browse products, manage orders, and use a shopping cart.
https://github.com/ath31st/market_palace

exposed full-stack gradle jwt kotlin ktor ktor-server pagination react reactjs redux redux-toolkit sqlite3 styled-components

Last synced: about 1 month ago
JSON representation

Market Palace is an online marketplace application where users can browse products, manage orders, and use a shopping cart.

• Host: GitHub
• URL: https://github.com/ath31st/market_palace
• Owner: ath31st
• Created: 2024-08-04T19:39:25.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-09-01T19:03:11.000Z (5 months ago)
• Last Synced: 2024-10-31T12:24:28.215Z (3 months ago)
• Topics: exposed, full-stack, gradle, jwt, kotlin, ktor, ktor-server, pagination, react, reactjs, redux, redux-toolkit, sqlite3, styled-components
• Language: Kotlin
• Homepage:
• Size: 4.26 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Market Palace

Market Palace is an online marketplace application designed for customers to browse products, manage

their orders, and utilize a shopping cart. The application features both authenticated and

unauthenticated user access, with different functionalities available based on user status.

## Features

### Common Pages

- **Main Page**: Displays a list of all products available in the marketplace. Users can search for

  products and sort them by name or price. Unauthenticated users can view this page and product

  details, but will be redirected to the login page if they try to add items to the cart.

  ![Main Page](images/main_page.jpg)

- **Product Page**: Shows detailed information about a specific product. This page is accessible to

  both authenticated and unauthenticated users.

  ![Product Page](images/product_page.jpg)

### Authenticated User Pages

- **My Orders Page**: Available to authenticated users only. Displays a list of orders made by the

  user, with options to sort them by price or date.

  ![My Orders Page](images/my_orders.jpg)

- **Cart Page**: Available to authenticated users only. Displays items currently in the user's

  shopping cart.

  ![Cart Page](images/cart.jpg)

### Authentication Pages

- **Login Page**: For user authentication. Users must log in to access certain features.

  ![Login Page](images/login.jpg)

- **Registration Page**: For new users to create an account.

  ![Registration Page](images/signup.jpg)

## User Permissions

- **Unauthenticated Users**: Can view the Main Page and Product Page. Attempting to add items to the

  cart will redirect them to the Login Page.

- **Authenticated Users**: Can access the Main Page, Product Page, My Orders Page, and Cart Page.

  They can also manage their cart and place orders. If they log out and log back in, their cart data

  will be preserved.

## Backend Endpoints

- **POST /login**: Authenticate a user.

- **POST /signup**: Register a new user.

- **GET /products**: Retrieve a list of all products.

- **GET /products/{id}**: Retrieve details of a specific product.

- **GET /my-orders**: Retrieve the list of orders made by the authenticated user.

- **POST /my-orders**: Create a new order.

- **GET /cart**: Retrieve the current user's shopping cart.

- **POST /cart**: Add items to the cart.

- **PUT /cart**: Update items in the cart.

## Technology Stack

- **Frontend**: JS(React, Redux, Styled-components).

- **Backend**: Kotlin (Ktor, exposed, sqlite).

## Setup Instructions

### Backend

1. Navigate to the backend directory.

2. Build the project and install dependencies: `./gradlew build`.

3. Start the backend server: `./gradlew run`.

### Frontend

1. Open a new terminal and navigate to the React application directory.

2. Install dependencies: `yarn install`.

3. Start the frontend application: `yarn start`.

## Repository Structure

- **backend/**: Contains backend server code.

- **frontend/**: Contains React application code.

Market Palace provides a user-friendly platform for customers to manage their shopping experience

efficiently.