Files
boehmitools-training/docs/MIGRATION.md
T
2026-07-24 21:37:03 +02:00

2.3 KiB

Migration auf Trainingsplan / Trainingstracker 2.0

Enthaltene Komponenten

plugins/trainingsplan/
plugins/trainingstracker/
data/trainingsplan/plans/phase-1.json
data/trainingsplan/plans/calihoss-newbie-8-wochen.json

Es werden keine anderen boehmitools-Komponenten verändert.

Installation

  1. boehmitools beziehungsweise den betroffenen Container stoppen.
  2. Die beiden bestehenden Plugin-Ordner sichern.
  3. plugins/trainingsplan/ und plugins/trainingstracker/ durch die Ordner aus dem Paket ersetzen.
  4. Die beiden mitgelieferten Plan-JSONs nach data/trainingsplan/plans/ kopieren.
  5. boehmitools wieder starten.

Bestehende Sessiondateien

Die Dateien unter data/trainingstracker/sessions/ müssen nicht manuell geändert werden.

  • Alte Positionsschlüssel wie d1-r0-e0 bleiben lesbar.
  • Die neuen Pläne speichern den ursprünglichen Positionsschlüssel dauerhaft als legacy_id.
  • Beim Öffnen und nächsten Speichern einer Session wird der Eintrag auf die stabile Übungs-ID migriert.
  • Bereits dokumentierte Sessiondaten erhalten beim nächsten Speichern die aktuelle plan_id und plan_revision, ohne Ergebnisse oder Notizen zu verwerfen.

Vorhandene Sessiondateien sollten trotzdem einmal separat gesichert werden.

Bestehende Analysen

Der Tracker führt künftig genau eine aktuelle Analyse je Woche und eine Gesamtanalyse:

analyses/<Plan-Dateiname>/week-01.json
analyses/<Plan-Dateiname>/week-02.json
analyses/<Plan-Dateiname>/overall.json

Beim ersten Lesen eines alten Analyseordners wird die im bisherigen index.json als aktuell markierte Analyse übernommen. Ältere Zeitstempeldateien und das alte History-Feld werden entfernt. Eine neue Analyse überschreibt anschließend immer dieselbe Datei.

Planrevisionen

Jede Plandatei enthält jetzt:

  • config: die veröffentlichte, vom Tracker gelesene Fassung
  • draft: den bearbeitbaren Entwurf
  • revision: Bearbeitungsrevision für Konfliktschutz
  • published_revision: veröffentlichte Planrevision

Das Speichern eines Entwurfs verändert laufende Sessions nicht. Erst Entwurf veröffentlichen stellt die neue Fassung dem Tracker bereit.

Bewusste Nicht-Funktionen

Nicht eingebaut wurden:

  • strukturierte Technik-, RIR- oder RPE-Werte
  • unterschiedliches Gewicht pro Satz
  • Trainings- oder Tabata-Timer
  • mehrere Versionen oder Historien von KI-Analysen