Listet die geplanten Einheiten eines Zeitraums — **mit ids und Schritten**, aelteste zuerst.
Das ist das Gegenstueck zu training_plan_create: erst hier siehst du, was tatsaechlich im Kalender
steht, und nur ueber die ids kann training_plan_update etwas davon aendern. training_stats mit
include_planned zaehlt bloss (5 geplant, 3 erledigt) und nennt keine einzelne Einheit.
**Das Standardfenster liegt in der Zukunft** — heute bis heute + days, weil ein Plan bevorsteht.
Fuer die Rueckschau auf verpasste Einheiten from/to setzen.
**Fuer eine einzelne Einheit id setzen** — das ist zugleich der Ersatz fuer ein training_get auf
eine Planung. training_get kennt nur absolvierte Einheiten: geplante liegen in einer eigenen
Tabelle mit eigenem id-Raum, und Streams, Runden und Zonen gibt es fuer sie nicht. Wer es doch
versucht, bekommt von training_get einen Verweis hierher statt einer Fehlermeldung.
Eine Einheit gilt als erledigt, wenn sie als erledigt markiert ist **oder** der Import eine
Aktivitaet mit ihr verknuepft hat; only_open zeigt genau die uebrigen. Dieselbe Regel benutzt
training_stats — waeren es zwei Regeln, wuerden die Tools einander widersprechen.
**Sortiert nach Zeitpunkt, nicht nur nach Tag.** start_time ist die Ortszeit des Athleten; steht
time_of_day daneben, ist die Uhrzeit noch offen und start_time nur der Platzhalter des Tagesfachs
(morgens 08:00, nachmittags 15:00, abends 20:00). Einheiten ohne jede Zeitangabe liegen mittags.
garmin_workout_id sagt, ob die Einheit schon auf der Uhr liegt. Steht dort eine id, traegt die Uhr
nach einer Aenderung weiter den alten Stand, bis die Einheit erneut an Garmin geschickt wird.
**Koppelläufe (Brick)** tragen brick_of (id des Rads); brick beschreibt das Paar von beiden Seiten:
group = id des Rads, position 1 = Rad, 2 = Koppellauf, size = Teile des Bricks, partner_ids = die anderen
Teile — auch wenn sie wegen Filter oder limit nicht in items stehen. Im Text: "Brick 1/2", "Brick 2/2".
Rad und Lauf stehen im selben Tagesfach (gleiche start_time mit ~), der Lauf beginnt am Radende.
Args:
- id (string, optional): genau eine Einheit. Schlaegt from/to/days/sport/only_open.
- from (string, optional): Startdatum YYYY-MM-DD, inklusive. Default heute.
- to (string, optional): Enddatum YYYY-MM-DD, inklusive. Default from + days - 1.
- days (number): 1-365, default 28 (vier Wochen). Wirkt nur, solange to fehlt.
- sport (string, optional): SWIM | BIKE | RUN | LONGRUN | STRENGTH | MOBILITY | YOGA | HIIT | CARDIO | WALK | HIKE | ALPINE_SKI | NORDIC_SKI | SOCCER | RACKET | OTHER
- include_steps (boolean, default true): Intervallschritte mit ausgeben
- only_open (boolean, default false): nur Einheiten, die weder erledigt noch verknuepft sind
- limit (number): 1-200, default 50
**Renntage im Fenster werden markiert** (race_days, und je Einheit race_day), aus derselben Tabelle wie
training_race_list — ein Rennen ist keine geplante Einheit und steht deshalb nicht in items. Einheiten
am **Tag davor** tragen race_eve ({ id, name, priority, risk }); risk ist true bei HARD/VERY_HARD, einem
Test im Titel oder mehr als 90 min — dieselbe Regel, nach der training_plan_create/_update warnen.
**planned_tss je Einheit** — aus den Schritten gegen die **heutige** Schwelle gerechnet (Rad ftp,
Lauf Schwellenpace, Schwimmen CSS mit IF^3; ohne Ziel IF nach Schritttyp), nicht gespeichert: nach
einem FTP-Test sinkt die TSS derselben 230 W von selbst. planned_tss_method: steps | intensity (Dauer x
Intensitaetslabel) | engine_target (Kraft: "Ziel N TSS" der Plan-Engine) | per_minute (Kraft/Mobility).
planned_tss_estimated: true, wenn nichts davon an einer gesetzten Schwelle haengt (z.B. Schwimmen ohne
CSS) — im Text mit ≈ markiert. null = weder Schritte noch Dauer.
**Harte Einheiten an schlechten Tagen tragen readiness_warning** ({ status YELLOW|RED, date, reasons }):
HARD/VERY_HARD und die Readiness-Ampel des Tages ist gelb oder rot — fuer eine Einheit morgen gilt der
heutige Stand, weiter voraus gibt es keine Warnung. Dieselbe Bewertung wie training_readiness.
Returns: { from, to, count, has_more, race_days: [{ id, date, name, priority, format, status }], items: [{ id, date, start_time, time_of_day, sport, title, duration_min, distance_km, intensity, planned_tss, planned_tss_estimated, planned_tss_method, completed, done, matched_activity_ids, notes, pool_length_m, garmin_workout_id, brick_of, brick: { group, position, size, partner_ids } | null, race_day, race_eve, readiness_warning, steps: [{ order, type, title, duration_min, duration_sec, distance_km, stroke, equipment, exercise?, reps?, weight_kg?, target_kind, target_low, target_high, target_pace, target_heart_rate, target_power, notes }] }] } — exercise/reps/weight_kg stehen nur bei Kraftschritten
ConnectorOAuth