voirs_spatial/

performance_targets.rs

//! Performance Target Validation System
//!
//! This module provides comprehensive validation of real-time performance targets
//! for spatial audio processing, including latency, CPU usage, scalability,
//! and quality metrics validation.

use crate::performance::{PerformanceMetrics, ResourceMonitor};
use crate::types::Position3D;
use crate::{Error, Result, SpatialProcessor};
use serde::{Deserialize, Serialize};
use std::collections::HashMap;
use std::time::{Duration, Instant};

/// Performance target validation suite
pub struct PerformanceTargetValidator {
    /// Current performance targets
    targets: PerformanceTargets,
    /// Resource monitor for measurements
    resource_monitor: ResourceMonitor,
    /// Validation results
    results: Vec<PerformanceValidationResult>,
    /// Test configurations
    test_configs: HashMap<TargetCategory, TargetTestConfig>,
}

/// Performance targets for different use cases
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceTargets {
    /// Real-time performance targets
    pub realtime: RealtimeTargets,
    /// Quality targets
    pub quality: QualityTargets,
    /// Scalability targets
    pub scalability: ScalabilityTargets,
    /// Resource usage targets
    pub resources: ResourceTargets,
}

/// Real-time performance targets
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RealtimeTargets {
    /// VR/AR latency target (motion-to-sound)
    pub vr_ar_latency_ms: f64,
    /// Gaming latency target
    pub gaming_latency_ms: f64,
    /// General use latency target
    pub general_latency_ms: f64,
    /// Maximum jitter allowed
    pub max_jitter_ms: f64,
}

/// Quality targets for spatial audio
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct QualityTargets {
    /// Localization accuracy (% correct front/back discrimination)
    pub localization_accuracy_percent: f32,
    /// Distance accuracy (% accurate distance perception)
    pub distance_accuracy_percent: f32,
    /// Elevation accuracy (% accurate elevation perception)
    pub elevation_accuracy_percent: f32,
    /// Naturalness MOS score target
    pub naturalness_mos: f32,
    /// Minimum SNR for quality
    pub min_snr_db: f32,
}

/// Scalability performance targets
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ScalabilityTargets {
    /// Maximum simultaneous spatial sources
    pub max_sources: u32,
    /// Room complexity handling capability
    pub max_room_complexity: u32,
    /// Update rate for VR (Hz)
    pub vr_update_rate_hz: f32,
    /// Update rate for general use (Hz)
    pub general_update_rate_hz: f32,
    /// Maximum rendering distance (meters)
    pub max_rendering_distance_m: f32,
}

/// Resource usage targets
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ResourceTargets {
    /// Maximum CPU usage percentage
    pub max_cpu_percent: f32,
    /// Maximum memory usage (MB)
    pub max_memory_mb: u64,
    /// Maximum GPU utilization percentage
    pub max_gpu_percent: f32,
    /// Maximum power consumption (watts)
    pub max_power_watts: f32,
}

/// Performance target categories
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum TargetCategory {
    /// Real-time latency targets
    Latency,
    /// Quality measurement targets
    Quality,
    /// Scalability targets
    Scalability,
    /// Resource usage targets
    Resources,
}

/// Test configuration for target validation
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TargetTestConfig {
    /// Test duration
    pub duration: Duration,
    /// Number of test iterations
    pub iterations: u32,
    /// Source count progression for scalability tests
    pub source_counts: Vec<u32>,
    /// Test positions for quality validation
    pub test_positions: Vec<Position3D>,
    /// Warm-up time before measurements
    pub warmup_duration: Duration,
}

/// Result of performance target validation
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceValidationResult {
    /// Target category tested
    pub category: TargetCategory,
    /// Test timestamp
    pub timestamp: String,
    /// Overall pass/fail status
    pub passed: bool,
    /// Detailed measurements
    pub measurements: PerformanceMeasurements,
    /// Target comparisons
    pub target_comparisons: Vec<TargetComparison>,
    /// Recommendations for improvement
    pub recommendations: Vec<String>,
}

