diff --git a/realtimeBidding-aayush/pwd.text b/realtimeBidding-aayush/pwd.text new file mode 100644 index 0000000..e2eec68 --- /dev/null +++ b/realtimeBidding-aayush/pwd.text @@ -0,0 +1,109 @@ +## 1. Introduction + +### **1.1. Product Vision** +To create a real-time, interactive online bidding platform that replicates the excitement and mechanics of an IPL-style player auction. The platform will allow users to observe auctions, team administrators to bid on players, and a main administrator to manage the entire process. + +### **1.2. Goal** +The primary goal is to provide a seamless and engaging experience for all user types, ensuring the bidding process is transparent, fair, and efficient. + +## 2. User Roles and Permissions + +### **2.1. Normal User** +* **Permissions:** + * View active and upcoming auctions. + * View player profiles, including stats and bidding history. + * View team rosters and wallet information. + * No bidding capabilities. + +### **2.2. Team Admin** +* **Permissions:** + * All permissions of a Normal User. + * **Place bids** on players during an active auction. + * View their team's current wallet balance and transaction history. + * View their team's roster of acquired players. + +### **2.3. Main Admin** +* **Permissions:** + * All permissions of a Team Admin. + * **Start and end auctions** for individual players. + * **Finalize a bid** and confirm the winning team. + * **Add new players** to the auction pool, including their base price and profile details. + * **Manage team wallets**, including adding or deducting funds. + * View and manage all team rosters. + * View a complete history of all auctions. + +--- + +## 3. Functional Requirements + +### **3.1. Auction Management** +* The Main Admin must be able to create a new auction session and add players to it. +* The system must display a real-time countdown for each player's bidding round. +* Bids must be registered instantly and displayed to all users in real-time. +* The platform must prevent bids from being placed after the timer expires. +* The Main Admin must be able to pause or cancel an ongoing auction. + +### **3.2. Bidding Process** +* Team Admins can only bid when the bidding is open. +* The minimum bid increment must be pre-defined. +* The system must validate bids against the team's available wallet balance. +* The system must display the current highest bid and the highest bidder's team name. +* Upon a bid being finalized, the player's price must be deducted from the winning team's wallet, and the player must be added to their roster. + +### **3.3. Bid Finalization Logic** +* **Bid Closure:** When the 10-minute timer for a player's auction expires, bidding automatically closes. +* **Player Status - Sold:** If a bid was placed, the system identifies the highest bid, marks the player as **"Sold"**, deducts the amount from the winning team's wallet, and adds the player to their roster. The Main Admin can review and finalize this sale. +* **Player Status - Unsold:** If no bids were placed, the system marks the player as **"Unsold"** and adds them to a dedicated "Unsold" list. + +### **3.4. Wallet and Player Management** +* Each team must have a unique wallet with a pre-defined starting value. +* The Main Admin must have a dashboard to manage all team wallets, including adding or subtracting funds. +* The Main Admin must be able to add new players with their name, position, skills, and a base price. + +--- + +## 4. Non-Functional Requirements + +### **4.1. Performance** +* The bidding platform must handle real-time data updates without delay, which will require technologies like **WebSockets**. +* The system must be able to support a large number of concurrent users. + +### **4.2. Security** +* User data, especially wallet information, must be secure. +* The platform must have a robust authentication system for all user roles. + +### **4.3. Usability (UI/UX)** +* The user interface must be intuitive and easy to navigate for all user types. +* The bidding process must be clear, with a prominent display of the timer, current bid, and bidder. + +--- + +## 5. Screen Flow and Design + +### **5.1. Pre-Auction State Screens** +* **Main Lobby Screen:** Shows a list of all players available for auction, their base prices, and their team affiliations (if any). +* **Main Admin Pre-Auction Screen:** The Main Admin sees the same list but also has options to **add new players**, set the auction order, and initiate the auction for a specific player. + +### **5.2. Player Profile Screen** +This screen provides detailed information about a single player. +* **Header:** Player's name, photo, and current status. +* **Player Details:** Image, personal info, base price, and key skills. +* **Auction History:** Displays the live countdown, current highest bid, and the bidding team. +* **Finalized Status:** Shows the winning team and final bid amount after the auction. + +### **5.3. Team Profile Screen** +This screen provides a comprehensive view of a specific team. +* **Header:** Team logo and name. +* **Team Summary:** Wallet balance and count of acquired players. +* **Team Roster:** A list of all players acquired by the team. +* **Transaction History:** A chronological list of all money spent and gained. + +### **5.4. Post-Auction State Screens** +* **Final Rosters Screen:** All users can see the final roster of every team, including the players acquired and the total amount spent. +* **Unsold Players Screen:** A dedicated list of all players who did not receive any bids. +* **Main Admin Post-Auction Screen:** The Main Admin can choose to re-list unsold players for a "mini-auction" or close the event. They can also export the final results. + +### **5.5. User-Specific Screens** +* **Normal User Dashboard:** Displays the player currently up for auction, a live timer, and a list of upcoming players. +* **Team Admin Dashboard:** Similar to the Normal User dashboard, but with an added **"Place Bid"** button and a summary of their team's status. +* **Main Admin Dashboard:** A comprehensive control panel with a view of the current auction, admin controls to **finalize bids**, and an overview of all teams and players. \ No newline at end of file diff --git a/realtimeBidding-aayush/screenDetail.text b/realtimeBidding-aayush/screenDetail.text new file mode 100644 index 0000000..e62d4a8 --- /dev/null +++ b/realtimeBidding-aayush/screenDetail.text @@ -0,0 +1,109 @@ +### **1. Normal User Screens** + +**1.1. Pre-Auction Lobby** +* **Header:** Platform Logo, "IPL Auction" title. +* **Main Content:** + * **"Up Next" Section:** + * Displays the name, photo, and base price of the player who will be auctioned next. + * A "Players Queue" list shows the next few players in line. + * **"Auction Players" List:** + * A scrollable and searchable list of all players available for auction. + * Each player entry includes: Player photo, Name, Base Price, and a small tag indicating their status (e.g., "Available," "Unsold"). + * **"Teams" List:** + * A list of all participating teams. Each entry shows the team logo, name, and current wallet balance. + +**1.2. Live Auction Screen** +* **Header:** Platform Logo, Live Auction title. +* **Main Bidding Area:** + * **Player Card:** + * Large photo of the player. + * Player Name, Country, and Role (e.g., Batsman, Bowler). + * **Base Price:** The starting price. + * **Live Bid Information:** + * **Current Bid:** A large, prominent number showing the current highest bid amount. + * **Bidding Team:** The logo and name of the team that placed the current highest bid. + * **Live Countdown Timer:** A real-time countdown clock (e.g., 09:45) showing the time remaining for the bid. +* **Right Sidebar:** + * **Live Bid Feed:** A chronological list of all bids placed, showing the team name and bid amount. + * **Teams' Wallet Status:** A real-time leaderboard of all teams, displaying their logo and current wallet balance. + +**1.3. Player Profile Screen** +* **Header:** Player's Name. +* **Main Content:** + * **Player Image:** A large, high-resolution photo. + * **Information Panel:** + * **Personal Info:** Name, Age, Country. + * **Skills:** Primary role (e.g., All-rounder), and a brief description of their strengths. + * **Auction Status:** "Sold" or "Unsold." + * **Final Bid Details:** If sold, displays the winning team's name and the final bid amount. + * **Detailed Stats:** (Optional but recommended) A table or list of key performance metrics (e.g., Matches Played, Runs, Wickets). + +--- + +### **2. Team Admin Screens** + +**2.1. Main Dashboard (Combines Live Auction and My Team)** +* **Header:** Team Logo, Team Name, and a large display of the **Team Wallet Balance**. +* **Main Content:** + * **Live Auction Player:** Same as the Normal User's live screen, but with a crucial addition: + * **"Place Bid" Section:** + * A button to "Bid [Next Bid Amount]." The amount should be pre-calculated based on the last bid + a minimum increment. + * A message indicating if the team has sufficient funds ("You have enough funds") or not ("Insufficient funds"). +* **My Team Roster:** + * A list of all players acquired by this specific team. + * Each player entry shows: Player photo, Name, Role, and the price at which they were bought. + +**2.2. Transaction History Screen** +* **Header:** Team Logo, Team Name. +* **Main Content:** + * **Wallet Summary:** Current Balance, Total Money Spent, and Total Money Remaining. + * **Transaction Log:** + * A table with columns: **Player Name, Bid Amount, Transaction Type (Buy/Deduct), and Date/Time.** + +--- + +### **3. Main Admin Screens** + +**3.1. Main Control Panel** +* **Header:** "Main Admin Dashboard," Platform Logo. +* **Key Metrics:** + * **Overall Progress:** Total players listed, players sold, players unsold. + * **Financial Summary:** Total money spent by all teams, total money remaining across all teams. +* **Live Auction Management:** + * **Current Player:** Displays the player currently up for auction with a large card. + * **Control Buttons:** + * **"Start Bidding":** Begins the 10-minute timer for the current player. + * **"Finalize Bid":** Confirms the sale to the highest bidder. + * **"Move to Unsold":** Manually ends the bidding and moves the player to the unsold list. + * **"Pause/Resume Auction":** Allows for a break. + * **"Next Player":** Moves to the next player in the queue. +* **Quick Links:** Buttons to navigate to other management screens. + +**3.2. Player Management Screen** +* **Header:** "Manage Players." +* **Main Content:** + * **"Add New Player" Section:** + * Input fields for: **Player Name (text), Country (dropdown), Role (dropdown), Base Price (number), and Player Photo (file upload).** + * A **"Save Player"** button. + * **Player List Table:** + * A table with columns: **Player Name, Base Price, Current Status (e.g., "Available," "Sold," "Unsold"), and Actions.** + * **Actions:** "Edit" and "Delete" buttons for each player entry. + +**3.3. Team Management Screen** +* **Header:** "Manage Teams." +* **Main Content:** + * **Team List Table:** + * A table with columns: **Team Name, Current Wallet Balance, and Actions.** + * **Actions:** + * **"Add/Deduct Funds" button:** Opens a modal with an input field to enter a value. + * **"View Roster" button:** Navigates to the team's profile. + * **"Add New Team" Section:** + * Input fields for: **Team Name (text), Wallet Initial Value (number), and Team Logo (file upload).** + * A **"Create Team"** button. + +**3.4. Auction History and Reports** +* **Header:** "Auction Reports." +* **Main Content:** + * **Sold Players List:** A table showing all sold players with details: **Player Name, Winning Team, Final Bid Price.** + * **Unsold Players List:** A table showing all unsold players with details: **Player Name, Base Price, Reason for Unsold (e.g., No bids received).** + * **Final Roster Report:** A downloadable report (e.g., CSV, PDF) summarizing the final roster and total spending for each team. \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/auction_history_and_reports/code.html b/realtimeBidding-aayush/stich-design/auction_history_and_reports/code.html new file mode 100644 index 0000000..ed52b65 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/auction_history_and_reports/code.html @@ -0,0 +1,157 @@ + + + + + +Auction Reports + + + + + + +
+
+
+ +

