chore: initial import

MIGRATION.md

@@ -0,0 +1,63 @@
+# 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