# 🎮 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**

### **Option 1: Desktop Application (Recommended)**
1. **Install Node.js** (if not already installed):
   - Download from: https://nodejs.org/
   - Choose the LTS version
   
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.