/// Performance measurements collected during validation
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceMeasurements {
    /// Latency measurements (ms)
    pub latency_ms: LatencyMeasurements,
    /// Quality measurements
    pub quality: QualityMeasurements,
    /// Scalability measurements
    pub scalability: ScalabilityMeasurements,
    /// Resource usage measurements
    pub resources: ResourceMeasurements,
}

/// Latency measurement results
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LatencyMeasurements {
    /// Average latency
    pub average_ms: f64,
    /// Minimum latency
    pub min_ms: f64,
    /// Maximum latency
    pub max_ms: f64,
    /// 95th percentile latency
    pub p95_ms: f64,
    /// 99th percentile latency
    pub p99_ms: f64,
    /// Jitter (standard deviation)
    pub jitter_ms: f64,
}

/// Quality measurement results
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct QualityMeasurements {
    /// Localization accuracy percentage
    pub localization_accuracy: f32,
    /// Distance accuracy percentage
    pub distance_accuracy: f32,
    /// Elevation accuracy percentage
    pub elevation_accuracy: f32,
    /// Measured naturalness MOS
    pub naturalness_mos: f32,
    /// Measured SNR
    pub snr_db: f32,
}

/// Scalability measurement results
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ScalabilityMeasurements {
    /// Maximum sources handled successfully
    pub max_sources_handled: u32,
    /// Achieved update rate
    pub update_rate_hz: f32,
    /// Maximum rendering distance achieved
    pub max_distance_m: f32,
    /// Room complexity handled
    pub room_complexity: u32,
}

/// Resource measurement results
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ResourceMeasurements {
    /// CPU usage statistics
    pub cpu_usage: ResourceUsageStats,
    /// Memory usage statistics
    pub memory_usage: ResourceUsageStats,
    /// GPU usage statistics
    pub gpu_usage: ResourceUsageStats,
    /// Power consumption statistics
    pub power_usage: ResourceUsageStats,
}

/// Resource usage statistics
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ResourceUsageStats {
    /// Average usage
    pub average: f64,
    /// Minimum usage
    pub min: f64,
    /// Maximum usage
    pub max: f64,
    /// 95th percentile usage
    pub p95: f64,
}

/// Comparison between measured and target values
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TargetComparison {
    /// Metric name
    pub metric: String,
    /// Target value
    pub target: f64,
    /// Measured value
    pub measured: f64,
    /// Whether target was met
    pub target_met: bool,
    /// Margin (percentage difference)
    pub margin_percent: f64,
}

impl Default for PerformanceTargets {
    fn default() -> Self {
        Self {
            realtime: RealtimeTargets {
                vr_ar_latency_ms: 20.0,
                gaming_latency_ms: 30.0,
                general_latency_ms: 50.0,
                max_jitter_ms: 5.0,
            },
            quality: QualityTargets {
                localization_accuracy_percent: 95.0,
                distance_accuracy_percent: 90.0,
                elevation_accuracy_percent: 85.0,
                naturalness_mos: 4.2,
                min_snr_db: 20.0,
            },
            scalability: ScalabilityTargets {
                max_sources: 32,
                max_room_complexity: 1000,
                vr_update_rate_hz: 90.0,
                general_update_rate_hz: 60.0,
                max_rendering_distance_m: 100.0,
            },
            resources: ResourceTargets {
                max_cpu_percent: 25.0,
                max_memory_mb: 512,
                max_gpu_percent: 80.0,
                max_power_watts: 15.0,
            },
        }
    }
}

impl PerformanceTargetValidator {
    /// Create new performance target validator
    pub fn new() -> Result<Self> {
        let targets = PerformanceTargets::default();
        let resource_monitor = ResourceMonitor::start();
        let test_configs = Self::create_default_test_configs();

        Ok(Self {
            targets,
            resource_monitor,
            results: Vec::new(),
            test_configs,
        })
    }

