Glueck-Auf/README.md

# Glück Auf – Persönliche Webseite

Persönliches Lernprojekt mit einer Flask-Anwendung und mehreren statischen
HTML-Seiten. Die Flask-App bildet einen kleinen Stadion-Escape-Room ab, in dem
ein Zahlencode eingegeben und serverseitig geprüft wird. Der bisherige
statische Teil besitzt ein gemeinsames Design, einen Dark-Mode-Umschalter und
kleine JavaScript-Übungen.

## Pfad auf dem Server

Der bisher dokumentierte Serverpfad lautet:

```text
/home/isa7/public_html
```

## Projektstruktur

```text
Glueck-Auf/
├── flask_app/
│   ├── app.py                  Flask-Anwendung und Routen
│   ├── templates/
│   │   ├── base.html           Gemeinsames Layout und Styling
│   │   ├── index.html          Startseite des Stadion-Escape-Rooms
│   │   └── raetsel.html        Rätselseite mit Formular
│   └── assets/
│       ├── css/                Platz für ausgelagerte Stylesheets
│       ├── img/                Platz für Bilder
│       └── js/                 Platz für JavaScript
│
├── index.html                  Startseite der bisherigen statischen Website
├── ueber_mich.html             Persönliche Vorstellungsseite
├── eis_projekt.html            Projektseite
├── kontakt.html                Kontaktseite
├── impressum.html              Impressum mit Platzhalterangaben
├── README.md                   Diese Datei
│
├── css/
│   └── style.css               Stylesheet der statischen Seiten
├── img/
│   ├── Hintergrund.jpg         Hero-Hintergrund der statischen Startseite
│   └── logo.png                Logo und Favicon
├── js/
│   ├── script.js               Dark Mode und Dropdown-Menü
│   ├── notenrechner.js         Logik des Notenrechners
│   └── textanalyse.js          Logik der Textanalyse
├── uebungen/
│   ├── notenrechner.html       JavaScript-Übung
│   └── textanalyse.html        JavaScript-Übung
└── python training/
    ├── frage.py                Frühere Python-Übung
    └── hallo.py                Frühere Python-Übung
```

## Flask-App lokal starten

Vorausgesetzt werden Python 3 und Flask.

```bash
cd flask_app
python3 -m venv venv
source venv/bin/activate
python3 -m pip install Flask
python3 app.py
```

Die Anwendung läuft anschließend auf:

```text
http://localhost:9007/
```

Der Entwicklungsserver lauscht auf `0.0.0.0` und verwendet Port `9007`.

## Flask-Routen

| Route | Methoden | Inhalt |
| --- | --- | --- |
| `/` und `/app/` | GET | Startseite des Stadion-Escape-Rooms |
| `/raetsel` und `/app/raetsel` | GET, POST | Rätsel am Stadiontor |
| `/frage` und `/app/frage` | GET, POST | Alternative Adressen für dieselbe Rätselseite |

Die Routen funktionieren jeweils auch mit abschließendem Schrägstrich.

## Aufbau der Flask-App

### `flask_app/app.py`

- Erstellt die Flask-Anwendung.
- Rendert die HTML-Seiten mit Jinja.
- Nimmt die Antwort des Rätsel-Formulars per `POST` entgegen.
- Vergleicht die Eingabe mit dem gesuchten Code `4`.
- Übergibt die passende Rückmeldung an das Template.
- Stellt zukünftige statische Dateien aus `flask_app/assets/` unter
  `/assets` bereit.

### Templates

`base.html` enthält das gemeinsame HTML-Grundgerüst, die Navigation und das
aktuelle Styling. `index.html` und `raetsel.html` erweitern dieses
Basis-Template mit Jinja-Blöcken.

Die Startseite führt in den Stadiongang ein. Auf der Rätselseite kann der Code
für das Stadiontor eingegeben werden. Die Auswertung erfolgt durch Flask auf
dem Server und wird anschließend auf derselben Seite angezeigt.

### Ablauf des Rätsels

1. Die Startseite wird über `/` oder `/app/` aufgerufen.
2. Der Link „Zum Stadiontor“ führt zur Rätselseite.
3. Das Formular sendet die eingegebene Antwort mit der Methode `POST` an
   dieselbe Route.
4. Flask liest den Wert aus `request.form["antwort"]`.
5. Bei der Antwort `4` wird eine Erfolgsmeldung angezeigt, bei jeder anderen
   Eingabe eine Fehlermeldung.

Die Rückmeldung wird in `app.py` erzeugt und als Variable `ergebnis` an
`raetsel.html` übergeben. Jinja zeigt den Ergebnisbereich nur an, wenn diese
Variable vorhanden ist.

### Gemeinsames Template `base.html`

