Lars/shinkan-jinkendo
1
0
Fork 0
Code Issues 7 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
ea7de64061
shinkan-jinkendo/.claude/docs/functional/PARALLEL_TRAINING_STREAMS_CONCEPT.md
Lars 76cc81a385
All checks were successful
Deploy Development / deploy (push) Successful in 42s
Details
Test Suite / pytest-backend (push) Successful in 37s
Details
Test Suite / lint-backend (push) Successful in 0s
Details
Test Suite / build-frontend (push) Successful in 20s
Details
Test Suite / k6 /health Baseline (push) Successful in 33s
Details
Test Suite / playwright-tests (push) Successful in 1m8s
Details
Update project documentation and enhance training features for parallel streams 
- Updated CLAUDE.md and PROJECT_STATUS.md to reflect the latest app version (0.8.140) and database schema (20260515063) as of 2026-05-14.
- Enhanced DOMAIN_MODEL.md and PARALLEL_TRAINING_STREAMS_CONCEPT.md to clarify the implementation of phases and parallel streams in training units.
- Improved HANDOVER.md with detailed descriptions of the coaching and breakout functionalities, including rejoin logic and session management.
- Updated FACHLICHE_NUTZERFUNKTIONEN.md to include new features related to training planning and execution, emphasizing the integration of phases and parallel streams.
- Revised FEATURES_DELIVERED_2026-Q2.md to document the latest changes and improvements in the training framework and media management.
2026-05-15 22:11:05 +02:00

7.3 KiB
Raw Blame History

Parallele Trainingsstreams (Breakout) — Fachkonzept

Status: MVP-Umsetzung teilweise (Code) · Stand: 2026-05-14
Ziel: Planung und Durchführung von Training mit phasenweise gemeinsamem Ablauf und beliebig vielen parallelen Teilstrecken (Breakout-Sessions), inkl. Sonderfall rotierende Stationen.

Technische Ausarbeitung: .claude/docs/technical/PARALLEL_TRAINING_STREAMS_SPEC.md
Domänenbegriffe (Überblick): .claude/docs/functional/DOMAIN_MODEL.md (Abschnitt Parallele Streams)

1. Ausgangslage und Problem

In Kinder- und Breitensport-Training ist ein typischer Ablauf:

  1. Gemeinsam: Aufwärmen, Koordination, Ansagen.
  2. Getrennt: Kinder in mehrere Gruppen teilen; Co-Trainer leiten jeweils eigene Inhalte gleichzeitig.
  3. Gemeinsam: Abschluss, gemeinsame Übungen, Verabschiedung.

Die aktuelle Shinkan-Planung modelliert pro Termin eine lineare Folge von Abschnitten und Übungen pro Einheit. Das genügt nicht, wenn mehrere gleichzeitige „Unter-Sessions“ mit unterschiedlichen Plänen dokumentiert und auf der Matte geführt werden sollen.

2. Ziele (fachlich)

ID Ziel
PT‑01 Eine Kalender-Einheit bleibt ein Termin (eine Halle, eine Gruppe, ein Datum) — kein Splitten in künstlich mehrere Kalendereinträge nur für Parallelität.
PT‑02 Unbegrenzte Anzahl paralleler Streams (Teilstrecken) in einer oder mehreren Parallelphasen.
PT‑03 Phasenmodell: klar erkennbar Gemeinsam vs. Parallel vs. wieder Gemeinsam (auch mehrfach hintereinander möglich).
PT‑04 Rollen: Leitung (Haupttrainer) und Co-Trainer; Zuordnung der Co-Trainer soll an konkrete Streams anschließbar sein (heute: nur flache Liste pro Einheit — siehe technische Spec).
PT‑05 Sonderfall Stationen: rotierender Ablauf (z. B. Wechsel alle 20 Min.) inhaltlich unterscheiden zwischen (a) Rotation innerhalb einer Teilstrecke und (b) synchron getakteter Hallen-Rotation — siehe §5.
PT‑06 Durchführung: Trainer können „ihre“ Spur auf dem Gerät abarbeiten; Fortschritt pro Spur nachvollziehbar.

Nicht-Ziel (frühe Stufen): Echtzeit-Synchronisation mehrerer Geräte; individuelles Athleten-Tracking; automatische Raumbelegung.

3. Begriffe

Begriff Definition
Einheit / Termin Geplante training_unit für Gruppe und Datum — übergeordneter Rahmen des Abends.
Phase Organisatorischer Block innerhalb der Einheit: entweder ganze Gruppe oder parallel.
Stream / Teilstrecke Innerhalb einer Parallelphase: eine von N gleichzeitig stattfindenden Unter-Abläufen mit eigenem Miniplan (Abschnitte, Übungen, Notizen — analog heutiger Planung).
Synchronisationspunkt Fachlich: alle treffen sich wieder (Beginn einer Gemeinschaftsphase nach Parallelität).
Station (Rotation) Inhaltlicher Fokus oder Platz, den Teilnehmer wechselnd anlaufen; kann als Kombinations-/Zirkellogik oder als koordinierter Hallenrhythmus modelliert werden (§5).

