Changes for page Fuhrpark (Fleet Manager)

Last modified by Patrizia Gurschka on 2026/09/14 07:51

From version 12.1
edited by Patrizia Gurschka
on 2026/09/10 07:39
Change comment: There is no comment for this version
To version 19.1
edited by Patrizia Gurschka
on 2026/09/14 07:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,10 +1,14 @@
1 1  |(((
2 -= **đźš— Fuhrpark (Fleet Manager)** =
2 += **đźš— **Fuhrpark (Fleet Manager) =
3 3  
4 4  |(((
5 +{{info}}
5 5  **Zweck: **Webbasierte Verwaltung des Firmenfuhrparks — Fahrzeug-/Fahrerstammdaten, Kostenkalkulation, Kilometerauswertung, Ersatzbeschaffungs-Planung (Handlungsbedarf) und monatliche Abrechnung.
6 -
7 7  **Zielgruppe: **Fuhrpark-/Controlling-Team, Line Manager, IT-Betrieb.
8 +
9 +{{/info}}
10 +
11 +
8 8  )))
9 9  
10 10  
... ... @@ -63,27 +63,27 @@
63 63  
64 64  = Hauptfunktionen =
65 65  
66 -~1. Stammdaten-Import
70 +== 1. Stammdaten-Import ==
67 67  
68 68  Fahrzeuge werden initial aus RIMO importiert und danach in der App gepflegt (RĂĽckschreiben nach RIMO ist geplant, aktuell nicht implementiert). Fahrer werden täglich um 4:00 Uhr gegen RIMO (ai.sdmperson) abgeglichen — Neuanlage bei unbekannter Personalnummer, sonst Aktualisierung von Stammdaten, Kostenstelle und Line Manager. Externe Fahrer können zusätzlich manuell angelegt werden; Stammdaten interner (RIMO-importierter) Fahrer sind schreibgeschĂĽtzt.
69 69  
70 -2. Fahrzeug-/Fahrer-Zuordnung
74 +== 2. Fahrzeug-/Fahrer-Zuordnung ==
71 71  
72 72  Fahrer und Line Manager können einem Fahrzeug direkt zugewiesen werden (Line Manager wird bei Fahrer-Auswahl automatisch ergänzt, bleibt aber ĂĽberschreibbar). Befristete Zuordnungen kehren nach Ablauf automatisch zum vorherigen Fahrer zurĂĽck. Jede Zuordnungs- sowie Line-Manager-/Kostenstellen-Ă„nderung wird vollständig und zeitlich abgegrenzt protokolliert (vehicle_assignment_history, driver_attribute_history) — sowohl bei manueller Ă„nderung als auch beim täglichen RIMO-Sync.
73 73  
74 -3. Kilometer-Erfassung
78 +== 3. Kilometer-Erfassung ==
75 75  
76 76  Kilometerstände werden automatisiert importiert: GPS-AT täglich, Tesla wöchentlich, jeweils zum Monatsende. FĂĽr Fahrzeuge ohne automatische Anbindung wird 3 Tage vor Monatsende täglich eine Erinnerungsmail verschickt, bis ein Wert in der SharePoint-Liste eingetragen ist. Das KM-Dashboard berĂĽcksichtigt bei der Auswertung ausschlieĂźlich den Zeitraum, in dem die jeweilige Zuordnung tatsächlich bestand — auch bei unterjährigem Fahrer- oder Line-Manager-Wechsel.
77 77  
78 -4. Kalkulation
82 +== 4. Kalkulation ==
79 79  
80 80  Pro Fahrzeug wird eine Kostenkalkulation aus Anschaffungskosten, laufenden Kosten und Verbrauch/Energiepreisen erstellt (Kosten pro Monat/Jahr/Kilometer). Beim Anlegen werden Default-Parameter aus „Kalkulationsparameter“ nach Fahrzeugtyp ĂĽbernommen; individuelle Felder werden ergänzt und per „Aktualisieren“ neu berechnet. Ă„nderungen an Kalkulationsparametern wirken sich auf alle Fahrzeuge des jeweiligen Typs aus (Rollen admin/demo/controlling).
81 81  
82 -5. Handlungsbedarf
86 +== 5. Handlungsbedarf ==
83 83  
84 84  Hochrechnungen werden bei jedem KM-Stand-Import neu berechnet. Ein bestelltes Fahrzeug wird ĂĽber das Häkchen „Bestellt“ markiert, erst danach anlegbar. Nach Anlage steht „Geliefert“ zur VerfĂĽgung; sobald gesetzt, entfällt das Fahrzeug automatisch aus der Handlungsbedarfsliste. Ein gesetztes „Deactivation Date“ deaktiviert und archiviert ein Fahrzeug automatisch zum entsprechenden Datum.
85 85  
86 -6. Export & Abrechnung
90 +== 6. Export & Abrechnung ==
87 87  
88 88  Monatliche Abrechnungen und Kostenstellen-Umbuchungen werden auf Klick erstellt und als CSV exportiert. Die vollständige Fahrzeugliste (inkl. kompletter KalkulationsaufschlĂĽsselung) sowie gefahrene Kilometer können als Excel-Datei heruntergeladen werden.
89 89  
... ... @@ -91,7 +91,7 @@
91 91  
92 92  Ă„ndert sich der Line Manager eines Fahrers — manuell oder ĂĽber den täglichen Cron-Sync — wird nicht nur drivers.user_id aktualisiert, sondern auch jede betroffene vehicle_assignment_history-Zeile korrekt geschlossen und neu angelegt. Ohne diesen Schritt bliebe ein Fahrzeug fälschlich sowohl beim alten als auch beim neuen Line Manager sichtbar (historisch aufgetretener Fehler, mittlerweile behoben und mit einem Reparatur-Skript fĂĽr Altfälle nachgezogen).
93 93  
94 -[[image:1789018507268-395.png||height="336" width="979"]]
98 +[[image:1789022432806-668.png]]
95 95  
96 96  //Ablauf bei einem Line-Manager-Wechsel, inkl. Absicherung gegen doppelte Sichtbarkeit.//
97 97  
... ... @@ -106,8 +106,6 @@
106 106  |Datenbank|SQLite, WAL-Modus, data/fleet.db (Projekt-Root, nicht in Git)
107 107  |Reparatur-Skript|repair_stale_line_manager_assignments.py — einmalig, bei Altlasten vor dem Line-Manager-Fix
108 108  
109 -
110 -
111 111  = Sicherheit =
112 112  
113 113  Authentifizierung
... ... @@ -127,17 +127,6 @@
127 127  * **Odometer vs. Jahreskilometer: **vehicles.current_km speichert die im laufenden Kalenderjahr gefahrenen Kilometer (Vergleichswert zu „Max. KM/Jahr“), nicht den tatsächlichen Tacho-Stand. FĂĽr die Anzeige des echten Kilometerstands wird stattdessen die letzte Ablesung aus der KM-Historie herangezogen (latest_odometer_km).
128 128  * **Zuordnungsende “heute“: **Wird als Enddatum das aktuelle Datum gewählt, wird als Enddatum bewusst der Vortag (23:59:59) gespeichert — damit gilt die Zuordnung ab exakt Mitternacht des gewählten Tages als beendet, ohne Sekundenpräzision oder Sonderfall im Code.
129 129  
130 -|(((
131 -**⚠️  Offene Punkte / zu verifizieren**
132 -
133 -* Flottenweite Reaktivierung in apply_due_deactivations(): Die automatische Reaktivierung („kein Deactivation Date mehr“) wirkt aktuell auf ALLE Fahrzeuge mit deactivation_date=NULL, nicht nur auf das gerade bearbeitete — kann manuell archivierte Fahrzeuge versehentlich mit reaktivieren. Fix identifiziert (Reaktivierung auf die eine Fahrzeug-ID scopen), Umsetzung noch ausständig.
134 -* Genaues Schema von rimo.sdmtool (Spaltennamen name/last_update) ist aus einer Beschreibung ĂĽbernommen, nicht 1:1 gegen die echte Tabelle verifiziert.
135 -* Kein bestätigtes automatisches Backup der Produktivdatenbank gefunden — falls vorhanden, läuft es außerhalb des Anwendungscodes; sollte auf dem Server verifiziert werden.
136 -* Exakte SharePoint-/Fabric-Spaltennamen (SP_LIST_ITEMS_URL u. Ă„.) sollten einmalig gegen die reale Liste geprĂĽft werden.
137 -)))
138 -
139 -
140 -
141 141  = Server / Umgebung =
142 142  
143 143  Die App läuft auf 192.168.208.2, per Docker Compose (Services backend + frontend), und liegt unter /mnt/data/fleet-manager/fuhrpark.
1789022432806-668.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.gurschkap
Size
... ... @@ -1,0 +1,1 @@
1 +55.3 KB
Content