# DORA Metrics Collection
class DORAMetrics:
    def __init__(self):
        self.metrics = {
            'deployment_frequency': DeploymentFrequency(),
            'lead_time_for_changes': LeadTimeForChanges(),
            'mean_time_to_restore': MeanTimeToRestore(),
            'change_failure_rate': ChangeFailureRate()
        }
    
    def collect_deployment_frequency(self, team, timeframe='week'):
        """
        Deployment Frequency: How often code is deployed to production
        Elite: Multiple deployments per day
        High: Between once per day and once per week
        Medium: Between once per week and once per month
        Low: Fewer than once per month
        """
        deployments = self.query_deployments(team, timeframe)
        return {
            'count': len(deployments),
            'frequency_per_day': len(deployments) / 7 if timeframe == 'week' else len(deployments) / 30,
            'performance_tier': self.classify_deployment_frequency(len(deployments), timeframe)
        }
    
    def collect_lead_time_for_changes(self, team):
        """
        Lead Time for Changes: Time from code commit to production deployment
        Elite: Less than one hour
        High: Between one day and one week
        Medium: Between one week and one month
        Low: More than one month
        """
        changes = self.query_recent_changes(team, days=30)
        lead_times = []
        
        for change in changes:
            commit_time = change.first_commit_timestamp
            deploy_time = change.production_deploy_timestamp
            lead_time_hours = (deploy_time - commit_time).total_seconds() / 3600
            lead_times.append(lead_time_hours)
        
        return {
            'median_hours': self.median(lead_times),
            'p95_hours': self.percentile(lead_times, 95),
            'distribution': self.distribution(lead_times),
            'performance_tier': self.classify_lead_time(self.median(lead_times))
        }
    
    def collect_mean_time_to_restore(self, team):
        """
        Mean Time to Restore (MTTR): Time to restore service after incident
        Elite: Less than one hour
        High: Less than one day
        Medium: Between one day and one week
        Low: More than one week
        """
        incidents = self.query_incidents(team, days=90)
        restore_times = []
        
        for incident in incidents:
            detection_time = incident.detected_at
            resolved_time = incident.resolved_at
            mttr_hours = (resolved_time - detection_time).total_seconds() / 3600
            restore_times.append(mttr_hours)
        
        return {
            'mean_hours': self.mean(restore_times),
            'median_hours': self.median(restore_times),
            'incidents_count': len(incidents),
            'performance_tier': self.classify_mttr(self.mean(restore_times))
        }
    
    def collect_change_failure_rate(self, team):
        """
        Change Failure Rate: Percentage of deployments causing failures
        Elite: 0-15%
        High: 16-30%
        Medium: 31-45%
        Low: >45%
        """
        deployments = self.query_deployments(team, days=30)
        failed_deployments = [d for d in deployments if d.caused_incident or d.was_rolled_back]
        
        failure_rate = len(failed_deployments) / len(deployments) * 100 if deployments else 0
        
        return {
            'failure_rate_percent': failure_rate,
            'total_deployments': len(deployments),
            'failed_deployments': len(failed_deployments),
            'performance_tier': self.classify_failure_rate(failure_rate)
        }

