64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
# Migration auf Trainingsplan / Trainingstracker 2.0
|
|
|
|
## Enthaltene Komponenten
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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
|