lang:ende

rodfather

Ein selbst hostbares Kicker-Wertungssystem. Glicko-2-Ratings, strikte 7-Tore-Regel, Teams, Spiel-Annullierung und ein Matchmaker — bereitgestellt von einem Nuxt-Web-Interface samt API, mit einer nativen App obendrauf. Server, Datenbank und Identity Provider betreibst du selbst; nichts telefoniert nach Hause.

modus selbst gehostet
stack Nuxt 4 · Expo 57
db SQLite / PostgreSQL
auth Keycloak (OIDC)

Was Rodfather ist

Eine Büro-Kickerliga, die sich selbst eine Spur zu ernst nimmt. Zwei Komponenten: rodfather-server (Nuxt-Web-Interface + API, ein Docker-Image) und die Rodfather-App (native, Expo), die dieselbe API nutzt.

[01/06]

Glicko-2-Ratings

$ rating --glicko2

Jedes beendete Spiel aktualisiert die Ratings per Glicko-2 — Rating plus Rating-Abweichung, damit sich der Wert von Neulingen schnell bewegt und der von Veteranen nicht.

[02/06]

Strikte 7-Tore-Regel

$ game --win-at 7

Ein Spiel endet bei genau sieben Toren. Kein Zwei-Tore-Vorsprung, kein Golden Goal, keine Verhandlung am Tisch. Tore werden pro Spiel erfasst.

[03/06]

Teams & Matchmaker

$ matchmaker --balance

1v1 oder 2v2, inklusive erfasster Positionswechsel. Der Matchmaker schlägt anhand der aktuellen Ratings ausgeglichene Teams vor — statt wer am lautesten ruft.

[04/06]

Spiele annullieren

$ game void <id>

Ein falsch eingetragenes Ergebnis wird annulliert, nicht gelöscht: Das Spiel bleibt als annulliert dokumentiert, die Ratings werden ohne es neu berechnet.

[05/06]

Web-Interface + App

$ curl /api/config

Das Web-Interface kommt mit dem Server. Die native App wird einmal gebaut und zeigt auf jede Instanz — sie liest das öffentliche GET /api/config, um Realm und Client-ID der Instanz zu ermitteln.

[06/06]

Selbst gehostet by design

$ docker run -v rodfather-data:/data

Ein organisationsunabhängiges Docker-Image, gesamte Konfiguration zur Laufzeit. Kein Tenant, kein Account, kein Lizenzserver, kein layer418-Backend im Spiel.

Server deployen

Nichts über dein Realm, deinen Firmennamen oder deine URLs steckt zur Build-Zeit im Image — ein veröffentlichtes Image bedient jedes Deployment, alles wird beim docker run übergeben.

01

Keycloak-Client

Lege in deinem Realm einen confidential Client für das Web-Interface an, mit https://dein-host/auth/keycloak/callback als gültiger Redirect-URI.

02

3 Secrets erzeugen

Session-Secret (≥48 Zeichen), ein Base64-Token-Key mit 32 Bytes und ein Auth-Session-Secret. In Produktion erfindet der Server sie nicht für dich.

03

Container starten

Starte ghcr.io/layer418/rodfather-server mit diesen Secrets, der Realm-Basis-URL und den Client-Credentials. Das Schema wird beim Boot erstellt — kein Migrationsschritt.

04

Optional: App aktivieren

Setze NUXT_APP_CLIENT_ID auf einen zweiten, öffentlichen Keycloak-Client. Bleibt es leer, liefert GET /api/config 501 und die App meldet schlicht, dass diese Instanz sie nicht unterstützt.

# one image, zero build-time config — everything is passed at run time
docker run -d \
  -p 3000:3000 \
  -v rodfather-data:/data \
  -e NUXT_OIDC_SESSION_SECRET="$(openssl rand -base64 48)" \
  -e NUXT_OIDC_TOKEN_KEY="$(openssl rand -base64 32)" \
  -e NUXT_OIDC_AUTH_SESSION_SECRET="$(openssl rand -base64 48)" \
  -e NUXT_OIDC_PROVIDERS_KEYCLOAK_BASE_URL="https://sso.example.com/realms/acme" \
  -e NUXT_OIDC_PROVIDERS_KEYCLOAK_CLIENT_ID="rodfather-web" \
  -e NUXT_OIDC_PROVIDERS_KEYCLOAK_CLIENT_SECRET="…" \
  -e NUXT_OIDC_PROVIDERS_KEYCLOAK_REDIRECT_URI="https://foos.example.com/auth/keycloak/callback" \
  -e NUXT_PUBLIC_ORG_NAME="Acme GmbH" \
  -e NUXT_APP_CLIENT_ID="rodfather-app" # optional: enables the app
  ghcr.io/layer418/rodfather-server:latest