Abgrenzung „Rahmenprogramm-Slot“: Ein Slot im Rahmenprogramm ist eine Session in einer Serie (z. B. Woche 1 vs. Woche 2), nicht „Teilgruppe A gleichzeitig mit Teilgruppe B in derselben Stunde“. Parallele Streams sind innerhalb einer Einheit, orthogonal zum Rahmen-Slot.

Abgrenzung Kombinationsübung: Eine Kombi-Übung bündelt mehrere Einzelübungen mit Methodenprofil (Archetyp, ggf. Rotation) in einem Plan-Item. Sie ersetzt nicht mehrere Trainer mit jeweils eigenem Gesamtablauf, kann aber pro Stream für Stationslogik genutzt werden.

4. Szenarien

4.1 Klassischer Breakout

30 Min. gemeinsam → 25 Min. drei parallele Streams (Gruppe an Matte / an Schlagsack / Fußarbeit) → 15 Min. gemeinsam.

4.2 Viele Kinder, mehrere Co-Trainer

Haupttrainer plant die Gesamtstruktur; jeder Co-Trainer sieht in der Durchführung primär die zugewiesene Teilstrecke.

4.3 Rollierendes Stationssystem

Alle Gruppen arbeiten an verschiedenen Schwerpunkten und wechseln nach festem Intervall die Station — entweder nur innerhalb einer Spur oder hallenweit synchron (offene fachliche Präzisierung in MVP vs. später, §5).

5. Sonderfall: Stationen und Kombinationsübungen

5.1 Variante A — Rotation innerhalb einer Teilstrecke

Eine Teilgruppe rotiert durch mehrere Übungen (Zeit oder Runden). Das liegt nah an einer Kombinationsübung mit Archetyp z. B. „Zirkel / zeitgesteuerte Rotation“ und Parametern (Wechselintervall). Empfehlung: Diese Variante über bestehendes Kombinationsübungs-Konzept in der jeweiligen Stream-Planung abbilden (planning_method_profile).

5.2 Variante B — Synchron getaktete Hallen-Rotation

Alle Streams (oder alle Kinder insgesamt) wechseln gleichzeitig zur nächsten Station; Startstation kann pro Teilgruppe versetzt sein. Das ist organisatorisch schwerer: es braucht entweder Phasen-Metadaten (globaler Takt) oder eine explizite Rot/Matrix. Empfehlung: In einer zweiten Ausbaustufe abbilden; MVP kann bei Variante A starten, sofern fachlich ausreichend.

6. Rollen und Verantwortlichkeiten

  • Leitungstrainer: Hält den Faden, startet Gemeinschaftsphasen, koordiniert Parallelbeginn/-ende (fachlich; ggf. später UI-Hinweise).
  • Co-Trainer: Verantwortlich für zugeteilte Streams; Zuordnung soll pro Stream möglich werden (Erweiterung gegenüber reiner Einheits-Co-Trainer-Liste).

7. Offene fachliche Entscheidungen

  1. MVP Umfang: Reicht freie Parallelität ohne synchronen Hallenwechsel (Variante B)?
  2. Dauer: Sollen Phasen oder Streams Soll-Minuten tragen (nur Anzeige vs. später Timer)?
  3. Vorlagen: Müssen training_plan_templates parallel-fähig werden vor oder mit der ersten Implementierung?
  4. Sichtbarkeit: Dürfen alle Co-Trainer alle Streams sehen, oder „nur meine Spur“?

9. Umsetzungsstand (kurz, 2026-05-14)

  • Erreicht: Datenmodell Phasen/Streams (063), API GET/PUT mit phases, Planungs-Breakout-UI, Durchführung und Coach nutzen dieselbe Phasen-/Stream-Logik im Frontend (trainingPlanUtils.js). Synchronisationspunkt fachlich umgesetzt: vor nächster Ganzgruppenphase oder nächstem Split erscheint im Coach die Rejoin-Karte (mehrere Streams), sofern nicht am absoluten Planende.
  • Noch offen: vollständige Persistenz-Konsistenz bei nachträglich geänderten Sektionen, Vorlagen mit Phasen, Trainer pro Stream in der UI, ggf. Stream-Tabs in der Durchführungsansicht wie in §5.2 skizziert — siehe docs/HANDOVER.md (Arbeitspaket-Tabelle).

10. Verwandte Dokumente

Dokument Bezug
technical/TRAINING_FRAMEWORK_SPEC.md Rahmen-Slots = Serien-Sessions, nicht Intra-Einheit-Parallelität
technical/TRAINING_MODULES_AND_COMBINATION_EXERCISES_SPEC.md Kombinationsübungen, Archetypen, Stationslogik im Item
functional/Shinkan Trainingsmodule Kombinationsuebungen Spezifikation V2.md Fachliche Tiefe Kombi
docs/FACHLICHE_NUTZERFUNKTIONEN.md Nutzerüberblick
docs/HANDOVER.md Ist-Stand Coach, offene Breakout-Punkte
technical/DATABASE_SCHEMA.md Aktueller Stand Tabellen