Auction Reports

+
+
+
+
+

Sold Players List

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Player NameWinning TeamFinal Bid
Liam CarterMumbai Indians$1,200,000
Ethan BennettChennai Super Kings$950,000
Noah ThompsonKolkata Knight Riders$800,000
Lucas HayesSunrisers Hyderabad$750,000
Oliver ReedDelhi Capitals$600,000
Elijah FosterPunjab Kings$550,000
+
+
+
+

Unsold Players List

+
+ + + + + + + + + + + + + + + + + + + + + + + + + +
Player NameBase PriceReason
Owen Harper$200,000Not Bid
Caleb Morgan$150,000Not Bid
Grayson Cooper$100,000Not Bid
+
+
+
+ +
+
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/auction_history_and_reports/screen.png b/realtimeBidding-aayush/stich-design/auction_history_and_reports/screen.png new file mode 100644 index 0000000..8214f67 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/auction_history_and_reports/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/live_auction_screen/code.html b/realtimeBidding-aayush/stich-design/live_auction_screen/code.html new file mode 100644 index 0000000..1406241 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/live_auction_screen/code.html @@ -0,0 +1,171 @@ + + + + + +IPL Auction + + + + + + +
+
+
+
+ +

Live Auction

+
+
+
+
+
+Rohan Sharma +
+