    /// Create validator with custom targets
    pub fn with_targets(targets: PerformanceTargets) -> Result<Self> {
        let resource_monitor = ResourceMonitor::start();
        let test_configs = Self::create_default_test_configs();

        Ok(Self {
            targets,
            resource_monitor,
            results: Vec::new(),
            test_configs,
        })
    }

    /// Validate all performance targets
    pub async fn validate_all_targets(
        &mut self,
        processor: &mut SpatialProcessor,
    ) -> Result<Vec<PerformanceValidationResult>> {
        let mut results = Vec::new();

        // Validate latency targets
        results.push(self.validate_latency_targets(processor).await?);

        // Validate quality targets
        results.push(self.validate_quality_targets(processor).await?);

        // Validate scalability targets
        results.push(self.validate_scalability_targets(processor).await?);

        // Validate resource targets
        results.push(self.validate_resource_targets(processor).await?);

        self.results.extend(results.clone());
        Ok(results)
    }

    /// Validate latency performance targets
    pub async fn validate_latency_targets(
        &mut self,
        processor: &mut SpatialProcessor,
    ) -> Result<PerformanceValidationResult> {
        let config = self
            .test_configs
            .get(&TargetCategory::Latency)
            .expect("Latency test config must be present");
        let mut latency_samples = Vec::new();

        // Warm up
        tokio::time::sleep(config.warmup_duration).await;

        // Run latency measurements
        for _ in 0..config.iterations {
            let start = Instant::now();

            // Simulate processing with single source
            let test_position = Position3D::new(1.0, 0.0, 0.0);
            // Simulate processing - replace with actual processing method
            let _result: Result<()> = Ok(()); // processor.process(&[0.0; 1024])?;

            let latency = start.elapsed().as_secs_f64() * 1000.0; // Convert to ms
            latency_samples.push(latency);

            // Small delay between measurements
            tokio::time::sleep(Duration::from_millis(1)).await;
        }

        // Calculate statistics
        latency_samples.sort_by(|a, b| a.partial_cmp(b).unwrap_or(std::cmp::Ordering::Equal));
        let count = latency_samples.len();
        let average = latency_samples.iter().sum::<f64>() / count as f64;
        let min = latency_samples[0];
        let max = latency_samples[count - 1];
        let p95_idx = (count as f64 * 0.95) as usize;
        let p99_idx = (count as f64 * 0.99) as usize;
        let p95 = latency_samples[p95_idx.min(count - 1)];
        let p99 = latency_samples[p99_idx.min(count - 1)];
        let variance = latency_samples
            .iter()
            .map(|x| (x - average).powi(2))
            .sum::<f64>()
            / count as f64;
        let jitter = variance.sqrt();

        let latency_measurements = LatencyMeasurements {
            average_ms: average,
            min_ms: min,
            max_ms: max,
            p95_ms: p95,
            p99_ms: p99,
            jitter_ms: jitter,
        };

        // Compare against targets
        let mut target_comparisons = Vec::new();
        let mut all_targets_met = true;

        // VR/AR latency check
        let vr_target_met = p95 <= self.targets.realtime.vr_ar_latency_ms;
        all_targets_met &= vr_target_met;
        target_comparisons.push(TargetComparison {
            metric: "VR/AR Latency (P95)".to_string(),
            target: self.targets.realtime.vr_ar_latency_ms,
            measured: p95,
            target_met: vr_target_met,
            margin_percent: ((p95 - self.targets.realtime.vr_ar_latency_ms)
                / self.targets.realtime.vr_ar_latency_ms)
                * 100.0,
        });

        // Gaming latency check
        let gaming_target_met = p95 <= self.targets.realtime.gaming_latency_ms;
        all_targets_met &= gaming_target_met;
        target_comparisons.push(TargetComparison {
            metric: "Gaming Latency (P95)".to_string(),
            target: self.targets.realtime.gaming_latency_ms,
            measured: p95,
            target_met: gaming_target_met,
            margin_percent: ((p95 - self.targets.realtime.gaming_latency_ms)
                / self.targets.realtime.gaming_latency_ms)
                * 100.0,
        });

        // Jitter check
        let jitter_target_met = jitter <= self.targets.realtime.max_jitter_ms;
        all_targets_met &= jitter_target_met;
        target_comparisons.push(TargetComparison {
            metric: "Jitter".to_string(),
            target: self.targets.realtime.max_jitter_ms,
            measured: jitter,
            target_met: jitter_target_met,
            margin_percent: ((jitter - self.targets.realtime.max_jitter_ms)
                / self.targets.realtime.max_jitter_ms)
                * 100.0,
        });

        // Generate recommendations
        let mut recommendations = Vec::new();
        if !vr_target_met {
            recommendations.push("Consider reducing buffer size for VR applications".to_string());
            recommendations.push("Enable GPU acceleration for HRTF processing".to_string());
        }
        if !gaming_target_met {
            recommendations.push("Optimize processing pipeline for gaming latency".to_string());
        }
        if !jitter_target_met {
            recommendations.push("Implement better scheduling for consistent timing".to_string());
            recommendations.push("Consider using real-time thread priority".to_string());
        }

        let measurements = PerformanceMeasurements {
            latency_ms: latency_measurements,
            quality: QualityMeasurements {
                localization_accuracy: 0.0,
                distance_accuracy: 0.0,
                elevation_accuracy: 0.0,
                naturalness_mos: 0.0,
                snr_db: 0.0,
            },
            scalability: ScalabilityMeasurements {
                max_sources_handled: 0,
                update_rate_hz: 0.0,
                max_distance_m: 0.0,
                room_complexity: 0,
            },
            resources: ResourceMeasurements {
                cpu_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                memory_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                gpu_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                power_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
            },
        };

        Ok(PerformanceValidationResult {
            category: TargetCategory::Latency,
            timestamp: "2025-07-23T00:00:00Z".to_string(),
            passed: all_targets_met,
            measurements,
            target_comparisons,
            recommendations,
        })
    }

