Differences

This shows you the differences between two versions of the page.

--- to [2026/03/13 12:22] – created admin
+++ to [2026/03/13 12:56] (current) – admin
@@ Line 1: / Line 1: @@
-TowingOptimizer Algorithmus Dokumentation
+====== TowingOptimizer Algorithmus Dokumentation ======
-Überblick
-Der TowingOptimizer verwendet einen ausgeklügelten 4-Phasen-Bewertungsalgorithmus, um automatisch die optimalen Fahrer-Fahrzeug-Kombinationen für Abschleppaufträge zuzuweisen. Das System gewährleistet die strikte Einhaltung von Führerscheinanforderungen, Ausrüstungskompatibilität und betrieblichen Beschränkungen.
+===== Überblick =====
+Der TowingOptimizer verwendet einen ausgeklügelten **4-Phasen-Bewertungsalgorithmus**, um automatisch die optimalen Fahrer-Fahrzeug-Kombinationen für Abschleppaufträge zuzuweisen. Das System gewährleistet die strikte Einhaltung von Führerscheinanforderungen, Ausrüstungskompatibilität und betrieblichen Beschränkungen.
+===== Algorithmus-Phasen =====
+==== Phase 1: Fahrer-Auftrag Kompatibilitätsbewertung ====
-Algorithmus-Phasen
-Phase 1: Fahrer-Auftrag Kompatibilitätsbewertung
 Diese Phase bewertet die Eignung jedes Fahrers für den Auftrag basierend auf:
-Harte Constraints (Ausschlusskriterien):
+=== Harte Constraints (Ausschlusskriterien) ===
-Führerscheinanforderungen:
+  * **Führerscheinanforderungen**:
-HV-Schein Check: Elektrofahrzeug-Aufträge (IstHvScheinNotwendig = true) erfordern Fahrer mit Hochvolt-Zertifizierung (HatHvSchein = true)
+    * **HV-Schein Check**: Elektrofahrzeug-Aufträge (''IstHvScheinNotwendig = true'') erfordern Fahrer mit Hochvolt-Zertifizierung (''HatHvSchein = true'')
-Kran-Schein Check: Kran-erforderliche Aufträge (IstKranNotwendig = true) benötigen Fahrer mit Kranführerschein (HatKranSchein = true)
+    * **Kran-Schein Check**: Kran-erforderliche Aufträge (''IstKranNotwendig = true'') benötigen Fahrer mit Kranführerschein (''HatKranSchein = true'')
-Aktuelle Zuweisung: Bereits anderen Aufträgen zugewiesene Fahrer werden ausgeschlossen
+  * **Aktuelle Zuweisung**: Bereits anderen Aufträgen zugewiesene Fahrer werden ausgeschlossen
-Arbeitszeit: Fahrer ohne ausreichende verbleibende Arbeitsstunden (RestArbeitszeitMin) werden ausgeschlossen
+  * **Arbeitszeit**: Fahrer ohne ausreichende verbleibende Arbeitsstunden (''RestArbeitszeitMin'') werden ausgeschlossen
-Bewertungsfaktoren:
+=== Bewertungsfaktoren ===
+  * **Arbeitslasten-Ausgleich**: Fahrer mit weniger täglichen Zuweisungen erhalten höhere Punkte
+  * **Zeitstrafen**: Rufbereitschaftsfahrer erhalten Strafen für Nacht-/Tag-Zuweisungen basierend auf ''HatRufbereitschaft''
+  * **Standortkorrekturen**: Strafe wird angewandt, wenn Fahrzeugstandort zur Filiale korrigiert wurde
+==== Phase 2: Fahrzeug-Auftrag Kompatibilitätsbewertung ====
-Arbeitslasten-Ausgleich: Fahrer mit weniger täglichen Zuweisungen erhalten höhere Punkte
-Zeitstrafen: Rufbereitschaftsfahrer erhalten Strafen für Nacht-/Tag-Zuweisungen basierend auf HatRufbereitschaft
-Standortkorrekturen: Strafe wird angewandt, wenn Fahrerstandort zur Filiale korrigiert wurde
-Phase 2: Fahrzeug-Auftrag Kompatibilitätsbewertung
 Diese Phase bewertet die Fahrzeugeignung für den spezifischen Abschleppauftrag:
