VDV454 Fahrten-Analyse — Technische Dokumentation

Abhängigkeiten

Alle Projekte referenzieren VBK_VDV454_ImportCore. Die UI nutzt zusätzlich DevExpress 24.1.14 (Wpf.Grid, Mvvm, Themes).

Das Hauptfenster verwendet einen DockLayoutManager mit folgender Aufteilung:

Abb. 1: Fahrten-Ansicht — Steuerung-Panel (links), Fahrten-Master-Grid (oben), Fahrt-Detail-Grid (unten)

Quelle: MainWindow.xaml

Tab „Betriebstage“

Datenquelle: ImportedBetriebstage (List<ImportInfoModel>), geladen via IImportService.FindImportedBetriebstage(rootFolder).

Selektion eines Betriebstages triggert GetFahrtenAsync() im ViewModel.

Tab „Import“

Manueller Import-Workflow:

1. Import-Ordner wählen (ButtonEdit mit FolderBrowserDialog)
2. „Import vorbereiten“ → PrepareImportCommand → IImportService.InitImport()
   Erkennt Betriebstage aus XML/LOG-Dateien, füllt Combobox
3. Betriebstag auswählen
4. „Import ausführen“ → ExecuteImportCommand → IImportService.ExecuteImport()
   Schreibt JSON-Dateien in Data/{YYYY}/{MM}/{DD}/

Tab „Einstellungen“

Zeigt alle Fahrten eines ausgewählten Betriebstages. Selektion einer Zeile lädt das Fahrt-Detail-Grid.