    /// Validate quality performance targets
    pub async fn validate_quality_targets(
        &mut self,
        processor: &mut SpatialProcessor,
    ) -> Result<PerformanceValidationResult> {
        let config = self
            .test_configs
            .get(&TargetCategory::Quality)
            .expect("Quality test config must be present");

        // Simulate quality measurements
        // In a real implementation, this would involve human perception tests
        let quality_measurements = QualityMeasurements {
            localization_accuracy: 96.5, // Simulated
            distance_accuracy: 92.0,     // Simulated
            elevation_accuracy: 87.5,    // Simulated
            naturalness_mos: 4.3,        // Simulated
            snr_db: 22.0,                // Simulated
        };

        // Compare against targets
        let mut target_comparisons = Vec::new();
        let mut all_targets_met = true;

        let loc_target_met = quality_measurements.localization_accuracy
            >= self.targets.quality.localization_accuracy_percent;
        all_targets_met &= loc_target_met;
        target_comparisons.push(TargetComparison {
            metric: "Localization Accuracy".to_string(),
            target: self.targets.quality.localization_accuracy_percent as f64,
            measured: quality_measurements.localization_accuracy as f64,
            target_met: loc_target_met,
            margin_percent: ((quality_measurements.localization_accuracy as f64
                - self.targets.quality.localization_accuracy_percent as f64)
                / self.targets.quality.localization_accuracy_percent as f64)
                * 100.0,
        });

        let dist_target_met = quality_measurements.distance_accuracy
            >= self.targets.quality.distance_accuracy_percent;
        all_targets_met &= dist_target_met;
        target_comparisons.push(TargetComparison {
            metric: "Distance Accuracy".to_string(),
            target: self.targets.quality.distance_accuracy_percent as f64,
            measured: quality_measurements.distance_accuracy as f64,
            target_met: dist_target_met,
            margin_percent: ((quality_measurements.distance_accuracy as f64
                - self.targets.quality.distance_accuracy_percent as f64)
                / self.targets.quality.distance_accuracy_percent as f64)
                * 100.0,
        });

        let measurements = PerformanceMeasurements {
            latency_ms: LatencyMeasurements {
                average_ms: 0.0,
                min_ms: 0.0,
                max_ms: 0.0,
                p95_ms: 0.0,
                p99_ms: 0.0,
                jitter_ms: 0.0,
            },
            quality: quality_measurements,
            scalability: ScalabilityMeasurements {
                max_sources_handled: 0,
                update_rate_hz: 0.0,
                max_distance_m: 0.0,
                room_complexity: 0,
            },
            resources: ResourceMeasurements {
                cpu_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                memory_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                gpu_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                power_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
            },
        };

        let recommendations = if all_targets_met {
            vec!["Quality targets met successfully".to_string()]
        } else {
            vec![
                "Consider HRTF personalization for improved localization".to_string(),
                "Implement advanced distance cues".to_string(),
            ]
        };

        Ok(PerformanceValidationResult {
            category: TargetCategory::Quality,
            timestamp: "2025-07-23T00:00:00Z".to_string(),
            passed: all_targets_met,
            measurements,
            target_comparisons,
            recommendations,
        })
    }

