📘

Fuhrpark & Fahrtenbuch

fleet core_platform 🛡️ RLS Protected

Fuhrpark & Fahrtenbuch — aus Code abgeleitete Prozess- und API-Dokumentation.

Fachliche Bestimmung: Fuhrpark & Fahrtenbuch — aus Code abgeleitete Prozess- und API-Dokumentation. Erfasst alle registrierten Prozesse, Capabilities, Zustandsmaschinen, APIs und Tabellen für Simulationen und Reviews.

⚡ Fluxos de trabalho e ciclos de vida (1) 🗄️ Modelos de dados (3) 🔌 Pontos de partida (UI e APIs) (24) 🛡️ Regulação e conformidade

⚡ Fluxos de trabalho e ciclos de vida

Benutzerbefehl: fleet agent `plan:command_fleet_agent`

O plano durável verificado (durable_plan), iniciação: manual_command.

1. fleet_agent

fleet_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "fleet_agent", "condition_fact": null}

Aktionen: fleet_agent

🗄️ Modelos de dados

FleetCosts fleet_costs RLS Aktiv

16 Fontes de cálculo

Tabelle fleet_costs

Feldname	Tipo de dados	Oficácia	Schlüssel	Importância profissional
`vehicle_id`	`UUID`	Ja *	FK ➔ fleet_vehicles.id	Feld vehicle_id
`cost_type`	`VARCHAR(24)`	Ja *	-	Feld cost_type
`amount`	`NUMERIC(14, 2)`	Ja *	-	Feld amount
`occurred_on`	`DATE`	Ja *	-	Feld occurred_on
`document_id`	`UUID`	Nein	FK ➔ documents.id	Feld document_id
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`notes`	`TEXT`	Nein	-	Feld notes
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

FleetTrips fleet_trips RLS Aktiv

27 Fontes de cálculo

Tabelle fleet_trips

Feldname	Tipo de dados	Oficácia	Schlüssel	Importância profissional
`vehicle_id`	`UUID`	Ja *	FK ➔ fleet_vehicles.id	Feld vehicle_id
`driver_user_id`	`UUID`	Nein	FK ➔ organization_users.id	Feld driver_user_id
`started_at`	`DATETIME`	Ja *	-	Feld started_at
`ended_at`	`DATETIME`	Nein	-	Feld ended_at
`odometer_start`	`INTEGER`	Nein	-	Feld odometer_start
`odometer_end`	`INTEGER`	Nein	-	Feld odometer_end
`distance_km`	`NUMERIC(8, 1)`	Nein	-	Feld distance_km
`origin_label`	`VARCHAR(255)`	Nein	-	Feld origin_label
`destination_label`	`VARCHAR(255)`	Nein	-	Feld destination_label
`purpose`	`VARCHAR(16)`	Ja *	-	Feld purpose
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`source`	`VARCHAR(16)`	Ja *	-	Feld source
`confirmed`	`BOOLEAN`	Ja *	-	Feld confirmed
`confirmed_at`	`DATETIME`	Nein	-	Feld confirmed_at
`confirmed_by`	`UUID`	Nein	-	Feld confirmed_by
`notes`	`TEXT`	Nein	-	Feld notes
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

FleetVehicles fleet_vehicles RLS Aktiv

22 Fontes de cálculo

Tabelle fleet_vehicles

Feldname	Tipo de dados	Oficácia	Schlüssel	Importância profissional
`license_plate`	`VARCHAR(32)`	Ja *	-	Feld license_plate
`label`	`VARCHAR(255)`	Ja *	-	Feld label
`make`	`VARCHAR(64)`	Nein	-	Feld make
`model`	`VARCHAR(64)`	Nein	-	Feld model
`fuel_type`	`VARCHAR(32)`	Nein	-	Feld fuel_type
`is_company`	`BOOLEAN`	Ja *	-	Feld is_company
`tax_method`	`VARCHAR(16)`	Ja *	-	Feld tax_method
`status`	`VARCHAR(16)`	Ja *	-	Feld status
`assigned_user_id`	`UUID`	Nein	FK ➔ organization_users.id	Feld assigned_user_id
`acquisition_date`	`DATE`	Nein	-	Feld acquisition_date
`tuv_until`	`DATE`	Nein	-	Feld tuv_until
`current_mileage`	`INTEGER`	Ja *	-	Feld current_mileage
`notes`	`TEXT`	Nein	-	Feld notes
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

🔌 Pontos de partida (UI e APIs)

Art	Método	Ponto final / caminho	Titel & Zweck	Recurso
⚡ 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`

🛡️ Regulação e conformidade

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards: