Audit-Report: KRITISCHE INKOHÄRENZ in /qualitaet/code-hygiene-score/faktoren (PHPStan Status, Faktoren-Messung)

Beschreibung

**Audit-Ergebnis für die Dokumentation: `/qualitaet/code-hygiene-score/faktoren`**

**Parent-Task:** #655

**Bewertung:** **INKOHÄRENT UND TEILWEISE FALSCH.** Die Dokumentation weist Inkonsistenzen im Status von Tools und der Messung von Hygiene-Faktoren auf.

**Checklisten-Status:**

* **1. Terminologische Konsistenz:** ✅ OK
* **2. Technische Konsistenz:** ❌ **Nicht erfüllt.**
* [✅] Die Datenquellen für "Größen-Hygiene" (`code_analysis.line_count`, `code_analysis.classes`, `code_analysis.functions`) und "Kopplungs-Hygiene" (`code_analysis.uses`) sind korrekt und existieren.
* [✅] Das Feld `hardcoded_count` in `code_quality` korrespondiert mit "Hardcoded Secrets".
* [❌] **Inkonsistenter PHPStan Status:** Die Dokumentation listet PHPStan als "Geplant" auf, obwohl es in `/qualitaet/php-quality` als aktiv beschrieben wird und in den Pre-Sync Checks läuft. Dies ist eine Inkonsistenz im Status.
* [❌] **Unklare Messung von "Magic Numbers":** Die Methode zur Erkennung von "Magic Numbers" über Regex ist dokumentiert, aber es ist unklar, wie diese in die `code_quality`-Tabelle einfließen. Das Feld `factor_scores` ist ein `LONGTEXT` und es ist nicht ersichtlich, ob und wie Magic Numbers darin abgebildet werden.
* [❌] **Unklare Erkennung von "Hardcoded Secrets":** Obwohl `hardcoded_count` existiert, ist die konkrete Regex-Erkennung für Passwörter, API-Keys etc. nicht in der Datenbankstruktur ersichtlich und könnte eine Lücke in der Dokumentation oder Implementierung darstellen.
* **3. Strukturelle und Formale Konsistenz:** ✅ OK
* **4. Konzeptuelle Kohärenz:** ❌ **Nicht erfüllt.** Das Konzept einer klaren Zuordnung von Faktoren zu Datenquellen und dem Status von Tools ist durch die oben genannten Inkonsistenzen beeinträchtigt.
* **5. Prozessuale Kohärenz:** ❌ **Nicht erfüllt.** Der Prozess der Messung von "Magic Numbers" und "Hardcoded Secrets" ist nicht vollständig nachvollziehbar.
* **6. Referentielle Integrität:** ✅ OK
* **7. Aktualität und Status-Konsistenz:** ❌ **Nicht erfüllt.** Die Dokumentation ist veraltet oder unklar bezüglich des PHPStan-Status und der Implementierung bestimmter Faktoren.

**Zu tätigende Korrekturen:**

1. **PHPStan Status aktualisieren:** Den Status von PHPStan von "Geplant" auf "Aktiv" ändern und die korrekte Version angeben.
2. **Messung von "Magic Numbers" klären:** Dokumentieren, wie "Magic Numbers" erkannt und in `code_quality.factor_scores` (oder einem anderen Feld) abgebildet werden.
3. **Erkennung von "Hardcoded Secrets" detaillieren:** Klarstellen, wie die "Hardcoded Secrets" erkannt werden und ob die Regex-Erkennung in der Codebasis existiert und wie sie mit `hardcoded_count` zusammenhängt.

**Task-Status:** **OFFEN**. Aufgrund der kritischen Diskrepanzen in der Beschreibung der Faktoren und ihrer Messung bleibt dieser Task offen.

Aktionen

← Zurück zur Task-Liste