-Harte Constraints:
+=== Harte Constraints ===
-Gewichtskapazität: Fahrzeug MaxZuladungKg muss das Auftrags-GewichtKg überschreiten
+  * **Gewichtskapazität**: Fahrzeug ''MaxZuladungKg'' muss das Auftrags-''GewichtKg'' überschreiten
-Ölspur-Spezialisierung: Ölspur-Aufträge erfordern spezialisierte Fahrzeuge (FahrzeugTyp.OelspurMaschine)
+  * **Ölspur-Spezialisierung**: Ölspur-Aufträge erfordern spezialisierte Fahrzeuge (''FahrzeugTyp.OelspurMaschine'')
-Fahrzeugtyp-Kompatibilität:
+  * **Fahrzeugtyp-Kompatibilität**:
-LKW-Aufträge: Nur LkwBerger oder Lkw Fahrzeuge
+    * LKW-Aufträge: Nur ''LkwBerger'' oder ''Lkw'' Fahrzeuge
-PKW-Aufträge: Pkw oder Lkw Fahrzeuge
+    * PKW-Aufträge: ''Pkw'' oder ''Lkw'' Fahrzeuge
-Motorrad-Aufträge: Benötigen HatBrille (Motorrad-Adapter) oder HatKran (Kran)
+    * Motorrad-Aufträge: Benötigen ''HatBrille'' (Motorrad-Adapter) oder ''HatKran'' (Kran)
-Fahrrad-Aufträge: Nur Pkw Fahrzeuge
+    * Fahrrad-Aufträge: Nur ''Pkw'' Fahrzeuge
-Nicht-rollfähige Fahrzeuge: Müssen Plateau (HatPlateau) UND Seilwinde (HatSeilwinde) oder Kran (HatKran) haben
+  * **Nicht-rollfähige Fahrzeuge**: Müssen Plateau (''HatPlateau'') UND Seilwinde (''HatSeilwinde'') oder Kran (''HatKran'') haben
-Tiefgarage: Muss geeignet sein (IstFuerTiefgarageGeeignet) mit angemessener Höhenfreiheit
+  * **Tiefgarage**: Muss geeignet sein (''IstFuerTiefgarageGeeignet'') mit angemessener Höhenfreiheit
-Kran-Anforderungen: Kran-erfordernde Aufträge benötigen Fahrzeuge mit HatKran = true
+  * **Kran-Anforderungen**: Kran-erfordernde Aufträge benötigen Fahrzeuge mit ''HatKran = true''
-Bewertungsfaktoren:
+=== Bewertungsfaktoren ===
+  * **Entfernungsbasierte Bewertung**: Nähere Fahrzeuge erhalten höhere Punkte (bis zu 50km Radius)
+  * **Personentransport**: Strafe wenn Fahrzeug erforderliche Passagiere nicht aufnehmen kann (''MaxMitfahrer'')
+  * **Standortkorrekturen**: Strafe wird angewandt, wenn Fahrerstandort zur Filiale korrigiert wurde
+==== Phase 3: Bestehende Zuweisungsanalyse ====
-Entfernungsbasierte Bewertung: Nähere Fahrzeuge erhalten höhere Punkte (bis zu 50km Radius)
-Personentransport: Strafe wenn Fahrzeug erforderliche Passagiere nicht aufnehmen kann (MaxMitfahrer)
-Phase 3: Bestehende Zuweisungsanalyse
 Überprüft Zielorte aktuell zugewiesener Aufträge zur Optimierung der Routeneffizienz und Identifizierung potenzieller Konflikte.