# generate the three secrets once and keep them stable —
# regenerating them invalidates every existing session.

SQLite oder PostgreSQL

Eine Umgebungsvariable entscheidet. Bleibt DATABASE_URL leer, nutzt der Server eine SQLite-Datei unter DB_PATH (im Image /data/rodfather.db) — die richtige Wahl für einen einzelnen Container mit gemountetem Volume.

Setze DATABASE_URL auf einen postgres://-Connection-String, wenn Pods unabhängig sein müssen: mehr als eine Replica, Rolling Updates oder kein Volume zum Anhängen. Eine SQLite-Datei verträgt keine parallelen Writer, und auf einem Netzwerk-Volume wird sie korrupt.

In beiden Fällen wird das Schema beim Boot erstellt, und es gibt keine automatische Migration zwischen den Backends — eine bestehende Liga umzuziehen heißt, fünf Tabellen selbst zu exportieren und einzulesen.

# SQLite (default) — single container + volume
# DATABASE_URL unset → /data/rodfather.db

# PostgreSQL — multiple replicas, rolling updates,
# or no volume to attach
DATABASE_URL="postgres://rodfather:…@db:5432/rodfather"

# the schema is created on boot in both cases:
# no migration step to run.
# tables: players, games, game_voids,
#         game_goals, game_position_switches

App nutzen

In der App steckt keine Server-URL. Sie wird einmal gebaut und funktioniert mit jeder selbst gehosteten Instanz: Beim ersten Start gibt man die Adresse des eigenen Servers ein, die App holt sich von dort die Auth-Parameter der Instanz.

01

Server eintragen

Im Setup-Screen gibt man die Adresse der eigenen Instanz ein. Die App normalisiert sie, liest GET /api/config und zeigt den gefundenen Organisationsnamen zur Bestätigung — eine vertippte Adresse, die zufällig HTTP 200 liefert, wird per Strukturprüfung abgelehnt, nicht stillschweigend akzeptiert.

02

Anmelden

Native OIDC Authorization Code + PKCE direkt gegen dein Keycloak, mit Issuer und öffentlicher Client-ID aus /api/config. Kein Passwort läuft jemals über die eigene UI der App.

03

Identifizieren

