iDefineHD/TurboTrades
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
TurboTrades/ADMIN_QUICK_REFERENCE.md
iDefineHD 232968de1e first commit
2026-01-10 04:57:43 +00:00

5.7 KiB
Raw Permalink Blame History

Admin Panel Quick Reference

🚀 Quick Start

# Check current status
node check-prices.js

# Update all prices now
node update-prices-now.js

# Update specific game
node update-prices-now.js cs2
node update-prices-now.js rust

# Test Steam API connection
node test-steam-api.js

# Make user admin
node make-admin.js

🔑 Access

URL: http://localhost:5173/admin

Requirements:

  • staffLevel >= 3
  • OR Steam ID in ADMIN_STEAM_IDS

Your Account: ✅ Already set to staffLevel 3

📊 Tabs Overview

1. Dashboard

  • User count, active items, transactions
  • Recent activity feed
  • Top sellers

2. Financial (🆕)

  • Gross Profit: Total fees collected
  • Net Profit: Profit after deposits/withdrawals
  • Deposits, Withdrawals, Purchases, Sales
  • Period filters (today, week, month, year, all)

3. Transactions (🆕)

  • View all transactions
  • Filter by type, status, user
  • Shows: date, user, amount, fee, balance

4. Items (🆕)

  • Filter by game: CS2 / Rust / All
  • Search, sort, filter by status/category
  • Edit Prices button to override
  • Shows listing price + market price

💰 Price Management

Current Status

CS2:  14/19 items (73.7%) ✅
Rust: 0/4 items (0%)

Override Prices

  1. Go to Items tab
  2. Filter by game (CS2/Rust)
  3. Click "Edit Prices" on item
  4. Set Listing Price + Market Price
  5. Save

Automatic Updates

  • ✅ Runs on backend startup
  • ✅ Runs every 60 minutes
  • ✅ 29,602 CS2 prices available
  • ✅ 5,039 Rust prices available

🎯 Common Tasks

Daily

  • Check Financial tab for profit
  • Review recent transactions
  • Check failed transactions
  • Monitor items without prices

Weekly

  • Analyze profit trends
  • Review top sellers
  • Override missing prices
  • Check user balances

Monthly

  • Audit price overrides
  • Review fee structure
  • Analyze sales patterns

🔍 Filters & Search

Transaction Filters

  • Type: deposit, withdrawal, purchase, sale, trade, bonus, refund
  • Status: completed, pending, failed, cancelled
  • User ID: MongoDB ObjectId
  • Date Range: Custom start/end dates

Item Filters

  • Game: CS2, Rust, or All
  • Status: active, sold, removed
  • Category: rifles, pistols, knives, gloves, etc.
  • Search: Item name
  • Sort: price, marketPrice, listedAt, views

📈 Understanding Metrics

Financial Formulas

Gross Profit = Sum(all fees)
Net Profit = Gross Profit - (Withdrawals - Deposits)
Net Balance = Deposits - Withdrawals

Color Codes

  • 🟢 Green: Positive (deposits, sales, income)
  • 🔴 Red: Negative (withdrawals, purchases, expenses)
  • 🟡 Yellow: Warning or pending
  • 🔵 Blue: Informational
  • 🟣 Purple: Admin actions

🛠️ Troubleshooting

Items Not Loading

✅ Fixed - Query params now filter empty values

No Prices

node update-prices-now.js

Admin Menu Not Gold

✅ Fixed - Gold gradient applied to Admin menu item

Prices Not Auto-Updating

Check .env:

ENABLE_PRICE_UPDATES=true

🔐 Security Checklist

  • Admin access limited to staffLevel 3+
  • All admin routes authenticated
  • Price overrides logged
  • Steam IDs validated
  • Enable 2FA (recommended)
  • Monitor for suspicious transactions

📱 UI Features

Dashboard Tab

  • Quick stats cards
  • Recent activity feed
  • Top sellers list

Financial Tab

  • Period filters
  • Profit calculations
  • Transaction breakdowns
  • CS2/Rust metrics

Transactions Tab

  • Advanced filters
  • Pagination (50/page)
  • User info with avatars
  • Type/status badges

Items Tab

  • Game separation
  • Search + filters
  • Price override modal
  • Pagination (20/page)

🎨 Visual Indicators

Admin Menu

  • 🟡 Gold background in dropdown
  • Yellow gradient highlight
  • Border accent

Transaction Types

  • Deposit: Green badge
  • Withdrawal: Red badge
  • Purchase: Blue badge
  • Sale: Purple badge
  • Trade: Yellow badge
  • Bonus: Pink badge
  • Refund: Orange badge

Item Rarity

  • Common: Gray
  • Uncommon: Green
  • Rare: Blue
  • Mythical: Purple
  • Legendary: Pink
  • Ancient: Red
  • Exceedingly: Yellow

🚨 Quick Alerts

When to Act

Immediate:

  • Failed withdrawals
  • Negative net profit
  • Security alerts
  • API errors

Soon:

  • Low price coverage (<50%)
  • Unusual transaction patterns
  • High refund rate
  • Missing market data

Eventually:

  • Items without views
  • Stale listings (>30 days)
  • Inactive users with balance
  • Price discrepancies

📞 Help

Diagnostic Commands

# Check everything
node check-prices.js

# Test API
node test-steam-api.js

# View MongoDB
mongosh turbotrades
db.items.countDocuments()
db.transactions.countDocuments()

Logs to Check

  • Backend console output
  • Browser dev console (F12)
  • MongoDB logs
  • API error responses

Files to Review

  • .env - Configuration
  • ADMIN_PANEL.md - Full documentation
  • PRICING_SYSTEM.md - Price details
  • SESSION_PILLS_AND_TRANSACTIONS.md - Transaction system

✅ Success Checklist

  • Admin panel accessible at /admin
  • Gold admin menu in dropdown
  • Financial tab tracking profit
  • Transactions tab with filters
  • Items tab with price overrides
  • CS2/Rust separation working
  • Automatic price updates (hourly)
  • 73.7% CS2 price coverage
  • Steam API connected (29,602 prices)
  • All tabs loading correctly

🎉 You're Ready!

Everything is configured and working. Navigate to /admin and start managing your marketplace!

Quick Links:

  • Admin Panel: http://localhost:5173/admin
  • Backend: http://localhost:3000
  • MongoDB: mongodb://localhost:27017/turbotrades
  • SteamAPIs: https://steamapis.com/

Support: Check ADMIN_PANEL.md for detailed documentation

Reference in New Issue View Git Blame Copy Permalink