🎯 Code Auction

A complete full-stack web application for competitive coding events featuring live auctions, virtual currency, code evaluation, and real-time leaderboards.

🚀 Quick Start

# Install dependencies
npm install

# Setup database
npx prisma db push

# Seed sample data
npm run db:seed

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

🔑 Login Credentials

Role	Username/ID	Password
Admin	admin	admin123
Team 1	TEAM-001	team001pass
Team 2	TEAM-002	team002pass
Team 3	TEAM-003	team003pass
Team 4	TEAM-004	team004pass
Team 5	TEAM-005	team005pass

✨ Features

🔨 Live Auction System

• Real-time bidding with countdown timers
• Minimum bid increments
• Bid history tracking
• Automatic auction ending

💰 Virtual Currency Economy

• Each team starts with 1000 Coins
• Strategic resource management
• Inverse pricing model (Easy = expensive, Hard = cheap)

🔒 Question Ownership Lock

• Only winning teams can view full problem statements
• Exclusive solving rights per question
• No question sharing between teams

💻 Code Evaluation

• Monaco Editor (VS Code-like experience)
• C, C++, Java, Python support
• Hidden test case validation
• Instant feedback on submissions

📊 Real-time Leaderboard

• Live score updates
• Tie-breaker rules:
  1. Total Score (highest wins)
  2. Coins Remaining (more = better)
  3. Questions Purchased (fewer = better)

🛠️ Admin Panel

• Create/Edit/Delete teams
• Manage question bank
• Control auctions
• Start/Pause/Reset events
• Configure event settings

📁 Project Structure

├── prisma/
│   ├── schema.prisma      # Database schema
│   └── seed.js            # Sample data seeder
│
├── src/
│   ├── app/
│   │   ├── api/           # REST API routes
│   │   │   ├── auth/      # Login/logout/session
│   │   │   ├── auctions/  # Auction management
│   │   │   ├── questions/ # Question CRUD
│   │   │   ├── submissions/ # Code evaluation
│   │   │   ├── leaderboard/ # Rankings
│   │   │   ├── teams/     # Team management
│   │   │   └── event/     # Event control
│   │   │
│   │   ├── admin/         # Admin dashboard
│   │   ├── auctions/      # Auction browser
│   │   ├── dashboard/     # Team dashboard
│   │   ├── leaderboard/   # Public leaderboard
│   │   ├── login/         # Authentication
│   │   ├── rules/         # Event rules
│   │   └── solve/[id]/    # Code editor
│   │
│   └── lib/
│       ├── auth.ts        # JWT authentication
│       ├── evaluator.ts   # Code evaluation
│       ├── prisma.ts      # Database client
│       ├── store.ts       # Zustand state
│       ├── types.ts       # TypeScript types
│       └── utils.ts       # Helper functions
│
├── CREDENTIALS.txt        # Login credentials
├── TECH_STACK.txt         # Technology details
└── QUESTIONS_LOGIC.txt    # Question bank info

🗄️ Database Models

Model	Description
Team	Team info, credentials, coins, score
Question	Problems with test cases
QuestionPurchase	Team ownership records
Auction	Live auctions
Bid	Auction bids
Submission	Code submissions
EventConfig	Global settings
AdminUser	Admin credentials

💎 Pricing Model

Difficulty	Base Price	Reward Points
🟢 Easy	400-500 ¢	100-150 pts
🟡 Medium	250-350 ¢	250-300 pts
🔴 Hard	100-200 ¢	450-600 pts

🔧 Configuration

Environment Variables

# .env.local
DATABASE_URL="file:./dev.db"
JWT_SECRET="your-super-secret-key"

# Optional: Judge0 API for real code execution
JUDGE0_API_URL=https://judge0-ce.p.rapidapi.com
JUDGE0_API_KEY=your-api-key

Event Settings

Configure via Admin Panel or directly in database:

• Initial coins per team
• Minimum bid increment
• Auction duration
• Allow multiple submissions

📜 API Endpoints

Authentication

• POST /api/auth/login - Login
• POST /api/auth/logout - Logout
• GET /api/auth/me - Current session

Questions

• GET /api/questions - List all questions
• GET /api/questions/[id] - Get question details
• POST /api/questions - Create question (admin)
• PUT /api/questions/[id] - Update question (admin)
• DELETE /api/questions/[id] - Delete question (admin)

Auctions

• GET /api/auctions - List active auctions
• POST /api/auctions - Start auction (admin)
• POST /api/auctions/[id]/bid - Place bid
• POST /api/auctions/[id]/end - End auction (admin)

Submissions

• POST /api/submissions - Submit code
• GET /api/submissions - Submission history

Leaderboard

• GET /api/leaderboard - Current rankings

Teams

• GET /api/teams - List teams (admin)
• POST /api/teams - Create team (admin)
• PUT /api/teams/[id] - Update team (admin)
• DELETE /api/teams/[id] - Delete team (admin)

Event

• GET /api/event - Event status
• POST /api/event - Control event (admin)

🎮 How to Run an Event

1. Setup - Run npm run db:seed to create teams and questions
2. Admin Login - Go to /login, select Admin, use credentials
3. Start Event - Click "Start Event" in admin panel
4. Start Auctions - Go to Questions tab, click "Start Auction" on a question
5. Teams Bid - Teams login and bid on the Auctions page
6. Solve Questions - Winning teams solve their purchased questions
7. Monitor - Watch the leaderboard update in real-time
8. End Event - Stop event from admin panel

🛡️ Security Features

• JWT tokens with HTTP-only cookies
• Password hashing with bcrypt
• Session-based authentication
• Role-based access control
• API route protection

📦 Tech Stack

• Frontend: Next.js 14, React 18, Tailwind CSS
• Backend: Next.js API Routes, Prisma ORM
• Database: SQLite (swappable to PostgreSQL)
• Auth: JWT (jose), bcryptjs
• Editor: Monaco Editor
• State: Zustand

📄 License

MIT License - Built for competitive coding events.

---

© 2026 Code Auction