Rohan Sharma

+

India | All-rounder

+
+
+
+
+
+

Base Price

+

$200,000

+
+
+

Highest Bid

+

$1,500,000

+
+
+
+

Bidding Team

+

Titans

+
+
+
+
+

00

+
+

Hours

+
+
+
+

00

+
+

Minutes

+
+
+
+

15

+
+

Seconds

+
+
+
+
+ +
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/live_auction_screen/screen.png b/realtimeBidding-aayush/stich-design/live_auction_screen/screen.png new file mode 100644 index 0000000..468963a Binary files /dev/null and b/realtimeBidding-aayush/stich-design/live_auction_screen/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/main_admin_control_panel/code.html b/realtimeBidding-aayush/stich-design/main_admin_control_panel/code.html new file mode 100644 index 0000000..c46bd17 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/main_admin_control_panel/code.html @@ -0,0 +1,119 @@ + + + + +Stitch Design + + + + + + + +
+
+ +

Main Admin Dashboard

+
+
+
+
+
+
+
+

IPL Auction 2024

+

Monitor and manage the live auction.

+
+
+
+
+

Auction Overview

+
+
+

Total Players

+

250

+
+
+

Players Sold

+

120

+
+
+

Players Unsold

+

130

+
+
+

Total Spent

+

$50M

