{
"event": "PreToolUse",
"tool_name": "mcp__mcp-docs__docs_create",
"tool_input": {
"title": "Normalisierung",
"slug": "normalisierung",
"parent_id": 131,
"status": "published",
"description": "Wie Rohwerte auf 0-100 normalisiert werden",
"content": "<h2>Prinzip<\/h2>\n<p>Jeder Faktor wird auf einen Wert zwischen 0 und 100 normalisiert, wobei:<\/p>\n<ul>\n<li><strong>100<\/strong> = Optimaler Wert (Zielzustand)<\/li>\n<li><strong>0<\/strong> = Maximaler Grenzwert überschritten<\/li>\n<\/ul>\n\n<h2>Normalisierungsformel<\/h2>\n<p>Für Metriken wo <em>weniger besser<\/em> ist (LOC, Methods, Dependencies):<\/p>\n<pre><code>normalized = max(0, 100 - ((value - optimal) \/ (maximum - optimal)) × 100)\n\nBeispiel LOC:\n- optimal = 100, maximum = 600\n- Bei 350 LOC: 100 - ((350-100) \/ (600-100)) × 100 = 100 - 50 = 50<\/code><\/pre>\n\n<h2>Normalisierung pro Faktor<\/h2>\n\n<h3>Lines of Code (LOC)<\/h3>\n<table>\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\n<tr><td>≤ 100<\/td><td>100<\/td><td>Optimum erreicht<\/td><\/tr>\n<tr><td>100-600<\/td><td>100-0<\/td><td>Linear interpoliert<\/td><\/tr>\n<tr><td>> 600<\/td><td>0<\/td><td>Maximum überschritten<\/td><\/tr>\n<\/table>\n<pre><code>normalize_loc(loc):\n if loc <= 100: return 100\n if loc >= 600: return 0\n return 100 - ((loc - 100) \/ 500) × 100<\/code><\/pre>\n\n<h3>Methoden-Anzahl<\/h3>\n<table>\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\n<tr><td>≤ 5<\/td><td>100<\/td><td>Optimum<\/td><\/tr>\n<tr><td>5-20<\/td><td>100-0<\/td><td>Linear<\/td><\/tr>\n<tr><td>> 20<\/td><td>0<\/td><td>Maximum<\/td><\/tr>\n<\/table>\n<pre><code>normalize_methods(count):\n if count <= 5: return 100\n if count >= 20: return 0\n return 100 - ((count - 5) \/ 15) × 100<\/code><\/pre>\n\n<h3>Klassen-Anzahl<\/h3>\n<table>\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\n<tr><td>1<\/td><td>100<\/td><td>Optimum (1 Klasse\/Datei)<\/td><\/tr>\n<tr><td>2<\/td><td>50<\/td><td>Akzeptabel<\/td><\/tr>\n<tr><td>3<\/td><td>25<\/td><td>Grenzwertig<\/td><\/tr>\n<tr><td>> 3<\/td><td>0<\/td><td>Verletzt SRP<\/td><\/tr>\n<\/table>\n\n<h3>Dependencies<\/h3>\n<table>\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\n<tr><td>≤ 3<\/td><td>100<\/td><td>Optimum<\/td><\/tr>\n<tr><td>3-20<\/td><td>100-0<\/td><td>Linear<\/td><\/tr>\n<tr><td>> 20<\/td><td>0<\/td><td>Maximum<\/td><\/tr>\n<\/table>\n<pre><code>normalize_deps(count):\n if count <= 3: return 100\n if count >= 20: return 0\n return 100 - ((count - 3) \/ 17) × 100<\/code><\/pre>\n\n<h3>Hardcoded Values<\/h3>\n<table>\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\n<tr><td>0<\/td><td>100<\/td><td>Keine Funde<\/td><\/tr>\n<tr><td>1<\/td><td>70<\/td><td>-30 pro Fund<\/td><\/tr>\n<tr><td>2<\/td><td>40<\/td><td>-30 pro Fund<\/td><\/tr>\n<tr><td>≥ 4<\/td><td>0<\/td><td>Zu viele Sicherheitsrisiken<\/td><\/tr>\n<\/table>\n<pre><code>normalize_hardcoded(count):\n return max(0, 100 - (count × 30))<\/code><\/pre>\n\n<h3>Magic Numbers<\/h3>\n<table>\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\n<tr><td>0<\/td><td>100<\/td><td>Keine Funde<\/td><\/tr>\n<tr><td>1-5<\/td><td>90-50<\/td><td>-10 pro Fund<\/td><\/tr>\n<tr><td>> 5<\/td><td>50<\/td><td>Floor (weniger kritisch)<\/td><\/tr>\n<\/table>\n\n<h2>Sonderfälle<\/h2>\n\n<h3>Dateityp-spezifische Anpassungen<\/h3>\n<table>\n<tr><th>Dateityp<\/th><th>Anpassung<\/th><\/tr>\n<tr><td>Controller<\/td><td>Methods-Maximum: 25 statt 20<\/td><\/tr>\n<tr><td>Entity\/Model<\/td><td>LOC-Maximum: 400 statt 600<\/td><\/tr>\n<tr><td>Config<\/td><td>Magic Numbers: ignoriert<\/td><\/tr>\n<tr><td>Test<\/td><td>LOC-Maximum: 800 statt 600<\/td><\/tr>\n<\/table>\n\n<h3>Fehlende Werte<\/h3>\n<p>Wenn ein Faktor nicht berechnet werden kann (z.B. leere Datei):<\/p>\n<ul>\n<li>Faktor wird mit Gewicht 0 behandelt<\/li>\n<li>Gesamtgewicht entsprechend reduziert<\/li>\n<\/ul>"
}
}
{
"tool_response": [
{
"type": "text",
"text": "{\n \"success\": true,\n \"doc\": {\n \"id\": 133,\n \"parent_id\": 131,\n \"slug\": \"normalisierung\",\n \"path\": \"\/qualitaet\/code-quality-score\/normalisierung\",\n \"title\": \"Normalisierung\",\n \"description\": \"Wie Rohwerte auf 0-100 normalisiert werden\",\n \"content\": \"<h2>Prinzip<\/h2>\\n<p>Jeder Faktor wird auf einen Wert zwischen 0 und 100 normalisiert, wobei:<\/p>\\n<ul>\\n<li><strong>100<\/strong> = Optimaler Wert (Zielzustand)<\/li>\\n<li><strong>0<\/strong> = Maximaler Grenzwert überschritten<\/li>\\n<\/ul>\\n\\n<h2>Normalisierungsformel<\/h2>\\n<p>Für Metriken wo <em>weniger besser<\/em> ist (LOC, Methods, Dependencies):<\/p>\\n<pre><code>normalized = max(0, 100 - ((value - optimal) \/ (maximum - optimal)) × 100)\\n\\nBeispiel LOC:\\n- optimal = 100, maximum = 600\\n- Bei 350 LOC: 100 - ((350-100) \/ (600-100)) × 100 = 100 - 50 = 50<\/code><\/pre>\\n\\n<h2>Normalisierung pro Faktor<\/h2>\\n\\n<h3>Lines of Code (LOC)<\/h3>\\n<table>\\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\\n<tr><td>≤ 100<\/td><td>100<\/td><td>Optimum erreicht<\/td><\/tr>\\n<tr><td>100-600<\/td><td>100-0<\/td><td>Linear interpoliert<\/td><\/tr>\\n<tr><td>> 600<\/td><td>0<\/td><td>Maximum überschritten<\/td><\/tr>\\n<\/table>\\n<pre><code>normalize_loc(loc):\\n if loc <= 100: return 100\\n if loc >= 600: return 0\\n return 100 - ((loc - 100) \/ 500) × 100<\/code><\/pre>\\n\\n<h3>Methoden-Anzahl<\/h3>\\n<table>\\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\\n<tr><td>≤ 5<\/td><td>100<\/td><td>Optimum<\/td><\/tr>\\n<tr><td>5-20<\/td><td>100-0<\/td><td>Linear<\/td><\/tr>\\n<tr><td>> 20<\/td><td>0<\/td><td>Maximum<\/td><\/tr>\\n<\/table>\\n<pre><code>normalize_methods(count):\\n if count <= 5: return 100\\n if count >= 20: return 0\\n return 100 - ((count - 5) \/ 15) × 100<\/code><\/pre>\\n\\n<h3>Klassen-Anzahl<\/h3>\\n<table>\\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\\n<tr><td>1<\/td><td>100<\/td><td>Optimum (1 Klasse\/Datei)<\/td><\/tr>\\n<tr><td>2<\/td><td>50<\/td><td>Akzeptabel<\/td><\/tr>\\n<tr><td>3<\/td><td>25<\/td><td>Grenzwertig<\/td><\/tr>\\n<tr><td>> 3<\/td><td>0<\/td><td>Verletzt SRP<\/td><\/tr>\\n<\/table>\\n\\n<h3>Dependencies<\/h3>\\n<table>\\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\\n<tr><td>≤ 3<\/td><td>100<\/td><td>Optimum<\/td><\/tr>\\n<tr><td>3-20<\/td><td>100-0<\/td><td>Linear<\/td><\/tr>\\n<tr><td>> 20<\/td><td>0<\/td><td>Maximum<\/td><\/tr>\\n<\/table>\\n<pre><code>normalize_deps(count):\\n if count <= 3: return 100\\n if count >= 20: return 0\\n return 100 - ((count - 3) \/ 17) × 100<\/code><\/pre>\\n\\n<h3>Hardcoded Values<\/h3>\\n<table>\\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\\n<tr><td>0<\/td><td>100<\/td><td>Keine Funde<\/td><\/tr>\\n<tr><td>1<\/td><td>70<\/td><td>-30 pro Fund<\/td><\/tr>\\n<tr><td>2<\/td><td>40<\/td><td>-30 pro Fund<\/td><\/tr>\\n<tr><td>≥ 4<\/td><td>0<\/td><td>Zu viele Sicherheitsrisiken<\/td><\/tr>\\n<\/table>\\n<pre><code>normalize_hardcoded(count):\\n return max(0, 100 - (count × 30))<\/code><\/pre>\\n\\n<h3>Magic Numbers<\/h3>\\n<table>\\n<tr><th>Rohwert<\/th><th>Normalisiert<\/th><th>Formel<\/th><\/tr>\\n<tr><td>0<\/td><td>100<\/td><td>Keine Funde<\/td><\/tr>\\n<tr><td>1-5<\/td><td>90-50<\/td><td>-10 pro Fund<\/td><\/tr>\\n<tr><td>> 5<\/td><td>50<\/td><td>Floor (weniger kritisch)<\/td><\/tr>\\n<\/table>\\n\\n<h2>Sonderfälle<\/h2>\\n\\n<h3>Dateityp-spezifische Anpassungen<\/h3>\\n<table>\\n<tr><th>Dateityp<\/th><th>Anpassung<\/th><\/tr>\\n<tr><td>Controller<\/td><td>Methods-Maximum: 25 statt 20<\/td><\/tr>\\n<tr><td>Entity\/Model<\/td><td>LOC-Maximum: 400 statt 600<\/td><\/tr>\\n<tr><td>Config<\/td><td>Magic Numbers: ignoriert<\/td><\/tr>\\n<tr><td>Test<\/td><td>LOC-Maximum: 800 statt 600<\/td><\/tr>\\n<\/table>\\n\\n<h3>Fehlende Werte<\/h3>\\n<p>Wenn ein Faktor nicht berechnet werden kann (z.B. leere Datei):<\/p>\\n<ul>\\n<li>Faktor wird mit Gewicht 0 behandelt<\/li>\\n<li>Gesamtgewicht entsprechend reduziert<\/li>\\n<\/ul>\",\n \"status\": \"published\",\n \"sort_order\": 0,\n \"depth\": 2,\n \"created_at\": \"2025-12-25T15:58:35\",\n \"updated_at\": \"2025-12-25T15:58:35\"\n },\n \"message\": \"Dokument 'Normalisierung' erstellt mit ID 133\"\n}"
}
]
}