Artisan-Kommandos

Reference · Stand: 2026-09-22

Alle Kommandos laufen im api/-Kontext (lokal im PHP-Container).

kpi:rule:list

Zeigt die evaluation_rules-Zeilen — die zur Laufzeit wirksamen Grenzwerte.

php artisan kpi:rule:list [--scope=supplier|service] [--case=*] [--kpi=wear_cost]

kpi:rule:add

Legt eine neue Regel an (eine Zelle der Bewertungsmatrix).

php artisan kpi:rule:add {caseType} {kpiKey} \
    [--scope=supplier|service]   # Default: supplier
    [--operator=">="]            # > < >= <= == ; ohne Operator wird nie gebandet
    [--critical=7.5]             # Riskant-Grenze (schwerste Stufe!)
    [--risky=5.0]                # Kritisch-Grenze (Warnstufe)

Achtung Namensdreher: --critical setzt die Riskant-Grenze, --risky die Kritisch-Grenze (Spalten sind nach Schweregrad benannt, siehe KPIs und Grenzwerte). Als caseType ist * das Wildcard; eine Regel mit konkretem case_type gewinnt gegen * für denselben kpi_key.

kpi:rule:remove

Löscht eine Regel anhand von (caseType, kpiKey):

php artisan kpi:rule:remove {caseType} {kpiKey} [--scope=supplier|service]

Es gibt kein Update-Kommando — Änderung = remove + add, siehe KPI-Grenzwerte anpassen.

kpi:purge-expired

Löscht kpi_values-Zeilen, deren superseded_at älter als 90 Tage ist. Läuft täglich per Scheduler (routes/console.php); manueller Aufruf ist idempotent und gefahrlos.

php artisan kpi:purge-expired

Seeding

php artisan db:seed --class="Database\Seeders\EvaluationRulesSeeder"

Idempotent (updateOrCreate je (scope, case_type, kpi_key)): setzt die Standard-Grenzwerte, ohne zusätzliche, manuell angelegte Regeln zu löschen. Überschreibt aber manuell geänderte Grenzwerte der Standard-KPIs.

Grenzwert-Änderungen, die alle Umgebungen erreichen sollen, werden als Migration ausgeliefert, die den Seeder erneut ausführt (Muster: 2026_08_28_000000_update_submission_rate_thresholds.php).