Secure Online Auction Platform with AI, Blockchain & Ethiopian Languages
# ποΈ Online Auction Platform
A full-stack auction platform built with Next.js, Node.js, and PostgreSQL featuring real-time bidding, escrow payments, and comprehensive admin controls.
---
## π Quick Start
### Prerequisites
- Node.js (v18+)
- PostgreSQL (v14+)
- npm or yarn
### 1. Setup Database
**Option A: Using SQL directly (Recommended)**
```bash
# Create database
createdb auction_platform
# Run setup scripts
cd backend
psql -U postgres -d auction_platform -f CREATE-ALL-TABLES.sql
psql -U postgres -d auction_platform -f fix-admin-database-complete.sql
```
**Option B: Using batch script (Windows)**
```bash
cd backend
setup-database.bat
```
### 2. Start Backend
```bash
cd backend
npm install
cp .env.example .env # Configure your environment variables
npm start
```
Backend runs on: **
http://localhost:5000**
### 3. Start Frontend
```bash
cd online-auction-b
npm install
cp .env.example .env.local # Configure your environment variables
npm run dev
```
Frontend runs on: **
http://localhost:3000**
### 4. Default Admin Login
- Email: `admin@auction.et`
- Password: (set during database setup)
## β¨ Features
### π₯ User Features
- User registration & authentication (JWT)
- Email verification
- Profile management with photo upload
- Wallet system with balance management
- Real-time auction bidding
- Auto-bid functionality
- Watchlist
- Bid history tracking
- Dispute resolution system
- Report auctions/sellers
- Multi-language support (English/Amharic/Afan Oromo)
- AI Virtual Assistant (24/7 help)
### πͺ Seller Features
- Seller verification & approval
- Create and manage auctions
- Upload multiple images
- Set starting bid & buy-now price
- Subscription plans (Free/Premium/Enterprise)
- Sales analytics
- Transaction history
### π° Payment & Escrow
- Wallet-based payments
- Blockchain escrow integration
- Secure fund holding
- Shipping confirmation
- Ad β¦