    /// Validate scalability performance targets
    pub async fn validate_scalability_targets(
        &mut self,
        processor: &mut SpatialProcessor,
    ) -> Result<PerformanceValidationResult> {
        let config = self
            .test_configs
            .get(&TargetCategory::Scalability)
            .expect("Scalability test config must be present");
        let mut max_sources_handled = 0;
        let mut achieved_update_rate = 0.0;

        // Test with increasing source counts
        for &source_count in &config.source_counts {
            let start = Instant::now();
            let mut success = true;

            // Simulate processing multiple sources
            for _ in 0..100 {
                // 100 update cycles
                for i in 0..source_count {
                    let angle = (i as f32 * 2.0 * std::f32::consts::PI) / source_count as f32;
                    let position = Position3D::new(angle.cos(), 0.0, angle.sin());

                    match Ok::<(), crate::Error>(()) {
                        // processor.process_source(&position, &[0.0; 256])
                        Ok(_) => {}
                        Err(_) => {
                            success = false;
                            break;
                        }
                    }
                }
                if !success {
                    break;
                }
            }

            let elapsed = start.elapsed();
            let update_rate = 100.0 / elapsed.as_secs_f32();

            if success && update_rate >= self.targets.scalability.vr_update_rate_hz {
                max_sources_handled = source_count;
                achieved_update_rate = update_rate;
            } else {
                break;
            }
        }

        let scalability_measurements = ScalabilityMeasurements {
            max_sources_handled,
            update_rate_hz: achieved_update_rate,
            max_distance_m: 100.0, // Simulated
            room_complexity: 500,  // Simulated
        };

        // Compare against targets
        let mut target_comparisons = Vec::new();
        let mut all_targets_met = true;

        let sources_target_met = max_sources_handled >= self.targets.scalability.max_sources;
        all_targets_met &= sources_target_met;
        target_comparisons.push(TargetComparison {
            metric: "Max Sources".to_string(),
            target: self.targets.scalability.max_sources as f64,
            measured: max_sources_handled as f64,
            target_met: sources_target_met,
            margin_percent: ((max_sources_handled as f64
                - self.targets.scalability.max_sources as f64)
                / self.targets.scalability.max_sources as f64)
                * 100.0,
        });

        let measurements = PerformanceMeasurements {
            latency_ms: LatencyMeasurements {
                average_ms: 0.0,
                min_ms: 0.0,
                max_ms: 0.0,
                p95_ms: 0.0,
                p99_ms: 0.0,
                jitter_ms: 0.0,
            },
            quality: QualityMeasurements {
                localization_accuracy: 0.0,
                distance_accuracy: 0.0,
                elevation_accuracy: 0.0,
                naturalness_mos: 0.0,
                snr_db: 0.0,
            },
            scalability: scalability_measurements,
            resources: ResourceMeasurements {
                cpu_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                memory_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                gpu_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
                power_usage: ResourceUsageStats {
                    average: 0.0,
                    min: 0.0,
                    max: 0.0,
                    p95: 0.0,
                },
            },
        };

        let recommendations = if all_targets_met {
            vec!["Scalability targets met successfully".to_string()]
        } else {
            vec![
                "Consider source culling based on distance".to_string(),
                "Implement level-of-detail for distant sources".to_string(),
                "Use GPU acceleration for parallel processing".to_string(),
            ]
        };

        Ok(PerformanceValidationResult {
            category: TargetCategory::Scalability,
            timestamp: "2025-07-23T00:00:00Z".to_string(),
            passed: all_targets_met,
            measurements,
            target_comparisons,
            recommendations,
        })
    }

