Plattform-Konzepte
TRACKTICS organisiert alle Daten in einer Hierarchie aus Vereinen, Mannschaften, Spielern, Trackern und Sessions. Das Verständnis dieses Modells ist die Grundlage für die effektive Arbeit mit der API.
Übersicht
Verein (Club)
├── Rollen (Zugriffskontrolle für Nutzer)
├── Mannschaften (Teams)
│ └── Spieler (Mitglieder der Mannschaft)
├── Spieler (alle Spieler des Vereins)
├── Tracker (GPS-Geräte des Vereins)
│ └── Spieler-Zuordnung (welcher Tracker von welchem Spieler getragen wird)
└── Sessions (Training und Spiele)
└── Marker (Ereignisse: Tore, Fouls usw.)
Verein (Club)
Ein Verein ist die übergeordnete Einheit in TRACKTICS. Alles — Spieler, Tracker, Sessions und Mannschaftsstrukturen — gehört zu einem Verein.
Vereine werden vom TRACKTICS-Team erstellt und verwaltet. Um ein Vereinskonto zu erhalten, kontaktieren Sie info@tracktics.com.
Jeder Verein hat:
- Eine eindeutige Vereins-ID (UUID)
- Einen Namen zur Anzeige
- Eine Reihe von Rollen, die festlegen, was Nutzer innerhalb des Vereins tun dürfen (siehe Rollen weiter unten)
Mannschaften (Teams)
Eine Mannschaft ist eine benannte Gruppe innerhalb eines Vereins. Vereine betreiben in der Regel mehrere Mannschaften (z. B. erste Mannschaft, U17, U19, Damen).
Mannschaften dienen dazu, Spieler zu strukturieren und Statistiken nach Kader zu filtern. Ein Spieler kann mehreren Mannschaften angehören.
Spieler (Players)
Ein Spieler ist ein im Verein registrierter Athlet. Spieler sind unabhängig von Mannschaften — sie werden auf Vereinsebene hinzugefügt und optional einer oder mehreren Mannschaften zugewiesen.
Jeder Spieler hat:
- Eine eindeutige Spieler-ID
- Einen Namen und ein optionales Profilbild
- Mitgliedschaft in keiner oder mehreren Mannschaften
Während einer Session kann ein Spieler mit einem Tracker-Gerät verknüpft werden, sodass seine GPS-Positionsdaten erfasst und ihm zugeordnet werden.
Tracker
Ein Tracker ist ein physisches GPS-Gerät, das die Position eines Spielers in Echtzeit aufzeichnet. Tracker werden einem Verein zugeordnet und können zwischen Spielern und Sessions neu vergeben werden.
Wichtige Eigenschaften:
- Jeder Tracker hat eine eindeutige Tracker-ID und einen lesbaren Namen (z. B. „Tracker 01")
- Ein Tracker wird innerhalb einer Session einem Spieler zugeordnet, um Positionsdaten mit diesem Spieler zu verknüpfen
- Mehrere Tracker können in einer Sessions gleichzeitig aktiv sein
Die Zuordnung zwischen Tracker und Spieler wird pro Session verwaltet: Vor Beginn einer Session weisen Trainer jedem Spieler einen Tracker zu.
Sessions
Eine Session repräsentiert eine einzelne Trainingseinheit oder ein Spiel. Alle Positionsdaten und Ereignismarker werden im Kontext einer Session aufgezeichnet.
Sessions gehören zu einem Verein und können optional einer Mannschaft zugeordnet werden. Eine Session erfasst:
- Start- und Endzeiten
- Echtzeit-GPS-Positionsdaten — live via WebSocket-API gestreamt und zur späteren Wiedergabe gespeichert
- Marker — diskrete Ereignisse während der Session wie Tore, Fouls oder Trainer-Annotationen, jeweils mit Zeitstempel und Position
Auf Positionsdaten kann während einer laufenden Session live via WebSocket oder nach dem Ende der Session historisch über die REST-API zugegriffen werden.
Rollen
Der Zugang zu einem Verein wird über Rollen gesteuert. Die Rolle eines Nutzers innerhalb eines Vereins bestimmt, was er lesen oder ändern darf.
| Rolle | Berechtigungen |
|---|---|
club admin | Vollzugriff: Vereinseinstellungen, Nutzer, Spieler, Tracker und Sessions verwalten |
club editor | Spieler, Tracker, Mannschaften und Sessions anlegen und bearbeiten; keine Nutzer- oder Vereinseinstellungen |
club viewer | Nur-Lese-Zugriff auf Vereinsdaten, Sessions und Positionshistorie |
Ein Nutzer kann mehrere Rollen gleichzeitig besitzen (z. B. club admin und club editor).
Um Rollen zu ändern oder weitere Nutzer zu Ihrem Verein einzuladen, wenden Sie sich an info@tracktics.com.
Zusammenspiel der Konzepte
Ein typischer Arbeitsablauf sieht so aus:
- Ihr Verein wird von TRACKTICS eingerichtet und Sie erhalten Zugangsdaten.
- Sie legen Mannschaften und Spieler in Ihrem Verein an.
- Vor jeder Session ordnen Sie Trackern Spielern zu.
- Sie starten eine Session — Live-Positionsdaten fließen über den WebSocket.
- Trainer erstellen Marker (Tore, Highlights) während der Session.
- Nach Ende der Session rufen Sie Positionshistorie und Marker über die REST-API für Analysen ab.