Das Basis-Template stellt die wiederverwendbaren Bestandteile der Flask-Seiten
bereit:

- HTML-Grundgerüst und deutsche Spracheinstellung,
- responsive Meta-Angaben,
- Google Fonts,
- Navigation zur Start- und Rätselseite,
- gemeinsames blaues Stadion-Design,
- responsive Darstellung für kleinere Bildschirme,
- Jinja-Blöcke für Seitentitel und Seiteninhalt.

Die beiden Unterseiten verwenden `{% extends "base.html" %}`. Dadurch müssen
Navigation, Layout und Styling nicht in jeder Datei wiederholt werden.

### Vorbereitete Assets

Flask wurde mit folgendem Verzeichnis für statische Dateien eingerichtet:

```text
flask_app/assets/
```

Dateien aus diesem Verzeichnis wären unter `/assets/...` erreichbar. Die
Unterordner `css`, `img` und `js` sind bereits angelegt, derzeit aber noch
leer. Das CSS der Flask-App steht deshalb momentan direkt in `base.html`.

## Statische Website

Die älteren statischen Seiten bleiben im Hauptverzeichnis erhalten. Sie
verwenden gemeinsam `css/style.css` und `js/script.js` und enthalten unter
anderem:

- eine persönliche Start- und Vorstellungsseite,
- eine Projekt-, Kontakt- und Impressumsseite,
- einen Dark-Mode-Umschalter,
- einen Notenrechner,
- eine einfache Textanalyse.

Die statische Website und die Flask-App sind derzeit getrennte Bereiche des
Projekts. Die Dateien in den Verzeichnissen `css/`, `img/` und `js/` gehören
zu den statischen HTML-Seiten. Für die Flask-App ist das Verzeichnis
`flask_app/assets/` vorgesehen.

### `index.html` – Startseite

- Einstiegspunkt der statischen Website,
- Hero-Bereich mit Hintergrundbild,
- Begrüßungstext mit Link zu `ueber_mich.html`,
- verlinkte Cards zu „Über mich“, Projekten und Kontakt,
- Navigation mit Dropdown zu den Übungen,
- Footer mit Links zu Kontakt und Impressum.

### `ueber_mich.html` – Über mich

- persönliche Vorstellungsseite,
- aktuell mit kurzen Platzhaltertexten,
- Skill-Badges für HTML, CSS, JavaScript, Python, Webdesign und Linux,
- gemeinsames Layout, Navigation und Dark Mode.

### `eis_projekt.html` – Projektseite

- Seite für das Glück-Auf-Lernprojekt,
- Projektinhalt aktuell noch als Platzhalter vorbereitet,
- verwendet das gemeinsame Layout, die Navigation und den Dark Mode.

### `kontakt.html` – Kontakt

- gestaltetes Kontaktformular,
- Eingabefelder für Name, E-Mail und Nachricht,
- Hinweis, dass das Formular aktuell nur ein Layout ist,
- Absenden-Button aktuell nur visuell vorhanden,
- keine Backend-Anbindung und keine Formularübertragung.

### `impressum.html` – Impressum

- Impressumsseite für ein privates Lernprojekt,
- Abschnitte zu Angaben, Kontakt, Verantwortung, Haftung, Links,
  Urheberrecht und Hinweis,
- ausschließlich fiktive Platzhalterdaten, die nicht für eine öffentliche
  Veröffentlichung gedacht sind.

## JavaScript-Übungen

### Notenrechner

Die Seite `uebungen/notenrechner.html` bindet `js/notenrechner.js` ein. Die
Oberfläche wird per JavaScript nach dem Seiten-Hero erstellt und verarbeitet
zwei Eingaben: erreichte Punkte und maximal erreichbare Punkte.

Aus diesen Werten werden Prozentwert und Bewertung berechnet:

| Prozentwert | Bewertung |
| --- | --- |
| ab 90 % | Sehr gut |
| ab 75 % | Gut |
| ab 60 % | Befriedigend |
| ab 50 % | Ausreichend |
| unter 50 % | Nicht bestanden |

Das Ergebnis zeigt Prozentwert, Note, Eingabewerte und einen farbigen
Fortschrittsbalken in Cards. Vor der Berechnung wird geprüft, ob Punkte und
Maximalpunkte gültig sind.

### Textanalyse

Die Seite `uebungen/textanalyse.html` verwendet `js/textanalyse.js`. Ein
eingegebener Text wird direkt im Browser analysiert. Angezeigt werden:

- Anzahl der Zeichen,
- Anzahl der Wörter,
- Anzahl der Großbuchstaben,
- Anzahl der Sätze.

Auch diese Oberfläche wird dynamisch mit JavaScript erzeugt. Vor der Analyse
wird geprüft, ob überhaupt Text eingegeben wurde. Die Resultate erscheinen in
einer Card-Übersicht.

