luneraria-control-center/README.md
Martin Stickelbroeck 0df07eefd1
Some checks are pending
CI/CD Cloud Deployment / test-and-build (push) Waiting to run
feat: Champions of Luneraria - Portal & LiveOps Schaltzentrale
- Triple-A Werbeseite mit Gameplay-Videos, 3-Lane Radar und Einheiten-Showcase
- LiveOps-Schaltzentrale mit CCU-Tracking, Download-Statistiken und Match-Balance
- Reale Engine-Benchmarks (C# vs Godot, U2-U5.5 FPS, GPU-Skinning Entlastung)
- Zero-Dependency Node.js Backend mit REST-APIs und Server-Sent Events (SSE)
- Cloud-Ready mit Dockerfile, docker-compose.yml und GitHub Actions CI/CD
2026-10-11 20:07:51 +02:00

114 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```