# SPACE Framework Metrics
class SPACEMetrics:
    """
    SPACE Framework:
    - Satisfaction and well-being
    - Performance
    - Activity
    - Communication and collaboration
    - Efficiency and flow
    """
    
    def __init__(self):
        self.dimensions = {
            'satisfaction': SatisfactionMetrics(),
            'performance': PerformanceMetrics(),
            'activity': ActivityMetrics(),
            'collaboration': CollaborationMetrics(),
            'efficiency': EfficiencyMetrics()
        }
    
    def collect_satisfaction_metrics(self, team):
        """
        Satisfaction: Developer happiness and well-being
        """
        survey_results = self.get_latest_survey(team)
        
        return {
            'overall_satisfaction': survey_results.overall_score,  # 1-5 scale
            'platform_satisfaction': survey_results.platform_score,
            'tool_satisfaction': survey_results.tools_score,
            'documentation_satisfaction': survey_results.docs_score,
            'support_satisfaction': survey_results.support_score,
            'work_life_balance': survey_results.work_life_score,
            'burnout_indicators': self.calculate_burnout_risk(team),
            'turnover_risk': self.calculate_turnover_risk(team)
        }
    
    def collect_performance_metrics(self, team):
        """
        Performance: Outcomes and impact
        """
        return {
            'features_delivered': self.count_features_delivered(team, days=30),
            'bug_fix_rate': self.calculate_bug_fix_rate(team),
            'technical_debt_ratio': self.calculate_tech_debt(team),
            'code_quality_score': self.calculate_code_quality(team),
            'user_satisfaction': self.get_user_satisfaction(team)
        }
    
    def collect_activity_metrics(self, team):
        """
        Activity: Developer actions and outputs
        """
        return {
            'commits_per_day': self.calculate_commit_rate(team),
            'pull_requests_created': self.count_pull_requests(team, days=30),
            'pull_requests_reviewed': self.count_pr_reviews(team, days=30),
            'documentation_contributions': self.count_doc_updates(team),
            'platform_usage_frequency': self.calculate_platform_usage(team)
        }
    
    def collect_collaboration_metrics(self, team):
        """
        Collaboration: Communication and teamwork
        """
        return {
            'pr_review_time_hours': self.calculate_pr_review_time(team),
            'cross_team_contributions': self.count_cross_team_activity(team),
            'knowledge_sharing_sessions': self.count_knowledge_sharing(team),
            'pair_programming_hours': self.calculate_pairing_time(team),
            'help_given_received_ratio': self.calculate_help_ratio(team)
        }
    
    def collect_efficiency_metrics(self, team):
        """
        Efficiency: Flow state and minimal interruptions
        """
        return {
            'uninterrupted_coding_time_hours': self.calculate_flow_time(team),
            'context_switches_per_day': self.count_context_switches(team),
            'wait_time_for_reviews_hours': self.calculate_wait_time(team),
            'ci_cd_pipeline_time_minutes': self.calculate_pipeline_time(team),
            'toil_percentage': self.calculate_toil(team),
            'automation_coverage': self.calculate_automation(team)
        }

# Platform Experience Metrics
class PlatformDXMetrics:
    def __init__(self):
        self.collectors = {
            'onboarding': OnboardingMetrics(),
            'self_service': SelfServiceMetrics(),
            'reliability': ReliabilityMetrics(),
            'documentation': DocumentationMetrics(),
            'support': SupportMetrics()
        }
    
    def collect_onboarding_metrics(self):
        """
        Time and effort to get started
        """
        new_developers = self.get_new_developers(days=90)
        
        metrics = []
        for dev in new_developers:
            metrics.append({
                'time_to_first_commit_hours': self.calculate_time_to_first_commit(dev),
                'time_to_first_deployment_hours': self.calculate_time_to_first_deploy(dev),
                'setup_steps_completed': dev.onboarding_progress,
                'help_requests_needed': len(dev.support_tickets),
                'onboarding_satisfaction': dev.onboarding_survey_score
            })
        
        return {
            'average_time_to_productivity_days': self.average([m['time_to_first_deployment_hours'] for m in metrics]) / 24,
            'onboarding_completion_rate': self.calculate_completion_rate(new_developers),
            'average_help_requests': self.average([m['help_requests_needed'] for m in metrics]),
            'satisfaction_score': self.average([m['onboarding_satisfaction'] for m in metrics if m['onboarding_satisfaction']])
        }
    
    def collect_self_service_metrics(self):
        """
        Platform self-service capability
        """
        service_requests = self.get_service_requests(days=30)
        
        self_service_completed = [r for r in service_requests if r.self_service_completion]
        manual_intervention_needed = [r for r in service_requests if r.required_human_help]
        
        return {
            'self_service_completion_rate': len(self_service_completed) / len(service_requests) * 100,
            'average_completion_time_minutes': self.average([r.completion_time_minutes for r in self_service_completed]),
            'manual_intervention_rate': len(manual_intervention_needed) / len(service_requests) * 100,
            'common_failure_reasons': self.analyze_failures(service_requests),
            'capability_coverage': self.calculate_self_service_coverage()
        }
    
    def collect_reliability_metrics(self):
        """
        Platform reliability and availability
        """
        return {
            'platform_availability_percent': self.calculate_uptime(days=30),
            'api_success_rate_percent': self.calculate_api_success_rate(),
            'average_api_latency_ms': self.calculate_api_latency(),
            'error_budget_remaining_percent': self.calculate_error_budget(),
            'incidents_per_month': len(self.get_incidents(days=30)),
            'user_impacting_incidents': len(self.get_user_impacting_incidents(days=30))
        }
    
    def collect_documentation_metrics(self):
        """
        Documentation quality and usage
        """
        return {
            'documentation_page_views': self.get_doc_page_views(days=30),
            'search_success_rate': self.calculate_search_success(),
            'average_time_on_page_minutes': self.calculate_time_on_page(),
            'documentation_feedback_score': self.get_doc_feedback_score(),
            'outdated_documentation_percent': self.calculate_outdated_docs(),
            'documentation_coverage_percent': self.calculate_doc_coverage()
        }
    
    def collect_support_metrics(self):
        """
        Platform support effectiveness
        """
        tickets = self.get_support_tickets(days=30)
        
        return {
            'tickets_per_developer_per_month': len(tickets) / self.get_developer_count(),
            'first_response_time_hours': self.average([t.first_response_time for t in tickets]),
            'resolution_time_hours': self.average([t.resolution_time for t in tickets]),
            'resolution_rate_first_contact': self.calculate_first_contact_resolution(tickets),
            'ticket_escalation_rate': self.calculate_escalation_rate(tickets),
            'support_satisfaction_score': self.average([t.satisfaction_score for t in tickets if t.satisfaction_score])
        }

