docs: Fehler korrigiert - Betriebsstunden fälschlich fahrzeug-only geplant
CI / backend-tests (push) Failing after 1m54s
CI / frontend-build (push) Successful in 17s

Nutzer-Fund: FLEET-003 (Kilometerstand/Betriebsstunden) war fälschlich als
fahrzeug-gebundenes Datenmodell geplant, obwohl die Ursprungs-Anforderung
explizit auch Stromerzeuger/Pumpen mit betriebsstundenabhängiger Wartung
nennt (Modul 14). Neue generische Kachel ASSET-009 (Nutzungszähler)
eingeführt, FLEET-003 zur bloßen Fahrzeug-Anwendung davon reduziert.

MABEA-Abgleich korrigiert: echte Lücke ist jetzt doppelt - kein generischer
Zähler für Nicht-Fahrzeug-Geräte UND keine Rückwärtslauf-Validierung am
bestehenden Fahrzeug-Kilometerstand.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KC8HYvv6UkCVYheYiTw9DD
This commit is contained in:
2026-09-05 15:23:41 +02:00
co-authored by Claude Sonnet 5
parent c7784f0106
commit b7c7276b20
3 changed files with 71 additions and 27 deletions
+29 -23
View File
@@ -46,28 +46,30 @@ Details zu FLEET-001 … FLEET-006 (vollständig).
- **DoD:** deckt sich mit MABEA `fahrzeugdetails` (bereits umgesetzt, diente hier als
Vorbild).
## FLEET-003 — Kilometerstand/Betriebsstunden
## FLEET-003 — Kilometerstand (Fahrzeug-Anwendung von ASSET-009)
- **Ziel:** Nutzungsgrad des Fahrzeugs erfassen (Basis für km-/std-abhängige
Wartungsintervalle, MAINT-002).
- **Beschreibung:** Felder + Erfassungsverlauf (nicht nur aktueller Wert, sondern Verlauf
der Meldungen).
- **Benutzerwert:** Grundlage für Wartungsplanung.
- **Abhängigkeiten:** FLEET-002
- **Datenmodell:** `fahrzeugdetails.kilometerstand`/`betriebsstunden` (aktuell) +
optional `km_stand_historie`
- **Backend:** Update-Endpoint mit Plausibilitätsprüfung
- **Frontend:** Eingabefeld bei Kontrolle/Rückkehr
- **Korrektur (Nutzer-Fund):** ursprünglich hier fälschlich als fahrzeug-eigenes
Datenmodell geplant. Betriebsstunden brauchen auch Nicht-Fahrzeuge (Stromerzeuger,
Pumpen) — der generische Zähler-Mechanismus ist jetzt **ASSET-009**. Diese Kachel ist
nur noch die Fahrzeug-spezifische Anwendung davon (Zählertyp=kilometer, UI-Einbindung in
die Fahrzeug-Akte).
- **Ziel:** Kilometerstand des Fahrzeugs im Kontroll-/Rückkehr-Ablauf erfassbar machen.
- **Beschreibung:** Fahrzeug nutzt ASSET-009 mit `zaehler_typ=kilometer`, kein eigenes
Feld/Endpoint mehr nötig.
- **Benutzerwert:** Grundlage für kilometerabhängige Wartungsplanung (MAINT-002).
- **Abhängigkeiten:** FLEET-002, **ASSET-009**
- **Datenmodell:** keins zusätzlich (nutzt ASSET-009)
- **Backend:** keins zusätzlich
- **Frontend:** Eingabefeld bei Kontrolle/Rückkehr, eingebettet in Fahrzeug-Akte
- **Mobile:** Eingabe im Feld (nach Fahrt)
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Stammdatenbereich
- **Rechte:** jeder Fahrzeugnutzer darf melden (breiter als reine Materialwart-Rechte),
Korrektur nur Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** Wert kann nur steigen (Validierung gegen Rückwärtslauf, außer
Admin-Korrektur-Override).
- **Tests:** Validierungstest (Rückwärtslauf abgelehnt, Override funktioniert).
- **DoD:** funktioniert, Validierung greift nachweisbar.
- **Rechte:** wie ASSET-009
- **Audit:** wie ASSET-009
- **Akzeptanzkriterien:** Kilometerstand-Eingabe am Fahrzeug nutzt denselben validierten
Mechanismus wie ein Betriebsstunden-Gerät.
- **Tests:** Integrationstest (Fahrzeug als Anwendungsfall von ASSET-009).
- **DoD:** funktioniert, keine Fahrzeug-spezifische Sonderlogik mehr nötig.
## FLEET-004 — Fahrzeugstatus (5-stufig)
@@ -128,9 +130,13 @@ Details zu FLEET-001 … FLEET-006 (vollständig).
---
**MABEA-Ist-Stand-Abgleich:** FLEET-001005 sind praktisch 1:1 in MABEA vorhanden
**MABEA-Ist-Stand-Abgleich:** FLEET-001/002/004/005 sind praktisch 1:1 in MABEA vorhanden
(Objekttyp mit `ist_zugfahrzeug`, `fahrzeugdetails`-Tabelle, 5-stufiger `ObjektStatus`,
generisches DokumentePanel). Einzige offene Lücke: FLEET-003s Plausibilitätsprüfung
(„Kilometerstand darf nicht sinken") ist in MABEA **nicht** validiert — reiner
Zahlen-Input ohne Rückwärtslauf-Schutz. Kleine, konkrete Nachbesserung, keine neue Kachel
nötig. FLEET-006 ist in MABEA (noch) nicht relevant, da kein Operations-Epic existiert.
generisches DokumentePanel). **FLEET-003/ASSET-009 zeigen eine echte Lücke:** MABEA führt
Kilometerstand/Betriebsstunden NUR an `fahrzeugdetails` (fahrzeug-gebunden), es gibt keinen
generischen Zähler-Mechanismus für Geräte wie Stromerzeuger/Pumpen (`GeraetInstanz` hat kein
Betriebsstunden-Feld) — und selbst der Fahrzeug-Kilometerstand hat **keine
Rückwärtslauf-Validierung** (reiner Zahlen-Input). Beides zusammen: ASSET-009 wäre in MABEA
kein reiner Nachzug, sondern verlangt (a) ein neues generisches Zählerfeld an Objekt/
GeraetInstanz und (b) eine bisher fehlende Validierungsregel. FLEET-006 ist in MABEA (noch)
nicht relevant, da kein Operations-Epic existiert.