# Champions of Luneraria · Portal & Schaltzentrale

> **Mission Control, LiveOps-Telemetrie, Engine-Benchmarks und Triple-A Werbeseite für Champions of Luneraria.**  
> Entwickelt für den lokalen Betrieb und bereit für den direkten Push auf Cloud-Server (GitHub, GitLab, Docker, Hetzner, AWS, GCP).

---

## 🎛️ Was ist enthalten?

1. **Öffentliche Triple-A Werbeseite (`/`)**:
   * Vollständig animiertes Web-Portal mit Gameplay-Videos, Partikel-Canvas, Audiogerüst und Einheitenshowcase.
   * Interaktiver 3-Lane Taktik-Radar mit Höhenprofil und Landmarken-Inspektor.
   * Rundenzyklus-Timeline (5 Phasen von Aufstellung bis Ancient-Sturz).
   * Roster-Showcase für Champions (Sylvara, Brunhild, Funkenlanze).

2. **LiveOps-Schaltzentrale (`/dashboard`)**:
   * **Live Concurrency (CCU):** Gleichzeitige Spieler online mit Echtzeit-Graph (SSE / Server-Sent Events).
   * **Download- & Vertriebsstatistiken:** Aufschlüsselung nach Plattform (macOS 40 %, Windows 49 %, Linux 11 %) und Verlauf der letzten 14 Tage.
   * **Reale Engine-Benchmarks:** Direkter Vergleich aus den Meilensteinen (C# Core 0,259 ms vs. Godot 1,587 ms; GPU-Skinning Entlastung −27 % CPU; 457/457 Golden Tests grün mit 0,00 Abweichung).
   * **Match-Balance & Einheiten-Telemetrie:** Winrates (Blau 50,2 % vs. Rot 49,8 %), First-Tower-Fall Quoten, Boss-Expeditionsstatistik.
   * **Autoritative Server-Steuerung:** Wartungsmodus-Toggle, Tickrate-Umschalter (10/20/30 Hz), Live Broadcast Nachrichten und Traffic-Simulation.
   * **Live Event Stream:** Scrollende Server-Konsole mit TCP- und Kampfereignissen.

3. **Backend API (`server.js`)**:
   * Zero-Dependency Node.js Server (läuft sofort ohne zwingendes `npm install`).
   * REST APIs (`/api/metrics`, `/api/benchmarks`, `/api/downloads/history`, `/api/logs`).
   * Server-Sent Events Feed (`/api/events`) für Echtzeit-Push im Sekundentakt.

---

## 🚀 Lokaler Start

### Variante A: Direkt mit Node.js (Empfohlen)
```bash
# Im Projektverzeichnis:
node server.js
```
* **Website:** [http://localhost:8080/](http://localhost:8080/)
* **Schaltzentrale:** [http://localhost:8080/dashboard](http://localhost:8080/dashboard)

### Variante B: Mit Docker Compose
```bash
docker compose up -d --build
```

---

## ☁️ Wie schiebe ich dieses Git auf einen Cloud-Server?

Dieses Verzeichnis ist als **eigenständiges Git-Repository** aufgesetzt. So verbinden Sie es mit GitHub oder einem eigenen Git-Server:

### 1. Bei GitHub / GitLab ein leeres Repository anlegen
Erstellen Sie z. B. auf GitHub ein neues Repository namens `luneraria-control-center`.

### 2. Remote hinzufügen und pushen
```bash
cd luneraria-control-center

# Remote-URL Ihres Cloud-Repositories verknüpfen:
git remote add origin https://github.com/IhrAccount/luneraria-control-center.git

# Auf den Cloud-Server pushen:
git branch -M main
git push -u origin main
```

---

## 🌐 Bereitstellung auf einem Cloud-Server / VPS (z. B. Hetzner, Ubuntu, Debian)

Auf Ihrem Cloud-Server (mit Docker und Git):

```bash
# 1. Repository auf dem Server klonen
git clone https://github.com/IhrAccount/luneraria-control-center.git /opt/luneraria
cd /opt/luneraria

# 2. Mit Docker Compose im Hintergrund starten
docker compose up -d --build

# 3. Status prüfen
docker compose ps
docker compose logs -f
```

### Optional: Automatisches HTTPS mit Caddy (Reverse Proxy)
Ergänzen Sie in `/etc/caddy/Caddyfile`:
```caddy
luneraria.ihredomain.de {
    reverse_proxy 127.0.0.1:8080
}
```
Fertig! Caddy stellt automatisch gültige Let's Encrypt SSL-Zertifikate aus.

---

## 📁 Repository-Struktur

```
luneraria-control-center/
├── .git/                      # Lokales Git-Repository (bereit zum Pushen)
├── .github/workflows/         # CI/CD Pipeline für GitHub Actions
├── Dockerfile                 # Multi-Stage Alpine Container
├── docker-compose.yml         # Container-Orchestrierung
├── package.json               # Paketkonfiguration
├── server.js                  # REST API, SSE Live-Stream & Static File Server
├── src/
│   └── data/
│       └── telemetry.js       # LiveOps-Datenmodell, Benchmarks & Metriken
└── public/
    ├── index.html             # Öffentliche Triple-A Werbeseite
    ├── dashboard.html         # Die Schaltzentrale (LiveOps / Mission Control)
    └── assets/                # Geteilte CSS-, JS-, Font-, Icon-, Bild- und Videodateien
```