Erstellt: 2025-12-25 | Aktualisiert: 2025-12-27

Hygiene-Prinzip

Der Code Hygiene Score misst Ordnung und Sauberkeit, nicht Architektur. Die Faktoren beantworten:

• Laufen Dateien aus dem Ruder?
• Sind Verantwortlichkeiten erkennbar?
• Gibt es offensichtliche Risiken?

1. Größen-Hygiene

„Dateien nicht ausufern lassen"

1.1 Lines of Code (LOC)

1.2 Methoden-Anzahl

1.3 Klassen pro Datei

2. Kopplungs-Hygiene

„Abhängigkeiten im Griff behalten"

2.1 Dependencies

use-Statements sind ein pragmatischer Hygiene-Proxy. Nicht perfekt, aber messbar.

3. Sicherheits-Hygiene

„Offensichtliche Risiken früh erkennen"

3.1 Hardcoded Secrets

Härtung: Bei Secrets → Score ≤ 20 (Hard Fail)

3.2 Magic Numbers

Niedrig gewichtet. Lesbarkeit, nicht Sicherheit.

4. Statische Analyse (geplant)

„Technische Schulden sichtbar machen"

4.1 PHPStan Errors

Ohne PHPStan bleibt Hygiene unvollständig, aber nicht falsch.

Zusammenfassung

Erstellt: 2025-12-25 | Aktualisiert: 2025-12-27

Prinzip

Jeder Faktor wird auf 0-100 normalisiert:

• 100 = Hygienisch einwandfrei
• 0 = Hygiene-Grenze überschritten

Lineare Interpolation dazwischen. Keine Sprünge, keine Magie.

Normalisierungsformel

Für Metriken wo weniger = sauberer:

normalized = max(0, 100 - ((wert - optimal) / (grenze - optimal)) × 100)

Beispiel LOC:
- optimal = 100, grenze = 600
- Bei 350 LOC: 100 - ((350-100) / 500) × 100 = 50

Normalisierung pro Faktor

Lines of Code

normalize_loc(loc):
    if loc ≤ 100: return 100   # sauber
    if loc ≥ 600: return 0     # Grenze
    return 100 - ((loc - 100) / 500) × 100

Methoden-Anzahl

normalize_methods(count):
    if count ≤ 5: return 100
    if count ≥ 20: return 0
    return 100 - ((count - 5) / 15) × 100

Klassen pro Datei

normalize_classes(count):
    if count == 1: return 100
    if count == 2: return 50
    if count == 3: return 25
    return 0

Dependencies

normalize_deps(count):
    if count ≤ 3: return 100
    if count ≥ 20: return 0
    return 100 - ((count - 3) / 17) × 100

Hardcoded Secrets

normalize_secrets(count):
    if count == 0: return 100
    if count ≥ 1: return 20   # Hard Fail

Sonderregel: Secrets sind ein Hygiene-Killer. Ein Fund → Score maximal 20.

Magic Numbers

normalize_magic(count):
    if count == 0: return 100
    if count ≤ 5: return 100 - (count × 10)
    return 50  # Floor

Weniger kritisch. Floor bei 50, nicht 0.

Dateityp-Anpassungen

Pragmatische Hygiene berücksichtigt Kontext:

Erstellt: 2025-12-25 | Aktualisiert: 2025-12-27

Prinzip

Jeder normalisierte Faktor wird gewichtet. Die Gewichte spiegeln Hygiene-Relevanz, nicht Architektur-Bedeutung.

Standard-Gewichtung

Score-Berechnung

hygiene_score = (
    deps_normalized × 0.25 +
    loc_normalized × 0.20 +
    methods_normalized × 0.20 +
    secrets_normalized × 0.15 +
    classes_normalized × 0.10 +
    magic_normalized × 0.10
)

Beispiel: ContentController.php

400 LOC, 16 Methoden, 1 Klasse, 6 Dependencies, 0 Secrets, 2 Magic Numbers

Interpretation: Score 67 = „Gepflegt" (60-79)

Dateityp-Modifikatoren

Pragmatische Gewichtsanpassung nach Dateityp:

Controller

Controller haben viele Actions. Dafür ist Kopplung kritischer.

Entity/Model

Entities müssen schlank bleiben. Framework-Dependencies sind unvermeidbar.

Repository

Viele CRUD-Methoden sind normal. LOC-Hygiene wichtiger.

Zukünftige Erweiterung

Bei Integration von PHPStan:

PHPStan wird hoch gewichtet - statische Analyse ist Kern-Hygiene.