# 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