TurnFix v2.0 - Webbasierte Wettkampfverwaltung¶

Moderne Webanwendung für Turnwettkämpfe

📖 Über diese Dokumentation¶

Diese Dokumentation beschreibt die webbasierte Version von TurnFix v2.0 - ein vollständiges Rewrite der Desktop-Anwendung als moderne Full-Stack-Webanwendung.

Zielgruppen¶

• 👥 Anwender: Turnvereine, Wettkampfveranstalter, Kampfrichter
• 👨‍💻 Entwickler: Beitragende, Maintainer, System-Administratoren

🚀 Schnellstart¶

• Installation & Setup
• Erste Schritte
• Veranstaltung anlegen

📚 Dokumentations-Bereiche¶

Für Anwender¶

• Benutzerhandbuch - Vollständige Anleitung zur Bedienung
• Workflows - Schritt-für-Schritt Anleitungen
• Features - Funktionsübersicht

Für Entwickler¶

• Entwicklerhandbuch - Technische Dokumentation
• Architektur - System-Design & Patterns
• API-Referenz - Backend-Schnittstellen
• Contributing - Beiträge & Standards

Deployment & Administration¶

• Produktiv-Deployment - Server-Installation
• Netzwerk-Setup - Multi-Client-Betrieb
• Troubleshooting - Fehlerbehandlung

🎯 Hauptfunktionen¶

✅ Veranstaltungsverwaltung - Events, Wettkämpfe, Teilnehmer ✅ Riegenverwaltung - Squad-Zuordnung, Rotation-Planning ✅ Wertungserfassung - Live-Scoring mit Socket.IO ✅ Kampfrichter-Portal - Eigenständiges Jury-Interface ✅ Zeitplanung - Gantt-Charts, Rotations-Übersicht ✅ Urkunden & Export - PDF-Generation, CSV-Export ✅ GymNet-Import - XML-Import von DTB GymNet

🛠️ Technologie-Stack¶

• Backend: Node.js 18+, Express, TypeScript, Prisma ORM
• Frontend: React 18, TypeScript, Tailwind CSS, Vite
• Datenbank: PostgreSQL (Legacy-Schema-kompatibel)
• Real-time: Socket.io für Live-Updates
• Process Manager: PM2

📊 Projekt-Status¶

Version: 2.0 (Production Ready) Letztes Update: 5. November 2025 Entwicklungsstatus: ✅ Aktiv

Abgeschlossene Features (86/221 Points)¶

• ✅ Vollständige Lokalisierung (DE/EN)
• ✅ Gender-Unification über alle UIs
• ✅ PDF-Export-System
• ✅ GymNet XML-Import
• ✅ Socket.IO Live-Updates
• ✅ Startgeräte-Verwaltung (Point 135)

Vollständiger Fortschritt

🔗 Wichtige Links¶

• Haupt-Repository: github.com/Igel18/turnfix
• Issue Tracker: GitHub Issues
• Changelog: CHANGELOG.md

📞 Support & Kontakt¶

Bei Fragen oder Problemen:

• 📧 Email: [Support kontaktieren]
• 💬 GitHub Discussions: Diskussionen
• 🐛 Bug Reports: Issues erstellen

---

Hinweis: Diese Dokumentation ersetzt die Legacy-Dokumentation für die Qt/C++-Version. Für die alte Desktop-Version siehe Legacy-Dokumentation.