TurboTrades/docs/ADMIN_QUICK_START.md

Admin Panel Quick Start Guide

🚀 Quick Access

1. Log in with admin credentials (staffLevel >= 3)
2. Navigate to Admin section
3. Select the tab you need

---

📋 Quick Actions

Maintenance Mode

Enable Maintenance:

1. Go to Maintenance tab
2. Toggle switch ON
3. Enter custom message
4. Save

Allow Admin Access During Maintenance:

1. Add Steam IDs to whitelist
2. Admins can login via maintenance page

---

Create Announcement

Steps:

1. Announcements tab → + Create
2. Choose type: Info | Warning | Success | Error
3. Write message
4. Toggle enabled
5. (Optional) Set schedule dates
6. Save

Quick Types:

• 🔵 Info - General updates
• 🟡 Warning - Important notices
• 🟢 Success - Good news
• 🔴 Error - Critical alerts

---

Create Promotion

Quick Setup:

1. Promotions tab → + Create
2. Fill basics:
   • Name & description
   • Type (deposit_bonus, discount, etc.)
   • Start/end dates
3. Configure rewards:
   • Bonus percentage or amount
   • Min deposit (if applicable)
   • Max bonus cap
4. Set limits:
   • Uses per user
   • Total uses
5. Save

View Stats:

• Click Stats button on any promotion
• See usage, revenue, and user data
• Export for reports

---

User Management

Search User:

1. User Management tab
2. Type username, Steam ID, or email
3. Results appear instantly

Quick Actions:

• 👁️ Details - View full profile
• 💰 Balance - Add/remove funds
• 🚫 Ban - Temporarily or permanently ban
• ⭐ Promote - Set staff level

Adjust Balance:

1. Click Balance on user
2. Select Credit (add) or Debit (subtract)
3. Enter amount
4. Provide reason (required for audit)
5. Confirm

Ban User:

1. Click Ban
2. Enter reason (required)
3. Set duration in hours (0 = permanent)
4. Confirm

---

🔧 Trading & Market Settings

Trading Settings

• Enabled - Toggle trading on/off
• Deposit/Withdraw - Control each separately
• Min Amounts - Set minimums for deposits/withdrawals
• Withdraw Fee - Percentage fee (0-100%)
• Max Items - Items per trade limit

Market Settings

• Enabled - Toggle marketplace
• Commission - Platform fee (0-100%)
• Price Limits - Min/max listing prices
• Auto-Update - Automatic price updates
• Update Interval - How often to update prices

Don't forget to SAVE after changes!

---

📊 Staff Levels

Level	Role	Permissions
0	User	Regular user access
1	Moderator	Basic moderation
2	Support	User support tools
3	Admin	Full admin panel access
4	Super Admin	All permissions

---

⚠️ Common Mistakes to Avoid

1. ❌ Forgetting to enable announcements/promotions
2. ❌ Not setting end dates for time-limited promotions
3. ❌ Enabling maintenance without adding admin Steam IDs
4. ❌ Forgetting to save changes
5. ❌ Banning users without providing reason

---

🆘 Quick Troubleshooting

Changes not saving?

• Check for error messages in console
• Verify all required fields are filled
• Ensure you have admin permissions

Announcement not showing?

• Is it enabled?
• Check start/end dates
• Clear browser cache

Can't access during maintenance?

• Add your Steam ID to whitelist
• Use Steam login on maintenance page

User balance not updating?

• Check transaction logs
• Verify reason was provided
• Ensure amount is valid

---

📈 Best Practices

Announcements

• ✅ Use appropriate type for message severity
• ✅ Keep messages concise and clear
• ✅ Set end dates for temporary announcements
• ✅ Test dismissibility before going live

Promotions

• ✅ Set realistic usage limits
• ✅ Always set end dates
• ✅ Monitor stats regularly
• ✅ Test promo codes before announcing
• ✅ Use descriptive names

User Management

• ✅ Always provide detailed ban reasons
• ✅ Document balance adjustments
• ✅ Be cautious with permanent bans
• ✅ Review user history before actions
• ✅ Communicate with users about major actions

Maintenance

• ✅ Schedule during low-traffic hours
• ✅ Announce in advance
• ✅ Keep maintenance windows short
• ✅ Test admin bypass before enabling
• ✅ Provide estimated completion time

---

🔐 Security Reminders

1. Never share admin credentials
2. Always provide reasons for actions (audit trail)
3. Double-check before banning users
4. Use strong passwords and 2FA
5. Log out when finished
6. Monitor admin activity logs

---

📞 Emergency Actions

Site Down / Critical Issue

1. Enable maintenance mode immediately
2. Set clear message explaining issue
3. Add all admin Steam IDs to whitelist
4. Investigate and fix
5. Test thoroughly
6. Disable maintenance

Malicious User

1. Ban immediately
2. Document reason thoroughly
3. Review recent transactions
4. Check for associated accounts
5. Report to security team

Promotion Error

1. Disable promotion immediately
2. Review usage logs
3. Adjust balances if necessary
4. Document what happened
5. Fix and re-enable or create new

---

💡 Pro Tips

1. Use search efficiently - Partial matches work for usernames
2. Export promotion data - Use Stats modal export for reports
3. Schedule maintenance - Use date/time pickers for planned windows
4. Monitor regularly - Check user activity and promotion performance
5. Keep notes - Document why you made certain decisions
6. Test first - Try changes on test accounts when possible

---

🎯 Daily Admin Tasks

Morning Checklist

• Check for new user issues
• Review overnight transactions
• Check active promotions performance
• Verify no maintenance mode enabled
• Review any ban appeals

Weekly Tasks

• Analyze promotion statistics
• Review user growth
• Check trading/market performance
• Update announcements if needed
• Clean up expired promotions

Monthly Tasks

• Full platform audit
• Review all active staff members
• Analyze revenue from promotions
• Update trading/market settings if needed
• Plan upcoming promotions

---

🔗 Quick Links

• Complete Documentation
• API Reference
• Troubleshooting Guide

---

📱 Keyboard Shortcuts

To be implemented in future version

---

🆕 Recent Updates

Version 1.0.0

• ✅ Full admin panel implementation
• ✅ User management system
• ✅ Promotion analytics
• ✅ Enhanced security features

---

Need More Help? Refer to the Complete Admin Panel Guide for detailed information.

Questions? Contact the development team or check the troubleshooting section.

---

Last Updated: 2024 Happy Administrating! 🎉