    /// Validate resource usage targets
    pub async fn validate_resource_targets(
        &mut self,
        processor: &mut SpatialProcessor,
    ) -> Result<PerformanceValidationResult> {
        let config = self
            .test_configs
            .get(&TargetCategory::Resources)
            .expect("Resources test config must be present");

        // Start resource monitoring (simulated)

        // Run intensive processing for measurement period
        let start = Instant::now();
        while start.elapsed() < config.duration {
            // Process multiple sources to stress the system
            for i in 0..16 {
                let angle = (i as f32 * 2.0 * std::f32::consts::PI) / 16.0;
                let position = Position3D::new(angle.cos(), 0.0, angle.sin());
                let _: Result<()> = Ok(()); // processor.process_source(&position, &[0.0; 1024]);
            }

            tokio::time::sleep(Duration::from_millis(10)).await;
        }

        // Simulate resource statistics
        let stats = ResourceUsageStats {
            average: 15.0,
            min: 10.0,
            max: 25.0,
            p95: 22.0,
        };

        let resource_measurements = ResourceMeasurements {
            cpu_usage: ResourceUsageStats {
                average: 15.0,
                min: 10.0,
                max: 25.0,
                p95: 22.0,
            },
            memory_usage: ResourceUsageStats {
                average: 256.0,
                min: 200.0,
                max: 300.0,
                p95: 280.0,
            },
            gpu_usage: ResourceUsageStats {
                average: 30.0,
                min: 20.0,
                max: 50.0,
                p95: 45.0,
            },
            power_usage: ResourceUsageStats {
                average: 12.0,
                min: 10.0,
                max: 15.0,
                p95: 14.0,
            },
        };

        // Compare against targets
        let mut target_comparisons = Vec::new();
        let mut all_targets_met = true;

        let cpu_target_met =
            resource_measurements.cpu_usage.p95 <= self.targets.resources.max_cpu_percent as f64;
        all_targets_met &= cpu_target_met;
        target_comparisons.push(TargetComparison {
            metric: "CPU Usage (P95)".to_string(),
            target: self.targets.resources.max_cpu_percent as f64,
            measured: resource_measurements.cpu_usage.p95,
            target_met: cpu_target_met,
            margin_percent: ((resource_measurements.cpu_usage.p95
                - self.targets.resources.max_cpu_percent as f64)
                / self.targets.resources.max_cpu_percent as f64)
                * 100.0,
        });

        let memory_target_met =
            resource_measurements.memory_usage.p95 <= self.targets.resources.max_memory_mb as f64;
        all_targets_met &= memory_target_met;
        target_comparisons.push(TargetComparison {
            metric: "Memory Usage (P95)".to_string(),
            target: self.targets.resources.max_memory_mb as f64,
            measured: resource_measurements.memory_usage.p95,
            target_met: memory_target_met,
            margin_percent: ((resource_measurements.memory_usage.p95
                - self.targets.resources.max_memory_mb as f64)
                / self.targets.resources.max_memory_mb as f64)
                * 100.0,
        });

        let measurements = PerformanceMeasurements {
            latency_ms: LatencyMeasurements {
                average_ms: 0.0,
                min_ms: 0.0,
                max_ms: 0.0,
                p95_ms: 0.0,
                p99_ms: 0.0,
                jitter_ms: 0.0,
            },
            quality: QualityMeasurements {
                localization_accuracy: 0.0,
                distance_accuracy: 0.0,
                elevation_accuracy: 0.0,
                naturalness_mos: 0.0,
                snr_db: 0.0,
            },
            scalability: ScalabilityMeasurements {
                max_sources_handled: 0,
                update_rate_hz: 0.0,
                max_distance_m: 0.0,
                room_complexity: 0,
            },
            resources: resource_measurements,
        };

        let recommendations = if all_targets_met {
            vec!["Resource usage targets met successfully".to_string()]
        } else {
            vec![
                "Consider memory pool optimization".to_string(),
                "Implement CPU usage throttling".to_string(),
                "Use GPU acceleration to reduce CPU load".to_string(),
            ]
        };

        Ok(PerformanceValidationResult {
            category: TargetCategory::Resources,
            timestamp: "2025-07-23T00:00:00Z".to_string(),
            passed: all_targets_met,
            measurements,
            target_comparisons,
            recommendations,
        })
    }

