boehmitools-training/plugins/trainingsplan/TOOL-README.md

Trainingsplan-Backend

Dieses Plugin ist nur noch das Eintragebackend fuer Trainingsplaene.

Es verwaltet:

• Plaene
• Uebungen in einer zentralen Uebungsbibliothek
• Trainingstage
• Warm-up und Cool-down pro Trainingstag
• Uebungen, die an Trainingstagen hinterlegt sind

Nicht mehr enthalten sind PDF-Erzeugung, Rezeptsammlungen, Progressionen, Planvorschlaege, Analyse-/ChatGPT-Anbindungen und Farbdefinitionen fuer eine Ausgabeoberflaeche.

Datenvertrag

Trainingsplaene verwenden:

schema_version: 4
contract_version: 3

Eine Plan-Config ist bewusst flach:

{
  "schema_version": 4,
  "contract_version": 3,
  "plan_id": "basis-plan",
  "meta": {
    "title": "Basis-Plan"
  },
  "exercises": [
    {
      "id": "exercise-squat",
      "name": "Squat",
      "cue": "Sauber und kontrolliert"
    }
  ],
  "days": [
    {
      "id": "day-1",
      "num": 1,
      "name": "Tag 1",
      "warmup": { "items": ["Gelenke mobilisieren"] },
      "cooldown": { "items": ["Locker auslaufen"] },
      "exercises": [
        {
          "id": "day-exercise-1",
          "exercise_id": "exercise-squat",
          "sets": 3,
          "reps": "8-12"
        }
      ]
    }
  ]
}

API

• GET /api/plans
• POST /api/plans
• GET /api/plans/<plan>
• POST /api/plans/<plan>
• POST /api/plans/<plan>/publish
• POST /api/plans/<plan>/rename
• DELETE /api/plans/<plan>
• GET /api/plans/<plan>/exercises
• POST /api/plans/<plan>/exercises
• PATCH /api/plans/<plan>/exercises/<exercise>
• DELETE /api/plans/<plan>/exercises/<exercise>
• GET /api/plans/<plan>/days
• POST /api/plans/<plan>/days
• PATCH /api/plans/<plan>/days/<day>
• DELETE /api/plans/<plan>/days/<day>
• POST /api/plans/<plan>/days/<day>/exercises
• PATCH /api/plans/<plan>/days/<day>/exercises/<item>
• DELETE /api/plans/<plan>/days/<day>/exercises/<item>

Der alte aktive Config-Zugriff bleibt fuer einfache Clients erhalten:

• GET /api/config
• POST /api/config
• GET /api/default
• POST /api/reset

Migration

Aeltere Trainingsplaene werden beim Laden auf den flachen Vertrag reduziert. Uebungen aus alten Rotationen werden in die Uebungsbibliothek uebernommen und als Tagesuebungen referenziert. Warm-up und Cool-down werden aus den bisherigen Tages- oder prepost-Feldern uebernommen.