- Troubleshooted and fixed issues with the plugin deployment script (`deploy-plugin.sh`) to ensure all necessary plugin files, including the main plugin file, are correctly transferred to the staging environment. - Corrected a role name mismatch in the test user creation script (`setup-staging-test-users.sh`) to successfully create a test user with the `hvac_trainer` role on staging. - Updated the E2E test runner script (`run-tests.sh`) to replace deprecated Docker commands with SSH commands targeting the staging environment and explicitly pass the staging URL to Playwright. - Increased the global timeout and enabled retries in the Playwright configuration (`playwright.config.ts`) to aid in debugging test failures on the staging environment. - Updated documentation files (`docs/mvp-integration-testing-plan.md`, `wordpress-dev/README.md`, and `wordpress-dev/MIGRATION_GUIDE.md`) to include instructions on setting up the test user for the staging environment and corrected section numbering in the testing plan.
3.5 KiB
3.5 KiB
Product Context
This file provides a high-level overview of the project and the expected product that will be created. 2025-04-23 19:00:00 - Updated with Cloudways staging environment workflow
Project Goal
Network Events is a WordPress plugin that extends The Events Calendar suite to create a specialized platform for HVAC trainers. The system enables independent trainers to manage their own events, sell tickets, and track performance without accessing the WordPress admin panel.
Development Environment
Core Components
- Cloudways Staging Environment
- WordPress (PHP 8.1-FPM)
- Nginx web server
- MariaDB database
- Cloudways dashboard for management
- Development Tools
- Playwright testing framework
- Git version control
- SSH and rsync for deployment
- Development scripts
- Debug tools
Development Workflow
- Staging-Based Approach
- Production data backup creation
- Staging environment deployment
- Testing on staging environment
- Consistent development environment
- Collaborative development capability
- Script Suite
- deploy-config-staging.sh - Deploy configuration to staging
- configure-staging-tests.sh - Configure test environment
- run-staging-tests.sh - Run tests on staging
- verify-staging.sh - Verify staging environment
- sync-staging.sh - Sync data from staging
- deploy-plugin.sh - Deploy plugin to staging
- run-staging-unit-tests.sh - Run unit tests on staging
Configuration Management
- Environment Settings
- Staging-specific configurations
- Debug mode enabled
- Error display active
- SSL enabled
- Staging URLs
- Production Preparation
- Secure configurations ready
- SSL support enabled
- Error logging configured
- Performance optimizations
- Security measures
Key Features
- Custom user role for HVAC trainers
- Trainer registration and login system
- Comprehensive trainer dashboard
- Event creation and management
- Event summary and reporting
- Attendee management
- Email communication with attendees (Phase 2)
- Certificate generation and management (Phase 3)
- Integration with The Events Calendar suite
- Future Zoho CRM integration (Phase 2)
Implementation Phases
Phase 1 (In Progress)
- Community Login Page (Completed)
- Registration Page (Completed)
- Basic Dashboard (In Progress)
- Create/Modify Event Pages (Planned)
- Event Summary Page (Planned)
Phase 2 (Future)
- Zoho CRM API Integration
- Email Attendees functionality
- Enhanced event management
- Advanced reporting
Phase 3 (Future)
- Certificate generation
- Request Training Page
- My Training Page
- Advanced reporting
Technical Architecture
WordPress Integration
- Core WordPress 6.7+
- The Events Calendar suite integration
- Custom plugin development
- Theme compatibility
- Security measures
Required Plugins
-
The Events Calendar Suite:
- The Events Calendar (6.10.2+)
- Events Calendar Pro (7.4.2+)
- Event Tickets (5.19.3+)
- Event Tickets Plus (6.2.0+)
- Community Events (4.10.0+)
-
Additional Required Plugins:
- Spectra Pro (2.0.0+)
- Premium Starter Templates (4.4.14+)
- Essential Blocks (5.3.2+)
Development Standards
- PHP 8.1+ compatibility
- WordPress coding standards
- Modern JavaScript practices
- Responsive design
- Accessibility compliance
- Security best practices
Testing Strategy
- Unit testing
- Integration testing
- E2E testing with Playwright
- Performance testing
- Security testing
2025-04-23 19:00:00 - Updated with Cloudways staging environment workflow