# Grafana Dashboard Configuration
apiVersion: v1
kind: ConfigMap
metadata:
  name: dx-metrics-dashboard
  namespace: monitoring
data:
  dashboard.json: |
    {
      "dashboard": {
        "title": "Developer Experience Metrics",
        "tags": ["platform", "dx", "dora"],
        "timezone": "UTC",
        "panels": [
          {
            "title": "DORA Metrics - Deployment Frequency",
            "targets": [
              {
                "expr": "rate(deployments_total[7d])",
                "legendFormat": "{{team}}"
              }
            ],
            "type": "graph"
          },
          {
            "title": "Lead Time for Changes (Median)",
            "targets": [
              {
                "expr": "histogram_quantile(0.5, rate(lead_time_seconds_bucket[7d]))",
                "legendFormat": "{{team}}"
              }
            ],
            "type": "graph"
          },
          {
            "title": "Change Failure Rate",
            "targets": [
              {
                "expr": "rate(failed_deployments_total[30d]) / rate(deployments_total[30d]) * 100",
                "legendFormat": "{{team}}"
              }
            ],
            "type": "graph"
          },
          {
            "title": "Platform Satisfaction Score",
            "targets": [
              {
                "expr": "avg(platform_satisfaction_score)",
                "legendFormat": "Overall"
              }
            ],
            "type": "stat",
            "thresholds": [
              {
                "value": 0,
                "color": "red"
              },
              {
                "value": 3,
                "color": "yellow"
              },
              {
                "value": 4,
                "color": "green"
              }
            ]
          },
          {
            "title": "Time to First Deployment (New Developers)",
            "targets": [
              {
                "expr": "avg(onboarding_time_to_first_deploy_hours)",
                "legendFormat": "Average"
              }
            ],
            "type": "stat"
          },
          {
            "title": "Self-Service Completion Rate",
            "targets": [
              {
                "expr": "sum(self_service_completed_total) / sum(service_requests_total) * 100",
                "legendFormat": "Completion Rate %"
              }
            ],
            "type": "gauge"
          },
          {
            "title": "Platform Availability",
            "targets": [
              {
                "expr": "avg(platform_availability_percent)",
                "legendFormat": "Availability"
              }
            ],
            "type": "stat"
          },
          {
            "title": "Support Ticket Volume",
            "targets": [
              {
                "expr": "sum(rate(support_tickets_total[7d]))",
                "legendFormat": "Tickets per Day"
              }
            ],
            "type": "graph"
          }
        ]
      }
    }

# Developer Experience Survey
apiVersion: platform.company.com/v1
kind: DeveloperSurvey
metadata:
  name: quarterly-dx-survey
spec:
  frequency: quarterly
  questions:
    - id: overall_satisfaction
      type: rating
      scale: 1-5
      question: "How satisfied are you with the overall developer experience?"
      required: true
    
    - id: platform_ease_of_use
      type: rating
      scale: 1-5
      question: "How easy is it to use the internal platform?"
    
    - id: documentation_quality
      type: rating
      scale: 1-5
      question: "How would you rate the quality of platform documentation?"
    
    - id: support_responsiveness
      type: rating
      scale: 1-5
      question: "How responsive is the platform team to your needs?"
    
    - id: biggest_pain_points
      type: multiple_choice
      question: "What are your biggest pain points? (Select up to 3)"
      options:
        - "Slow CI/CD pipelines"
        - "Complex deployment process"
        - "Poor documentation"
        - "Lack of self-service options"
        - "Insufficient tooling"
        - "Too many manual steps"
        - "Environment provisioning delays"
        - "Debugging difficulties"
      maxSelections: 3
    
    - id: most_valuable_improvement
      type: open_text
      question: "What single improvement would have the biggest positive impact on your productivity?"
    
    - id: time_wasted_weekly
      type: rating
      scale: 0-20
      question: "How many hours per week do you spend on non-coding activities (toil, waiting, etc.)?"
    
    - id: would_recommend
      type: rating
      scale: 1-10
      question: "How likely are you to recommend our platform to other developers? (Net Promoter Score)"

