tippspiel2027/README.md

# Tippspiel 2027

Dieses Projekt ist der offizielle Nachfolger des alten Tippspiels. Es basiert auf reinem PHP, um eine maximale Langlebigkeit, leichte Lesbarkeit und einfache Anpassbarkeit für die Zukunft zu gewährleisten. Komplexe Abstraktionsschichten wurden entfernt und Legacy-Features eliminiert.

## Voraussetzungen

- Docker & Docker Compose V2

## Lokale Entwicklung und Testumgebung starten

Die Applikation und die dazugehörige Datenbank können einfach via Docker gestartet werden:

```bash
docker compose up -d
```

Die Web-Oberfläche ist anschließend unter `http://localhost:8080` erreichbar.

## Daten-Migration (Import vom Live-Dump)

Das alte Projekt basiert auf Laravel und hat einige Features, die im neuen Projekt nicht mehr existieren (wie z.B. "Ligen" oder das "grüne Trikot"). Um mit den echten Testdaten aus dem Live-Betrieb arbeiten zu können, gibt es ein automatisiertes Import-Skript.

### 1. Legacy Datenbank importieren

Zuerst muss der Dump des alten Tippspiels in den laufenden Datenbank-Container importiert werden. Wir laden den alten SQL-Dump in eine Datenbank namens `tippspiel_legacy`:

```bash
# Alte DB im Container anlegen
docker compose exec db mysql -uroot -proot -e "CREATE DATABASE IF NOT EXISTS tippspiel_legacy;"

# Dump importieren (Beispiel-Kommando)
# docker exec -i $(docker compose ps -q db) mysql -uroot -proot tippspiel_legacy < /pfad/zum/dump.sql
```

### 2. Import-Skript ausführen

Nachdem die alten Daten in der `tippspiel_legacy` Datenbank liegen, kann das Import-Skript ausgeführt werden. Dieses Skript legt automatisch das neue bereinigte Schema (`schema.sql`) in der neuen Datenbank (`tippspiel2027`) an und migriert die Daten. Tote Features und alte Spalten werden dabei automatisch übersprungen.

Das Import-Skript kann im Container aufgerufen werden:

```bash
docker compose exec app php import.php
```

Sobald das Skript durchgelaufen ist, sind die sauberen Daten im System und du kannst die Anwendung auf Port 8080 testen.