Zweck
Diese Seite legt die Schwellwerte der Deckungsbeitrags-Ampel fest — also ab welchem DB-Prozentsatz eine Marge rot, gelb oder grün eingefärbt wird. Die Ampel wirkt in der Lieferanten-Sub-Liste und in der Deckungsbeitrags-Übersicht. Die Mechanik beschreibt das Konzept Produkt-Lieferanten-Preise.
Voraussetzungen
- Berechtigung `view:FE_Settings` + `view:Settings` (Seite öffnen), `update:Settings` (ändern).
Berechtigungen (CASL)
| Action | Subject | Wirkung |
|---|
view | FE_Settings, Settings | Seite aufrufbar, Werte lesen |
update | Settings | Schwellwerte ändern |
Einstellungen
Die Werte liegen im Settings-Modell unter keyGroup = product (Prozentangaben):
| Feldname | Datentyp | Default | Wirkung |
|---|
contributionMarginMin | Zahl (%) | 10 | Unter diesem DB% → rot (zu niedrig). |
contributionMarginNormal | Zahl (%) | 20 | Bis hierhin gelb (akzeptabel). |
contributionMarginBest | Zahl (%) | 35 | Darüber grün (gut). |
Daraus ergeben sich vier Bänder:
| DB% | Farbe |
|---|
< Min | rot |
Min – Normal | gelb |
Normal – Best | grün |
≥ Best | bestes Grün |
Die Schwellwerte bewerten den **Deckungsbeitrag** (`Verkaufspreis − Einkaufspreis`) in Prozent — nicht den einkaufsseitigen Rabatt. Siehe [Produkt-Lieferanten-Preise](/konzepte/produkt-lieferanten-preise).
Verknüpfungen zu anderen Modulen
Wiederverwendbare Konzepte
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|
GET | /api/settings?filter[keyGroup]=product | Schwellwerte lesen | view Settings |
PATCH | /api/settings | Schwellwerte speichern | update Settings |
Versionshinweise
- 2026-06-22: Initiale Veröffentlichung — Marge-Ampel-Schwellwerte (
contributionMarginMin/Normal/Best, Default 10/20/35 %). Verifiziert an SettingsProductsPage.tsx, Migration 20260617181444-add-product-margin-settings.js.