Backend: https://github.com/schustern/clubcorner_backend
Frontend: https://github.com/schustern/clubcorner_frontend
Präsentation + Video: https://slides.com/janoe/clubcorner/fullscreen
- Nils Jünemann
- Jan Oehlers
- Jan Scheuermann
- Niklas Schuster
Die Verwaltung und Organisation vieler Sportvereine funktioniert mithilfe von WhatsApp Gruppen. Diese sind unübersichtlich, jeder Nutzer kann beliebig viel schreiben, sodass eine Menge unwichtiger Nachrichten versendet werden und möglicherweise relevante Informationen untergehen und nicht wahrgenommen werden. Weiterhin ist die Planung der Spieler, welche ein Training zu- oder abgesagt haben und die damit folgende Kaderplanung mit hohem manuellen Aufwand verbunden. Aufgrund dessen wurden wir vom Vereinsvorsitzenden des TV Jahn Bockum, einem Sportverein aus Krefeld und insbesondere der Handballabteilung beauftragt eine App zur Mannschaftsverwaltung zu schreiben. Hauptansprechpartner war hier für Axel Jaspers (tvjahnbockum@web.de).
Die Hauptfunktionalität umfasst einen gemeinsamen Kalender als Kernpunkt der Mannschaftsverwaltung. Besonders wichtig war es auch, dass Spieler gleichzeitig in mehreren Mannschaften Spielen können, sowie Trainer zeitgleich auch Spieler sein können. Diese Funktionalität wurde von keinen den bisher existierenden Apps umgesetzt, weshalb der Verein keine dieser verwendet. Innerhalb der App sollen Trainer Termine erstellen, welche die zugehörigen Spieler der Mannschaft dann zu- oder absagen. Dadurch kann jeder der Nutzer auch die Zusagen zu bestimmten Terminen einsehen, um die Kaderplanung zu vereinfachen. Die App sammelt alle wichtigen Informationen in einem zentralen Ort und sorgt für übersichtliche Kommunikation.
Der Admin hat eine gesonderte Benutzeroberfläche der App und ist zuständig für grundlegende Verwaltung der App. Er kann Nutzer blockieren und legt Stammdaten fest, welche Mannschaften in der jeweiligen Spielzeit erstellt werden dürfen (Mannschaftsgrad entspricht Anzahl an aktiven Mannschaften für Altersklasse & Geschlecht für die jeweilige Spielzeit)
Trainer sind auch Spieler (Anforderung des Kunden), unterscheiden sich zu diesen aber durch zusätzliche Funktionalitäten, innerhalb der Mannschaft in der sie Trainer sind. Diese umfassen die gesamte Verwaltung der Mannschaft. (zusätzliche Funktionen in derTeampage beschrieben)
Die Spieler bilden den Großteil der Nutzer. Sie können Mannschaften über einen spezifischen Anmeldecode beitreten. Spieler geben persönliche Daten (Anmeldeadresse, Passwort, Name..) an und können diese jederzeit ändern. Innerhalb einer Mannschaft können eingeschriebene Spieler Terminen zu- oder absagen. Außerdem können neue Mannschaften erstellen. Wer eine Mannschaft erstellt wird automatisch zum Trainer dieser Mannschaft.
Nutzer der App können sich auf der Loginpage registrieren (mit EmailAdresse, Passwort, Name) und anmelden (Emailadresse und Passwort)
Die Homepage umfasst eine Liste über alle Mannschaften, denen man zugeordnet ist. Über ein Input Feld kann mit einem erhaltenen Anmeldungscode einer neuen Mannschaft beigetreten werden. Bei Erstellung der Mannschaft müssen folgende Parameter ausgewählt werden:
- Geschlecht
- Altersklasse
- Grad der Mannschaft (1., 2.,3…. Mannschaft dieser Altersklasse)
Diese Parameter können nur nach den Angaben des Admins ausgewählt werden, (also beispielsweise wenn der Admin angegeben hat es gibt 2 Mannschaften B-Jugend, können nur 2 Mannschaften in der B-Jugend dieser Sasion erstellt werden).
Jeder Nutzer der App kann auch eigenständig eine Mannschaft erstellen. Wenn ein Nutzer eine Mannschaft erstellt, wird dieser automatisch Trainer dieser Mannschaft. Durch Anklicken einer der Mannschaften aus der Liste, wird die jeweilige Teampage geöffnet. Oben Links kann eine Sidebar geöffnet werden. In dieser kann der Spieler seine persönlichen Informationen einsehen und ändern.
Die Teampage umfasst eine Übersicht mit allen Terminen der zugehörigen Mannschaft. Termine einer Mannschaft sind angesetzte Spiele und Trainingseinheiten, diese enthalten Datum, Uhrzeit, Ort, (Gegner). In dieser Terminübersicht kann jeder Spieler dieser Mannschaft Termine zu- oder absagen. Dem Trainer der Mannschaft wird ein zusätzlicher "Fab Button" angezeigt, über den er die Mannschaft verwalten kann. Dieses umfasst das Anzeigen der Spielerliste, Spieler einzuladen, Termin anzulegen und Mannschaften aufzulösen. Diese Funktionen werden als Pop-Ups oder Modals bereitgestellt.
Mit der Funktion Mannschaft auflösen kann der Trainer die Mannschaft komplett löschen. Die Spielerliste zeigt dem Trainer alle eingeschriebenen Spieler der Mannschaft an und er kann Spieler aus der Mannschaft entfernen. Über die Funktion Spieler einladen kann der Trainer den Anmeldecode der Mannschaft einsehen und diesen direkt per Mail teilen. Der Trainer kann Spiele und Trainings anlegen. Bei Trainings können einzelne Termine, oder wiederholende Serien (Beispielsweise immer Dienstags 18 Uhr) angelegt werden. Bei Spielen hingegen kann zusätzlich ein Gegner eingetragen werden. Außerdem können Spieler/Trainer Termine in der Übersicht auswählen, um sich anzuschauen wer zu- oder abgesagt hat. Dies ermöglicht eine einfache Kaderplanung. Der Trainer kann erstellte Termine auch wieder löschen.
- Kalender Anbindung für Termine
- Google Maps Anbindung für Navigation
- Push Benachrichtigungen
- App funktioniert auf Android und im Browser
Die App basiert auf einem MEAN Stack, bestehend aus einer MongoDB Datenbank, Express, Ionic verbunden mit Cordova für das Frontend und NodeJS für die Backendfunktionalität. Es gibt 2 verschiedene Docker Container, einer für die Nodeapp und einer für Mongo. Das Frontend mit Ionic wird auf dem Client bereitgestellt. Der Login basiert auf JWT Webtokens und die gesamte Kommunkation von Front- und Backend läuft mihilfe von einer Rest-Schnittstelle ab. Die verschiedenen Dockercontainer können über docker-compose gestartet werden.
Für die Laufzeitumgebung Node.js wurde npm als Paket-Manager verwendet. Die Bibliotheken inklusive einer kurzen Beschreibung der offiziellen Website die hierbei verwendet wurden, sind:
- HTTP: Interface zur Unterstützung und Sicherung des Internet-Protokolls. Insbesondere das Versenden von großen, verschlüsselten Nachrichten.
- jwt: Bibliothek zur Erstellung und Überprüfung von validen JSON Web Tokens. Beispielswiese zum Senden von Verifizierungsdaten für die Validierung auf Backendseite.
- bcrypt: Bibliothek, zur Ver- und Entschlüsselung von Passwörtern.
- Express: Werkzeug um robuste Routen für HTTP-Server zu erstellen.
- multer: Zwischenanwendung, welche das Absenden von Post-Anfragen ermöglicht. Dies wird primär für das Hochladen von Dateien verwendet.
- path: Ein Modul welches es ermöglicht, mit Dateien und Dateiablagepfaden zu arbeiten.
- morgan: Zwischenanwendung, welche http-Anfragen protokolliert.
- body-parser: Zwischenanwendung, mithilfe derer eingehende Datenpakete in das geforderte Format übersetzt werden.
- mongoose: Ein Objekt-Modellierungswerkzeug für asynchrone Umgebungen.
Das Backend besitzt fünf verschiedene Klassen, welche alle nach jeweils drei unterschiedlichen Rollen unterteilt sind. Als Basis dienen hierbei die Models, welche Informationen über die Objekte beinhalten, die in der Datenbank gespeichert werden sollen. Als nächstes kommen die Controller, welche die eigentliche Logik der Anwendung beinhalten. Zuletzt kümmern sich die Routes um die http Abfragen, welche an die Controller weitergeleitet werden. Die Klassen unterteilen sich hierbei mit ihren Funktionen folgendermaßen:
Klasse zur Verwaltung der Anwender, mit welcher das Anmelden, Einloggen und Löschen eines Nutzers möglich ist. Des Weiteren können Nutzer-Informationen abgerufen und geändert, sowie ein Profilbild angelegt werden.
Klasse zum Anlegen, Abrufen und Löschen von Mannschaften. Hierbei wird die Person automatisch als Mitglied hinzugefügt und erhält die Trainer Rolle, welche die Mannschaft erstellt.
Mithilfe dieser Klasse können unterschiedliche Aufgaben erledigt werden. Zum einen hier können Nutzer der Anwendung bestimmten Mannschaften hinzugefügt, oder aus diesen entfernt werden. Des Weiteren lassen sich aber auch anhand der NutzerID alle Mannschaften abrufen, in welchen sich dieser Nutzer befindet. Das gleiche gilt für die MannschaftsID, falls alle sich in dieser Mannschaft befindlichen Spieler abgerufen werden sollen.
Hier können Termine für Mannschaften erstellt, abgerufen, verändert und gelöscht werden.
Bei der Erstellung können Serientermine angelegt werden, indem ein Enddatum mitgegeben wird welches mindestens sieben Tage Abstand zum Anfangsdatum hat. Wird ein Termin entfernt kann dann ebenfalls angegeben werden, die gesamte Reihe mitzulöschen.
Diese Klasse repräsentiert den jeweiligen Status eines Mannschaftsmitglieds bezüglich eines bestimmten Termins. Hier kann der Status, also ob das Mitglied Zu- oder Abgesagt hat, geändert und für eine Übersicht von allen Mitgliedern einer Mannschaft für einen bestimmten Termin abgerufen werden.
- Deep Links beim Anmeldecode nutzen
- Orte mittels Standort festlegen / Navigation
- Anbindung an sis-Handball (Spielpläne)
- Möglichkeit Passwort/Email zu ändern
- Unterscheidung der Nutzer in Trainer & Spieler
- Fix: Trainer kann sich selbst aus Mannschaft löschen, dann existiert diese noch und kann nicht mehr gelöscht werden
- Unterscheidung von Spiel und Training im Frontend
- Erstellung der Admin Rolle
- Ende der Saison sollen Mannschaften gelöscht werden
- Verschlüsselung (Datenbankauthentifizierung)
- Logout (automatisch und manuell)
- Möglichkeit Termine zu- oder abzusagen
Diese Dokumentation ist lizenziert unter Creative Commons Attribution 4.0 International License.
Der Sourcecode und die Präsentation inklusive Video stehen unter Apache License 2.0