training-academy/docs/TESTER_GUIDE.md

6.3 KiB

🎮 Gooner Training Academy - Beta Testing Guide

Version: 4.0 Beta
Test Build Date: November 17, 2025
Testing Period: [Your Timeline Here]


🚨 Important Notice

This is adult content software intended only for consenting adults 18+. This beta version is for testing purposes only.


📋 Quick Setup Guide

  1. Install Node.js (if not already installed):

  2. Run Setup:

    • Windows: Double-click setup.bat
    • Mac/Linux: Run ./setup.sh in terminal
  3. Launch Application:

    • Windows: Double-click Start-webgame.bat
    • Mac/Linux: Run npm start

Option 2: Web Browser

  1. Open index.html in a modern browser (Chrome, Firefox, Edge)
  2. Allow camera permissions when prompted
  3. Note: Limited features compared to desktop version

🎯 What to Test

Priority 1: Core Game Modes

  • Training Academy - Scenario-based training with webcam verification
  • Quick Play - Fast-start sessions with task filtering
  • Porn Cinema - Professional video player with playlists

Priority 2: Key Features

  • XP System - Points tracking across all modes
  • Webcam Integration - Position verification and photo capture
  • Task Management - Enable/disable individual tasks
  • Background Videos - Video integration during gameplay
  • Library Management - Upload and organize custom content

Priority 3: System Features

  • Backup System - Automatic and manual backup/restore
  • Theme System - 6 visual themes including dynamic library theme
  • Statistics Dashboard - Progress tracking and analytics
  • Audio System - Background music and TTS narration

🔍 Testing Scenarios

Scenario 1: New User Experience

  1. Launch application for first time
  2. Navigate through main interface
  3. Try each game mode briefly
  4. Upload 2-3 test images to library
  5. Expected: Smooth onboarding with clear navigation

Scenario 2: Quick Play Session

  1. Start Quick Play mode
  2. Set 15-minute session
  3. Enable/disable different task types
  4. Test background video controls
  5. Complete session normally
  6. Expected: Seamless task flow with working controls

Scenario 3: Training Academy

  1. Start Training Academy
  2. Choose Photography Studio mode
  3. Complete webcam position verification
  4. Take multiple photos
  5. Expected: Stable webcam integration without crashes

Scenario 4: Media Library

  1. Upload 5+ custom images
  2. Test bulk selection and organization
  3. Switch between different themes
  4. Link external video directory (desktop only)
  5. Expected: Responsive library management

Scenario 5: Long Session Testing

  1. Run 30+ minute Quick Play session
  2. Test pause/resume functionality
  3. Monitor performance and memory usage
  4. Expected: Stable performance without slowdown

🐛 Known Issues

Current Limitations

  • Browser Version: Limited file system access
  • Video Formats: Some older formats may not play correctly
  • Storage Limits: 50 image maximum in library
  • Performance: May slow down with 20+ minutes sessions

Workarounds

  • Video Issues: Try different video formats (MP4 works best)
  • Performance: Restart application if sluggish
  • Storage Full: Use library management to remove unused images

📝 Feedback Collection

What We Need From You:

Bug Reports:

Bug Title: [Short description]
Steps to Reproduce:
1. 
2. 
3. 

Expected Result: 
Actual Result: 
Browser/OS: 
Screenshots: [If applicable]

Feature Feedback:

  • Most Used Features:
  • Least Used Features:
  • Missing Features:
  • UI/UX Suggestions:

Performance Reports:

  • Session Length Tested:
  • Performance Issues:
  • Crash Reports:
  • Memory Usage:

Content & Library:

  • Theme Preferences:
  • Library Organization:
  • Video Integration Quality:
  • Upload Process Experience:

⚠️ Troubleshooting

Application Won't Start

  • Ensure Node.js is installed (v16+ required)
  • Run npm install manually
  • Check antivirus isn't blocking files

Webcam Not Working

  • Grant camera permissions in browser
  • Check camera isn't used by other apps
  • Try refreshing the page

Videos Not Playing

  • Verify video format (MP4 recommended)
  • Check file paths for special characters
  • Ensure files aren't corrupted

Performance Issues

  • Restart application
  • Clear browser cache
  • Reduce session duration
  • Remove unused library content

Data Loss Issues

  • Use manual backup before testing
  • Check backups/ folder for auto-saves
  • Import/export feature available in settings

📊 Test Data Collection

Session Logs

The application automatically logs:

  • Session durations and completion rates
  • Feature usage statistics
  • Performance metrics
  • Error occurrences

Feedback Submission

Send feedback to: [Your Email/Contact]

Include:

  • Test environment details (OS, browser, hardware)
  • Session logs (if comfortable sharing)
  • Screenshots/videos of issues
  • Feature requests and suggestions

🎯 Testing Goals

Stability Testing

  • No crashes during normal use
  • Graceful error handling
  • Data persistence across sessions

Feature Completeness

  • All advertised features functional
  • Cross-mode compatibility
  • Proper XP tracking and statistics

User Experience

  • Intuitive navigation
  • Responsive interface
  • Clear error messages and feedback

Performance

  • Smooth operation under normal use
  • Reasonable resource usage
  • Fast loading times

📞 Support & Contact

For Technical Issues:

  • Check this guide first
  • Review console logs (F12 in browser)
  • Include detailed reproduction steps

For Feature Requests:

  • Describe the desired functionality
  • Explain the use case
  • Suggest implementation approach

For General Feedback:

  • Overall experience impressions
  • Comparison with similar applications
  • Suggestions for improvement

Thank you for helping test the Gooner Training Academy! 🎉

Your feedback is essential for creating the best possible experience for all users.