Dokumentation und Installationsanleitung: Liegestütz-Trainingsapp v7.0

Dieser Beitrag beschreibt die Funktionsweise und Installation der Liegestütz-Trainingsapp Version 7.0. Die Anwendung dient der Protokollierung und Planung von Trainingseinheiten und kann auf einem eigenen Webserver betrieben werden.

Installation

Die Installation der Webanwendung erfolgt automatisiert über ein PHP-Skript. Es sind keine manuellen Eingriffe in Konfigurationsdateien oder Datenbanken erforderlich.

Vorgehensweise

1. Upload: Laden Sie die Datei install.php in das gewünschte Verzeichnis auf Ihrem Webserver hoch.
2. Aufruf: Rufen Sie die Datei im Browser auf (z.B. ihre-domain.de/install.php).
3. Konfiguration: Ein Formular fragt die grundlegenden Parameter für Ihren Trainingsplan ab:
   • Startdatum: Beginn des Trainingszyklus.
   • Zieldatum: Datum, bis zu dem das Ziel erreicht werden soll.
   • Ziel: Anzahl der angestrebten Liegestütze (z.B. 50).
   • Titel: Name der Anwendung (wird im Header angezeigt).
   • Trainingsplan: Auswahl des Rhythmus für Krafttraining (Mo/Mi/Fr oder Di/Do/Sa).
   • Ruhetag: Festlegung eines fixen Ruhetags in der Woche.

[Bild des Installationsformulars]

Nach Bestätigung der Eingaben generiert das Skript alle notwendigen PHP-, JSON- und Textdateien, legt die Ordnerstruktur an und leitet zur Startseite weiter.

Funktionsumfang der Webapp (v7.0)

Die Anwendung ist als Single-Page-Applikation (im weiteren Sinne) konzipiert, die verschiedene Trainingsaspekte abdeckt. Die Datenhaltung erfolgt dateibasiert (JSON/TXT).

• Dashboard (index.php):
  • Zeigt den aktuellen Tagesplan basierend auf der berechneten Trainingswoche an.
  • Ermöglicht das Abhaken von Übungen.
  • Bietet ein Textfeld für tägliche Notizen.
  • Zusätzlich absolvierte Übungen (die nicht im regulären Plan stehen) werden dynamisch am Ende der Tagesliste eingeblendet.
• Backend (backend.php):
  • Verwaltung aller Übungen (Hinzufügen, Bearbeiten, Löschen).
  • Zuweisung von Übungen zu Kategorien (Kraft, Kardio, Unterwegs, Zusatz).
  • Definition von Gültigkeitszeiträumen für Übungen (Start- und Enddatum).
  • Erstellung eigener Kategorien (z.B. „Calisthenics“).
• Bild-Dokumentation (picture.php):
  • Upload von Fortschrittsfotos (Speicherung im Ordner pix/).
  • Automatische Erstellung von Thumbnails (250px Breite).
  • Erfassung von Gewicht und Notizen zu jedem Bild.
  • Galerieansicht mit Modal zur Großansicht und Rotationsfunktion.
• Alternative Trainingsmodi:
  • Unterwegs: Möglichkeit, an Kraft-Tagen per Klick auf ein alternatives Übungsset (ohne Geräte) zu wechseln.
  • Zusatztraining: Separate Bereiche für zusätzliche Übungen, die optional durchgeführt werden können.

Systemvoraussetzungen

Die Anwendung stellt geringe Anforderungen an die Hosting-Umgebung. Eine SQL-Datenbank ist nicht erforderlich.

Serveranforderungen

1. PHP Version: Mindestens PHP 7.4, empfohlen wird PHP 8.0 oder höher.
2. PHP-Erweiterungen:
   • json (für Datenhaltung)
   • gd (für die Erstellung von Thumbnails beim Bildupload)
3. Dateiberechtigungen: Der Webserver benötigt Schreibrechte im Installationsverzeichnis, um Dateien zu erstellen und Daten (Logs, JSON) zu aktualisieren.

Hier gibt es noch die aktuelle Dokumentation. Wenn diese im Hauptordner abgelegt wird, erscheint sie beim Klick auf die Versionsnummer.

Haftungsausschluss

Diese Software wird als Open-Source-Projekt zur Verfügung gestellt. Es wird keine Gewährleistung für die Funktionalität, Datensicherheit oder die Eignung für einen bestimmten Zweck übernommen. Die Nutzung erfolgt auf eigene Verantwortung. Es wird empfohlen, regelmäßige Backups der Dateien *.json und *.txt sowie des Ordners pix/ anzulegen.