init

backend/.claude/agent-memory/tester/MEMORY.md

@@ -0,0 +1,3 @@
+# Tester Agent Memory
+
+- [Test database setup pattern](feedback_test_db_setup.md) — store.New appends query params; use os.CreateTemp instead of ":memory:" URIs

backend/.claude/agent-memory/tester/feedback_test_db_setup.md

@@ -0,0 +1,18 @@
+---
+name: Test database setup pattern
+description: How to create isolated test databases for store and handler tests in this project
+type: feedback
+---
+
+Use `os.CreateTemp` to create a temporary SQLite file for each test. Pass that file path to `store.New`.
+
+**Why:** `store.New` always appends `?_journal_mode=WAL&_foreign_keys=ON` to the path argument. If you pass a URI like `file:name?mode=memory&cache=shared`, the result is a malformed DSN (`...?mode=memory&cache=shared?_journal_mode=WAL&...`) that SQLite rejects with "no such cache mode: shared".
+
+**How to apply:** In every `newTestStore` / `newHandlerWithStore` helper, do:
+```go
+f, _ := os.CreateTemp("", "krafttrainer-test-*.db")
+f.Close()
+dbPath := f.Name()
+s, err := store.New(dbPath)
+t.Cleanup(func() { s.Close(); os.Remove(dbPath) })
+```

backend/internal/handler/exercise.go

@@ -6,6 +6,8 @@ import (
 	"net/http"
 )
 
+// handleListExercises behandelt GET /api/v1/exercises.
+// Unterstützt optionale Query-Parameter: muscle_group und q (Namenssuche).
 func (h *Handler) handleListExercises(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -23,6 +25,7 @@ func (h *Handler) handleListExercises(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, exercises)
 }
 
+// handleCreateExercise behandelt POST /api/v1/exercises.
 func (h *Handler) handleCreateExercise(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -48,6 +51,7 @@ func (h *Handler) handleCreateExercise(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, exercise)
 }
 
+// handleUpdateExercise behandelt PUT /api/v1/exercises/{id}.
 func (h *Handler) handleUpdateExercise(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -82,6 +86,8 @@ func (h *Handler) handleUpdateExercise(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, exercise)
 }
 
