Debug-Ansicht

Die Debug-Ansicht (auch "Probleme" im Menü genannt) bietet direkten Zugriff auf die Anwendungsdatenbank für Fehlerbehebung und erweiterte Fehlersuche.

Zweck

⚠️ Warnung: Dies ist hauptsächlich ein Debugging-Tool für fortgeschrittene Benutzer und Entwickler.

Verwende die Debug-Ansicht um:

• Datenbankinhalte direkt zu inspizieren
• Datensynchronisationsprobleme zu diagnostizieren
• Ergebnisberechnungsprobleme zu untersuchen
• Datenintegrität zu überprüfen
• Mit dem Support-Team Fehler zu beheben

Debug-Ansicht aufrufen

1. Navigiere zu Probleme (oder Debug) im Hauptmenü
2. Du siehst Tabs für verschiedene Datenbank-Collections

Verfügbare Collections

Event

• Veranstaltungsgrundkonfiguration
• Veranstaltungseinstellungen und Optionen
• Nullzeit, Maximalzeit, ersetzte Posten
• Online-Ergebnisse-Konfiguration

Course

• Alle definierten Bahnen
• Postencodes und Sequenzen
• Bahnlänge und Steigung

Class

• Wettkampfkategorien
• Bahnzuweisungen
• Kategorien-spezifische Einstellungen

Participant

• Alle registrierten Teilnehmer
• Rohe Teilnehmerdaten
• Mitgliederinformationen
• Auslese-Zuordnungen

Readout

• Alle SportIdent-Kartenauslesungen
• Rohe Stempeldaten von Karten
• Lösch-, Prüf-, Start-, Zielzeiten
• Alle Postenstempel

Punch

• Stationsauslesedaten
• Einzelne Stempel von Stationen
• Verwendet für DNS-Prüfung und Analyse

Live

• Echtzeit-Datenbankänderungs-Events
• Zeigt Datenbankaktivität während sie passiert
• Nützlich für Debugging von Synchronisationsproblemen

Results

• Berechnete Ergebnisdaten
• Status-Bestimmung
• Zwischenzeitenberechnung
• Verwendet zum Debuggen der Ergebnisberechnung

Wann verwenden

Normale Benutzer

• Generell nicht für täglichen Betrieb benötigt
• Kann vom Support-Team während Fehlerbehebung angefordert werden
• Kann verifizieren, dass spezifische Daten existieren

Fortgeschrittene Benutzer

• Untersuchen, warum ein Ergebnis falsch ist
• Prüfen, ob Auslesedaten korrekt gespeichert wurden
• Synchronisationsstatus spezifischer Datensätze verifizieren
• Fehlende oder doppelte Daten diagnostizieren

Support/Debugging

• Screenshots zum Teilen mit Support machen
• Datenbankschema-Konformität verifizieren
• Auf Datenkorruption prüfen
• Performance-Probleme untersuchen

Wichtige Hinweise

• Nur-Lese-Interface: Du kannst die Datenbank nicht direkt durch diese Ansicht bearbeiten
• Rohdaten: Zeigt interne Datenbankstruktur, keine benutzerfreundliche Formatierung
• Technische Kenntnisse erforderlich: Verständnis erfordert Vertrautheit mit Datenbankkonzepten
• Performance: Anzeige grosser Collections kann langsam sein
• Nicht für reguläre Nutzung: Verwende Standard-App-Funktionen für normale Operationen

Fehlerbehebungs-Tipps

Teilnehmer fehlt Ergebnis

1. Participant Tab prüfen
2. Teilnehmer per Suche finden
3. Prüfen, ob readout Feld einen Wert hat
4. Zu Readout Tab gehen
5. Verifizieren, dass Auslese mit korrekter Kartennummer existiert
6. Results Tab für berechnetes Ergebnis prüfen

Auslese wird nicht angezeigt

1. Readout Tab prüfen
2. Nach SI-Kartennummer suchen
3. Verifizieren, dass Auslese gespeichert wurde
4. Zeitstempel prüfen - ist er aktuell?
5. event Feld verifizieren - stimmt es mit aktueller Veranstaltung überein

Synchronisationsprobleme

1. Live Tab verwenden, um Datenbankaktivität zu beobachten
2. Aktion auslösen (z.B. Teilnehmer speichern)
3. Auf entsprechende Datenbankänderung achten
4. Prüfen, ob Änderung updatedAt Zeitstempel hat
5. Netzwerkaktivität in Browser-Entwicklertools verifizieren

Alternative: Browser-Entwicklertools

Für noch detaillierteres Debugging:

1. F12 drücken, um Browser-Entwicklertools zu öffnen
2. Zu Application Tab (Chrome) oder Storage Tab (Firefox) gehen
3. IndexedDB → Deine Veranstaltungsdatenbank finden
4. Collections und Dokumente durchsuchen
5. Rohe JSON-Daten anzeigen

Hilfe bekommen

Wenn du Probleme hast:

1. Screenshots relevanter Debug-Ansicht-Tabs machen
2. Exakte Fehlermeldungen notieren
3. Schritte zur Reproduktion dokumentieren
4. Support mit diesen Informationen kontaktieren