-Phase 4: Fahrer-Fahrzeug Führerschein-Matching ⭐
+==== Phase 4: Fahrer-Fahrzeug Führerschein-Matching ⭐ ====
-Dies ist die kritische Phase, die die Führerschein-Kompatibilität zwischen Fahrer und Fahrzeug gewährleistet:
+<WRAP center round important 60%>
+Dies ist die **kritische Phase**, die die Führerschein-Kompatibilität zwischen Fahrer und Fahrzeug gewährleistet!
+</WRAP>
+=== Obligatorisches Führerschein-Matching ===
+<code>
+WENN fahrzeug.Fuehrerscheine != null UND fahrer.Fuehrerscheine != null DANN
+    fahrer.Fuehrerscheine MUSS mindestens EINEN Führerschein aus fahrzeug.Fuehrerscheine enthalten
+    SONST → DISQUALIFIZIERT (Punkte = 0)
+</code>
+=== Beispiel Führerschein-Anforderungen ===
+^ Fahrzeug benötigt ^ Fahrer hat ^ Ergebnis ^
+| ["C", "CE"] | ["B", "C"] | ✅ **ÜBEREINSTIMMUNG**: Fahrer hat "C" → Qualifiziert |
+| ["C", "CE"] | ["B"] | ❌ **KEINE ÜBEREINSTIMMUNG**: Nur "B" → Disqualifiziert |
+=== Zusätzliche Kreuzvalidierung ===
+  * **Kran-Aufträge**: SOWOHL Fahrzeug muss Kran haben (''HatKran'') ALS AUCH Fahrer muss Kranführerschein haben (''HatKranSchein'')
+  * **Elektrofahrzeug-Aufträge**: Fahrer muss HV-Schein (''HatHvSchein'') für entsprechende Aufträge haben
+===== Führerschein-Klassifizierungen =====
+==== Fahrer-Führerscheintypen ====
+^ Führerschein ^ Beschreibung ^
+| **B** | Normaler PKW-Führerschein |
+| **C** | LKW-Führerschein (bis bestimmtes Gewicht) |
+| **CE** | Schwer-LKW mit Anhänger-Führerschein |
+==== Spezielle Zertifizierungen ====
+^ Zertifizierung ^ Beschreibung ^
+| ''HatKranSchein'' | Kranführer-Lizenz |
+| ''HatHvSchein'' | Hochvolt-Elektroarbeits-Zertifizierung |
-🚨 OBLIGATORISCHES FÜHRERSCHEIN-MATCHING:
+===== Bewertungssystem =====
-Beispiel Führerschein-Anforderungen:
+Der Algorithmus verwendet ein **punktebasiertes System**, beginnend bei **100.000 Punkten** mit Strafen/Boni:
-Fahrzeug benötigt Führerscheinklassen: ["C", "CE"]
+==== Hauptstrafen ====
-Fahrer hat Führerscheine: ["B", "C"]
-✅ ÜBEREINSTIMMUNG: Fahrer hat "C" Führerschein → Qualifiziert
-❌ KEINE ÜBEREINSTIMMUNG: Fahrer hat nur "B" → Disqualifiziert mit 0 Punkten
-Zusätzliche Kreuzvalidierung:
-Kran-Aufträge: SOWOHL Fahrzeug muss Kran haben (HatKran) ALS AUCH Fahrer muss Kranführerschein haben (HatKranSchein)
+<WRAP center round alert 60%>
-Elektrofahrzeug-Aufträge: Fahrer muss HV-Schein (HatHvSchein) für entsprechende Aufträge haben
+**DISQUALIFIKATION (Punkte = 0)**
-Wichtige Führerschein-Klassifizierungen
+  * Führerschein-Nichtübereinstimmung
-Fahrer-Führerscheintypen (Fuehrerscheine):
+  * Fehlende erforderliche Ausrüstung
+  * Unzureichende Kapazität
+</WRAP>
-B: Normaler PKW-Führerschein
+==== Optimierungs-Boni ====
-C: LKW-Führerschein (bis bestimmtes Gewicht)
-CE: Schwer-LKW mit Anhänger-Führerschein
-Spezielle Zertifizierungen:
-HatKranSchein: Kranführer-Lizenz
-HatHvSchein: Hochvolt-Elektroarbeits-Zertifizierung
-Fahrzeug-Anforderungen:
-Verschiedene Abschleppfahrzeuge erfordern verschiedene Führerscheinklassen
+  * **Arbeitslasten-Ausgleichs-Boost**: Bis zu konfigurierbaren Bonuspunkten
-Schwere Bergungsfahrzeuge benötigen typischerweise C oder CE Führerscheine
+  * **Entfernungsnähe**: Bis zu 50.000 Punkte für nahegelegene Fahrzeuge
-Spezialisierte Ausrüstung (Kran, Hochvolt) erfordert zusätzliche Zertifizierungen
+  * **Prioritätsauftrags-Behandlung**: Garantierte Mindestpunkte für Notrufe
-Bewertungssystem
-Der Algorithmus verwendet ein punktebasiertes System, beginnend bei 100.000 Punkten mit Strafen/Boni:
-Hauptstrafen:
+===== Finale Empfehlungsgenerierung =====
-Führerschein-Nichtübereinstimmung: Disqualifikation (Punkte = 0)
+Der Algorithmus kombiniert alle Phasen-Punkte zur Erstellung bewerteter Empfehlungen:
-Fehlende erforderliche Ausrüstung: Disqualifikation
-Unzureichende Kapazität: Disqualifikation
-Optimierungs-Boni:
-Arbeitslasten-Ausgleichs-Boost: Bis zu konfigurierbaren Bonuspunkten
+  - Beste Fahrer-Fahrzeug-Kombinationen für jeden Auftrag
-Entfernungsnähe: Bis zu 50.000 Punkte für nahegelegene Fahrzeuge
+  - Detaillierte Begründung für jede Bewertungsentscheidung
-Prioritätsauftrags-Behandlung: Garantierte Mindestpunkte für Notrufe
+  - Klare Angabe aller disqualifizierenden Faktoren
-Finale Empfehlungsgenerierung
+  - Geschätzte Fertigstellungszeiten und Routeneffizienz
-Der Algorithmus kombiniert alle Phasen-Punkte zur Erstellung bewerteter Empfehlungen, die zeigen:
-Beste Fahrer-Fahrzeug-Kombinationen für jeden Auftrag
+<WRAP center round tip 80%>
-Detaillierte Begründung für jede Bewertungsentscheidung
+**Fazit**: Dieser mehrstufige Ansatz gewährleistet, dass jede Zuweisung alle Sicherheits- und Rechtsanforderungen erfüllt, während gleichzeitig für betriebliche Effizienz und Arbeitslasten-Verteilung optimiert wird.
-Klare Angabe aller disqualifizierenden Faktoren
+</WRAP>
-Geschätzte Fertigstellungszeiten und Routeneffizienz
-Dieser mehrstufige Ansatz gewährleistet, dass jede Zuweisung alle Sicherheits- und Rechtsanforderungen erfüllt, während gleichzeitig für betriebliche Effizienz und Arbeitslasten-Verteilung optimiert wird.