feat: Remover código inatingível dos testes de estresse e criar script manual para execução

Author: code-cfernandes

docs/CODE-QUALITY-IMPROVEMENTS.md

@@ -218,12 +218,42 @@ Updated documentation files:
 - **IMPLEMENTATION_GUIDE.md**: Documented test quality improvements
 - **CODE-QUALITY-IMPROVEMENTS.md**: This comprehensive tracking document
 
+### 8. Unreachable Code Removal
+
+**Problem**: Stress tests with unreachable code after `markTestSkipped()`
+**Location**: `tests/Performance/StressTest.php`
+**Solution**: Removed unreachable code and created separate manual test script
+
+```php
+// Before: Unreachable code after markTestSkipped()
+public function testHighConcurrentRequests(): void
+{
+    self::markTestSkipped('Stress tests should be run manually');
+    
+    // Hundreds of lines of unreachable code...
+    $concurrentRequests = 100;
+    // ... more unreachable implementation
+}
+
+// After: Clean test method
+public function testHighConcurrentRequests(): void
+{
+    self::markTestSkipped('Stress tests should be run manually');
+}
+```
+
+**Solution**: Created `scripts/stress-test.php` with all stress test implementations that can be run manually:
+```bash
+php scripts/stress-test.php
+```
+
 ## Future Recommendations
 
 1. **Continuous Quality Monitoring**: Run regular code quality checks
 2. **Automated Reviews**: Integrate AI-powered code review in CI/CD
 3. **Test Coverage**: Maintain high test coverage with meaningful assertions
 4. **Documentation**: Keep implementation guides updated with learnings
+5. **Separate Manual Tests**: Keep manual test code in scripts, not in unreachable PHPUnit methods
 
 ## Commands for Quality Assurance
 

docs/TESTING-GUIDE.md

@@ -91,6 +91,25 @@ Performance tests are marked as skipped by default to prevent accidental executi
 
 # Run with custom memory limit
 php -d memory_limit=1G vendor/bin/phpunit -c phpunit-performance.xml
+
+# Run manual stress tests (recommended)
+php scripts/stress-test.php
+```
+
+### Manual Stress Testing
+
+For comprehensive stress testing, use the dedicated manual script:
+
+```bash
+# Run all stress tests
+php scripts/stress-test.php
+
+# The script includes:
+# - High concurrent requests testing
+# - Memory usage monitoring under load
+# - CPU intensive workload testing
+# - Large response handling
+# - Error recovery validation
 ```
 
 ### Continuous Integration