Initial commit: Mathe-App Phase 1-3

- React+Vite Frontend mit Routing, eigenem fetch-Client (kein axios)
- Express Backend: Auth (JWT), Topics, Tasks, Leaderboard
- PostgreSQL Schema + Seed: 7 Kategorien, 21 Topics, ~25 Aufgaben
- Gamification: XP, Level (100×n^1.5), tägliche Streaks
- docker-compose auf Port 3100 für DS1621
- Alltagsaufgaben: Finanzen, Geometrie, Physik, Informatik, Verkehr, Shopping

README.md

@@ -0,0 +1,126 @@
+# Mathe im Alltag
+
+Mathe-Lern-App mit Gamification. Aufgaben aus dem echten Leben — Zinsen, Physik, Verkehr, Shopping und mehr.
+
+## Features
+
+- 7 Themenkategorien, 21 Topics, wachsender Aufgabenpool
+- XP, Level, tägliche Streaks
+- Leaderboard
+- Benutzerkonten mit JWT-Auth
+- Docker-basiert, läuft auf einem einzelnen Server
+
+## Tech-Stack
+
+| Schicht | Tech |
+|---|---|
+| Frontend | React + Vite |
+| Backend | Node.js + Express |
+| Datenbank | PostgreSQL 16 |
+| Auth | JWT |
+| Deployment | docker-compose + nginx |
+
+## Lokale Entwicklung
+
+### Voraussetzungen
+
+- Node.js 22+
+- Docker + docker-compose
+
+### Setup
+
+```bash
+# Abhängigkeiten installieren
+cd frontend && npm install
+cd ../backend && npm install
+
+# Umgebungsvariablen
+cp .env.example .env
+# .env anpassen (DB_PASSWORD, JWT_SECRET, etc.)
+
+# Starten
+docker compose up -d
+```
+
+Frontend läuft auf http://localhost:3100
+
+### Backend ohne Docker
+
+```bash
+cd backend
+npm run dev
+```
+
+## Deployment
+
+### Erste Inbetriebnahme
+
+```bash
+# .env anlegen (aus .env.example)
+cp .env.example .env
+nano .env
+
+# Starten (baut Images und initialisiert DB)
+docker compose up -d --build
+```
+
+### Update
+
+```bash
+git pull
+docker compose down && docker compose up -d --build
+```
+
+### NPM (Nginx Proxy Manager)
+
+- Domain: `mathe.motocamp.de`
+- Forward Hostname: `10.47.11.10`
+- Forward Port: `3100`
+- SSL: Let's Encrypt
+
+## Umgebungsvariablen
+
+| Variable | Beschreibung |
+|---|---|
+| `DB_HOST` | PostgreSQL Host (default: `db`) |
+| `DB_NAME` | Datenbankname |
+| `DB_USER` | Datenbankbenutzer |
+| `DB_PASSWORD` | Datenbankpasswort |
+| `JWT_SECRET` | Signierungsschlüssel für Access-Tokens |
+| `FRONTEND_URL` | Erlaubte CORS-Origin |
+| `PORT` | Backend-Port (default: 3001) |
+
+## Projektstruktur
+
+```
+mathe-app/
+├── frontend/          React+Vite App
+│   └── src/
+│       ├── api/       fetch-Client (kein axios)
+│       ├── pages/     Seiten (Home, Login, Dashboard, TopicPage)
+│       └── components/TaskCard — Aufgaben lösen
+├── backend/           Express API
+│   └── src/
+│       ├── routes/    auth, users, topics, tasks, health
+│       ├── middleware/ JWT-Auth
+│       ├── db/        PostgreSQL Pool
+│       └── utils/xp.js Level-Berechnung
+├── docker/
+│   ├── init.sql       DB-Schema + Seed-Daten
+│   ├── Dockerfile.frontend
+│   ├── Dockerfile.backend
+│   └── nginx.conf
+└── docker-compose.yml
+```
+
+## Themen
+
+| Kategorie | Topics |
+|---|---|
+| 💰 Finanzen | Zinsen & Sparen, Kredite & Raten, Rabatte & Steuern |
+| 📐 Geometrie | Flächen, Volumina, Winkel & Trigonometrie |
+| ⚖️ Verhältnisse & Zeit | Dreisatz, Zeitrechnung, Prozente |
+| ⚡ Physik | Mechanik, Elektrizität, Wärme & Energie |
+| 💻 Informatik | Binär & Hex, Dateigrößen, Algorithmen |
+| 🚗 Verkehr | Fahrtzeit & Tempo, Spritverbrauch, Bremswege |
+| 🛒 Shopping | Preisvergleich, Einheitspreis, Ratenkauf |