SmoothBid

An eBay-style auction platform where users can create listings, place bids, comment on items, and manage their watchlist.

Features

• User Authentication: Register, login, and logout functionality
• Create Listings: Post auction items with title, description, starting bid, image URL, and category
• Bidding System: Place bids on active listings with real-time bid validation
• Watchlist: Add/remove items to track auctions of interest
• Categories: Browse listings organized by categories
• Comments: Leave comments on auction listings
• Close Auctions: Listing creators can close their auctions to determine winners

Tech Stack

• Backend: Python 3.x with Django 3.0.2
• Database: SQLite3
• Frontend: HTML, CSS, JavaScript
• Styling: Bootstrap 4
• Currency: ExchangeRates API integration

Installation & Setup

Prerequisites

• Python 3.x installed on your system
• pip (Python package manager)

Steps

1. Clone the repository

   git clone <repository-url>
   cd SmoothBid

2. Install dependencies

   pip install -r requirements.txt

3. Run database migrations

   python manage.py migrate

4. Create a superuser (optional, for admin access)

   python manage.py createsuperuser

5. Start the development server

   python manage.py runserver

6. Access the application

   • Open your browser and navigate to http://127.0.0.1:8000
   • Admin panel available at http://127.0.0.1:8000/admin

Live Demo

Deployed at: yaoruixuu.pythonanywhere.com

Project Structure

SmoothBid/
├── auctions/           # Main application
│   ├── models.py      # Database models (User, Listing, Bid, Comment, Watchlist)
│   ├── views.py       # View functions and business logic
│   ├── urls.py        # URL routing
│   └── templates/     # HTML templates
├── commerce/          # Project settings
├── db.sqlite3         # SQLite database
├── manage.py          # Django management script
└── requirements.txt   # Python dependencies