Dokumentation: Supplier Cluster (Händlercluster)

Der Supplier-Cluster-Service bewertet Händler und einzelne Servicefälle anhand konfigurierbarer KPI-Grenzwerte und berechnet daraus eine Prüfungsintensität (0–100 %), mit der das Benefit-Portal entscheidet, ob ein Kostenvoranschlag automatisch freigegeben oder manuell geprüft wird.

Diese Doku folgt dem Diátaxis-Framework: vier Bereiche, je nachdem, ob du etwas lernen, eine Aufgabe erledigen, etwas nachschlagen oder etwas verstehen willst.

Für Product Owner / Fachbereich

Diese Dokumente kommen ohne Code aus:

• Architektur-Überblick — was das System tut und wie Portal und Cluster-Service zusammenspielen
• Ampel-Logik — warum Ampel-Bänder statt eines gewichteten Scores, und wie aus KPIs eine Prüfungsintensität wird
• KPIs und Grenzwerte — die aktuellen Grenzwerte aller KPIs, Cluster-Regeln und die Prüfungsintensitäts-Matrix

Für Entwickler

Tutorials — lernen

• Ersten Servicefall lokal durchspielen — Service lokal aufsetzen, KPI-Message und Evaluation-Request einspeisen, Ergebnis beobachten

How-to Guides — Aufgaben erledigen

• KPI-Grenzwerte anpassen
• Eine neue KPI aufnehmen
• Incomplete-Ergebnisse debuggen
• Händler-Status manuell übersteuern

Reference — nachschlagen

• KPIs und Grenzwerte
• Messages und Queues
• Artisan-Kommandos

Explanation — verstehen

• Architektur-Überblick
• Ampel-Logik

Verbindlichkeit

Die Grenzwert-Tabellen in reference/kpis-und-grenzwerte.md sind die dokumentierte Quelle für die Seed-Standardwerte. Die zur Laufzeit wirksamen Werte stehen in der Datenbank (evaluation_rules) und können per php artisan kpi:rule:list je Umgebung abgefragt werden — bei Abweichungen gilt die Datenbank.