## Gemeinsames Design der statischen Seiten

### `css/style.css`

Das zentrale Stylesheet enthält unter anderem:

- das Grundlayout für Body und Navigation,
- CSS-Variablen für Farben und Overlays,
- Layouts mit Grid und Flexbox,
- Hero-Bereiche, Cards, Buttons und Footer,
- die Google-Fonts-Anbindung für **Bebas Neue** und **Barlow**,
- die Animation `fadeUp`,
- Styles für das Dropdown-Menü,
- spezielle Styles für Kontaktformular und Impressum,
- responsive Anpassungen,
- Dark-Mode-Regeln über die Klasse `body.dark`,
- wiederverwendbare Klassen wie `.page-hero`, `.page`, `.cards`, `.card`,
  `.btn` und `.skill`.

### `js/script.js`

Das gemeinsame JavaScript der statischen Seiten:

- aktiviert den Dark-Mode-Umschalter,
- speichert die Auswahl in `localStorage`,
- wechselt die Beschriftung zwischen „Dark“ und „Light“,
- öffnet und schließt das Übungen-Dropdown,
- schließt das Dropdown bei einem Klick außerhalb des Menüs.

## Medien

### `img/Hintergrund.jpg`

Das Bild wird als Hintergrund des Hero-Bereichs der statischen Startseite
verwendet und liegt unter einem halbtransparenten Overlay.

### `img/logo.png`

Das Logo wird von den statischen Seiten als Favicon eingebunden. Seiten im
Hauptverzeichnis verwenden `img/logo.png`, die Übungsseiten im Unterordner
verwenden `../img/logo.png`.

## Verlinkungsübersicht

| Datei oder Ziel | Verlinkt beziehungsweise verwendet in | Zweck |
| --- | --- | --- |
| `flask_app/templates/index.html` | Flask-Routen `/` und `/app/` | Start des Stadion-Escape-Rooms |
| `flask_app/templates/raetsel.html` | Rätsel- und Frage-Routen | Formular und Auswertung des Stadiontor-Codes |
| `flask_app/templates/base.html` | Beide Flask-Seiten | Gemeinsames Layout, Navigation und Styling |
| `flask_app/assets/` | Flask-Konfiguration in `app.py` | Vorbereiteter Bereich für statische Flask-Dateien |
| `index.html` | Navigation aller statischen Seiten | Rückkehr zur statischen Startseite |
| `ueber_mich.html` | Navigation, Startseiten-Button und Startseiten-Card | Vorstellungsseite |
| `eis_projekt.html` | Navigation und Startseiten-Card | Projektseite |
| `kontakt.html` | Navigation, Footer und Startseiten-Card | Kontaktseite |
| `impressum.html` | Navigation und Footer | Rechtliche Angaben |
| `uebungen/notenrechner.html` | Dropdown-Menü | JavaScript-Übung Notenrechner |
| `uebungen/textanalyse.html` | Dropdown-Menü | JavaScript-Übung Textanalyse |
| `css/style.css` | Alle statischen HTML-Seiten | Gemeinsames Design |
| `js/script.js` | Alle statischen HTML-Seiten | Dark Mode und Dropdown |
| `js/notenrechner.js` | `uebungen/notenrechner.html` | Notenrechner-Logik |
| `js/textanalyse.js` | `uebungen/textanalyse.html` | Textanalyse-Logik |
| `img/Hintergrund.jpg` | `css/style.css` über die Klasse `.hero` | Hero-Hintergrundbild |
| `img/logo.png` | Alle statischen HTML-Seiten | Favicon |
| Google Fonts | Flask-Templates und statische Seiten | Schriftarten Bebas Neue und Barlow |

## Verwendete Technologien

- Python 3
- Flask
- Jinja
- HTML5
- CSS3 mit Custom Properties, Grid, Flexbox und Animationen
- JavaScript mit DOM-Manipulation, Events und `localStorage`
- Google Fonts: Bebas Neue und Barlow

## Aktuelle Hinweise

- Es gibt derzeit keine `requirements.txt`; Flask muss lokal manuell
  installiert werden.
- Die Styles der Flask-App befinden sich aktuell direkt in `base.html`.
- Die Unterordner in `flask_app/assets/` sind vorbereitet, enthalten aber
  noch keine eigenen CSS-, Bild- oder JavaScript-Dateien.
- Das Kontaktformular der statischen Website sendet keine Daten.
- Die Projektseite enthält noch keinen vollständig ausgearbeiteten Inhalt.
- Die Angaben im Impressum sind fiktive Platzhalterdaten und nicht für eine
  öffentliche Veröffentlichung gedacht.
- Die Übungsseiten erzeugen ihre Eingabeoberflächen per JavaScript.