Die fokussierte Zeile wird fett und mit grauem Hintergrund (#eeeeee) hervorgehoben (FocusedRowStyle).

Modell: FahrtModel (VBK_VDV454_Import_UI/Models/FahrtModel.cs)

Zeigt die zeitliche Entwicklung einer einzelnen Fahrt. Zeilen = VDV454-Datenabrufe (zeitlich aufsteigend), Spalten = Haltestellen (in Reihenfolge der Fahrt).

Feste Spalten (links, fixiert)

Dynamische Haltestellen-Spalten

Für jede Haltestelle der Fahrt wird dynamisch eine Spalte erzeugt. Die Spalten verwenden DefaultColumnTemplate und zeigen in jeder Zelle ein HstCell-Objekt.

Aufbau einer Haltestellen-Zelle (HstCell)

Template-Logik: MainWindow.xaml (Zeilen 169–300) | Datenaufbau: FahrtModel.FromOutputFahrtModel()

Der Tab „Fahrt-Detail“ erscheint nur, wenn eine Fahrt mehrere Telegramm-Nummern (Komplettfahrten) besitzt (HasMultipleFahrten = true). Er zeigt jede Telegramm-Nummer als separates Grid untereinander.

Abb. 2: Fahrt-Detail Tab — Mehrere Telegramm-Blöcke mit Checkbox-Steuerung (oben) und Detail-Grids (unten)

Sichtbarkeitssteuerung

Das Panel ist an HasMultipleFahrten gebunden:

Visibility="{Binding HasMultipleFahrten, Converter={BooleanToVisibilityConverter}}"

HasMultipleFahrten wird im ViewModel auf true gesetzt, wenn für den gewählten FahrtBezeichner mehr als eine Fahrt (Telegramm) existiert.

Layout-Aufbau

┌────────────────────────────────────────────────────────────┐
│ [☑] 1  [☑] 2  [ ] 3  [ ] 4  [☑] 5    S11 * de:kvv:00S11 * 56010-5048 │
│                                          (LinienText * LinienID * Bezeichner)  │
├────────────────────────────────────────────────────────────┤
│ GroupBox "1"                                                             │
│   GridControl (HstColumnTemplateSelector, MaxHeight=600)                │
│   → ColumnsSource: FahrtenItem.Fahrten[0].HstColumns                   │
│   → ItemsSource:   FahrtenItem.Fahrten[0].FahrtAbrufenItems             │
├────────────────────────────────────────────────────────────┤
│ GroupBox "2"                                                             │
│   GridControl (gleicher Aufbau)                                          │
├────────────────────────────────────────────────────────────┤
│ GroupBox "5" (3, 4 ausgeblendet via IsVisible)                           │
│   GridControl (gleicher Aufbau)                                          │
└────────────────────────────────────────────────────────────┘

Komponenten-Struktur

Datenfluss

Beim Klick auf eine Fahrt im Fahrten-Grid:

1. GetSelectedFahrtAllesAsync() lädt alle Fahrten mit gleichem FahrtBezeichner
2. Sortierung nach FahrtNr aufsteigend
3. Jede Fahrt wird als FahrtModel in FahrtenItem.Fahrten gespeichert
4. Erste Fahrt erhält IsVisible = true, restliche ebenfalls (alle Checkboxen initial aktiviert)
5. HasMultipleFahrten wird true wenn Fahrten.Count > 1 → Tab wird sichtbar
6. SingleFahrt wird auf die Fahrt mit der selektierten FahrtNr gesetzt (für das Detail-Grid im Fahrten-Tab)

Quelle: MainWindow.xaml (Zeilen 870–960) | ViewModel: MainWindowViewModel.GetSelectedFahrtAllesAsync()

Zeigt Fahrten aufgeschlüsselt nach Fahrzeugen in der Zugformation. Die Ansicht hat zwei umschaltbare Detail-Modi: Belegungsgrad und Barrierefreiheit.

Abb. 3: Formation-Ansicht — Modus Barrierefreiheit (Checkbox „Belegungs-Grad“ deaktiviert)

Abb. 4: Formation-Ansicht — Modus Belegungsgrad (Checkbox „Belegungs-Grad“ aktiviert)

Master-Grid (oben) — Modell: FahrtModelMitFahrzeug

Jede Zeile = eine Kombination aus Fahrt + Fahrzeug. Erbt von FahrtModel und ergänzt fahrzeugspezifische Felder.

Optionale Spalten (nur bei ShowGlobalId = true): LinienID, StartHaltID, EndHaltID

Detail-Grid — Zwei Modi via ShowBelegungsGrad

Der Detail-Bereich hat einen umschaltbaren Header: „Belegungsgrad“ oder „Barrierefreiheit“, gesteuert durch die Checkbox „Belegungs-Grad“.

Band-Struktur (ColumnBands)

Das Detail-Grid nutzt GridControlBand zur Gruppierung der Spalten:

Band "Info" (Fixed=Left)
└── Zeitstempel (HH:mm:ss:ffff)
└── Fzg Position (int)

Band "{StartHst} - {EndHst}"          ← Je Fahrtabschnitt ein Band
└── Haltestelle 1 (FormationHstCell)      (z.B. "Durlach Turm")
└── Haltestelle 2 (FormationHstCell)      (z.B. "Stupferich Ri")
└── ...
└── Haltestelle N_E (FormationHstCell)     (Endhalte: FieldName += "_E")

Zellenaufbau: FormationHstCell — Modus „Belegungsgrad“ (ShowBelegungsGrad = true)

Zellenaufbau: FormationHstCell — Modus „Barrierefreiheit“ (ShowBelegungsGrad = false)

Gemeinsame Eigenschaften beider Modi

Beispieldaten im Belegungsgrad-Modus

Zeitstempel      Fzg Pos  Karlsruhe Haup  Söllingen (b.K.  Berghausen Am  Grötzingen Kru  ...
02:59:59:8600      1      V86084_4562     V86084_4562 [1]  V86084_4562 [0] V86084_4562 [1]  ...
03:04:29:4510      1      V86084_4562     V86084_4562 [1]  V86084_4562 [0] V86084_4562 [1]  ...
                                           ^                ^               ^
                                           Belegung %       Belegung %      Belegung %
                                           (blau, fett)     (blau, fett)    (blau, fett)

Beispieldaten im Barrierefreiheit-Modus

Zeitstempel      Fzg Pos  Durlach Turm     Stupferich Ri    Stupferich Ki   ...
12:27:58:3250      1      V661-1556 [B,A]  V661-1556 [B,A]  V661-1556 [B,A] ...
                                    ^  ^
                                    |  Ankunft=Abfahrt (grün/rot)
                                    Barrierefreiheit (grün/rot/blau)

Quellen: FahrtModelFormation.cs | FahrtModelMitFahrzeug.cs | MainWindow.xaml (Zeilen 29–145, 733–860)

ImportInfoModel              ← Betriebstag-Übersicht (JSON: _vdv454_import_*.json)
│
├── OutputFahrtModel            ← Eine Fahrt mit allen Datenabrufen
│   ├── IstFahrtRowModel[]       ← Einzelne Datenabruf-Zeilen (FahrtRows)
│   │   ├── IstHaltRowModel[]    ← Haltestellen pro Abruf (IstHalts)
│   │   └── IstFormationXmlModel ← Formations-Daten (Fahrzeuge, Gruppen, Haltestellen)
│   └── OutputFzgModel[]         ← Fahrzeug-Kopfdaten (FormationModels)
│
└── UI-Modelle (VBK_VDV454_Import_UI/Models/)
    ├── FahrtModel               ← Flaches Modell für Fahrten-Grid
    │   ├── HstColumn             ← Dynamische Spalten-Definition
    │   └── HstCell               ← Zellen-Daten (Abfahrt, Prognose, Besetztgrad, ...)
    └── FahrtModelFormation      ← Formation-spezifisches Modell
        ├── FormationHstColumn    ← Spalte mit Abschnitt-Zuordnung
        └── FormationHstCell      ← Zelle mit Fzg-ID, Belegung, Barrierefreiheit

Prognose-Statuslinie (rechter Zellrand, Fahrt-Detail)

Besetztgrad-Indikator (rechts oben in Zelle, 5×5px)

Buchstaben-Indikatoren (Fahrt-Detail)

Checkbox-Spalten (Fahrt-Detail, fixiert)

Formations-spezifische Farben (Detail-Grid)

Allgemeine UI-Styles