Ben Reed
04dcc32919
- 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.
127 lines
No EOL
3.8 KiB
Markdown
127 lines
No EOL
3.8 KiB
Markdown
# 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
|
|
1. 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+)
|
|
|
|
2. 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. |