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

Hygiene-Prinzip

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

1. Größen-Hygiene

„Dateien nicht ausufern lassen"

1.1 Lines of Code (LOC)

EigenschaftWert
Hygiene-FrageIst die Datei noch überschaubar?
Datenquellecode_analysis.line_count
Sauber≤ 100 Zeilen
Grenze600 Zeilen

1.2 Methoden-Anzahl

EigenschaftWert
Hygiene-FrageHat die Klasse zu viele Aufgaben?
Datenquellecode_analysis.functions
Sauber≤ 5 Methoden
Grenze20 Methoden

1.3 Klassen pro Datei

EigenschaftWert
Hygiene-FrageEine Datei = Eine Verantwortung?
Datenquellecode_analysis.classes
Sauber1 Klasse
Grenze3 Klassen

2. Kopplungs-Hygiene

„Abhängigkeiten im Griff behalten"

2.1 Dependencies

EigenschaftWert
Hygiene-FrageWie viele externe Abhängigkeiten?
Datenquellecode_analysis.uses (use-Statements)
Sauber≤ 3 Dependencies
Grenze20 Dependencies

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

3. Sicherheits-Hygiene

„Offensichtliche Risiken früh erkennen"

3.1 Hardcoded Secrets

EigenschaftWert
Hygiene-FrageLiegen Geheimnisse offen im Code?
ErkennungRegex: Passwörter, API-Keys, Tokens, IPs
Sauber0 Funde
KritischJeder Fund = schwere Hygiene-Verletzung

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

3.2 Magic Numbers

EigenschaftWert
Hygiene-FrageSind Konstanten benannt?
ErkennungRegex: 100, 1000, 60, 24, 365, etc.
Sauber0 Funde
AusnahmeConfig-Dateien ignoriert

Niedrig gewichtet. Lesbarkeit, nicht Sicherheit.

4. Statische Analyse (geplant)

„Technische Schulden sichtbar machen"

4.1 PHPStan Errors

EigenschaftWert
Hygiene-FrageGibt es Typ-Fehler oder tote Pfade?
StatusGeplant (Level 5)
Sauber0 Errors

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

Zusammenfassung

KategorieFaktorenHygiene-ZweckStatus
GrößeLOC, Methoden, KlassenÜberschaubarkeit✓
KopplungDependenciesÄnderbarkeit✓
SicherheitSecrets, Magic NumbersRisiko-Erkennung✓
StatischPHPStanTechnische Schulden○