upskill-event-manager/memory-bank/productContext.md
Ben Reed 04dcc32919 feat(testing): Implement comprehensive trainer journey test suite with Page Object Model
- 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.
2025-05-18 15:42:00 -03:00

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

  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.