MegaBid

A modern, full-stack auction platform for buying, selling, and bidding in real-time

Features • Demo • Tech Stack

---

✨ Features

🔐 Secure Authentication

• JWT-based authentication with role-based access control (Admin, Seller / Buyer, Guest)
• HTTPS/TLS encryption for all communications
• Session management with token expiration

🛍️ Complete Auction System

• Create auctions with multiple images, descriptions, and categories
• Set starting bids and optional buy-now prices
• Real-time bid tracking
• Automatic auction lifecycle management (pending → active → completed)

🔍 Advanced Search & Discovery

• Smart keyword search across items and categories
• Multi-criteria filtering (price range, location, category)
• Sort by popularity, bids, price, seller rating, and more
• Hierarchical category browsing with taxonomy tree

🧠 AI-Powered Recommendations

• Machine learning-driven item suggestions
• Personalized based on browsing history and bidding activity
• Collaborative filtering for "users like you" recommendations

💬 Built-in Messaging

• Direct buyer ↔ seller communication
• Inbox/outbox with read/unread status
• Message history

🗺️ Location Services

• Interactive map integration (OpenStreetMap/Leaflet)
• Location-based filtering and display

🛡️ Admin Dashboard

• User approval workflow for new registrations
• Export auctions in JSON/XML formats
• User management and moderation tools

---

🖼️ Demo

🏠 Home Page

Personalized recommendations and trending auctions

🔍 Browse Page

Advanced search with filters and category navigation

📦 Item Details

Complete auction details with bidding interface and location map

---

🛠️ Tech Stack

Frontend

• ⚛️ React with TypeScript
• 🎨 TailwindCSS for styling

Backend

• ☕ Java 21 with Spring Boot 3
• 🗄️ MySQL with JPA/Hibernate
• 🔒 Spring Security for authentication & authorization
• 🌐 RESTful API architecture
• 🤖 ML integration for recommendations

DevOps & Tools

• 🎯 TypeScript for type safety
• 🚀 Vite for fast development builds
• 📦 Maven for dependency management
• 🔧 ESLint for code quality

---

📁 Project Structure

MegaBid/
├── client/                     # React frontend
│   ├── src/     
│   │   ├── components/         # Reusable UI components
│   │   ├── pages/              # Page components
│   │   ├── utils/              # Helper functions
│   │   ├── assets/             # Images and static files
|   |   └── *.tsx               # Simple UI pages
│   └── package.json     
│     
├── server/                     # Spring Boot backend
│   ├── src/main/java/
│   │   └── com/megabid/server/
│   │       ├── config/         # Security & app configuration
│   │       ├── users/          # User management
│   │       ├── items/          # Auction items
│   │       ├── bids/           # Bidding system
|   |       ...     
│   │       └── messages/       # Messaging system
│   └── pom.xml     
│     
├── database/     
│   └── megabid.sql             # SQL schema
│     
├── docs/                       # Documentation & screenshots
│     
└── useful/                     # Utility scripts

---

🎯 Key Features Explained

🔐 Role-Based Access Control

Role	Permissions
Guest	Browse auctions, view items
Buyer / Seller	Place bids, buy items, send messages, create auctions, manage listings
Admin	Approve users, export data, moderate content

🤖 Recommendation Engine

The platform uses collaborative filtering to suggest items based on:

• User browsing history (tracked via visited table)
• Bidding patterns
• Similar user preferences
• Item popularity metrics

---

🔒 Security Features

• ✅ HTTPS/TLS encryption
• ✅ JWT token-based authentication
• ✅ SQL injection prevention (JPA/Hibernate)
• ✅ XSS protection
• ✅ Role-based API endpoints
• ✅ Session timeout management