Tokens liegen im Keystore des Betriebssystems, /api/** wird mit Bearer-Token aufgerufen. GET /api/me ordnet dem Subject des Tokens einen Spieler-Datensatz zu — ein „wähle deinen Spieler“-Schritt entfällt.

04

Spielen

Spiele eintragen, Rangliste und Spielerdetails ansehen, eigene Bilanz prüfen. Abmelden löscht die Tokens, behält aber die Serveradresse; „Server wechseln“ löscht beides.

Die App braucht einen eigenen Keycloak-Client

Das Web-Interface nutzt einen confidential Client mit Secret. Eine mobile App kann kein Secret geheim halten und braucht daher einen zweiten, öffentlichen Client im selben Realm — mit deaktivierter Client-Authentifizierung, PKCE S256 und der Redirect-URI rodfather://auth.

Zeigt NUXT_APP_CLIENT_ID auf den confidential Web-Client, lehnt Keycloak den Token-Tausch der App mit unauthorized_client ab. Gleiches Symptom, wenn der Client existiert, die Client-Authentifizierung aber aktiviert bleibt.

Ein Audience-Mapper ist nicht nötig: Der Server prüft bei jedem App-Request, dass das Token für diesen Client ausgestellt wurde — über Keycloaks azp-Claim oder eine passende aud. Diese Prüfung ist nicht abschaltbar, sonst könnte ein Token für einen beliebigen anderen Client im Realm als App agieren.

# Keycloak → Clients → Create client
client_id            = "rodfather-app"
client_auth          = off        # public client
standard_flow        = on
direct_access_grants = off
redirect_uri         = "rodfather://auth"
pkce                 = "S256"
audience_mapper      = not needed

# then on the server container:
NUXT_APP_CLIENT_ID   = "rodfather-app"

Datenschutz

Kurzfassung: Die App erhebt keine Daten, und layer418 speichert keine. Die Daten deiner Liga existieren ausschließlich auf dem Rodfather-Server, in seiner Datenbank und im Keycloak-Realm, die du selbst hostest.

Die App erhebt keine Daten

$ telemetry --status → none

Keine Analytics, keine Telemetrie, kein Crash- oder Performance-Reporting, keine Werbung, keine Tracking-IDs, keine Drittanbieter-SDKs, die nebenbei etwas sammeln. Es gibt keine Nutzungsdaten, denen man widersprechen müsste, weil keine erhoben werden.

keine Analyticskeine Telemetriekein Crash-Reportingkeine Werbungkeine Tracking-IDs

Es gibt kein layer418-Backend

$ grep -r "layer418.de" app/ → 0

Die App wird ohne Server-URL ausgeliefert und hat keine Standard-Instanz als Rückfallebene. Sie spricht mit genau einem Host: der eingegebenen Adresse. layer418 betreibt in diesem Pfad keinen Dienst und erhält keine Requests aus der App.

Alle Daten liegen auf deinen Systemen

$ df -h /your/infrastructure

Spieler, Spiele und Ratings speichert der Rodfather-Server, den du deployt hast — in der SQLite-Datei oder PostgreSQL-Datenbank, die du angebunden hast. Accounts, Namen, E-Mail-Adressen und Logins liegen in deinem eigenen Keycloak-Realm. All das sind Backends, die du selbst hostest, auf Infrastruktur deiner Wahl.

rodfather-serverSQLite / PostgreSQLKeycloak

Was auf dem Gerät bleibt

$ keychain list rodfather

Die Serveradresse in den App-Einstellungen und die OIDC-Tokens im Keystore der Plattform (iOS Keychain / Android Keystore). Abmelden löscht die Tokens, „Server wechseln“ löscht beides. Weder das eine noch das andere wird irgendwohin übertragen außer an deinen Server und dein Realm.

Was dein Server speichert

$ sqlite3 rodfather.db ".tables"

Fünf Tabellen: players, games, game_voids, game_goals und game_position_switches — Ligaergebnisse, keine Personenprofile. Identitätsdaten (Name, E-Mail, Zugangsdaten) bleiben in Keycloak und werden nur über das Subject des Tokens referenziert.

Verantwortlich bist du

$ whoami → you

Wer die Instanz betreibt, ist dafür der Verantwortliche im Sinne der DSGVO und entscheidet über Aufbewahrung, Backups, Zugriff und Löschung. layer418 ist kein Auftragsverarbeiter deines Deployments und hat keinen Zugriff darauf. Hosten wir eine Instanz als bezahlte Leistung für dich, ist das ein separater Vertrag mit AVV.

# where data flows — and where it does not

  [ rodfather app ]
         │
         │  HTTPS, bearer token
         ├──────────────▶ [ your rodfather-server ] ──▶ [ your database ]
         │
         └──────────────▶ [ your Keycloak realm ]  # login, identities

         ✕──────────────▶ [ layer418 ]            # no connection, ever
         ✕──────────────▶ [ third parties ]       # no SDKs, no analytics
Sendet die App irgendetwas an layer418?

Nein. In der App ist kein layer418-Endpunkt einkompiliert und kein Analytics- oder Crash-Reporting-SDK enthalten. Jeder Netzwerk-Request geht an die konfigurierte Serveradresse und an das Keycloak-Realm dieser Instanz.

Wer kann die Spiele meiner Liga sehen?

Nur wem du in deinem Keycloak-Realm Zugriff gibst. Die Daten verlassen deinen Server und deine Datenbank nicht, die Zugriffskontrolle liegt also vollständig bei dir — inklusive vollständiger Löschung durch Verwerfen des Volumes oder der Datenbank.

Brauche ich Keycloak oder geht ein anderer Identity Provider?

Rodfather ist gegen Keycloak gebaut und getestet — der Server nutzt dessen azp-Claim für die App-Client-Prüfung und das Keycloak-OIDC-Preset für das Web-Interface. Andere OIDC-Provider sind ungetestet.

Kann layer418 das für uns hosten?

Ja — als Managed Deployment auf EU-Infrastruktur, inklusive Keycloak-Realm und Backups. Das ist gewöhnliches Hosting nach Vertrag; der Selbsthosting-Weg bleibt bestehen und kostet nichts.

Hilfe beim Deployment?

Selbst hosten ist der Punkt der Sache, und die Doku oben sollte reichen. Wenn wir es lieber betreiben sollen — oder es in ein bestehendes Keycloak-Realm gehört — schreib anhello@layer418.deund wir klären das.