+
+
+

Total Remaining Purse

+

$50M

+
+
+
+
+

Live Auction Management

+
+
+
+

Alex Turner

+

Team: Royal Challengers Bangalore

+

Base Price: $100K

+
+ + + + + +
+
+
+
+
+

Quick Links

+ +
+
+
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/main_admin_control_panel/screen.png b/realtimeBidding-aayush/stich-design/main_admin_control_panel/screen.png new file mode 100644 index 0000000..2329f10 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/main_admin_control_panel/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/player_management_screen/code.html b/realtimeBidding-aayush/stich-design/player_management_screen/code.html new file mode 100644 index 0000000..e5ac330 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/player_management_screen/code.html @@ -0,0 +1,144 @@ + + + + + +Stitch Design + + + + + + +
+
+
+
+ +

Manage Players

+
+
+
+
+
+

Add New Player

+
+ + + + +
+ + +
+ +
+
+
+

Player List

+
+
    +
  • +
    +

    Ethan Carter

    +

    Base Price: $50,000

    +

    Status: Available

    +
    +
    + + +
    +
  • +
  • +
    +

    Olivia Bennett

    +

    Base Price: $75,000

    +

    Status: Sold

    +
    +
    + + +
    +
  • +
  • +
    +

    Noah Thompson

    +

    Base Price: $60,000

    +

    Status: Available

    +
    +
    + + +
    +
  • +
+
+
+
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/player_management_screen/screen.png b/realtimeBidding-aayush/stich-design/player_management_screen/screen.png new file mode 100644 index 0000000..018ab8e Binary files /dev/null and b/realtimeBidding-aayush/stich-design/player_management_screen/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/player_profile_screen/code.html b/realtimeBidding-aayush/stich-design/player_profile_screen/code.html new file mode 100644 index 0000000..ddb8175 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/player_profile_screen/code.html @@ -0,0 +1,119 @@ + + + + + + +Stitch Design + + + + + + +
+
+
+
+ +

Player Details

+
+
+
+
+
+
+
+
+

Rohan Sharma

+

Age: 28 | Country: India

+
+
+
+
+

Skills

+
+Batsman +Right-arm Fast +All-rounder +
+
+
+

Auction Status

+
+
+

Sold

+

$1.2M

+
+

Winning Team: Mumbai

+
+
+
+

Statistics

+
+
+

Matches Played

+

120

+
+
+

Runs

+

3500

+
+
+

Wickets

+

80

+
+
+

Average

+

35.00

+
+
+

Strike Rate

+

140.50

+
+
+

Economy

+

7.50

+
+
+
+
+
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/player_profile_screen/screen.png b/realtimeBidding-aayush/stich-design/player_profile_screen/screen.png new file mode 100644 index 0000000..16d9bf9 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/player_profile_screen/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/pre-auction_lobby/code.html b/realtimeBidding-aayush/stich-design/pre-auction_lobby/code.html new file mode 100644 index 0000000..aea988c --- /dev/null +++ b/realtimeBidding-aayush/stich-design/pre-auction_lobby/code.html @@ -0,0 +1,193 @@ + + + + + + +Stitch Design + + + + + + +
+
+
+ +

IPL Auction

+
+
+
+
+
+

Next Player

+
+
+
+
+
+

Set 1

+

Rohan Sharma

+

All-Rounder | India

+
+
+

Base Price

+

₹20L

+
+
+
+
+
+
+

Upcoming Players

+
+
+Arjun Verma +
+

Arjun Verma

+

Batsman | India

+
+

₹20L

+
+
+Liam Carter +
+

Liam Carter

+

Bowler | Australia

+
+

₹20L

+
+
+Ethan Bennett +
+

Ethan Bennett

+

All-Rounder | England

+
+

₹20L

+
+
+
+
+

All Players

+
+search + +
+
+
+Arjun Verma +
+

Arjun Verma

+

Batsman | India

+
+₹20L +
+
+Liam Carter +
+

Liam Carter

+

Bowler | Australia

+
+₹20L +
+
+Ethan Bennett +
+

Ethan Bennett

+

All-Rounder | England