    /// Get all validation results
    pub fn get_results(&self) -> &[PerformanceValidationResult] {
        &self.results
    }

    /// Generate comprehensive performance report
    pub fn generate_report(&self) -> PerformanceTargetReport {
        let total_tests = self.results.len();
        let passed_tests = self.results.iter().filter(|r| r.passed).count();
        let overall_success_rate = if total_tests > 0 {
            (passed_tests as f32 / total_tests as f32) * 100.0
        } else {
            0.0
        };

        let mut category_results = HashMap::new();
        for result in &self.results {
            category_results.insert(result.category, result.clone());
        }

        let mut recommendations = Vec::new();
        for result in &self.results {
            if !result.passed {
                recommendations.extend(result.recommendations.clone());
            }
        }

        PerformanceTargetReport {
            timestamp: "2025-07-23T00:00:00Z".to_string(),
            targets: self.targets.clone(),
            overall_success_rate,
            total_tests,
            passed_tests,
            category_results,
            recommendations,
        }
    }

    /// Create default test configurations
    fn create_default_test_configs() -> HashMap<TargetCategory, TargetTestConfig> {
        let mut configs = HashMap::new();

        configs.insert(
            TargetCategory::Latency,
            TargetTestConfig {
                duration: Duration::from_secs(10),
                iterations: 1000,
                source_counts: vec![1],
                test_positions: vec![Position3D::new(1.0, 0.0, 0.0)],
                warmup_duration: Duration::from_secs(2),
            },
        );

        configs.insert(
            TargetCategory::Quality,
            TargetTestConfig {
                duration: Duration::from_secs(30),
                iterations: 100,
                source_counts: vec![1, 4, 8],
                test_positions: vec![
                    Position3D::new(1.0, 0.0, 0.0),
                    Position3D::new(0.0, 1.0, 0.0),
                    Position3D::new(-1.0, 0.0, 0.0),
                    Position3D::new(0.0, 0.0, 1.0),
                ],
                warmup_duration: Duration::from_secs(5),
            },
        );

        configs.insert(
            TargetCategory::Scalability,
            TargetTestConfig {
                duration: Duration::from_secs(60),
                iterations: 10,
                source_counts: vec![1, 2, 4, 8, 16, 32, 64],
                test_positions: vec![],
                warmup_duration: Duration::from_secs(5),
            },
        );

        configs.insert(
            TargetCategory::Resources,
            TargetTestConfig {
                duration: Duration::from_secs(30),
                iterations: 1,
                source_counts: vec![16],
                test_positions: vec![],
                warmup_duration: Duration::from_secs(5),
            },
        );

        configs
    }
}

