Zum Inhalt

Wettkampf-App - Gerätturnen

Willkommen zum Benutzerhandbuch. Es richtet sich an Nutzer — Veranstalter, Kampfrichter, Moderation, Coaches — nicht an Entwickler.

Schritt für Schritt (Bildanleitungen)

Wer lieber Bildern folgt als Fließtext: drei durchnummerierte Wege, jeder Schritt mit eigenem Bildschirmfoto und eigener Sprungadresse.

Weg Wann
Vorbereitung Tage vorher, am Laptop
Wettkampftag am Wettkampftag, am Laptop
Kampfrichter am Tablet am Wettkampftag, am Gerät

Übersicht mit allen 30 Schritten

Die Kapitel unter Wettkampf durchführen und Rollen bleiben das Nachschlagewerk mit den Hintergründen.

Nach Rolle navigieren

Sie sind… Starten Sie hier
Veranstalter / Admin rollen/admin.md
Kampfrichter (Kari) rollen/kampfrichter.md
Moderation rollen/moderation.md
Oberkampfgericht (Oberkari) rollen/oberkari.md
Trainer / Coach rollen/coach.md

Installation & Einrichtung

  1. Master-Laptop aufsetzen
  2. Netzwerk einrichten (WLAN/LAN)
  3. Raspberry Pi für LED-Wände
  4. Kampfrichter-Tablets vorbereiten

Wettkampf durchführen

  1. Vor dem Wettkampf: Event & Teilnehmer
  2. Durchgang starten & Rotation
  3. Wertungseingabe (Kari)
  4. Oberkari & Proteste
  5. Live-Anzeige bedienen
  6. Ergebnisse abschließen & archivieren

Hilfe bei Problemen

Symbole im Handbuch

Symbol Bedeutung
Hinweis: Nützliche Ergänzung, kein Pflichtschritt
Wichtig: Unbedingt beachten
Tipp: Empfehlung aus der Praxis
Problem?: Verweis ins Troubleshooting

Kontakt

Bei Fragen, Fehlermeldungen oder Featurewünschen:

  • E-Mail: tobiasnolte@gmx.de
  • Telefon: 0177 / 3 91 20 10
  • Vor-Ort-Support: Tobias Nolte, Frankenstraße 17, 65719 Hofheim a. Taunus

Version: steht rechts oben in der Kopfzeile dieses Handbuchs — sie wird beim Erzeugen aus dem laufenden Stand von Frontend und Server übernommen. Stand: Aktualisierung bei jedem Release über den Veranstalter.

Für Redakteure: PDF / HTML erzeugen

Das Handbuch lässt sich mit MkDocs Material als HTML und PDF erzeugen.

Setup (einmalig)

Benötigt Python 3.9+ und Node.js (für Playwright). Kein Admin-Recht:

npm run docs:install:venv    # erstellt .venv-docs/ und installiert MkDocs + print-site-plugin

Live-Preview

npm run docs:serve:venv      # http://localhost:8000

HTML + PDF bauen

npm run docs:build           # Linux / Git Bash
npm run docs:build:win       # Windows PowerShell

Ergebnis:

  • site/index.html — durchsuchbare HTML-Version mit Suche (offline-fähig)
  • site/print_page.html — Alles-in-einer-Seite (druckbar)
  • site/pdf/WettkampfApp-Handbuch.pdf — A4-PDF mit Seitenzahl, Kopfzeile, eingebetteten Bildern

Wie es funktioniert

  1. MkDocs Material baut die HTML-Variante und via print-site-plugin eine gebündelte Druckseite.
  2. Playwright (aus dem Projekt, bereits installiert) rendert diese Druckseite im Chromium-Headless zu PDF.
  3. Keine WeasyPrint/GTK-Abhängigkeiten — läuft sauber unter Windows.

HTML auf dem Master-Laptop ausliefern

Parallel zu den WettkampfApp-Apps bedient die Doku auf Port 4210:

# Live-Vorschau während man schreibt (HTTP, mit Live-Reload)
mkdocs serve --dev-addr 0.0.0.0:4210

# Oder die gebaute Site statisch serven (HTTP)
python -m http.server 4210 -d site

Kunden im WLAN öffnen dann z. B. http://<master-ip>:4210/. HTTPS ist für die Doku nicht zwingend; wer's braucht, kann server.js erweitern.