upskill-event-manager/docs/staging-test-simplified-plan.md

Simplified Staging Test Plan

Overview

This document outlines a simplified approach for running basic functional tests on the staging server without relying on Docker or complex test environment setup.

Staging Environment Details

STAGING_URL: https://wordpress-974670-5399585.cloudwaysapps.com/
STAGING_IP: 146.190.76.204
STAGING_SSH_USER: roodev
STAGING_SSH_PASS: uSCO6f1y
STAGING_PATH: /home/974670.cloudwaysapps.com/uberrxmprk/public_html
STAGING_DB_NAME: uberrxmprk
STAGING_DB_USER: uberrxmprk
STAGING_DB_PASSWORD: vRVr7GJCAZ

Simplified Testing Approach

1. Basic Test Configuration

• Use existing database credentials instead of creating a test database
• Focus on tests that don't depend on The Events Calendar functionality
• Use test doubles for essential WordPress/TEC functions

2. Test Configuration Files

wp-tests-config.php

<?php
// Use existing database
define('DB_NAME', 'uberrxmprk');
define('DB_USER', 'uberrxmprk');
define('DB_PASSWORD', 'vRVr7GJCAZ');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

// Test environment
define('WP_TESTS_DOMAIN', 'wordpress-974670-5399585.cloudwaysapps.com');
define('WP_TESTS_EMAIL', 'admin@example.com');
define('WP_TESTS_TITLE', 'Test Blog');

// Debug mode
define('WP_DEBUG', true);

// Path settings
define('ABSPATH', '/home/974670.cloudwaysapps.com/uberrxmprk/public_html/');

bootstrap.php

<?php
// Define test environment
define('HVAC_TEST_DIR', __DIR__);
define('HVAC_PLUGIN_DIR', dirname(__DIR__));
define('HVAC_DEBUG', true);

// Load test doubles first
require_once __DIR__ . '/test-doubles.php';

// Load our plugin
require_once dirname(__DIR__) . '/hvac-community-events.php';

// Initialize test environment
if (defined('HVAC_DEBUG') && HVAC_DEBUG) {
    error_log('[HVAC TEST] Bootstrap complete');
}

test-doubles.php

<?php
// Mock TEC classes if they don't exist
if (!class_exists('Tribe__Events__Main')) {
    class Tribe__Events__Main {
        const POSTTYPE = 'tribe_events';
        const VENUE_POST_TYPE = 'tribe_venue';
        const ORGANIZER_POST_TYPE = 'tribe_organizer';
    }
}

// Mock TEC functions
if (!function_exists('tribe_get_start_date')) {
    function tribe_get_start_date($event_id) {
        return get_post_meta($event_id, '_EventStartDate', true);
    }
}

// Add other required function mocks

3. Basic Test Suite

Create a simplified test suite that focuses on core plugin functionality:

test-basic-functionality.php

<?php
class Test_Basic_Functionality extends WP_UnitTestCase {
    public function test_plugin_loaded() {
        $this->assertTrue(class_exists('HVAC_Community_Events'));
    }
    
    public function test_plugin_version() {
        $this->assertNotEmpty(HVAC_CE_VERSION);
    }
    
    // Add other basic tests
}

4. Deployment and Execution

deploy-basic-tests.sh

#!/bin/bash
# Load environment variables
source $(dirname "$0")/../.env

# Deploy test files
sshpass -p "$UPSKILL_STAGING_PASS" ssh -o StrictHostKeyChecking=no "$UPSKILL_STAGING_SSH_USER@$UPSKILL_STAGING_IP" \
    "mkdir -p $UPSKILL_STAGING_PATH/wp-content/plugins/hvac-community-events/tests/basic"

# Copy test files
scp -o StrictHostKeyChecking=no \
    test-basic-functionality.php \
    "$UPSKILL_STAGING_SSH_USER@$UPSKILL_STAGING_IP:$UPSKILL_STAGING_PATH/wp-content/plugins/hvac-community-events/tests/basic/"

echo "Basic test files deployed successfully."

run-basic-tests.sh

#!/bin/bash
# Load environment variables
source $(dirname "$0")/../.env

# Run basic tests
sshpass -p "$UPSKILL_STAGING_PASS" ssh -o StrictHostKeyChecking=no "$UPSKILL_STAGING_SSH_USER@$UPSKILL_STAGING_IP" \
    "cd $UPSKILL_STAGING_PATH/wp-content/plugins/hvac-community-events && \
    ./vendor/bin/phpunit --testsuite basic"

echo "Basic tests completed."

Implementation Steps

1. Create simplified test configuration files
2. Create basic test suite focusing on core functionality
3. Deploy test files to staging
4. Run basic tests to validate the approach
5. Gradually expand test coverage as confidence increases

Test Implementation Results (2025-04-10)

Current Status

• Enhanced logging system fully implemented
• Plugin loading issues resolved
• Simplified test framework operational
• Monitoring and maintenance procedures established

Implemented Solutions

1. Enhanced Logging System

   • Multi-level logging (DEBUG, INFO, WARNING, ERROR)
   • Categorized log entries
   • Automatic log rotation
   • Log analysis utilities

2. Test Framework Improvements

   • Environment-aware configuration
   • Automatic validation checks
   • Independent test execution
   • Detailed test reporting

3. Plugin Loading Resolution

   • Corrected test doubles loading order
   • Added environment validation
   • Implemented dependency checks
   • Created diagnostic utilities

4. Monitoring System

   • Log analysis tools
   • Performance tracking
   • Error rate monitoring
   • Resource usage tracking

New Testing Approach

1. Environment Validation

   // Example validation check
   class EnvironmentValidator {
       public static function validate() {
           self::checkWordPressVersion();
           self::validateConstants();
           self::checkDependencies();
           self::verifyPermissions();
       }
   }
   

2. Test Execution

   // Example test runner
   class SimplifiedTestRunner {
       public function run($testSuite) {
           $this->validateEnvironment();
           $this->initializeLogging();
           $this->loadTestDoubles();
           $this->executeTests($testSuite);
           $this->generateReport();
       }
   }
   

3. Diagnostic Tools

   // Example diagnostic utility
   class DiagnosticTools {
       public static function analyzeLogFile($logFile) {
           $stats = self::gatherStatistics($logFile);
           $issues = self::identifyIssues($stats);
           return self::generateReport($issues);
       }
   }
   

Maintenance Procedures

1. Regular Checks

   • Daily log analysis
   • Weekly performance review
   • Monthly test coverage assessment
   • Quarterly framework update review

2. Issue Response

   • Error threshold monitoring
   • Automatic alert system
   • Escalation procedures
   • Recovery protocols

3. Documentation

   • Maintenance guides
   • Troubleshooting procedures
   • Best practices
   • Configuration templates

Future Enhancements

1. Advanced Testing

   • Integration test suites
   • Performance benchmarks
   • Load testing scenarios
   • Security test cases

2. Automation

   • Automated log analysis
   • Test scheduling system
   • Report generation
   • Alert management

3. Monitoring

   • Real-time dashboards
   • Trend analysis
   • Predictive diagnostics
   • Resource optimization

4. Framework Evolution

   • Plugin API testing
   • Database integration tests
   • UI component testing
   • End-to-end scenarios