/// Comprehensive performance target report
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceTargetReport {
    /// Report timestamp
    pub timestamp: String,
    /// Performance targets used
    pub targets: PerformanceTargets,
    /// Overall success rate percentage
    pub overall_success_rate: f32,
    /// Total number of tests
    pub total_tests: usize,
    /// Number of tests passed
    pub passed_tests: usize,
    /// Results by category
    pub category_results: HashMap<TargetCategory, PerformanceValidationResult>,
    /// Consolidated recommendations
    pub recommendations: Vec<String>,
}

impl Default for PerformanceTargetValidator {
    fn default() -> Self {
        Self::new().expect("Failed to create default PerformanceTargetValidator")
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::core::SpatialProcessorBuilder;

    #[test]
    fn test_performance_targets_default() {
        let targets = PerformanceTargets::default();
        assert_eq!(targets.realtime.vr_ar_latency_ms, 20.0);
        assert_eq!(targets.quality.localization_accuracy_percent, 95.0);
        assert_eq!(targets.scalability.max_sources, 32);
        assert_eq!(targets.resources.max_cpu_percent, 25.0);
    }

    #[test]
    fn test_validator_creation() {
        let validator = PerformanceTargetValidator::new();
        assert!(validator.is_ok());
    }

    #[test]
    fn test_target_comparison() {
        let comparison = TargetComparison {
            metric: "Test Metric".to_string(),
            target: 100.0,
            measured: 95.0,
            target_met: false,
            margin_percent: -5.0,
        };

        assert_eq!(comparison.metric, "Test Metric");
        assert!(!comparison.target_met);
        assert_eq!(comparison.margin_percent, -5.0);
    }

    #[tokio::test]
    async fn test_latency_validation() {
        let mut validator = PerformanceTargetValidator::new().unwrap();
        let mut processor = SpatialProcessorBuilder::new().build().await.unwrap();

        let result = validator.validate_latency_targets(&mut processor).await;
        assert!(result.is_ok());

        let validation_result = result.unwrap();
        assert_eq!(validation_result.category, TargetCategory::Latency);
        assert!(!validation_result.target_comparisons.is_empty());
    }

    #[tokio::test]
    async fn test_quality_validation() {
        let mut validator = PerformanceTargetValidator::new().unwrap();
        let mut processor = SpatialProcessorBuilder::new().build().await.unwrap();

        let result = validator.validate_quality_targets(&mut processor).await;
        assert!(result.is_ok());

        let validation_result = result.unwrap();
        assert_eq!(validation_result.category, TargetCategory::Quality);
        assert!(validation_result.measurements.quality.localization_accuracy > 0.0);
    }

    #[tokio::test]
    async fn test_scalability_validation() {
        let mut validator = PerformanceTargetValidator::new().unwrap();
        let mut processor = SpatialProcessorBuilder::new().build().await.unwrap();

        let result = validator.validate_scalability_targets(&mut processor).await;
        assert!(result.is_ok());

        let validation_result = result.unwrap();
        assert_eq!(validation_result.category, TargetCategory::Scalability);
        assert!(
            validation_result
                .measurements
                .scalability
                .max_sources_handled
                > 0
        );
    }

    #[tokio::test]
    async fn test_comprehensive_validation() {
        let mut validator = PerformanceTargetValidator::new().unwrap();
        let mut processor = SpatialProcessorBuilder::new().build().await.unwrap();

        let results = validator.validate_all_targets(&mut processor).await;
        assert!(results.is_ok());

        let validation_results = results.unwrap();
        assert_eq!(validation_results.len(), 4); // All four categories

        let report = validator.generate_report();
        assert!(report.total_tests > 0);
        assert!(!report.timestamp.is_empty());
    }
}