# Metrics Collection System
class DXMetricsCollector:
    def __init__(self):
        self.collectors = {
            'git': GitMetricsCollector(),
            'ci_cd': CICDMetricsCollector(),
            'incidents': IncidentMetricsCollector(),
            'surveys': SurveyMetricsCollector(),
            'platform': PlatformMetricsCollector()
        }
        self.storage = MetricsStorage()
        self.aggregator = MetricsAggregator()
    
    def collect_all_metrics(self):
        """
        Collect metrics from all sources
        """
        metrics = {}
        
        for source, collector in self.collectors.items():
            try:
                metrics[source] = collector.collect()
                self.storage.store(source, metrics[source])
            except Exception as e:
                logger.error(f"Failed to collect {source} metrics: {e}")
        
        # Aggregate and export
        aggregated = self.aggregator.aggregate(metrics)
        self.export_to_prometheus(aggregated)
        self.export_to_datadog(aggregated)
        
        return aggregated
    
    def export_to_prometheus(self, metrics):
        """
        Export metrics to Prometheus
        """
        for metric_name, value in metrics.items():
            gauge = Gauge(metric_name, f'DX metric: {metric_name}')
            gauge.set(value)
    
    def generate_weekly_report(self):
        """
        Generate weekly DX metrics report
        """
        metrics = self.storage.get_weekly_metrics()
        
        report = {
            'week': datetime.now().strftime('%Y-W%W'),
            'dora_metrics': self.calculate_dora_summary(metrics),
            'space_metrics': self.calculate_space_summary(metrics),
            'platform_metrics': self.calculate_platform_summary(metrics),
            'trends': self.calculate_trends(metrics),
            'recommendations': self.generate_recommendations(metrics)
        }
        
        self.send_report(report)
        return report

# Insights Engine
class DXInsightsEngine:
    def analyze_metrics(self, metrics):
        """
        Generate actionable insights from metrics
        """
        insights = []
        
        # Deployment frequency analysis
        if metrics['deployment_frequency_per_day'] < 1:
            insights.append({
                'severity': 'high',
                'category': 'deployment_speed',
                'finding': 'Low deployment frequency detected',
                'impact': 'Slower feedback loops and longer time to market',
                'recommendations': [
                    'Implement trunk-based development',
                    'Automate more of the deployment process',
                    'Reduce deployment risk with feature flags',
                    'Break down larger changes into smaller increments'
                ]
            })
        
        # Lead time analysis
        if metrics['lead_time_median_hours'] > 168:  # > 1 week
            insights.append({
                'severity': 'high',
                'category': 'lead_time',
                'finding': 'Long lead time for changes',
                'impact': 'Delayed value delivery and feedback',
                'recommendations': [
                    'Identify and remove approval bottlenecks',
                    'Optimize CI/CD pipeline performance',
                    'Reduce batch sizes',
                    'Automate testing and security scanning'
                ]
            })
        
        # Change failure rate analysis
        if metrics['change_failure_rate'] > 15:
            insights.append({
                'severity': 'high',
                'category': 'quality',
                'finding': 'High change failure rate',
                'impact': 'Reduced stability and team confidence',
                'recommendations': [
                    'Improve test coverage',
                    'Implement progressive delivery',
                    'Add more pre-production testing',
                    'Review incident post-mortems for patterns'
                ]
            })
        
        # Self-service analysis
        if metrics['self_service_completion_rate'] < 70:
            insights.append({
                'severity': 'medium',
                'category': 'automation',
                'finding': 'Low self-service completion rate',
                'impact': 'Platform team bottleneck and developer frustration',
                'recommendations': [
                    'Identify common failure patterns',
                    'Improve error messages and guidance',
                    'Add more documentation',
                    'Simplify complex workflows'
                ]
            })
        
        # Satisfaction analysis
        if metrics['platform_satisfaction'] < 3.5:
            insights.append({
                'severity': 'high',
                'category': 'experience',
                'finding': 'Low platform satisfaction',
                'impact': 'Developer productivity and retention risk',
                'recommendations': [
                    'Conduct user research interviews',
                    'Address top pain points from survey',
                    'Improve documentation and support',
                    'Increase transparency on roadmap'
                ]
            })
        
        return insights