- Created Page Object Model structure for all trainer-facing pages - Implemented complete test coverage for trainer journey steps 1-8 - Added centralized test data management with test users and events - Updated run-tests.sh with --trainer-journey option for easy execution - Enhanced documentation with test setup, usage, and troubleshooting guides - Created verification scripts to ensure proper test environment setup - Prepared framework for Phase 2/3 features (email, check-in, certificates) This implementation provides a solid foundation for testing the complete trainer user journey and can be easily extended as new features are deployed.
3.8 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 [2025-04-29 19:09:15] - Debugging and test validation for prioritized plugin features: Ensured Playwright E2E tests accurately reflect the current DOM structure of WordPress plugin pages. Updated documentation to emphasize selector verification and debug log usage for future test maintenance.