Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alper-sayin/online-auction-hub

Online-Auction-Hub A Django-based Web Application
https://github.com/alper-sayin/online-auction-hub

bootstrap5 class-based-views crud csrf-tokens django django-application django-forms django-framework html-css-javascript oop orm pagination python sqlite-database user-authentication validation

Last synced: about 1 month ago
JSON representation

Online-Auction-Hub A Django-based Web Application

Awesome Lists containing this project

README

        

## Table of Contents

1. [Introduction](#introduction)
2. [Key Features](#key-features)
3. [Technologies Used](#technologies-used)
4. [Project Structure](#project-structure)
5. [Installation & Setup](#installation--setup)
6. [Usage & Screenshots](#usage--screenshots)

## Introduction

OnlineAuctionHub is a dynamic online auction platform built with Django. It provides a user-friendly interface for buyers and sellers to participate in auctions, manage products, and track bids.

## Key Features

- User authentication (login, logout, signup)
- Back-end & front-end validations for data integrity, user privacy and auction rules.
- Product listing and management
- Advanced search & filtering: Finding items by category, price range, or keywords.
- Bidding system
- User dashboard
- Favorite products
- Products on sale
- Submitted bids
- Responsive design for desktop
- Bootstrap-based UI with custom styling

## Technologies Used

- Python
- Django
- HTML/CSS/JavaScript
- Bootstrap 5
- SQLite

## Project Structure

![Description](images/projectstructure.png)

## Installation & Setup

After obtaining the files in repository or cloning the repository(`git clone https://github.com/alper-sayin/Online-Auction-Hub.git`) to desired folder, setting up virtual environment and satisfying the requirements([requirements.txt](requirements.txt)), open the terminal(.venv) in your IDE, you should apply:

- `python manage.py makemigrations auctions`
- `python manage.py migrate`
- `python manage.py create_test_data`
- And our database is ready with test datas and also users(user0, user1, user2, user3, user4-both passwords are “password” You can see the details in [create_test_data.py](auctions/management/commands/create_test_data.py) and also data details in test_data.json file which automatically created in your project directory after execution
- `python manage.py runserver`
And then server is ready on http://127.0.0.1:8000

## Usage & Screenshots

Home
![Description](images/home.PNG)

Register for an account or log in if you already have one.

![Description](images/signup.PNG)

![Description](images/login.PNG)

Browse items or use the search functionality to find specific auctions.

![Description](images/product_listing.PNG)

![Description](images/pagination.PNG)

![Description](images/filtering.PNG)

![Description](images/filtering2.PNG)

Place bids on items you're interested in.

![Description](images/bidding.PNG)

Create your own auction listings to sell items.

![Description](images/creating_product.PNG)

Manage your bids and listings from your user dashboard.

![Description](images/user_dashboard.PNG)

![Description](images/favorites.PNG)

![Description](images/submitted_bids.PNG)