🏆 TurnFix Jury Portal - Competition Day Access

Quick Access for Jury Members

Dedicated URL (No Dashboard Confusion)

  • Local Computer: http://localhost:5174
  • Network Access: http://[YOUR-IP]:5174
  • Mobile/Tablet: Same network URL

Key Benefits

✅ Separate from main dashboard - jury can't access administrative functions
✅ Real data - connected to actual database and participants
✅ Mobile optimized - works on tablets and smartphones
✅ Simple workflow - Event → Squad → Device → Score Entry

For Competition Organizers

Setup Instructions

  1. Start All Services: 
    .\start-with-jury.ps1
    This starts:
  2. Main Server (API): http://localhost:3001
  3. Main Client: http://localhost:5173

  4. Jury Portal: http://localhost:5174

  5. Network Access:

  6. Ensure Windows Firewall allows port 5174
  7. Get your IP address: ipconfig

  8. Share URL: http://[YOUR-IP]:5174 with jury members

  9. QR Code Generation (Optional):

  10. Generate QR code for http://[YOUR-IP]:5174
  11. Print and post at jury stations

Jury Workflow

  1. Access Portal: Go to dedicated URL (port 5174)
  2. Select Event: Choose active competition
  3. Select Squad: Pick assigned riege/squad
  4. Select Device: Choose gymnastics apparatus
  5. Score Entry:
  6. See current participant highlighted
  7. View participant list for this device
  8. Enter scores and progress automatically

Features

Real Data Integration

  • ✅ Fetches actual events from database
  • ✅ Shows real squads with participant counts
  • ✅ Displays actual participants per squad/device
  • ✅ Saves scores to database with proper foreign key handling

Participant Management

  • ✅ Shows previous, current, and next participant
  • ✅ Displays full participant list for selected device
  • ✅ Visual progress tracking
  • ✅ Automatic advancement after score entry

Mobile Support

  • ✅ Touch-friendly large buttons
  • ✅ Responsive design for tablets
  • ✅ Network accessible from any device
  • ✅ No app installation required

Technical Details

Architecture

  • Port: 5174 (dedicated for jury)
  • Backend: Proxies to main API (port 3001)
  • Frontend: Simplified React interface
  • Database: Same as main application

Network Requirements

  • Port 5174 open for jury access
  • Same network as main TurnFix server
  • No additional firewall rules needed

Backup Access

If jury portal is unavailable: - Use main application: http://localhost:5173 - Navigate to Dashboard → Event Management → "Jury Portal" - Less optimal but functional fallback

Troubleshooting

Common Issues

  1. "No events found"
  2. Check main server is running (port 3001)

  3. Verify database connection

  4. "No participants for device"

  5. Ensure participants are assigned to squads

  6. Check competition has participants registered

  7. Network access fails

  8. Verify Windows Firewall settings
  9. Check IP address is correct
  10. Ensure all devices on same network

Support Commands

# Check if services are running
netstat -an | findstr "3001 5174"

# Get current IP address  
ipconfig | findstr "IPv4"

# Test jury portal locally
curl http://localhost:5174/api/health

Competition Day Checklist

Before Competition

  • Start all services with start-with-jury.ps1
  • Test jury portal access locally
  • Test jury portal from mobile device
  • Share network URL with jury members
  • Print QR codes if needed

During Competition

  • Jury accesses dedicated URL (port 5174)
  • No access to main dashboard
  • Real participant data displayed
  • Scores saved automatically
  • Progress tracked visually

Emergency Fallback

  • Main application available at port 5173
  • Dashboard access if needed
  • Manual score entry possible

🎯 Result: Jury members have a dedicated, simplified interface that eliminates confusion and focuses solely on score entry with real competition data!