Changes for page Fuhrpark (Fleet Manager)

Summary

• Page properties (3 modified, 0 added, 0 removed)
• Attachments (0 modified, 0 added, 3 removed)
  • 1776413498048-751.png
  • 1789018507266-361.png
  • 1789018507268-395.png

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.gurschkap
	1	+XWiki.drupp

Tags

...	...	@@ -1,1 +1,0 @@
1		-anleitung

Content

...	...	@@ -1,154 +1,243 @@
1		-|(((
2		-= **🚗 Fuhrpark (Fleet Manager)** =
	1	+**Ablauf Fleet Manager:**
3	3
4		-|(((
5		-**Zweck: **Webbasierte Verwaltung des Firmenfuhrparks — Fahrzeug-/Fahrerstammdaten, Kostenkalkulation, Kilometerauswertung, Ersatzbeschaffungs-Planung (Handlungsbedarf) und monatliche Abrechnung.
6	6
7		-**Zielgruppe: **Fuhrpark-/Controlling-Team, Line Manager, IT-Betrieb.
8		-)))
	4	+**~1. Fahrzeuge verwalten**
9	9
10		-
11		-)))|(((
12		-|(((
13		-**Auf dieser Seite**
	6	+Fahrzeuge werden bis jetzt einmal aus Rimo importiert und dann in der App gepflegt. (Geplant: retour schreiben in Rimo)
14	14
15		-* [[🚗 Fuhrpark (Fleet Manager)>>path:#top]]
16		-** [[Überblick>>path:#ueberblick]]
17		-** [[Architektur>>path:#architektur]]
18		-** [[Technologiestack>>path:#technologiestack]]
19		-** [[Hauptfunktionen>>path:#hauptfunktionen]]
20		-*** [[1. Stammdaten-Import>>path:#hf1]]
21		-*** [[2. Fahrzeug-/Fahrer-Zuordnung>>path:#hf2]]
22		-*** [[3. Kilometer-Erfassung>>path:#hf3]]
23		-*** [[4. Kalkulation>>path:#hf4]]
24		-*** [[5. Handlungsbedarf>>path:#hf5]]
25		-*** [[6. Export & Abrechnung>>path:#hf6]]
26		-** [[Nachvollziehbarkeit & Fehlerbehandlung>>path:#orch]]
27		-** [[Cronjobs & Konfiguration>>path:#konfiguration]]
28		-** [[Sicherheit>>path:#sicherheit]]
29		-*** [[Authentifizierung>>path:#auth]]
30		-*** [[Datenschutz>>path:#datenschutz]]
31		-** [[Besondere Geschäftslogik>>path:#geschaeftslogik]]
32		-** [[Offene Punkte / zu verifizieren>>path:#offene-punkte]]
33		-** [[Server / Umgebung>>path:#server]]
34		-)))
35	35
36		-
37		-)))
	9	+**Fahrzeug anlegen**
38	38
	11	+1. Menü **„Fahrzeuge“** öffnen
	12	+1. Auf **„Fahrzeug hinzufügen“** klicken
	13	+1. Pflichtfelder ausfüllen (MAT-ID, Marke, Modell verpflichtend)
	14	+1. Fahrer und Line Manager (wird automatisch ergänzt, kann dennoch selbst ausgewählt werden) auswählen
	15	+1. Speichern
39	39
40	40
41		-= Überblick =
42	42
43		-Fuhrpark ist eine FastAPI-Backend- + React-Frontend-Anwendung (migriert von einer Streamlit-Monolith-Anwendung). Die Lösung besteht aus:
	19	+**Fahrzeug bearbeiten**
44	44
45		-* Frontend: React 18 · Vite · React Query · Axios-Client (nginx-Reverse-Proxy)
46		-* Backend: FastAPI · SQLite (WAL-Modus) · JWT-Authentifizierung
47		-* Datenquellen: RIMO/SQL-Server (Fahrer-Stammdaten) · Microsoft Fabric (SharePoint, KM-Formular-Mails) · GPS-AT/Tesla-APIs (Kilometerstände)
48		-* Orchestrierung: eigenständige Cron-Skripte auf dem Server, unabhängig vom Docker-Container
	21	+* Fahrzeug auswählen
	22	+* Änderungen durchführen
49	49
50		-= Architektur =
	24	+Wenn ein Fahrer nur für einen Zeitraum zugewiesen wird, wird nach diesem Zeitraum wieder der Ursprungsfahrer eingetragen. Wenn kein Enddatum eingetragen wird, bleibt der Fahrer bis etwas geändert wird.
51	51
52		-[[image:1789018507266-361.png]]
	26	+* Speichern
53	53
54		-//Frontend, Backend und Datenbank laufen im Docker-Compose-Stack; die Cron-Skripte laufen direkt auf dem Host und schreiben in dieselbe fleet.db.//
55	55
56		-= Technologiestack =
57	57
58		-**Frontend: **React 18 · Vite · React Router · React Query (TanStack Query) · Axios
	30	+**Fahrzeug deaktivieren**
59	59
60		-**Backend: **FastAPI (Python) · SQLite · Pandas · python-jose (JWT) · passlib/bcrypt · pyodbc
	32	+* in "bearbeiten" kann das Fahrzeug auf inaktiv gesetzt werden und bleibt in der Tabelle
61	61
62		-**Externe APIs: **RIMO/SQL-Server (ai.sdmperson, rimo.sdmtool) · Microsoft Fabric (SharePoint, KM-Formular-Mails) · GPS-AT- und Tesla-API
63	63
64		-= Hauptfunktionen =
65	65
66		-~1. Stammdaten-Import
	36	+**Fahrzeug archivieren**
67	67
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.
	38	+* Fahrzeug kann archiviert werden, dann wird es automatisch auf inaktiv gesetzt und in der „archivierte Fahrzeuge“ Tabelle angezeigt (dort kann es wieder aktiviert werden)
69	69
70		-2. Fahrzeug-/Fahrer-Zuordnung
	40	+----
71	71
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
	43	+**2. Fahrer verwalten**
75	75
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.
	45	+Fahrer werden jeden Tag um 4:00 in der Früh in Rimo überprüft und wenn notwendig neu angelegt oder bei Veränderungen angepasst.
77	77
78		-4. Kalkulation
79	79
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).
	48	+**Fahrer anlegen (extern)**
81	81
82		-5. Handlungsbedarf
	50	+1. Menü **„Fahrer“** öffnen
	51	+1. Auf **„Fahrer hinzufügen“** klicken
	52	+1. Stammdaten eingeben
	53	+1. Speichern
83	83
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
87	87
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.
	57	+**Fahrer bearbeiten**
89	89
90		-= Nachvollziehbarkeit & Fehlerbehandlung =
	59	+* Stammdaten ändern (nur bei extern)
91	91
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).
	61	+----
93	93
94		-[[image:1789018507268-395.png]]
95	95
96		-//Ablauf bei einem Line-Manager-Wechsel, inkl. Absicherung gegen doppelte Sichtbarkeit.//
	64	+**3. Kilometer-Daten**
97	97
98		-= Cronjobs & Konfiguration =
	66	+* Kilometerstände werden automatisch importiert (z. B. GPS / Tesla)
	67	+** gpsat täglich um 4:00
	68	+** tesla montags 4:00
	69	+** beides jeweils Ende des Monats
	70	+** Erinnerungsmail wird 3 Tage von Ende des Monats täglich ausgeschickt, wenn kein KM Stand in der Sharepoint Liste vorhanden ist. Sobald die Liste vollständig ist, wird sie auf die App übertragen.
99	99
100		-|**Bereich**|**Details**
101		-|Täglicher Fahrer-Sync|1_import_users_drivers.py, 4:00 Uhr — Fahrer-Stammdaten, Line Manager, Kostenstelle gegen RIMO (ai.sdmperson) abgleichen
102		-|KM-Import gpsat|import_km.py gpsat, täglich 4:00 Uhr, jeweils zum Monatsende
103		-|KM-Import Tesla|import_km.py tesla, montags 4:00 Uhr, jeweils zum Monatsende
104		-|SharePoint-Erinnerung|3 Tage vor Monatsende täglich, wenn kein KM-Stand in der SharePoint-Liste vorhanden ist
105		-|Docker Compose|Services backend (FastAPI) + frontend (nginx + React-Build)
106		-|Datenbank|SQLite, WAL-Modus, data/fleet.db (Projekt-Root, nicht in Git)
107		-|Reparatur-Skript|repair_stale_line_manager_assignments.py — einmalig, bei Altlasten vor dem Line-Manager-Fix
108	108
109	109
	74	+* Das System berechnet:
	75	+** Differenzen
	76	+** Jahreskilometer
	77	+** aktuelle Laufleistung
110	110
111		-= Sicherheit =
112	112
113		-Authentifizierung
114	114
115		-* JWT (python-jose), OAuth2-Password-Flow, 8-Stunden-Tokens
116		-* Rollen: admin, demo, controlling, Benutzer (Line Manager/Fahrer)
117		-* Zugriff auf Fahrzeug-Zuweisungshistorie und rohe KM-Ablesungen ist admin/demo vorbehalten — serverseitig abgesichert (403), nicht nur im Frontend versteckt
	81	+Diese Daten sind im **KM-Dashboard** einsehbar.
118	118
119		-Datenschutz
	83	+----
120	120
121		-Sichtbarkeit von Fahrzeugen und Fahrern für normale Nutzer richtet sich ausschließlich nach der Line-Manager-Zuordnung. Passwörter sowie SQL-Server-/Fabric-Zugangsdaten liegen in nicht versionierten .env-Dateien (Docker-.env für Secrets der App, backend/.env für die Cron-Skripte).
122	122
123		-= Besondere Geschäftslogik =
	86	+**4. Kalkulation**
124	124
125		-* **Zeitzonen-Korrektur: **sync_vehicle_assignment() vergleicht mit datetime('now','localtime') statt datetime('now') — SQLite liefert sonst UTC, während alle gespeicherten Zeitstempel lokale Zeit sind. Ohne die Korrektur blieb eine gerade beendete Zuordnung bis zu 1–2 Stunden fälschlich „aktiv“.
126		-* **Import-Marker: **Historienzeilen aus der einmaligen Erstbefüllung (changed_by='import') zeigen in der Zuordnungs-Anzeige bewusst kein Startdatum („– 20.04.2026“ statt „28.02.2026 – 20.04.2026“), da dieses Datum nur den Zeitpunkt des Imports, nicht den echten historischen Beginn widerspiegelt.
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		-* **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.
	88	+Für jedes Fahrzeug kann eine Kostenkalkulation durchgeführt werden:
129	129
130		-|(((
131		-**⚠️  Offene Punkte / zu verifizieren**
	90	+* Anschaffungskosten
	91	+* Laufende Kosten (Versicherung, Wartung etc.)
	92	+* Verbrauch & Energiepreise
132	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	138
139	139
	96	+Ergebnisse:
140	140
141		-= Server / Umgebung =
	98	+* Kosten pro Monat
	99	+* Kosten pro Jahr
	100	+* Kosten pro Kilometer
142	142
143		-Die App läuft auf 192.168.208.2, per Docker Compose (Services backend + frontend), und liegt unter /mnt/data/fleet-manager/fuhrpark.
144	144
145		-**Deployment bei Codeänderungen** (manuell auf dem Server auszuführen):
146	146
147		-sudo -u www-data git pull
	104	+Wenn ein Fahrzeug hinzugefügt wird, werden die Default Parameter aus „Kalkulationsparameter“ nach Typ übernommen. Die 7 fehlenden Felder werden in „Kalkulation“ bei "bearbeiten" eingetragen und beim auf „Aktualisieren“ Drücken werden die Werte berechnet in die Tabelle eingetragen.
148	148
149		-docker compose up -d ~-~-build
	106	+----
150	150
151	151
152		-**Cronjobs: **sudo -u www-data crontab -e, Logs unter /mnt/data/fleet-manager/fuhrpark/logs.
	109	+**5. Handlungsbedarf**
153	153
154		-Erreichbar unter http:~/~/fleetmanager.spl-tele.com:8501 — mit VPN und im SPL-TELE-Netzwerk.
	111	+Die Hochrechnungen in Handlungsbedarf werden immer neu berechnet mit den Importen der KM Stände.
	112	+
	113	+
	114	+**Neues Fahrzeug bestellen**
	115	+
	116	+* Wenn neues Fahrzeug bestellt wurde, muss im Bereich „Handlungsbedarf“ das Häkchen bei „Bestellt“ gesetzt werden.
	117	+* Erst danach ist es möglich, ein neues Fahrzeug im System anzulegen.
	118	+
	119	+
	120	+
	121	+**Neues Fahrzeug anlegen**
	122	+
	123	+* Ein Fahrzeug kann erst bearbeitet werden, nachdem es angelegt wurde
	124	+* Nach der Anlage steht die Funktion „Geliefert“ zur Verfügung
	125	+
	126	+
	127	+
	128	+**Fahrzeug als geliefert markieren**
	129	+
	130	+* Sobald ein Fahrzeug als „geliefert“ markiert wird:
	131	+** wird es automatisch aus der Handlungsbedarfsliste entfernt
	132	+** gilt der Beschaffungsprozess als abgeschlossen
	133	+
	134	+
	135	+
	136	+**Darstellung im Forecast**
	137	+
	138	+* Neu hinzugefügte Fahrzeuge (Bereich „Fahrzeuge“)
	139	+* sowie im Handlungsbedarf angelegte Fahrzeuge
	140	+
	141	+werden automatisch im Bereich „Forecast“ angezeigt.
	142	+
	143	+Zusätzlich gilt:
	144	+
	145	+* Fahrzeuge aus dem Handlungsbedarf enthalten im Forecast eine
	146	+Referenz zum alten (ersetzten) Fahrzeug
	147	+
	148	+
	149	+
	150	+**Deaktivierung von Fahrzeugen**
	151	+
	152	+Wenn im Feld „Deactivation Date“ ein Datum eingetragen wird:
	153	+
	154	+wird das Fahrzeug ab diesem Datum automatisch:
	155	+
	156	+* deaktiviert
	157	+* in den Bereich „Archivierte Fahrzeuge**“** verschoben
	158	+
	159	+----
	160	+
	161	+
	162	+**6. Dashboard**
	163	+
	164	+Das Dashboard zeigt:
	165	+
	166	+* Anzahl Fahrzeuge
	167	+* Kostenübersicht
	168	+* relevante Kennzahlen
	169	+
	170	+Es dient als zentrale Übersicht für den aktuellen Fuhrparkstatus.
	171	+
	172	+----
	173	+
	174	+
	175	+**7. Benutzerverwaltung (Admin)**
	176	+
	177	+Admins können:
	178	+
	179	+* Benutzer anlegen
	180	+* Passwörter ändern
	181	+* Fahrer und Fahrzeuge zuweisen
	182	+
	183	+----
	184	+
	185	+
	186	+**8. Kalkulationsparameter**
	187	+
	188	+Wenn hier etwas angepasst wird, werden die Werte für alle Fahrzeuge dieses Typs abgeändert.
	189	+
	190	+----
	191	+
	192	+
	193	+**9. Export & Berichte**
	194	+
	195	+* Monatliche Abrechnungen werden automatisch erstellt
	196	+* Export erfolgt als CSV-Datei
	197	+* Daten können in Excel weiterverarbeitet werden
	198	+
	199	+----
	200	+
	201	+
	202	+**10. Hinweise**
	203	+
	204	+* Änderungen im Demo-Modus werden nicht gespeichert
	205	+* Benutzerrechte bestimmen die Sichtbarkeit der Daten
	206	+* Regelmäßige Datenpflege (z. B. Fahrerzuordnung) ist wichtig für korrekte Auswertungen
	207	+
	208	+
	209	+
	210	+
	211	+**Fehlerbehebung**
	212	+
	213	+* **Frontend:** Streamlit
	214	+* **Backend:** Python
	215	+* **Datenbank:** SQLite
	216	+* **Externe APIs:** Microsoft Fabric Integration
	217	+
	218	+Die App läuft auf 192.168.208.2, in einem Docker und liegt in: /mnt/data/fleet-manager/fuhrpark.
	219	+
	220	+Falls etwas in Github geändert wird muss der git pull manuell auf dem Server passieren:
	221	+
	222	+* sudo chown -R $USER:$USER /mnt/data/fleet-manager/fuhrpark
	223	+* git pull
	224	+* sudo chown -R www-data:www-data /mnt/data/fleet-manager/fuhrpark
	225	+* docker compose up -d ~-~-build
	226	+
	227	+Es gibt cronjobs in crontab -e, mit logs in /mnt/data/fleet-manager/fuhrpark/logs.
	228	+
	229	+----
	230	+
	231	+== Verwandte Themen ==
	232	+
	233	+//Kuratiert — kann direkt im Editor ergänzt werden://
	234	+
	235	+* [[ABK (Ausschreibungssoftware)>>doc:IT-Wiki.02-Tools.ABK.WebHome]]
	236	+* [[UiPath>>doc:IT-Wiki.02-Tools.UiPath.WebHome]]
	237	+* [[Microsoft Intune>>doc:IT-Wiki.02-Tools.Intune.WebHome]]
	238	+
	239	+{{include reference="IT-Wiki.Makros.Verwandte-Themen.WebHome"/}}
	240	+
	241	+----
	242	+**Status:** Migriert — Team-Review ausstehend · **Owner:** //(festlegen)// · **Letzter Review:** 2026-06-11
	243	+

1776413498048-751.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.drupp

Size

...	...	@@ -1,1 +1,0 @@
1		-3.1 KB

Content

1789018507266-361.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.gurschkap

Size

...	...	@@ -1,1 +1,0 @@
1		-52.2 KB

Content

1789018507268-395.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.gurschkap

Size

...	...	@@ -1,1 +1,0 @@
1		-19.7 KB

Content