Changes for page Fuhrpark (Fleet Manager)

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

Manage
- Copy
Actions
- Export
- Print Preview
Viewers
- Source
- Children
- Content
- Comments
- Attachments (5)
- History
- Information
- Likes

From 1.1 to 2.1 From 7.2 to 7.3

From version 2.1

edited by Dimitri Rupp
on 2026/06/11 11:00

Change comment: There is no comment for this version

To version 7.2

edited by Patrizia Gurschka
on 2026/09/09 13:08

Change comment: Auto-saved during real-time collaboration

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)
Attachments (0 modified, 1 added, 0 removed)
- 1776413498048-751.png

Details

Page properties

Author

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

Tags

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

Content

@@ -1,243 +1,157 @@
--**Ablauf Fleet Manager:**
++= 🚗 Fuhrpark (Fleet Manager) =
++>**Zweck:** Webbasiertes System zur Verwaltung des Firmenfuhrparks — von Fahrzeug- und Fahrerstammdaten über Kostenkalkulation und Kilometerauswertung bis zu automatisierter Ersatzbeschaffungs-Planung (Handlungsbedarf) und monatlicher Abrechnung.
--**~1. Fahrzeuge verwalten**
++== Übersicht ==
--Fahrzeuge werden bis jetzt einmal aus Rimo importiert und dann in der App gepflegt. (Geplant: retour schreiben in Rimo)
++Fuhrpark unterstützt den gesamten Lebenszyklus eines Firmenfahrzeugs: Anlage und Zuordnung, laufende Kostenkalkulation, Kilometer-Tracking, Handlungsbedarf/Ersatzbeschaffung bis zur monatlichen Abrechnung und Kostenstellen-Umbuchung. Fahrzeug- und Fahrerstammdaten werden aus dem unternehmensweiten RIMO-System (SQL-Server-DWH) synchronisiert, Kilometerstände automatisiert über GPS-/Tesla-Anbindung und SharePoint importiert.
++Das Projekt wurde von einer Streamlit-Monolith-Anwendung auf eine FastAPI-Backend- + React-Frontend-Architektur umgestellt.
--**Fahrzeug anlegen**
++== Technologie-Stack ==
--1. Menü **„Fahrzeuge“** öffnen
--1. Auf **„Fahrzeug hinzufügen“** klicken
--1. Pflichtfelder ausfüllen (MAT-ID, Marke, Modell verpflichtend)
--1. Fahrer und Line Manager (wird automatisch ergänzt, kann dennoch selbst ausgewählt werden) auswählen
--1. Speichern
++**Frontend:** React 18 · Vite · React Router · React Query (TanStack Query) · Axios · eigene UI-Komponentenbibliothek (kein UI-Framework wie MUI/shadcn)
++**Backend:** FastAPI (Python) · SQLite (WAL-Modus) · Pandas · python-jose (JWT) · passlib/bcrypt · pyodbc (SQL-Server-Anbindung)
++**Externe Anbindungen:**
--**Fahrzeug bearbeiten**
++* **RIMO / SQL-Server (ai.sdmperson, rimo.sdmtool):** täglicher Fahrer-/Line-Manager-Sync, Datumsermittlung für Nachkorrekturen
++* **Microsoft Fabric:** KM-Formular-E-Mails, SharePoint-Listenabgleich
++* **GPS-AT / Tesla:** automatischer Kilometerstand-Import
--* Fahrzeug auswählen
--* Änderungen durchführen
++== Projektstruktur ==
--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.
++{{{fuhrpark/
++├── _bootstrap.py                          Gemeinsames Setup für alle Skripte
++├── 1_import_users_drivers.py              Täglicher Fahrer-/Line-Manager-Sync (Cron)
++├── 2_import_vehicles.py                   Einmaliger Fahrzeug-Erstimport
++├── 3_import_vehicle_data.py                Manueller Excel-Import (Fahrzeugdaten)
++├── 4_import_km_history.py                  Manueller Excel-Import (KM-Historie)
++├── import_km.py                            KM-Stand-Import (gpsat/tesla/sharepoint)
++├── repair_stale_line_manager_assignments.py  Einmaliges Reparatur-Skript (Altlasten)
++├── docker-compose.yml
++├── .env                                    Secrets für Docker (SECRET_KEY, CORS)
++├── data/                                   fleet.db, fleet_demo.db (nicht in Git)
++├── abrechnungen/                           Export-Ablage (nicht in Git)
++├── backend/
++│   ├── Dockerfile
++│   ├── .env                                Secrets für Cron-Skripte (CONN_STR, SP_*, SMTP_*)
++│   ├── requirements.txt
++│   └── app/
++│       ├── main.py                         FastAPI-Einstiegspunkt, Hintergrund-Jobs
++│       ├── config.py                       Zentrale Konfiguration (ENV-Variablen)
++│       ├── db.py                           Schema, Migrationen, Indizes
++│       ├── auth.py                         JWT/Passwort-Logik
++│       ├── services.py                     Geschäftslogik (Kalkulation, Zuordnung, ...)
++│       └── routers/                        vehicles, drivers, users, dashboard, calc_params, auth
++└── frontend/
++    ├── Dockerfile
++    ├── nginx.conf                          Reverse-Proxy zu /api, SPA-Routing
++    └── src/
++        ├── api/                            zentraler Axios-Client
++        ├── context/                        AuthContext
++        ├── components/                     VehicleFormModal, DriverFormModal, ui/, ...
++        └── pages/                          Dashboard, Fahrzeuge, Fahrer, KM-Dashboard, ...
++}}}
--* Speichern
++== Hauptfunktionen ==
++=== Fahrzeuge verwalten ===
++Fahrzeuge werden initial aus RIMO importiert und danach in der App gepflegt (Rückschreiben nach RIMO ist geplant, aktuell nicht implementiert). Anlegen erfordert MAT-ID, Marke und Modell als Pflichtfelder; Fahrer und Line Manager können direkt zugewiesen werden (Line Manager wird bei Fahrer-Auswahl automatisch ergänzt, ist aber weiterhin manuell überschreibbar). Zuordnungen mit befristetem Zeitraum kehren nach Ablauf automatisch zum vorherigen Fahrer zurück — ohne Enddatum bleibt die Zuordnung bestehen, bis sie aktiv geändert wird. Fahrzeuge können auf inaktiv gesetzt (bleiben sichtbar) oder archiviert werden (wandern in die Archiv-Ansicht, von dort reaktivierbar). Ein gesetztes „Deactivation Date" deaktiviert und archiviert das Fahrzeug automatisch zum entsprechenden Datum. Komponenten: FahrzeugePage, VehicleFormModal, VehicleDrawer.
--**Fahrzeug deaktivieren**
++=== Fahrer verwalten ===
--* in "bearbeiten" kann das Fahrzeug auf inaktiv gesetzt werden und bleibt in der Tabelle
++Fahrer werden täglich um 4:00 Uhr gegen RIMO abgeglichen (Neuanlage bei unbekannter Personalnummer, sonst Aktualisierung von Stammdaten, Kostenstelle und Line Manager). Externe Fahrer können manuell angelegt und bearbeitet werden; Stammdaten interner (per RIMO importierter) Fahrer sind schreibgeschützt. Komponenten: FahrerPage, DriverFormModal.
++=== Kilometer-Daten ===
++Kilometerstände werden automatisiert importiert: GPS-AT täglich um 4:00, Tesla montags um 4:00, 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; sobald die Liste vollständig ist, wird sie automatisch übernommen. Berechnet werden Differenzen, Jahreskilometer und aktuelle Laufleistung, einsehbar im KM-Dashboard — inklusive korrekter Zeitraum-Begrenzung bei unterjährigem Fahrer-/Line-Manager-Wechsel. Komponente: KmDashboardPage.
--**Fahrzeug archivieren**
++=== Kalkulation ===
--* Fahrzeug kann archiviert werden, dann wird es automatisch auf inaktiv gesetzt und  in der „archivierte Fahrzeuge“ Tabelle angezeigt (dort kann es wieder aktiviert werden)
++Pro Fahrzeug wird eine Kostenkalkulation aus Anschaffungskosten, laufenden Kosten (Versicherung, Wartung etc.) sowie Verbrauch und Energiepreisen erstellt. Ergebnis: Kosten pro Monat, Jahr und Kilometer. Beim Anlegen eines Fahrzeugs werden die Default-Parameter aus „Kalkulationsparameter" nach Fahrzeugtyp übernommen; die verbleibenden individuellen Felder werden in „Kalkulation" ergänzt und per „Aktualisieren" neu berechnet. Komponente: KalkulationPage.
------
++=== Handlungsbedarf ===
++Hochrechnungen werden bei jedem KM-Stand-Import neu berechnet. Ein neu bestelltes Fahrzeug wird zunächst über das Häkchen „Bestellt" markiert — erst danach kann es im System angelegt werden. Nach Anlage steht die Funktion „Geliefert" zur Verfügung; sobald ein Fahrzeug als geliefert markiert wird, entfällt es automatisch aus der Handlungsbedarfsliste, der Beschaffungsprozess gilt als abgeschlossen. Neu angelegte sowie aus dem Handlungsbedarf stammende Fahrzeuge erscheinen automatisch im Forecast; Ersatzfahrzeuge enthalten dort eine Referenz auf das ursprüngliche (ersetzte) Fahrzeug. Komponente: HandlungsbedarfPage.
--**2. Fahrer verwalten**
++=== Dashboard ===
--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.
++Zentrale Übersicht: Anzahl Fahrzeuge, Kostenübersicht und relevante Kennzahlen zum aktuellen Fuhrparkstatus. Komponente: DashboardPage.
++=== Benutzerverwaltung (Admin) ===
--**Fahrer anlegen (extern)**
++Admins können Benutzer anlegen, Passwörter ändern sowie Fahrer und Fahrzeuge zuweisen. Änderungen an Line Manager und Kostenstelle werden nachvollziehbar protokolliert (driver_attribute_history), sowohl bei manueller Änderung als auch beim täglichen RIMO-Sync. Komponente: BenutzerPage.
--1. Menü **„Fahrer“** öffnen
--1. Auf **„Fahrer hinzufügen“** klicken
--1. Stammdaten eingeben
--1. Speichern
++=== Kalkulationsparameter ===
++Anpassungen hier wirken sich auf **alle** Fahrzeuge des jeweiligen Typs aus. Dem Controlling vorbehalten (Rollen admin, demo, controlling). Komponente: KalkParamsPage.
++=== Export & Berichte ===
--**Fahrer bearbeiten**
++Monatliche Abrechnungen und Kostenstellen-Umbuchungen werden auf Klick erstellt und als CSV exportiert, zur Weiterverarbeitung in Excel. Gefahrene Kilometer sowie die vollständige Fahrzeugliste (inkl. Kalkulationsaufschlüsselung) können als Excel-Datei heruntergeladen werden.
--* Stammdaten ändern (nur bei extern)
++== Routing ==
------
++|=Seite|=Beschreibung
++|Dashboard|Startseite, zentrale Kennzahlen
++|Fahrzeuge|Fahrzeugverwaltung, Zuordnung, Archiv
++|Fahrer|Fahrerverwaltung
++|KM-Dashboard|Kilometerauswertung, Monatsabrechnung
++|Kalkulation|Kostenkalkulation je Fahrzeug
++|Handlungsbedarf|Ersatzbeschaffung, Forecast
++|Kalkulationsparameter|Typ-Defaults (Controlling)
++|Benutzer|Benutzerverwaltung (Admin)
++|Login|Anmeldung
++== Datenzugriff ==
--**3. Kilometer-Daten**
++Der Zugriff erfolgt über einen zentralen Axios-Client (api/index.js) in Verbindung mit React Query für Caching, Invalidierung und Hintergrund-Aktualisierung. Jede Seite bindet die für sie relevanten REST-Endpunkte des FastAPI-Backends ein (vehiclesApi, driversApi, usersApi, calcParamsApi).
--* Kilometerstände werden automatisch importiert (z. B. GPS / Tesla)
--** gpsat täglich um 4:00
--** tesla montags 4:00
--** beides jeweils Ende des Monats
--** 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.
++== Backend ==
++**Authentifizierung:** JWT (python-jose), OAuth2-Password-Flow, 8-Stunden-Tokens. Rollen: admin, demo, controlling, Benutzer (Line Manager/Fahrer). Sichtbarkeit von Fahrzeugen/Fahrern für normale Nutzer richtet sich nach Line-Manager-Zuordnung.
++**Datenbank:** SQLite im WAL-Modus. Schema und nicht-destruktive Migrationen in db.py. Änderungen an Fahrzeugen, Fahrern, Kalkulationsparametern und Passwörtern werden inklusive verantwortlicher Person nachvollzogen (updated_by); Zuordnungsänderungen (Fahrzeug↔Fahrer, Fahrer↔Line-Manager/Kostenstelle) führen eine vollständige, zeitlich abgegrenzte Historie (vehicle_assignment_history, driver_attribute_history).
--* Das System berechnet:
--** Differenzen
--** Jahreskilometer
--** aktuelle Laufleistung
++**Externe Anbindung:** SQL-Server-Zugriff über pyodbc (CONN_STR) für den täglichen RIMO-Sync sowie Datumsermittlung bei nachträglichen Korrekturen (rimo.sdmtool.last_update). Microsoft-Fabric-Anbindung für KM-Formular-E-Mails und SharePoint-Abgleich.
++== Architektur ==
++{{{flowchart TD
++    A[React Frontend] --> B[React Query / Axios-Client]
++    B --> C[nginx Reverse-Proxy]
++    C --> D[FastAPI Backend]
++    D --> E[(SQLite<br/>fleet.db)]
++    D --> F[JWT Auth]
--Diese Daten sind im **KM-Dashboard** einsehbar.
++    G[Cron-Skripte<br/>Projekt-Root] --> E
++    G --> H[SQL-Server / RIMO<br/>ai.sdmperson, rimo.sdmtool]
++    G --> I[Microsoft Fabric<br/>SharePoint / KM-Mails]
++    G --> J[GPS-AT / Tesla APIs]
++}}}
------
++Die Cron-Skripte laufen **unabhängig** von der FastAPI-App direkt auf dem Server (nicht im Docker-Container), schreiben aber in dieselbe fleet.db wie das Backend.
++== Server ==
--**4. Kalkulation**
++Die App läuft auf 192.168.208.2, per Docker Compose (Services backend + frontend), und liegt unter /mnt/data/fleet-manager/fuhrpark.
--Für jedes Fahrzeug kann eine Kostenkalkulation durchgeführt werden:
++**Deployment bei Codeänderungen** (manuell auf dem Server auszuführen):
--* Anschaffungskosten
--* Laufende Kosten (Versicherung, Wartung etc.)
--* Verbrauch & Energiepreise
++{{{sudo -u www-data git pull
++docker compose up -d --build
++}}}
++**Cronjobs:** sudo -u www-data crontab -e, Logs unter /mnt/data/fleet-manager/fuhrpark/logs. Enthält u. a. den täglichen Fahrer-Sync (1_import_users_drivers.py) und die KM-Stand-Importe (gpsat/tesla/sharepoint über import_km.py).
++Erreichbar unter [[http:~~/~~/fleetmanager.spl-tele.com:8501>>url:http://fleetmanager.spl-tele.com:8501/]] — mit VPN und im SPL-TELE-Netzwerk.
--Ergebnisse:
++== Hinweise ==
--* Kosten pro Monat
--* Kosten pro Jahr
--* Kosten pro Kilometer
--
--
--
--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.
--
------
--
--
--**5. Handlungsbedarf**
--
--Die Hochrechnungen in Handlungsbedarf werden immer neu berechnet mit den Importen der KM Stände.
--
--
--**Neues Fahrzeug bestellen**
--
--* Wenn neues Fahrzeug bestellt wurde, muss im Bereich „Handlungsbedarf“ das Häkchen bei „Bestellt“ gesetzt werden.
--* Erst danach ist es möglich, ein neues Fahrzeug im System anzulegen.
--
--
--
--**Neues Fahrzeug anlegen**
--
--* Ein Fahrzeug kann erst bearbeitet werden, nachdem es angelegt wurde
--* Nach der Anlage steht die Funktion „Geliefert“ zur Verfügung
--
--
--
--**Fahrzeug als geliefert markieren**
--
--* Sobald ein Fahrzeug als „geliefert“ markiert wird:
--** wird es automatisch aus der Handlungsbedarfsliste entfernt
--** gilt der Beschaffungsprozess als abgeschlossen
--
--
--
--**Darstellung im Forecast**
--
--* Neu hinzugefügte Fahrzeuge (Bereich „Fahrzeuge“)
--* sowie im Handlungsbedarf angelegte Fahrzeuge
--
--werden automatisch im Bereich „Forecast“ angezeigt.
--
--Zusätzlich gilt:
--
--* Fahrzeuge aus dem Handlungsbedarf enthalten im Forecast eine
--Referenz zum alten (ersetzten) Fahrzeug
--
--
--
--**Deaktivierung von Fahrzeugen**
--
--Wenn im Feld „Deactivation Date“ ein Datum eingetragen wird:
--
--wird das Fahrzeug ab diesem Datum automatisch:
--
--* deaktiviert
--* in den Bereich „Archivierte Fahrzeuge**“** verschoben
--
------
--
--
--**6. Dashboard**
--
--Das Dashboard zeigt:
--
--* Anzahl Fahrzeuge
--* Kostenübersicht
--* relevante Kennzahlen
--
--Es dient als zentrale Übersicht für den aktuellen Fuhrparkstatus.
--
------
--
--
--**7. Benutzerverwaltung (Admin)**
--
--Admins können:
--
--* Benutzer anlegen
--* Passwörter ändern
--* Fahrer und Fahrzeuge zuweisen
--
------
--
--
--**8. Kalkulationsparameter**
--
--Wenn hier etwas angepasst wird, werden die Werte für alle Fahrzeuge dieses Typs abgeändert.
--
------
--
--
--**9. Export & Berichte**
--
--* Monatliche Abrechnungen werden automatisch erstellt
--* Export erfolgt als CSV-Datei
--* Daten können in Excel weiterverarbeitet werden
--
------
--
--
--**10. Hinweise**
--
--* Änderungen im Demo-Modus werden nicht gespeichert
--* Benutzerrechte bestimmen die Sichtbarkeit der Daten
--* Regelmäßige Datenpflege (z. B. Fahrerzuordnung) ist wichtig für korrekte Auswertungen
--
--
--
--
--**Fehlerbehebung**
--
--* **Frontend:** Streamlit
--* **Backend:** Python
--* **Datenbank:** SQLite
--* **Externe APIs:** Microsoft Fabric Integration
--
--Die App läuft auf 192.168.208.2, in einem Docker und liegt in: /mnt/data/fleet-manager/fuhrpark.
--
--Falls etwas in Github geändert wird muss der git pull manuell auf dem Server passieren:
--
--* sudo chown -R $USER:$USER /mnt/data/fleet-manager/fuhrpark
--* git pull
--* sudo chown -R www-data:www-data /mnt/data/fleet-manager/fuhrpark
--* docker compose up -d ~-~-build
--
--Es gibt cronjobs in crontab -e, mit logs in /mnt/data/fleet-manager/fuhrpark/logs.
--
------
--
--== Verwandte Themen ==
--
--//Kuratiert — kann direkt im Editor ergänzt werden://
--
--* [[ABK (Ausschreibungssoftware)>>doc:IT-Wiki.02-Tools.ABK.WebHome]]
--* [[UiPath>>doc:IT-Wiki.02-Tools.UiPath.WebHome]]
--* [[Microsoft Intune>>doc:IT-Wiki.02-Tools.Intune.WebHome]]
--
--{{include reference="IT-Wiki.Makros.Verwandte-Themen.WebHome"/}}
--
------
--**Status:** Migriert — Team-Review ausstehend · **Owner:** //(festlegen)// · **Letzter Review:** 2026-06-11
--
++* Änderungen im Demo-Modus werden nicht gespeichert.
++* Benutzerrechte bestimmen die Sichtbarkeit der Daten (Line-Manager-Zuordnung).
++* Regelmäßige Datenpflege (z. B. Fahrerzuordnung) ist wichtig für korrekte Auswertungen.
++* backend/data/ bzw. data/ (Projekt-Root) enthält die produktive Datenbank und ist **nicht** Teil des Git-Repos — ein git pull verändert die Datenbank nie.

1776413498048-751.png

Author

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

Size

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

Content

Changes for page Fuhrpark (Fleet Manager)

Summary

Details

Applications

Navigation

Verwandte Themen

Recently Created

Recently Modified

Changes for page Fuhrpark (Fleet Manager)

Summary

Details

Applications

Tag Cloud

Verwandte Themen

Recently Created

Recently Modified