auditmysite 0.26.0

//! Standard-Issue-Klassen
//!
//! Jeder Fund wird einer Issue-Klasse zugeordnet, die beschreibt
//! *was* das Problem ist — unabhängig vom Schweregrad.

use serde::{Deserialize, Serialize};

/// 6 Standard-Issue-Klassen
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum IssueClass {
    /// Etwas fehlt, das vorhanden sein sollte
    /// z.B. fehlender Alt-Text, fehlendes lang-Attribut, fehlender HSTS Header
    Missing,

    /// Vorhanden, aber falsch oder ungültig
    /// z.B. ungültiger Sprachcode, defekter Canonical, fehlerhafte strukturierte Daten
    Invalid,

    /// Formal vorhanden, aber qualitativ zu schwach
    /// z.B. Meta Description zu lang, Touch Targets zu klein, unklare Linktexte
    Weak,

    /// Kein direkter Fehler, aber ein relevantes Risiko
    /// z.B. sehr großes DOM, fehlende CSP, hoher JS-Heap
    Risk,

    /// Verbesserungspotenzial ohne akuten Mangel
    /// z.B. strukturierte Daten ergänzen, interne Verlinkung ausbauen
    Opportunity,

    /// Nur Hinweis / Kontext, kein Problem
    /// z.B. H1-Anzahl, Wortanzahl, Open Graph vorhanden
    Informational,
}

impl IssueClass {
    /// Ob diese Issue-Klasse den Score beeinflusst
    pub fn affects_score(&self) -> bool {
        !matches!(self, IssueClass::Opportunity | IssueClass::Informational)
    }

    /// Nutzerfreundlicher Label (deutsch)
    pub fn label(&self) -> &'static str {
        match self {
            IssueClass::Missing => "Fehlend",
            IssueClass::Invalid => "Ungültig",
            IssueClass::Weak => "Schwach",
            IssueClass::Risk => "Risiko",
            IssueClass::Opportunity => "Optimierungspotenzial",
            IssueClass::Informational => "Hinweis",
        }
    }
}

impl std::fmt::Display for IssueClass {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.label())
    }
}