Fuhrpark & Fahrtenbuch
fleet
core_platform
🛡️ RLS Protected
Fuhrpark & Fahrtenbuch — aus Code abgeleitete Prozess- und API-Dokumentation.
⚡ Рабочие процессы и жизненные циклы
Benutzerbefehl: fleet agent
plan:command_fleet_agent
Проверенный план длительности (durable_plan), старт: manual_command.
⚙️ Fachprozesse & Capabilities (System-Fachlogik)
Registrierte Fachoperationen und System-Capabilities dieses Moduls zur Steuerung von Workflows, Kaskaden und KI-Agenten.
| Capability & Schlüssel | Fachliche Bezeichnung | Ausführung / Coverage | Risikostufe & Freigabe | Effekte & Kaskaden |
|---|---|---|---|---|
Agent-Einstieg fleet_agent
agent_entry:fleet_agent
|
Agent-Einstieg fleet_agent
Quelle:
code:module_agent_map
|
manual_entry |
✓ Auto
|
Keine Seiteneffekte deklariert |
Kosten auf Projekt
capability:fleet.cost.allocate_project
Op:
fleet.cost.allocate_project
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fahrzeugkosten buchen
capability:fleet.cost.book
Op:
fleet.cost.book
|
Intent:
confirm_fleet_trip
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: assign driver
capability:fleet.fleet.assign_driver
Op:
fleet.fleet.assign_driver
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: confirm trip
capability:fleet.fleet.confirm_trip
Op:
fleet.fleet.confirm_trip
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: create cost
capability:fleet.fleet.create_cost
Op:
fleet.fleet.create_cost
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: create trip
capability:fleet.fleet.create_trip
Op:
fleet.fleet.create_trip
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: create vehicle
capability:fleet.fleet.create_vehicle
Op:
fleet.fleet.create_vehicle
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: update trip
capability:fleet.fleet.update_trip
Op:
fleet.fleet.update_trip
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fleet: update vehicle
capability:fleet.fleet.update_vehicle
Op:
fleet.fleet.update_vehicle
|
Objekt:
fleet
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Versicherung verlängern
capability:fleet.insurance.renew
Op:
fleet.insurance.renew
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fahrt bestätigen
capability:fleet.trip.confirm
Op:
fleet.trip.confirm
|
Intent:
confirm_fleet_trip
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fahrt erfassen
capability:fleet.trip.create
Op:
fleet.trip.create
|
Intent:
confirm_fleet_trip
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Telematik importieren
capability:fleet.trip.import_telematics
Op:
fleet.trip.import_telematics
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fahrer zuweisen
capability:fleet.vehicle.assign_driver
Op:
fleet.vehicle.assign_driver
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fuhrparkfahrzeug anlegen
capability:fleet.vehicle.create
Op:
fleet.vehicle.create
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Tankbuchung
capability:fleet.vehicle.record_fuel
Op:
fleet.vehicle.record_fuel
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Werkstatttermin
capability:fleet.vehicle.schedule_service
Op:
fleet.vehicle.schedule_service
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Fahrzeug umschreiben
capability:fleet.vehicle.transfer
Op:
fleet.vehicle.transfer
|
Objekt:
fleet_vehicle
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
fleet_vehicle: edit form
form_surface_anchor:fleet_vehicle.edit
|
Objekt:
fleet_vehicle
Quelle:
code:erp_form_surface
|
operator_surface |
✓ Auto
|
Keine Seiteneffekte deklariert |
Fahrtenbuch: Fahrt bestätigen
gateway:fleet_logbook
Op:
fleet.trip.confirm
|
Fahrtenbuch: Fahrt bestätigen
Quelle:
code:reviewed_gateway
|
⚙️ Engine |
✓ Auto
|
Keine Seiteneffekte deklariert |
Benutzerbefehl: fleet agent
plan:command_fleet_agent
|
Benutzerbefehl: fleet agent
Quelle:
code:reviewed_execution_plan
|
durable_plan |
✓ Auto
|
Keine Seiteneffekte deklariert |
🧠 Fachprozess-Erzählung & Dual Knowledge Architektur
Synthese aus der ideologischen Blaupause (Meta-Fachlogik / Soll), der faktischen System-Implementierung (System-Fachlogik / Ist) und No-Code Customizing für KI-Consultants.
Der durchgängige Businessprozess im Detail (End-to-End Fließtext-Erzählung)
Der durchgängige Logistik-, Versand- und Fuhrparkprozess in der betrieblichen Praxis
Die pünktliche und unbeschädigte Zustellung von Waren beim Kunden sowie der sichere und rechtlich einwandfreie Betrieb der Firmenfahrzeuge bilden das logistische Rückgrat jedes Handels- und Fertigungsunternehmens.
1. Warenausgang & Versandbereitstellung (Dispatch Staging)
Sobald das Lager (inventory) die Kommissionierung für einen Verkaufsauftrag (sales) abschließt, übernimmt das Logistikmodul:
- Packstückbildung: Die gepickten Artikel werden in Versandkartons oder auf Europaletten konsolidiert. Das System ermittelt Brutto-, Netto- und Volumengewicht.
- NVE / SSCC-Etikettierung: Jedes Packstück erhält eine weltweit eindeutige Nummer der Versandeinheit (NVE / Serial Shipping Container Code - SSCC) als GS1-128-Barcode.
- Frachtführer-Auswahl & Ratenvergleich: Anhand von Gewicht, Destination (Inland, EU, Drittland) und gewünschter Laufzeit (Standard vs. Express) vergleicht das System hinterlegte Tarife oder ruft Live-Raten über Speditions-APIs ab (DHL, UPS, DPD, Dachser, DB Schenker, Kühne+Nagel).
- Labeldruck: Über die integrierte Druckserver-Bridge (
printbridge) wird das offizielle Versandetikett mit Routing-Barcode auf dem Thermotransferdrucker am Packtisch ausgegeben.
2. Ladelisten & Speditionsübergabe (Manifest & Handover)
- Bei Paletten- und Speditionssendungen fasst das System Packstücke zu einer Ladeliste / einem Frachtbrief (CMR-Frachtbrief) zusammen (
cap:logistics.shipment.generate_manifest). - Bei Abholung durch den Speditionsfahrer quittiert dieser die Anzahl der übernommenen Packstücke auf dem Handheld oder Lieferschein.
- Warenausgangs-Gateway: Der Gateway setzt den Sendungsstatus auf Im Transit (
in_transit) und übermittelt die Sendungsverfolgungsnummer (Tracking-ID) per E-Mail an den Kunden.
3. Eigener Fuhrpark & Tourenplanung (Fleet & Routing)
Verfügt das Unternehmen über eigene Liefer- oder Montagefahrzeuge:
- Fahrzeugstamm (
fleet): Verwaltung von PKWs, Transportern, LKWs und Anhängern mit Kennzeichen, Nutzlast, Ladevolumen und Wartungsintervallen. - Tourenoptimierung: Aufträge eines Liefergebiets werden wege- und zeitoptimiert zu einer Ausliefertour zusammengefasst. Das System berücksichtigt Zeitfenster, LKW-Mautstrecken und Lenk- und Ruhezeiten.
- Rollende Fahrzeuglager: Kundendienstfahrzeuge führen einen eigenen mobilen Ersatzteilbestand, der vor Abfahrt aufgefüllt wird.
4. Halterhaftung & Führerscheinkontrolle (§ 21 StVG)
Als Fahrzeughalter haftet die Geschäftsführung strafrechtlich, wenn Mitarbeitern ohne gültige Fahrerlaubnis ein Firmenwagen überlassen wird:
- Regelmäßige Pflichtprüfung: Das System erzwingt alle 6 Monate (oder anlassbezogen) die Führerscheinprüfung aller Dienstwagenberechtigten (
cap:fleet.vehicle.verify_license). - Audit-Nachweis: Die Prüfung erfolgt per Sichtprüfung mit Scan oder über manipulationssichere RFID-Führersiegelsysteme. Das Prüfergebnis wird unveränderbar im Audit-Trail protokolliert.
5. Digitales Fahrtenbuch & Finanzamtskonformität
- Zur Versteuerung des geldwerten Vorteils (Alternative zur 1%-Regelung) führt das Modul ein digitales, finanzamtskonformes Fahrtenbuch.
- Fahrten werden mit Startort, Zielort, Kilometerstand, Fahrtzweck (Dienstfahrt, Arbeitsweg, Privatfahrt) und besuchtem Kunden erfasst.
- Nachträgliche Manipulationen an Zeitstempeln oder Routendaten sind softwareseitig ausgeschlossen.
6. UVV-Sicherheitsprüfung nach DGUV Vorschrift 70
- Gewerblich genutzte Fahrzeuge unterliegen der jährlichen Prüfung auf Betriebssicherheit nach DGUV Vorschrift 70 (UVV Fahrzeuge):
- Überprüfung von Bremsen, Reifen, Gurten, Ladungssicherungsmitteln (Spanngurte, Antirutschmatten), Warnwesten und Verbandkasten.
- Das System terminiert die UVV-Prüfung und sperrt das Fahrzeug bei Fristüberziehung für Neuvergaben im Kalender (
cap:fleet.vehicle.schedule_uvv).
Meta-Fachlogik: Ideologische Blaupause, Soll-Weltbild & Normen
Meta-Fachlogik: Die ideologische Blaupause & das normative Weltbild
Die Meta-Fachlogik stützt sich auf das Transport- und Speditionsrecht (HGB §§ 407 ff., ADSp 2017), das Straßenverkehrsgesetz (§ 21 StVG), die Berufsgenossenschaftlichen Vorschriften (DGUV V70) und Steuerrichtlinien zum Fahrtenbuch.
1. Frachtrecht & Haftung (HGB §§ 407 ff., CMR, ADSp 2017)
- Frachtvertrag & Haftungskorridor: Gesetzliche Haftungsbegrenzung des Frachtführers nach HGB § 431 (8,33 SZR pro kg) bzw. CMR im internationalen Straßengüterverkehr.
- Sorgfaltspflicht der Ladungssicherung (§ 22 StVO / VDI 2700): Der Absender ist für die verkehrssichere Verladung und Ladungssicherung verantwortlich. Das Soll-Modell verlangt Dokumentation geeigneter Sicherungsmittel vor Abfahrt.
2. Gesetzliche Halterhaftung (§ 21 Abs. 1 Nr. 2 StVG)
- Wer als Fahrzeughalter anordnet oder zulässt, dass jemand ein Fahrzeug führt, der die erforderliche Fahrerlaubnis nicht besitzt, macht sich strafbar (Freiheitsstrafe bis zu einem Jahr oder Geldstrafe).
- Das Soll-Modell verbietet die Zuweisung von Dienstwagen an Mitarbeiter mit ungeprüftem oder abgelaufenem Führerschein.
3. Invarianten des Soll-Modells
- Kein Warenausgang ohne lückenlose Packstück- und Gewichtsdokumentation.
- Keine Fahrzeugausgabe ohne verifizierten Führerscheinprüfungsnachweis.
- Ein finanzamtskonformes Fahrtenbuch darf keine rückwirkenden, unprotokollierten Änderungen zulassen.
- Fahrzeuge mit überzogener UVV-Prüfung oder abgelaufenem TÜV sind für den Fahrdienst zu sperren.
Systemische Fachlogik: Faktische Umsetzung in Centurio ERP & Capabilities
Systemische Fachlogik: Die faktische Umsetzung in Centurio ERP
Die System-Fachlogik dokumentiert die Realisierung in den Modulen logistics und fleet.
1. Datenmodelle & Semantische Schicht (ORM)
LogisticsShipment: Sendungskopf (Felder:id,tenant_id,shipment_number,carrier_code,tracking_number,service_level,total_weight_kg,package_count,shipping_label_url,status).ShipmentPackage: Einzelne Packstücke (Felder:shipment_id,sscc_nve,weight_kg,dimensions_cm).FleetVehicle: Fahrzeugstamm (Felder:id,license_plate,vin_chassis,vehicle_type,assigned_driver_id,odometer_km,next_inspection_date,next_uvv_date,status[active, maintenance, locked]).FleetTrip: Fahrtenbucheintrag (Felder:vehicle_id,driver_id,start_time,end_time,start_km,end_km,trip_type[business, commute, private],purpose,customer_id).DriverLicenseCheck: Revisionssicherer Nachweis der Führerscheinkontrolle.
2. Das Capability-Register
cap:logistics.shipment.create: Erzeugung einer Sendung und Ratenabfrage.cap:logistics.shipment.generate_label: Druck des Frachtführer-Versandlabels via PrintBridge.cap:logistics.shipment.generate_manifest: Ladelistenerstellung und Speditionsavis.cap:logistics.shipment.track: Statusabfrage der Tracking-Events beim Carrier.cap:fleet.vehicle.verify_license: Erfassung der gesetzlichen Führerscheinprüfung.cap:fleet.vehicle.log_trip: Verbuchung eines Fahrtenbucheintrags.cap:fleet.vehicle.schedule_uvv: Planung der jährlichen Sicherheitsprüfung nach DGUV 70.
3. Der Gateway gw:shipment_dispatch@v1
Sichert den Warenausgang ab:
- Validierung: Prüft Gewicht, Versandadresse und Gefahrgutdeklaration.
- Statuswechsel:
LogisticsShipment.status = 'dispatched'. - Outbox-Signal: Feuert
SHIPMENT_DISPATCHEDund triggert die Kundenbenachrichtigung mit Tracking-Link.
4. Statusmodelle
- Sendung:
draft➔labeled➔manifested➔in_transit➔deliveredoderexception. - Fahrzeug:
available➔in_use➔maintenance_due➔locked(z.B. wegen fehlender UVV).
KI-Consultant Leitfaden: Customizing- & No-Code-Konzept (Soll-Ist-Synthese)
KI-Consultant Blueprint: Customizing & No-Code Architektur
Anleitung für Solution Architects zur Einrichtung von Logistik- und Fuhrparkprozessen.
1. Kundenanforderungsanalyse
- Welche Frachtführer und Speditionen müssen angebunden werden?
- Sollen Versandkosten dem Kunden nach Staffel oder mit Festpauschalen in Rechnung gestellt werden?
- Gibt es Gefahrguttransporte (ADR-Auflagen mit Tunnelbeschränkungen)?
2. No-Code Zusatzfelder (Custom Fields)
Im No-Code Studio (/semantic/customizing):
- Auf
LogisticsShipment:customs_declaration_mrn(Text): Movement Reference Number bei Ausfuhr in Drittländer (ATLAS).liftgate_required(Checkbox): Hebebühnenzustellung erforderlich.
- Auf
FleetVehicle:fuel_card_number(Text): Flottentankkartennummer für Tankbelegabgleich.toll_onboard_unit_id(Text): OBU-Gerätenummer für automatische LKW-Maut.
3. No-Code Workflow Canvas DAGs
Blueprint A: Automatisches Tracking & Proaktiver Lieferverzugs-Alert
- Trigger-Node: Webhook des Paketdienstes (z.B. DHL Event
shipment.delayed). - Condition-Node:
event.delay_days >= 2. - Action-Node: Sende automatische SMS/E-Mail an Kunden: "Ihre Sendung verzögert sich um 2 Tage; Tracking-Link hier."
Blueprint B: Automatische Sperre bei überfälliger Führerscheinkontrolle
- Trigger-Node: Täglicher Scan der Führerscheingültigkeit.
- Condition-Node:
driver.last_license_check_date < current_date - 180_days. - Action-Node: Sperre Fahrzeugzuweisung für diesen Fahrer und sende Eskalations-Mail an Fuhrparkleiter.
📚 Operative Prozessbegriffe & Transaktionsschnittstellen
- Versandbereite Packstücke aus dem Warenausgang des Lagers
- Speditionsaufträge aus Streckengeschäften (Dropshipping)
- Fahrzeugdaten und Fahrtenbucheingaben der Fahrer
- Prüffristen für Führerscheine und Hauptuntersuchungen
- Frachtführer-Versandlabels mit Barcodes (DHL, UPS, Dachser)
- Speditions-Ladelisten und CMR-Frachtbriefe
- Audit-Nachweise über durchgeführte Führerscheinkontrollen (§ 21 StVG)
- Finanzamtskonforme Fahrtenbuchberichte (PDF/Excel)
- Tracking-Links und Lieferzeit-Avis an Kunden
- shipment_dispatched -> update_sales_order_status: Auftrag wird als versendet markiert
- tracking_delivered -> trigger_customer_review: Einladung zur Kundenzufriedenheitsbewertung
- license_check_failed -> lock_vehicle_assignment: Fahrersperre im Fuhrpark
- uvv_expired -> set_vehicle_status_maintenance: Fahrzeugsperre bis zur Werkstattprüfung
- Schadensabwicklung bei Transportschäden mit Speditionsregress
- Zollabfertigung und Ausfuhranmeldung über ATLAS bei Drittlandsendungen
- Kraftstoff- und Tankkartenabrechnung mit Plausibilitätsprüfung (Verbrauch l/100km)
- Bußgeldbearbeitung und Zeugenfragebogenverwaltung im Fuhrpark
- Speditions- und Paketdienst-Zugangsdaten (API-Keys) im System hinterlegen
- Zyklen für Führerscheinprüfung (Standard: 6 Monate) in Fuhrparkrichtlinien definieren
- Frachtkostenstaffeln nach Gewicht und Postleitzahlenzonen pflegen
- No-Code Zusatzfelder für Maut-OBU und Gefahrgut auf LogisticsShipment anlegen
🗄️ Модели данных & поля
🔌 Входные пункты (UI & API)
| Art | Метод | Конечный пункт / путь | Titel & Zweck | Право на |
|---|---|---|---|---|
| ⚡ REST API | GET | /api/v1/fleet/costs |
list_costs
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/summary |
fleet_summary
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/trips |
list_trips
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/trips/{trip_id} |
get_trip
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/vehicles |
list_vehicles
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/vehicles/{vehicle_id} |
get_vehicle
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/vehicles/{vehicle_id}/costs |
vehicle_costs
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /api/v1/fleet/vehicles/{vehicle_id}/trips |
vehicle_trips
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /fahrtenbuch |
logbook_page
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /fuhrpark |
fleet_page
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | GET | /fuhrpark/{vehicle_id} |
vehicle_detail_page
Semantic binding: inventory_only; mutation=False
|
fleet
|
| ⚡ REST API | PATCH | /api/v1/fleet/trips/{trip_id} |
update_trip
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | PATCH | /api/v1/fleet/vehicles/{vehicle_id} |
update_vehicle
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /api/v1/fleet/costs |
create_cost
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /api/v1/fleet/trips |
create_trip
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /api/v1/fleet/trips/{trip_id}/confirm |
confirm_trip
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /api/v1/fleet/vehicles |
create_vehicle
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /api/v1/fleet/vehicles/{vehicle_id}/assign |
assign_driver
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /fahrtenbuch |
create_trip_form
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /fahrtenbuch/{trip_id}/bestaetigen |
confirm_trip_form
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /fuhrpark/fahrzeuge |
create_vehicle_form
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /fuhrpark/fahrzeuge/{vehicle_id}/status |
vehicle_status_form
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /fuhrpark/fahrzeuge/{vehicle_id}/zuordnen |
assign_driver_form
Semantic binding: operator_surface; mutation=True
|
fleet
|
| ⚡ REST API | POST | /fuhrpark/{vehicle_id}/kosten |
create_cost_form
Semantic binding: operator_surface; mutation=True
|
fleet
|
🛡️ Регуляторство и соответствие
Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:
- Проверяемость
- Изоляция клиентов (PostgreSQL RLS)