+
+SOLD +
+
+Rohan Sharma +
+

Rohan Sharma

+

Batsman | India

+
+₹20L +
+
+
+
+

Teams

+
+
+Mumbai Titans +
+

Mumbai Titans

+

Wallet: ₹10Cr

+
+
+
+Chennai Super Kings +
+

Chennai Super Kings

+

Wallet: ₹12Cr

+
+
+
+Delhi Capitals +
+

Delhi Capitals

+

Wallet: ₹8Cr

+
+
+
+
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/pre-auction_lobby/screen.png b/realtimeBidding-aayush/stich-design/pre-auction_lobby/screen.png new file mode 100644 index 0000000..734dd18 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/pre-auction_lobby/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/team_admin_dashboard/code.html b/realtimeBidding-aayush/stich-design/team_admin_dashboard/code.html new file mode 100644 index 0000000..624d216 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/team_admin_dashboard/code.html @@ -0,0 +1,133 @@ + + + +Stitch Design + + + + + + +
+
+
+
+ +

Live Auction

+
+
+
+
+
+
+Team Titans logo +
+

Team Titans

+

Wallet Balance: $1,200,000

+
+
+
+
+

Current Player

+
+
+
+

Player 1

+

Rohan Sharma

+

All-rounder

+
+Rohan Sharma +
+
+
+

Place Bid

+

Next Bid: $100,000

+
+ +
+
+
+
+

Acquired Players

+
+
+
+Rohan Sharma +
+

Rohan Sharma

+

All-rounder

+
+
+

$100,000

+
+
+
+Arjun Verma +
+

Arjun Verma

+

Batsman

+
+
+

$150,000

+
+
+
+Karan Patel +
+

Karan Patel

+

Bowler

+
+
+

$80,000

+
+
+
+
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/team_admin_dashboard/screen.png b/realtimeBidding-aayush/stich-design/team_admin_dashboard/screen.png new file mode 100644 index 0000000..c16ca67 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/team_admin_dashboard/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/team_management_screen/code.html b/realtimeBidding-aayush/stich-design/team_management_screen/code.html new file mode 100644 index 0000000..30bea74 --- /dev/null +++ b/realtimeBidding-aayush/stich-design/team_management_screen/code.html @@ -0,0 +1,123 @@ + + + + + +Stitch Design + + + + + + +
+
+
+ +

Manage Teams

+
+
+
+
+
+

Team List

+
+
+Mumbai Stars logo +
+

Mumbai Stars

+

Wallet: $500,000

+
+
+ + +
+
+
+Chennai Super Kings logo +
+

Chennai Super Kings

+

Wallet: $750,000

+
+
+ + +
+
+
+
+
+

Add New Team

+
+
+ + +
+
+ +
+
+$ +
+ +
+
+
+ +
+
+ +
+ +

or drag and drop

+
+

PNG, JPG, GIF up to 10MB

+
+
+
+ +
+
+
+
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/team_management_screen/screen.png b/realtimeBidding-aayush/stich-design/team_management_screen/screen.png new file mode 100644 index 0000000..ecce2a8 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/team_management_screen/screen.png differ diff --git a/realtimeBidding-aayush/stich-design/transaction_history_screen/code.html b/realtimeBidding-aayush/stich-design/transaction_history_screen/code.html new file mode 100644 index 0000000..dda125d --- /dev/null +++ b/realtimeBidding-aayush/stich-design/transaction_history_screen/code.html @@ -0,0 +1,135 @@ + + + + + + +Stitch Design + + + + + + +
+
+
+ +

Team Wallet

+
+
+
+
+

Mumbai Titans

+

Team Admin

+
+
+

Wallet Summary

+
+
+

Current Balance

+

$1,200,000

+
+
+

Total Money Spent

+

$800,000

+
+
+

Total Money Remaining

+

$400,000

+
+
+
+
+

Transaction Log

+
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Player NameBid AmountTypeDate
Rohan Sharma$200,000 +Buy +05/20/24 10:00 AM
Vikram Patel$150,000 +Buy +05/20/24 11:30 AM
-$50,000 +Deduct +05/20/24 12:00 PM
+
+
+
+
+
+ +
+ + \ No newline at end of file diff --git a/realtimeBidding-aayush/stich-design/transaction_history_screen/screen.png b/realtimeBidding-aayush/stich-design/transaction_history_screen/screen.png new file mode 100644 index 0000000..f751482 Binary files /dev/null and b/realtimeBidding-aayush/stich-design/transaction_history_screen/screen.png differ