+// handleDeleteExercise behandelt DELETE /api/v1/exercises/{id}.
+// Führt einen Soft-Delete durch (setzt deleted_at).
 func (h *Handler) handleDeleteExercise(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {

backend/internal/handler/handler.go

@@ -61,26 +61,32 @@ func (h *Handler) RegisterRoutes(mux *http.ServeMux) {
 
 // --- Hilfsfunktionen ---
 
+// writeJSON schreibt data als JSON mit dem angegebenen HTTP-Statuscode.
 func writeJSON(w http.ResponseWriter, status int, data any) {
 	w.Header().Set("Content-Type", "application/json")
 	w.WriteHeader(status)
 	json.NewEncoder(w).Encode(data)
 }
 
+// writeError schreibt eine Fehlerantwort im Format {"error": "..."}.
 func writeError(w http.ResponseWriter, status int, message string) {
 	writeJSON(w, status, map[string]string{"error": message})
 }
 
+// decodeJSON dekodiert den Request-Body als JSON in dst.
+// Unbekannte Felder werden als Fehler behandelt.
 func decodeJSON(r *http.Request, dst any) error {
 	dec := json.NewDecoder(r.Body)
 	dec.DisallowUnknownFields()
 	return dec.Decode(dst)
 }
 
+// pathID liest einen Integer-Pfadparameter aus dem Request.
 func pathID(r *http.Request, name string) (int64, error) {
 	return strconv.ParseInt(r.PathValue(name), 10, 64)
 }
 
+// queryInt liest einen Integer-Query-Parameter. Gibt defaultVal zurück wenn der Parameter fehlt oder ungültig ist.
 func queryInt(r *http.Request, name string, defaultVal int) int {
 	v := r.URL.Query().Get(name)
 	if v == "" {

backend/internal/handler/image_handler.go

@@ -1,8 +1,8 @@
 package handler
 
 import (
-	"fmt"
 	"io"
+	"log"
 	"net/http"
 	"os"
 	"path/filepath"
@@ -15,6 +15,7 @@ const (
 	uploadDir    = "uploads"
 )
 
+// handleListImages behandelt GET /api/v1/exercises/{id}/images.
 func (h *Handler) handleListImages(w http.ResponseWriter, r *http.Request) {
 	exerciseID, err := pathID(r, "id")
 	if err != nil {
@@ -30,6 +31,9 @@ func (h *Handler) handleListImages(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, images)
 }
 
+// handleUploadImage behandelt POST /api/v1/exercises/{id}/images.
+// Erwartet multipart/form-data mit Feld "image" (nur JPEG, max 5 MB).
+// Die Datei wird unter uploads/<uuid>.jpg gespeichert.
 func (h *Handler) handleUploadImage(w http.ResponseWriter, r *http.Request) {
 	exerciseID, err := pathID(r, "id")
 	if err != nil {
@@ -99,6 +103,8 @@ func (h *Handler) handleUploadImage(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, img)
 }
 
+// handleDeleteImage behandelt DELETE /api/v1/exercises/{id}/images/{imageId}.
+// Löscht den Datenbankeintrag und die zugehörige Datei vom Dateisystem.
 func (h *Handler) handleDeleteImage(w http.ResponseWriter, r *http.Request) {
 	imageID, err := pathID(r, "imageId")
 	if err != nil {
@@ -128,8 +134,8 @@ func (h *Handler) RegisterImageRoutes(mux *http.ServeMux) {
 	mux.Handle("GET /uploads/", http.StripPrefix("/uploads/",
 		http.FileServer(http.Dir(uploadDir))))
 
-	// uploads-Verzeichnis sicherstellen
+	// uploads-Verzeichnis beim Start sicherstellen
-	os.MkdirAll(uploadDir, 0755)
+	if err := os.MkdirAll(uploadDir, 0755); err != nil {
-
+		log.Printf("Warnung: Upload-Verzeichnis konnte nicht erstellt werden: %v", err)
-	fmt.Println("Bild-Upload konfiguriert:", uploadDir)
+	}
 }

backend/internal/handler/session.go

@@ -7,6 +7,9 @@ import (
 	"strings"
 )
 
+// handleGetActiveSession behandelt GET /api/v1/sessions/active.
+// Gibt die offene Session des Nutzers mit den Übungen des zugehörigen Sets zurück,
+// oder null wenn keine Session aktiv ist.
 func (h *Handler) handleGetActiveSession(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -37,6 +40,8 @@ func (h *Handler) handleGetActiveSession(w http.ResponseWriter, r *http.Request)
 	})
 }
 
+// handleCreateSession behandelt POST /api/v1/sessions.
+// Gibt 409 zurück wenn bereits eine offene Session existiert.
 func (h *Handler) handleCreateSession(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -70,6 +75,8 @@ func (h *Handler) handleCreateSession(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, session)
 }
 
+// handleListSessions behandelt GET /api/v1/sessions.
+// Unterstützt Query-Parameter: limit (Standard: 20) und offset (Standard: 0).
 func (h *Handler) handleListSessions(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -87,6 +94,7 @@ func (h *Handler) handleListSessions(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, sessions)
 }
 
+// handleGetSession behandelt GET /api/v1/sessions/{id}.
 func (h *Handler) handleGetSession(w http.ResponseWriter, r *http.Request) {
 	id, err := pathID(r, "id")
 	if err != nil {
@@ -106,6 +114,8 @@ func (h *Handler) handleGetSession(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, session)
 }
 
+// handleEndSession behandelt PUT /api/v1/sessions/{id}/end.
+// Beendet eine offene Session und speichert optional eine Notiz.
 func (h *Handler) handleEndSession(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -167,6 +177,9 @@ func (h *Handler) handleDeleteSession(w http.ResponseWriter, r *http.Request) {
 	w.WriteHeader(http.StatusNoContent)
 }
 
+// handleCreateLog behandelt POST /api/v1/sessions/{id}/logs.
+// Fügt einen Satz zu einer offenen Session hinzu.
+// Gibt 409 zurück bei doppelter (exercise_id, set_number)-Kombination.
 func (h *Handler) handleCreateLog(w http.ResponseWriter, r *http.Request) {
 	sessionID, err := pathID(r, "id")
 	if err != nil {
@@ -204,6 +217,8 @@ func (h *Handler) handleCreateLog(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, log)
 }
 
+// handleUpdateLog behandelt PUT /api/v1/sessions/{id}/logs/{logId}.
+// Alle Felder im Request sind optional (Partial Update).
 func (h *Handler) handleUpdateLog(w http.ResponseWriter, r *http.Request) {
 	sessionID, err := pathID(r, "id")
 	if err != nil {
@@ -242,6 +257,7 @@ func (h *Handler) handleUpdateLog(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, log)
 }
 
+// handleDeleteLog behandelt DELETE /api/v1/sessions/{id}/logs/{logId}.
 func (h *Handler) handleDeleteLog(w http.ResponseWriter, r *http.Request) {
 	sessionID, err := pathID(r, "id")
 	if err != nil {

backend/internal/handler/stats.go

@@ -2,6 +2,8 @@ package handler
 
 import "net/http"
 
+// handleGetLastLog behandelt GET /api/v1/exercises/{id}/last-log.
+// Gibt den zuletzt geloggten Satz der Übung zurück, oder 404 wenn noch kein Satz existiert.
 func (h *Handler) handleGetLastLog(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -26,6 +28,8 @@ func (h *Handler) handleGetLastLog(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, lastLog)
 }
 
+// handleGetExerciseHistory behandelt GET /api/v1/exercises/{id}/history.
+// Unterstützt Query-Parameter: limit (Standard: 30).
 func (h *Handler) handleGetExerciseHistory(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -47,6 +51,7 @@ func (h *Handler) handleGetExerciseHistory(w http.ResponseWriter, r *http.Reques
 	writeJSON(w, http.StatusOK, logs)
 }
 
+// handleGetStatsOverview behandelt GET /api/v1/stats/overview.
 func (h *Handler) handleGetStatsOverview(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {

backend/internal/handler/training_set.go

@@ -7,6 +7,7 @@ import (
 	"strings"
 )
 
+// handleListSets behandelt GET /api/v1/sets.
 func (h *Handler) handleListSets(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -22,6 +23,7 @@ func (h *Handler) handleListSets(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, sets)
 }
 
+// handleCreateSet behandelt POST /api/v1/sets.
 func (h *Handler) handleCreateSet(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -51,6 +53,8 @@ func (h *Handler) handleCreateSet(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, set)
 }
 
+// handleUpdateSet behandelt PUT /api/v1/sets/{id}.
+// Ersetzt Name und Übungszuordnungen vollständig.
 func (h *Handler) handleUpdateSet(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {
@@ -89,6 +93,8 @@ func (h *Handler) handleUpdateSet(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, set)
 }
 
+// handleDeleteSet behandelt DELETE /api/v1/sets/{id}.
+// Führt einen Soft-Delete durch (setzt deleted_at).
 func (h *Handler) handleDeleteSet(w http.ResponseWriter, r *http.Request) {
 	uid, err := userID(r)
 	if err != nil {

backend/internal/handler/user.go

@@ -7,6 +7,7 @@ import (
 	"strings"
 )
 
+// handleListUsers behandelt GET /api/v1/users.
 func (h *Handler) handleListUsers(w http.ResponseWriter, r *http.Request) {
 	users, err := h.store.ListUsers()
 	if err != nil {
@@ -16,6 +17,7 @@ func (h *Handler) handleListUsers(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusOK, users)
 }
 
+// handleCreateUser behandelt POST /api/v1/users.
 func (h *Handler) handleCreateUser(w http.ResponseWriter, r *http.Request) {
 	var req model.CreateUserRequest
 	if err := decodeJSON(r, &req); err != nil {
@@ -35,6 +37,8 @@ func (h *Handler) handleCreateUser(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, user)
 }
 
+// handleDeleteUser behandelt DELETE /api/v1/users/{id}.
+// Gibt 409 zurück wenn es sich um den letzten Nutzer handelt.
 func (h *Handler) handleDeleteUser(w http.ResponseWriter, r *http.Request) {
 	id, err := pathID(r, "id")
 	if err != nil {

backend/internal/store/session_store.go

@@ -157,6 +157,8 @@ func (s *Store) CreateLog(sessionID int64, req *model.CreateLogRequest) (*model.
 		return nil, err
 	}
 
+	// exercise_name wird denormalisiert gespeichert, damit historische Logs
+	// erhalten bleiben wenn die Übung später gelöscht wird.
 	var exerciseName string
 	err := s.db.QueryRow(`SELECT name FROM exercises WHERE id = ? AND deleted_at IS NULL`, req.ExerciseID).Scan(&exerciseName)
 	if err == sql.ErrNoRows {
@@ -197,6 +199,7 @@ func (s *Store) UpdateLog(sessionID, logID int64, req *model.UpdateLogRequest) (
 		return nil, nil
 	}
 
+	// Dynamisches UPDATE: nur explizit übergebene Felder werden geändert (Partial Update).
 	updates := []string{}
 	args := []any{}
 	if req.WeightKg != nil {
@@ -293,7 +296,8 @@ func (s *Store) DeleteSession(id, userID int64) error {
 	return nil
 }
 
-// checkSessionOpen prüft ob eine Session offen ist.
+// checkSessionOpen prüft ob eine Session existiert und noch nicht beendet wurde.
+// Gibt einen Fehler mit "SESSION_CLOSED" zurück wenn ended_at bereits gesetzt ist.
 func (s *Store) checkSessionOpen(sessionID int64) error {
 	var endedAt *string
 	err := s.db.QueryRow(`SELECT ended_at FROM sessions WHERE id = ?`, sessionID).Scan(&endedAt)
@@ -309,7 +313,7 @@ func (s *Store) checkSessionOpen(sessionID int64) error {
 	return nil
 }
 
-// getLog gibt einen einzelnen Log-Eintrag zurück.
+// getLog lädt einen einzelnen Session-Log-Eintrag anhand seiner ID.
 func (s *Store) getLog(id int64) (*model.SessionLog, error) {
 	var log model.SessionLog
 	err := s.db.QueryRow(`
@@ -325,7 +329,7 @@ func (s *Store) getLog(id int64) (*model.SessionLog, error) {
 	return &log, nil
 }
 
-// getSessionLogs gibt alle Logs einer Session zurück.
+// getSessionLogs lädt alle Logs einer Session, sortiert nach Übung und Satznummer.
 func (s *Store) getSessionLogs(sessionID int64) ([]model.SessionLog, error) {
 	rows, err := s.db.Query(`
 		SELECT id, session_id, exercise_id, exercise_name, set_number, weight_kg, reps, note, logged_at

backend/internal/store/set_store.go

@@ -168,7 +168,8 @@ func (s *Store) SoftDeleteSet(id, userID int64) error {
 	return nil
 }
 
-// getSetExercises lädt die Übungen eines Sets sortiert nach Position.
+// getSetExercises lädt die nicht-gelöschten Übungen eines Sets, sortiert nach Position.
+// Soft-gelöschte Übungen werden nicht zurückgegeben.
 func (s *Store) getSetExercises(setID int64) ([]model.Exercise, error) {
 	rows, err := s.db.Query(`
 		SELECT e.id, e.name, e.description, e.muscle_group, e.weight_step_kg, e.created_at, e.updated_at

backend/internal/store/stats_store.go

@@ -5,7 +5,7 @@ import (
 	"krafttrainer/internal/model"
 )
 
-// StatsOverview enthält die Gesamtübersicht.
+// StatsOverview enthält aggregierte Trainingsdaten eines Nutzers.
 type StatsOverview struct {
 	TotalSessions    int                   `json:"total_sessions"`
 	TotalVolumeKg    float64               `json:"total_volume_kg"`

backend/internal/store/user_store.go

@@ -59,6 +59,7 @@ func (s *Store) DeleteUser(id int64) error {
 	return nil
 }
 
+// getUser lädt einen Nutzer anhand seiner ID.
 func (s *Store) getUser(id int64) (*model.User, error) {
 	var u model.User
 	err := s.db.QueryRow(`SELECT id, name, created_at FROM users WHERE id = ?`, id).

frontend/src/api/client.ts

@@ -16,6 +16,11 @@ import type {
 } from '../types';
 import { getActiveUserId } from '../stores/userStore';
 
+/**
+ * Fehlerklasse für HTTP-Antworten mit Nicht-2xx-Statuscodes.
+ * Die `status`-Property enthält den HTTP-Statuscode für differenzierte
+ * Fehlerbehandlung im aufrufenden Code.
+ */
 export class ApiError extends Error {
   constructor(
     public status: number,
@@ -26,6 +31,11 @@ export class ApiError extends Error {
   }
 }
 
+/**
+ * Generische Hilfsfunktion für alle API-Aufrufe.
+ * Setzt automatisch den `Content-Type`- und `X-User-ID`-Header
+ * und wirft bei Nicht-2xx-Antworten eine `ApiError`.
+ */
 async function request<T>(
   url: string,
   options?: RequestInit,
@@ -52,6 +62,7 @@ async function request<T>(
   return data as T;
 }
 
+/** Typisiertes API-Objekt mit allen Backend-Endpunkten unter `/api/v1`. */
 export const api = {
   users: {
     list(): Promise<User[]> {
@@ -105,6 +116,10 @@ export const api = {
       return request<ExerciseImage[]>(`/api/v1/exercises/${id}/images`);
     },
 
+    /**
+     * Lädt ein Bild für eine Übung hoch (Multipart-Upload).
+     * Verwendet keinen JSON-Header, da `FormData` den Content-Type selbst setzt.
+     */
     async uploadImage(id: number, file: File): Promise<ExerciseImage> {
       const formData = new FormData();
       formData.append('image', file);

frontend/src/components/exercises/ExerciseCard.tsx

@@ -7,6 +7,10 @@ interface ExerciseCardProps {
   onDelete: (exercise: Exercise) => void;
 }
 
+/**
+ * Zeigt eine einzelne Übung als Karte mit Muskelgruppen-Badge,
+ * Gewichtsschritt und Aktions-Buttons für Bearbeiten und Löschen.
+ */
 export function ExerciseCard({ exercise, onEdit, onDelete }: ExerciseCardProps) {
   const label = MUSCLE_GROUP_LABELS[exercise.muscle_group] || exercise.muscle_group;
   const color = MUSCLE_GROUP_COLORS[exercise.muscle_group] || 'bg-gray-600';

frontend/src/components/exercises/ExerciseForm.tsx

@@ -4,11 +4,17 @@ import { MUSCLE_GROUPS } from '../../types';
 import { ImageGallery } from './ImageGallery';
 
 interface ExerciseFormProps {
+  /** Vorhandene Übung beim Bearbeiten; `null`/`undefined` beim Erstellen. */
   exercise?: Exercise | null;
   onSubmit: (data: CreateExerciseRequest) => void;
   onCancel: () => void;
 }
 
+/**
+ * Formular zum Erstellen und Bearbeiten einer Übung.
+ * Im Bearbeitungsmodus werden die vorhandenen Werte automatisch befüllt
+ * und die Bildergalerie der Übung angezeigt.
+ */
 export function ExerciseForm({ exercise, onSubmit, onCancel }: ExerciseFormProps) {
   const [name, setName] = useState('');
   const [description, setDescription] = useState('');

frontend/src/components/exercises/ExerciseList.tsx

@@ -9,6 +9,11 @@ interface ExerciseListProps {
   onDelete: (exercise: Exercise) => void;
 }
 
+/**
+ * Zeigt alle Übungen als gefilterte Liste.
+ * Filter nach Muskelgruppe und Freitext werden direkt im Store verwaltet
+ * und lösen automatisch einen Neuladevorgang aus.
+ */
 export function ExerciseList({ onEdit, onDelete }: ExerciseListProps) {
   const { exercises, loading, filter, fetchExercises, setFilter } = useExerciseStore();
 
@@ -18,7 +23,6 @@ export function ExerciseList({ onEdit, onDelete }: ExerciseListProps) {
 
   return (
     <div className="space-y-4">
-      {/* Filter-Bar */}
       <div className="flex flex-col sm:flex-row gap-2">
         <select
           value={filter.muscleGroup}
@@ -41,7 +45,6 @@ export function ExerciseList({ onEdit, onDelete }: ExerciseListProps) {
         />
       </div>
 
-      {/* Liste */}
       {loading ? (
         <div className="text-center text-gray-500 py-8">Laden...</div>
       ) : exercises.length === 0 ? (

frontend/src/components/exercises/ImageGallery.tsx

@@ -7,6 +7,11 @@ interface ImageGalleryProps {
   exerciseId: number;
 }
 
+/**
+ * Bildergalerie für eine Übung mit Upload- und Löschfunktion.
+ * Akzeptiert ausschließlich JPG-Dateien bis 5 MB.
+ * Ein Klick auf ein Bild öffnet eine Vollbildvorschau.
+ */
 export function ImageGallery({ exerciseId }: ImageGalleryProps) {
   const [images, setImages] = useState<ExerciseImage[]>([]);
   const [uploading, setUploading] = useState(false);
@@ -22,7 +27,7 @@ export function ImageGallery({ exerciseId }: ImageGalleryProps) {
       const imgs = await api.exercises.listImages(exerciseId);
       setImages(imgs || []);
     } catch {
-      // Fehler ignorieren
+      // Fehler ignorieren – Bilder sind optional
     }
   }
 

frontend/src/components/history/ExerciseChart.tsx

@@ -12,6 +12,10 @@ import { api } from '../../api/client';
 import { useExerciseStore } from '../../stores/exerciseStore';
 import type { SessionLog } from '../../types';
 
+/**
+ * Zeigt den Gewichtsverlauf einer ausgewählten Übung als Liniendiagramm.
+ * Pro Trainingstag wird das jeweils höchste verwendete Gewicht dargestellt.
+ */
 export function ExerciseChart() {
   const { exercises, fetchExercises } = useExerciseStore();
   const [selectedId, setSelectedId] = useState<number | null>(null);
@@ -32,7 +36,7 @@ export function ExerciseChart() {
     api.exercises
       .history(selectedId, 50)
       .then((logs: SessionLog[]) => {
-        // Gruppiere nach Datum, nehme max Gewicht pro Tag
+        // Pro Datum das Maximalgewicht ermitteln
         const byDate = new Map<string, number>();
         for (const log of logs) {
           const date = new Date(log.logged_at).toLocaleDateString('de-DE', {

frontend/src/components/history/SessionDetail.tsx

@@ -4,12 +4,16 @@ interface SessionDetailProps {
   logs: SessionLog[];
 }
 
+/**
+ * Zeigt alle protokollierten Sätze einer Session gruppiert nach Übung.
+ * Innerhalb jeder Übung sind die Sätze aufsteigend nach Satznummer sortiert.
+ */
 export function SessionDetail({ logs }: SessionDetailProps) {
   if (!logs || logs.length === 0) {
     return <p className="text-sm text-gray-500 py-2">Keine Sätze aufgezeichnet.</p>;
   }
 
-  // Gruppiere nach Übung
+  // Sätze nach Übungs-ID gruppieren
   const grouped = new Map<number, { name: string; logs: SessionLog[] }>();
   for (const log of logs) {
     if (!grouped.has(log.exercise_id)) {

frontend/src/components/history/SessionList.tsx

@@ -5,6 +5,11 @@ import type { Session } from '../../types';
 import { api, ApiError } from '../../api/client';
 import { useToastStore } from '../../stores/toastStore';
 
+/**
+ * Liste abgeschlossener Trainings-Sessions als aufklappbares Accordion.
+ * Beim Aufklappen einer Session werden deren Sätze per API nachgeladen.
+ * Laufende Sessions (ohne `ended_at`) können nicht gelöscht werden.
+ */
 export function SessionList() {
   const { sessions, loading, fetchSessions } = useHistoryStore();
   const [expandedId, setExpandedId] = useState<number | null>(null);
@@ -30,6 +35,7 @@ export function SessionList() {
     }
   };
 
+  /** Formatiert ein ISO-Datum als lokalisiertes Datum mit Uhrzeit. */
   const formatDate = (dateStr: string) => {
     return new Date(dateStr).toLocaleDateString('de-DE', {
       day: '2-digit',
@@ -40,6 +46,17 @@ export function SessionList() {
     });
   };
 
+  /** Berechnet Trainingsdauer als lesbaren String oder "laufend". */
+  const formatDuration = (start: string, end?: string) => {
+    if (!end) return 'laufend';
+    const ms = new Date(end).getTime() - new Date(start).getTime();
+    const mins = Math.round(ms / 60000);
+    if (mins < 60) return `${mins} Min.`;
+    const h = Math.floor(mins / 60);
+    const m = mins % 60;
+    return `${h}h ${m}m`;
+  };
+
   const handleDelete = async (e: React.MouseEvent, id: number) => {
     e.stopPropagation();
     if (!confirm('Session wirklich löschen? Alle Sätze werden unwiderruflich entfernt.')) return;
@@ -48,7 +65,7 @@ export function SessionList() {
     try {
       await api.sessions.delete(id);
       useToastStore.getState().addToast('success', 'Session erfolgreich gelöscht');
-      // Aufgeklappte Session schließen falls sie gerade gelöscht wurde
+      // Aufgeklappte Session schließen, falls sie gerade gelöscht wurde
       if (expandedId === id) {
         setExpandedId(null);
         setExpandedSession(null);
@@ -65,16 +82,6 @@ export function SessionList() {
     }
   };
 
-  const formatDuration = (start: string, end?: string) => {
-    if (!end) return 'laufend';
-    const ms = new Date(end).getTime() - new Date(start).getTime();
-    const mins = Math.round(ms / 60000);
-    if (mins < 60) return `${mins} Min.`;
-    const h = Math.floor(mins / 60);
-    const m = mins % 60;
-    return `${h}h ${m}m`;
-  };
-
   if (loading) {
     return <div className="text-center text-gray-500 py-8">Laden...</div>;
   }

frontend/src/components/layout/BottomNav.tsx

@@ -50,6 +50,7 @@ const navItems = [
   },
 ];
 
+/** Mobile Bottom-Navigation mit Links zu allen Hauptseiten. */
 export function BottomNav() {
   return (
     <nav className="md:hidden fixed bottom-0 left-0 right-0 bg-gray-900 border-t border-gray-800 z-40">
@@ -74,6 +75,7 @@ export function BottomNav() {
   );
 }
 
+/** Desktop-Seitenleiste mit Navigation und aktivem Nutzer-Indikator. */
 export function Sidebar() {
   const { activeUser } = useUserStore();
 

frontend/src/components/sets/SetDetail.tsx

@@ -5,6 +5,10 @@ interface SetDetailProps {
   trainingSet: TrainingSet;
 }
 
+/**
+ * Zeigt die Übungsliste eines Trainings-Sets mit Muskelgruppen-Badges.
+ * Wird in der Set-Übersicht als Detailansicht verwendet.
+ */
 export function SetDetail({ trainingSet }: SetDetailProps) {
   return (
     <div className="bg-gray-900 border border-gray-800 rounded-xl p-4">

frontend/src/components/sets/SetForm.tsx

@@ -4,11 +4,17 @@ import type { TrainingSet, MuscleGroup } from '../../types';
 import { MUSCLE_GROUPS, MUSCLE_GROUP_LABELS } from '../../types';
 
 interface SetFormProps {
+  /** Vorhandenes Set beim Bearbeiten; `null`/`undefined` beim Erstellen. */
   trainingSet?: TrainingSet | null;
   onSubmit: (name: string, exerciseIds: number[]) => void;
   onCancel: () => void;
 }
 
+/**
+ * Formular zum Erstellen und Bearbeiten eines Trainings-Sets.
+ * Übungen können nach Muskelgruppe gefiltert und per Checkbox ausgewählt werden.
+ * Die Reihenfolge der ausgewählten Übungen ist per Pfeil-Buttons sortierbar.
+ */
 export function SetForm({ trainingSet, onSubmit, onCancel }: SetFormProps) {
   const { exercises, fetchExercises } = useExerciseStore();
   const [name, setName] = useState('');
@@ -16,7 +22,7 @@ export function SetForm({ trainingSet, onSubmit, onCancel }: SetFormProps) {
   const [filterMg, setFilterMg] = useState<MuscleGroup | ''>('');
 
   useEffect(() => {
-    // Lade alle Übungen ohne Filter
+    // Alle Übungen ohne aktiven Filter laden
     useExerciseStore.getState().setFilter({ muscleGroup: '', query: '' });
     fetchExercises();
   }, [fetchExercises]);
@@ -66,6 +72,7 @@ export function SetForm({ trainingSet, onSubmit, onCancel }: SetFormProps) {
 
   const isValid = name.trim().length > 0 && selectedIds.length > 0;
 
+  /** Map für effizienten Zugriff auf Übungsnamen in der Reihenfolge-Ansicht. */
   const exerciseMap = new Map(exercises.map((e) => [e.id, e]));
 
   return (
@@ -86,7 +93,6 @@ export function SetForm({ trainingSet, onSubmit, onCancel }: SetFormProps) {
         />
       </div>
 
-      {/* Übungsauswahl */}
       <div>
         <label className="block text-sm text-gray-400 mb-1">Übungen auswählen *</label>
         <select
@@ -127,7 +133,6 @@ export function SetForm({ trainingSet, onSubmit, onCancel }: SetFormProps) {
         </div>
       </div>
 
-      {/* Sortierbare ausgewählte Übungen */}
       {selectedIds.length > 0 && (
         <div>
           <label className="block text-sm text-gray-400 mb-1">

frontend/src/components/sets/SetList.tsx

@@ -7,6 +7,10 @@ interface SetListProps {
   onDelete: (set: TrainingSet) => void;
 }
 
+/**
+ * Listet alle Trainings-Sets mit ihren Übungen sowie Bearbeiten-
+ * und Löschen-Aktionen auf.
+ */
 export function SetList({ onEdit, onDelete }: SetListProps) {
   const { sets, loading, fetchSets } = useSetStore();
 

frontend/src/components/training/ActiveSession.tsx

@@ -8,9 +8,15 @@ import { ExerciseSparkline } from './ExerciseSparkline';
 import type { Exercise, SessionLog } from '../../types';
 
 interface ActiveSessionProps {
+  /** Wird aufgerufen, nachdem das Training erfolgreich beendet wurde. */
   onEnd: () => void;
 }
 
+/**
+ * Hauptansicht einer laufenden Trainings-Session.
+ * Zeigt alle Übungen des Sets als aufklappbares Accordion mit
+ * Fortschritts-Sparkline, letzten Trainingswerten und Satz-Eingabeformular.
+ */
 export function ActiveSession({ onEnd }: ActiveSessionProps) {
   const { session, exercises, lastLogs, addLog, updateLog, deleteLog, endSession } =
     useActiveSessionStore();
@@ -22,11 +28,13 @@ export function ActiveSession({ onEnd }: ActiveSessionProps) {
 
   const logs = session.logs || [];
 
+  /** Gibt alle protokollierten Sätze für eine Übung sortiert nach Satznummer zurück. */
   const getExerciseLogs = (exerciseId: number) =>
     logs
       .filter((l) => l.exercise_id === exerciseId)
       .sort((a, b) => a.set_number - b.set_number);
 
+  /** Berechnet die nächste Satznummer als Maximum der bisherigen + 1. */
   const getNextSetNumber = (exerciseId: number) => {
     const exLogs = getExerciseLogs(exerciseId);
     return exLogs.length > 0 ? Math.max(...exLogs.map((l) => l.set_number)) + 1 : 1;
@@ -93,7 +101,6 @@ export function ActiveSession({ onEnd }: ActiveSessionProps) {
 
       <RestTimer />
 
-      {/* Übungen als Accordion */}
       {exercises.map((exercise) => {
         const exLogs = getExerciseLogs(exercise.id);
         const isExpanded = expandedExercise === exercise.id;
@@ -104,7 +111,6 @@ export function ActiveSession({ onEnd }: ActiveSessionProps) {
             key={exercise.id}
             className="bg-gray-900 border border-gray-800 rounded-xl overflow-hidden"
           >
-            {/* Header */}
             <button
               onClick={() => toggleExercise(exercise.id)}
               className="w-full flex items-center justify-between px-4 py-3 min-h-[44px] text-left hover:bg-gray-800/50"
@@ -131,20 +137,16 @@ export function ActiveSession({ onEnd }: ActiveSessionProps) {
               </svg>
             </button>
 
-            {/* Expanded content */}
             {isExpanded && (
               <div className="px-4 pb-4 space-y-3">
-                {/* Fortschritts-Sparkline */}
                 <ExerciseSparkline exerciseId={exercise.id} />
 
-                {/* Vorherige Werte */}
                 {lastLog && (
                   <div className="text-sm text-gray-500 bg-gray-800 rounded-lg px-3 py-2">
                     Letztes Training: {lastLog.weight_kg} kg x {lastLog.reps} Wdh.
                   </div>
                 )}
 
-                {/* Bisherige Sätze */}
                 {exLogs.map((log) => (
                   <div key={log.id}>
                     {editingLog?.id === log.id ? (
@@ -198,7 +200,11 @@ export function ActiveSession({ onEnd }: ActiveSessionProps) {
                   </div>
                 ))}
 
-                {/* Neuer Satz — Werte vom letzten Satz dieser Session, sonst vom letzten Training */}
+                {/*
+                  Formular für neuen Satz: Vorausfüllung mit Werten des letzten Satzes
+                  dieser Session, falls vorhanden, sonst mit dem letzten Trainingseintrag.
+                  Der key-Wechsel erzwingt Reset des Formularzustands bei jedem neuen Satz.
+                */}
                 <LogEntryForm
                   key={`new-${exercise.id}-${exLogs.length}`}
                   exercise={exercise}
@@ -213,7 +219,6 @@ export function ActiveSession({ onEnd }: ActiveSessionProps) {
         );
       })}
 
-      {/* Training beenden */}
       <button
         onClick={handleEndSession}
         className="w-full bg-red-600 hover:bg-red-500 text-white font-semibold rounded-xl py-4 min-h-[44px]"

frontend/src/components/training/ExerciseSparkline.tsx

@@ -18,12 +18,20 @@ interface DataPoint {
   e1rm: number;
 }
 
-// Epley-Formel: e1RM = Gewicht × (1 + Wdh / 30)
+/**
+ * Berechnet den geschätzten 1-Wiederholungs-Maximalwert (e1RM) nach der Epley-Formel:
+ * e1RM = Gewicht × (1 + Wiederholungen / 30)
+ */
 function calcE1RM(weight: number, reps: number): number {
   if (reps <= 0 || weight <= 0) return 0;
   return Math.round(weight * (1 + reps / 30) * 10) / 10;
 }
 
+/**
+ * Kompaktes Liniendiagramm (Sparkline) für den e1RM-Verlauf einer Übung.
+ * Pro Trainings-Session wird der beste e1RM-Wert dargestellt.
+ * Rendert nichts, wenn weniger als 2 Datenpunkte vorhanden sind.
+ */
 export function ExerciseSparkline({ exerciseId }: ExerciseSparklineProps) {
   const [data, setData] = useState<DataPoint[]>([]);
 
@@ -31,7 +39,7 @@ export function ExerciseSparkline({ exerciseId }: ExerciseSparklineProps) {
     api.exercises
       .history(exerciseId, 100)
       .then((logs: SessionLog[]) => {
-        // Gruppiere nach Session (= Trainingstag), nimm bestes e1RM pro Session
+        // Pro Session den besten e1RM ermitteln
         const bySession = new Map<number, { date: string; e1rm: number }>();
         for (const log of logs) {
           const e1rm = calcE1RM(log.weight_kg, log.reps);
@@ -46,6 +54,7 @@ export function ExerciseSparkline({ exerciseId }: ExerciseSparklineProps) {
             });
           }
         }
+        // API liefert neueste Einträge zuerst; umkehren für chronologische Darstellung
         const points = Array.from(bySession.values()).reverse();
         setData(points);
       })

frontend/src/components/training/LogEntryForm.tsx

@@ -7,9 +7,15 @@ interface LogEntryFormProps {
   initialWeight?: number;
   initialReps?: number;
   onSubmit: (weight: number, reps: number, note: string) => void;
+  /** Beschriftung des Speichern-Buttons; Standard: "Satz speichern". */
   submitLabel?: string;
 }
 
+/**
+ * Eingabeformular für einen einzelnen Trainingssatz.
+ * Gewicht wird in Schritten von `exercise.weight_step_kg` angepasst,
+ * Wiederholungen in Einerschritten. Nach dem Speichern wird die Notiz geleert.
+ */
 export function LogEntryForm({
   exercise,
   setNumber,
@@ -41,7 +47,6 @@ export function LogEntryForm({
     <div className="space-y-4 bg-gray-800 rounded-lg p-4">
       <div className="text-sm text-gray-400">Satz {setNumber}</div>
 
-      {/* Gewicht */}
       <div>
         <label className="block text-sm text-gray-400 mb-2">Gewicht (kg)</label>
         <div className="flex items-center gap-2 justify-center">
@@ -84,7 +89,6 @@ export function LogEntryForm({
         </div>
       </div>
 
-      {/* Wiederholungen */}
       <div>
         <label className="block text-sm text-gray-400 mb-2">Wiederholungen</label>
         <div className="flex items-center gap-2 justify-center">
@@ -112,7 +116,6 @@ export function LogEntryForm({
         </div>
       </div>
 
-      {/* Notiz */}
       <div>
         <input
           type="text"

frontend/src/components/training/RestTimer.tsx

@@ -1,13 +1,20 @@
 import { useActiveSessionStore } from '../../stores/activeSessionStore';
 
+/** Voreingestellte Pausenzeiten in Sekunden. */
 const PRESETS = [60, 90, 120, 180];
 
+/**
+ * Pause-Timer für die aktive Trainings-Session.
+ * Zeigt bei laufendem Timer Countdown und Fortschrittsbalken an;
+ * andernfalls Schnellauswahl-Buttons für die vordefinierten Pausenzeiten.
+ */
 export function RestTimer() {
   const { timerSeconds, timerTarget, startTimer, stopTimer } = useActiveSessionStore();
   const isRunning = timerSeconds > 0;
 
   const progress = timerTarget > 0 ? ((timerTarget - timerSeconds) / timerTarget) * 100 : 0;
 
+  /** Formatiert Sekunden als `m:ss`. */
   const formatTime = (s: number) => {
     const mins = Math.floor(s / 60);
     const secs = s % 60;

frontend/src/stores/activeSessionStore.ts

@@ -13,8 +13,11 @@ import { useToastStore } from './toastStore';
 interface ActiveSessionState {
   session: Session | null;
   exercises: Exercise[];
+  /** Zuletzt protokollierte Werte pro Übungs-ID – wird für Vorausfüllung genutzt. */
   lastLogs: Map<number, LastLogResponse>;
+  /** Verbleibende Sekunden des laufenden Pause-Timers. */
   timerSeconds: number;
+  /** Ursprünglich eingestellte Sekunden – für Fortschrittsbalken-Berechnung. */
   timerTarget: number;
   timerInterval: ReturnType<typeof setInterval> | null;
 
@@ -32,6 +35,13 @@ interface ActiveSessionState {
   clearSession: () => void;
 }
 
+/**
+ * Store für die laufende Trainings-Session.
+ *
+ * Verwaltet Session-Zustand, protokollierte Sätze, letzte Trainingswerte
+ * und den Pause-Timer. Der Timer-Interval wird manuell verwaltet;
+ * beim Stopp muss `stopTimer()` explizit aufgerufen werden.
+ */
 export const useActiveSessionStore = create<ActiveSessionState>((set, get) => ({
   session: null,
   exercises: [],
@@ -45,7 +55,7 @@ export const useActiveSessionStore = create<ActiveSessionState>((set, get) => ({
       const session = await api.sessions.create({ set_id: setId });
       set({ session, exercises });
 
-      // Lade letzte Logs für alle Übungen
+      // Letzte Logs für alle Übungen vorladen, um Formular-Vorausfüllung zu ermöglichen
       for (const ex of exercises) {
         await get().fetchLastLog(ex.id);
       }
@@ -65,7 +75,6 @@ export const useActiveSessionStore = create<ActiveSessionState>((set, get) => ({
 
       set({ session: result.session, exercises: result.exercises || [] });
 
-      // Lade letzte Logs für alle Übungen
       for (const ex of (result.exercises || [])) {
         await get().fetchLastLog(ex.id);
       }
@@ -93,7 +102,7 @@ export const useActiveSessionStore = create<ActiveSessionState>((set, get) => ({
     if (!session) return null;
     try {
       const log = await api.sessions.createLog(session.id, data);
-      // Reload session to get updated logs
+      // Session neu laden, damit die Logs-Liste aktuell ist
       const updated = await api.sessions.get(session.id);
       set({ session: updated });
       return log;
@@ -161,7 +170,7 @@ export const useActiveSessionStore = create<ActiveSessionState>((set, get) => ({
       });
       return lastLog;
     } catch {
-      // 404 = noch kein Log vorhanden
+      // 404 bedeutet: noch kein Trainingseintrag für diese Übung vorhanden
       return null;
     }
   },

frontend/src/stores/exerciseStore.ts

@@ -3,6 +3,7 @@ import { api } from '../api/client';
 import type { Exercise, MuscleGroup, CreateExerciseRequest } from '../types';
 import { useToastStore } from './toastStore';
 
+/** Filterkriterien für die Übungsliste. */
 interface ExerciseFilter {
   muscleGroup: MuscleGroup | '';
   query: string;
@@ -20,6 +21,7 @@ interface ExerciseState {
   setFilter: (filter: Partial<ExerciseFilter>) => void;
 }
 
+/** Store für Übungsverwaltung inkl. Filterung und CRUD-Operationen. */
 export const useExerciseStore = create<ExerciseState>((set, get) => ({
   exercises: [],
   loading: false,

frontend/src/stores/historyStore.ts

@@ -12,6 +12,7 @@ interface HistoryState {
   fetchStats: () => Promise<void>;
 }
 
+/** Store für Trainings-Historie und Übungsstatistiken. */
 export const useHistoryStore = create<HistoryState>((set) => ({
   sessions: [],
   loading: false,

frontend/src/stores/setStore.ts

@@ -13,6 +13,7 @@ interface SetState {
   deleteSet: (id: number) => Promise<boolean>;
 }
 
+/** Store für Trainings-Sets inkl. CRUD-Operationen. */
 export const useSetStore = create<SetState>((set, get) => ({
   sets: [],
   loading: false,

frontend/src/stores/toastStore.ts

@@ -1,5 +1,6 @@
 import { create } from 'zustand';
 
+/** Eine einzelne Toast-Benachrichtigung. */
 export interface Toast {
   id: string;
   type: 'success' | 'error' | 'info';
@@ -12,6 +13,13 @@ interface ToastState {
   removeToast: (id: string) => void;
 }
 
+/**
+ * Store für temporäre Benachrichtigungen.
+ *
+ * Toasts verschwinden nach 3 Sekunden automatisch.
+ * Wird aus anderen Stores via `useToastStore.getState().addToast()` aufgerufen,
+ * um Store-zu-Store-Abhängigkeiten zu vermeiden.
+ */
 export const useToastStore = create<ToastState>((set) => ({
   toasts: [],
 

frontend/src/stores/userStore.ts

@@ -11,6 +11,16 @@ interface UserState {
   deleteUser: (id: number) => Promise<boolean>;
 }
 
+/**
+ * Store für Nutzerverwaltung.
+ *
+ * Der aktive Nutzer wird im localStorage persistiert (`activeUser`-Feld),
+ * damit die Auswahl nach einem Seitenneustart erhalten bleibt.
+ *
+ * Dieser Store verwendet bewusst direkte `fetch`-Aufrufe statt `api/client.ts`,
+ * da `api/client.ts` seinerseits `getActiveUserId()` aus diesem Store liest
+ * und ein zirkulärer Import vermieden werden muss.
+ */
 export const useUserStore = create<UserState>()(
   persist(
     (set, get) => ({
@@ -27,7 +37,7 @@ export const useUserStore = create<UserState>()(
         const users: User[] = await res.json();
         set({ users });
 
-        // Aktiven Nutzer aktualisieren falls er sich geändert hat
+        // Aktiven Nutzer aktualisieren, falls sich seine Daten geändert haben
         const { activeUser } = get();
         if (activeUser) {
           const updated = users.find((u) => u.id === activeUser.id);
@@ -64,7 +74,10 @@ export const useUserStore = create<UserState>()(
   ),
 );
 
-// Gibt die aktive User-ID zurück — wird von api/client.ts verwendet.
+/**
+ * Gibt die ID des aktiven Nutzers als String zurück.
+ * Wird von `api/client.ts` verwendet, um den `X-User-ID`-Header zu setzen.
+ */
 export function getActiveUserId(): string | null {
   const { activeUser } = useUserStore.getState();
   return activeUser ? String(activeUser.id) : null;

frontend/src/types/index.ts

@@ -1,3 +1,4 @@
+/** Bezeichner für Muskelgruppen – spiegeln die DB-Enum-Werte wider. */
 export type MuscleGroup =
   | 'brust'
   | 'ruecken'
@@ -9,6 +10,7 @@ export type MuscleGroup =
   | 'ganzkoerper'
   | 'sonstiges';
 
+/** Alle Muskelgruppen mit Anzeigebezeichnungen für Select-Felder. */
 export const MUSCLE_GROUPS: { value: MuscleGroup; label: string }[] = [
   { value: 'brust', label: 'Brust' },
   { value: 'ruecken', label: 'Rücken' },
@@ -21,6 +23,7 @@ export const MUSCLE_GROUPS: { value: MuscleGroup; label: string }[] = [
   { value: 'sonstiges', label: 'Sonstiges' },
 ];
 
+/** Anzeigebezeichnungen für Muskelgruppen, direkt per Schlüssel abrufbar. */
 export const MUSCLE_GROUP_LABELS: Record<MuscleGroup, string> = {
   brust: 'Brust',
   ruecken: 'Rücken',
@@ -33,6 +36,7 @@ export const MUSCLE_GROUP_LABELS: Record<MuscleGroup, string> = {
   sonstiges: 'Sonstiges',
 };
 
+/** Tailwind-Hintergrundfarben für Muskelgruppen-Badges. */
 export const MUSCLE_GROUP_COLORS: Record<MuscleGroup, string> = {
   brust: 'bg-red-600',
   ruecken: 'bg-blue-600',
@@ -45,18 +49,21 @@ export const MUSCLE_GROUP_COLORS: Record<MuscleGroup, string> = {
   sonstiges: 'bg-gray-600',
 };
 
+/** Eine einzelne Kraftübung aus der Datenbank. */
 export interface Exercise {
   id: number;
   name: string;
   description: string;
   muscle_group: MuscleGroup;
   weight_step_kg: number;
+  /** Optionale Nummerierung aus dem Übungskatalog (UF#). */
   exercise_number?: number;
   created_at: string;
   updated_at: string;
   deleted_at?: string;
 }
 
+/** Ein Trainings-Set: Sammlung von Übungen, die gemeinsam trainiert werden. */
 export interface TrainingSet {
   id: number;
   name: string;
@@ -65,6 +72,11 @@ export interface TrainingSet {
   deleted_at?: string;
 }
 
+/**
+ * Ein einzelner protokollierter Satz innerhalb einer Trainings-Session.
+ * Der Übungsname wird denormalisiert gespeichert, damit gelöschte Übungen
+ * historische Einträge nicht verwaisen lassen.
+ */
 export interface SessionLog {
   id: number;
   session_id: number;
@@ -77,6 +89,7 @@ export interface SessionLog {
   logged_at: string;
 }
 
+/** Eine Trainings-Session, optional mit allen protokollierten Sätzen. */
 export interface Session {
   id: number;
   set_id: number;
@@ -87,11 +100,13 @@ export interface Session {
   logs?: SessionLog[];
 }
 
+/** Antwort des Endpunkts "letztes Training" für eine Übung. */
 export interface LastLogResponse {
   weight_kg: number;
   reps: number;
 }
 
+/** Aggregierte Statistiken für eine einzelne Übung. */
 export interface ExerciseStats {
   exercise_id: number;
   exercise_name: string;
@@ -101,6 +116,7 @@ export interface ExerciseStats {
   last_trained: string;
 }
 
+/** Metadaten eines hochgeladenen Übungsbilds. */
 export interface ExerciseImage {
   id: number;
   exercise_id: number;
@@ -109,6 +125,7 @@ export interface ExerciseImage {
   created_at: string;
 }
 
+/** Request-Body zum Erstellen oder Aktualisieren einer Übung. */
 export interface CreateExerciseRequest {
   name: string;
   description: string;
@@ -117,30 +134,36 @@ export interface CreateExerciseRequest {
   exercise_number?: number;
 }
 
+/** Request-Body zum Erstellen eines Trainings-Sets. */
 export interface CreateSetRequest {
   name: string;
   exercise_ids: number[];
 }
 
+/** Request-Body zum Aktualisieren eines Trainings-Sets. */
 export interface UpdateSetRequest {
   name: string;
   exercise_ids: number[];
 }
 
+/** Request-Body zum Starten einer neuen Trainings-Session. */
 export interface CreateSessionRequest {
   set_id: number;
 }
 
+/** Anwendungsnutzer. */
 export interface User {
   id: number;
   name: string;
   created_at: string;
 }
 
+/** Request-Body zum Anlegen eines neuen Nutzers. */
 export interface CreateUserRequest {
   name: string;
 }
 
+/** Request-Body zum Protokollieren eines Satzes in einer laufenden Session. */
 export interface CreateLogRequest {
   exercise_id: number;
   set_number: number;
@@ -149,6 +172,7 @@ export interface CreateLogRequest {
   note: string;
 }
 
+/** Request-Body zum nachträglichen Bearbeiten eines protokollierten Satzes. */
 export interface UpdateLogRequest {
   weight_kg?: number;
   reps?: number;