Debug-/Problemansicht

Debug-/Problemansicht

Im Menü "Probleme" liegen die Datenwerkzeuge: Gespeichertes ansehen, Resultate neu berechnen, Bahnzuweisungen korrigieren, prüfen ob alles beim Server angekommen ist und — selten — ein Gerät mit beschädigter Datenbank wiederherstellen.

Was im Problem-Menü steckt

Eintrag Wirkung
Alle Resultate neu berechnen Berechnet alle Resultate aus den gespeicherten Auslesungen neu
Bahnen gemäss Kategorie neu zuweisen Korrigiert Teilnehmer, deren Bahn nicht zur Kategorie passt
Rohdaten inspizieren Nur-Lesen-Ansicht der gespeicherten Daten
Auslesung an Teilnehmer binden Verbindet Auslesungen ohne Teilnehmer — sortiert, beste Übereinstimmung zuerst
Auslesungs-Backup-Inspektor Zeigt die lokalen Sicherungskopien der Auslesungen
Genauer Sync-Status Was synchronisiert wurde und was fehlgeschlagen ist
Prüfen, ob alles hochgeladen ist Prüft beim Server, ob jeder Eintrag angekommen ist
Synchronisation neu starten Baut die Sync-Verbindungen neu auf
Sicherungsmodus und Reparatur Gerät reparieren, Zwischenspeicher einspielen, Sicherungsmodus ein-/ausschalten

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 SI-Card-Auslesungen
  • Rohe Stempeldaten von SI-Cards
  • 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 SI-Card-Nummer existiert
  6. Results Tab für berechnetes Ergebnis prüfen

Auslese wird nicht angezeigt

  1. Readout Tab prüfen
  2. Nach SI-Card-Nummer 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