Zum Inhalt

KPI-Grenzwerte anpassen

How-to · Stand: 2026-09-22

Grenzwerte leben in der Tabelle evaluation_rules und wirken sofort auf die nächste Bewertung — kein Deployment nötig. Es gibt zwei Wege; welcher passt, hängt davon ab, ob die Änderung dauerhaft für alle Umgebungen gelten soll.

Vorher: aktuellen Stand ansehen

php artisan kpi:rule:list
php artisan kpi:rule:list --scope=service

Weg 1: Dauerhaft, alle Umgebungen (Standard)

Für abgestimmte Grenzwert-Änderungen (z. B. per ClickUp-Ticket):

  1. Werte in api/database/seeders/EvaluationRulesSeeder.php ändern. Spaltenreihenfolge im Seeder-Array beachten: [scope, kpi_key, Kritisch-Grenze, Riskant-Grenze, operator] — die mittlere Zahl ist die mildere Warnstufe.
  2. Migration anlegen, die den Seeder erneut ausführt — Muster kopieren von api/database/migrations/2026_08_28_000000_update_submission_rate_thresholds.php (inkl. des runningUnitTests()-Guards).
  3. README-Tabellen synchron halten: reference/kpis-und-grenzwerte.md (Tabelle + Historie) und die Tabelle in api/app/Modules/KpiEvaluation/README.md.
  4. MR wie gewohnt; nach dem Deploy setzt die Migration die Werte auf allen Umgebungen.

Weg 2: Ad-hoc auf einer Umgebung

Für Experimente oder einen schnellen Eingriff (z. B. Stage). Es gibt kein Update-Kommando — Ändern heißt Löschen und neu Anlegen:

php artisan kpi:rule:remove "*" wear_cost --scope=service
php artisan kpi:rule:add "*" wear_cost --scope=service --operator=">=" --critical=300 --risky=120

Achtung Namensdreher: --critical = Riskant-Grenze (schwerste Stufe), --risky = Kritisch-Grenze (Warnstufe).

Danach verifizieren:

php artisan kpi:rule:list --scope=service --kpi=wear_cost

Zu beachten:

  • Zwischen remove und add bewerten laufende Requests diese KPI nicht — bei scope='supplier'-Regeln fällt sie kurz aus der Pflichtliste, das Ergebnis kann in dem Fenster milder ausfallen.
  • Ad-hoc-Änderungen an den Standard-KPIs werden von der nächsten Seeder-Migration überschrieben. Was bleiben soll, gehört in den Seeder (Weg 1).
  • Ad-hoc-Änderungen bitte im Team sichtbar machen (Ticket/Chat), sonst weicht die Umgebung unbemerkt von der Doku ab.