Konfiguration

libreStage wird über zwei Konfigurationsdateien gesteuert: die .env-Datei für serverseitige Einstellungen und appConfig.json für anwendungsspezifische Anpassungen.

Umgebungsvariablen (`.env`)

Kopiere zunächst die Vorlage:

cp .env.example .env

Anschließend alle relevanten Werte eintragen:

Variable	Standard	Beschreibung
`SECRET_KEY`	–	Pflichtfeld. Langer, zufälliger String zum Signieren von JWTs. Niemals öffentlich!
`ENVIRONMENT`	`production`	`development` deaktiviert das Secure-Flag für Cookies (nötig auf `localhost`)
`CORS_ORIGINS`	`http://localhost:5173`	Erlaubte Frontend-Ursprünge (kommagetrennt)
`FRONTEND_URL`	`http://localhost:5173`	Basis-URL des Frontends (wird in E-Mails verwendet)
`DATABASE_URL`	`sqlite:///./backend/db/app.db`	SQLAlchemy-Datenbank-URL (SQLite oder PostgreSQL)
`TIMEZONE`	`Europe/Berlin`	Zeitzone der Anwendung (IANA-Format)
`SMTP_HOST`	–	SMTP-Server für E-Mail-Versand (optional)
`SMTP_PORT`	`587`	SMTP-Port
`SMTP_USER`	–	SMTP-Benutzername
`SMTP_PASSWORD`	–	SMTP-Passwort
`MATTERMOST_WEBHOOK_URL`	–	Webhook-URL für Mattermost-Benachrichtigungen (optional)

Anwendungskonfiguration (`appConfig.json`)

Die Datei appConfig.json im Projekt-Root enthält alle band-spezifischen Einstellungen, die ohne erneutes Bauen des Frontends geändert werden können.

Ab v0.4.0 koennen Admins die weichen Parameter auch direkt in der Weboberflaeche unter Admin-Konfiguration pflegen.

{
  "app_name": "libreStage",
  "app_name_short": "LS",
  "timezone": "Europe/Berlin",
  "default_break_seconds": 30
}

Feld	Beschreibung
`app_name`	Vollständiger Anwendungsname (erscheint im Header)
`app_name_short`	Kurzname / Kürzel der Band
`app_title`	Untertitel der Anwendung
`timezone`	Zeitzone (IANA-Format, muss mit `.env` übereinstimmen)
`default_break_seconds`	Standard-Pausenlänge zwischen Sets in Sekunden (Standard: 30)
`genres`	Liste verfügbarer Genres für Songs
`gigTypes`	Auswahlliste für den Veranstaltungstyp
`tonekeys`	Verfügbare Tonarten
`rehearsalSongStatuses`	Song-Statuswerte für Proben-Ansichten

Song-Status

Status	Bedeutung
`vorschlag`	Song wurde vorgeschlagen, aber noch nicht bewertet
`angenommen`	Song ist grundsätzlich akzeptiert
`proben`	Song wird aktiv geprobt
`spielbar`	Song ist bühnenreif und kann in Setlists eingesetzt werden
`bedarfsweise_proben`	Song ist spielbar, wird aber bei Bedarf nochmals geprobt

Gig-Status

Status	Bedeutung
`anfrage`	Auftrittsanfrage eingegangen, noch keine Zusage
`angenommen`	Auftritt wurde bestätigt
`abgelehnt`	Auftrittsanfrage wurde abgelehnt

Frontend-Konfiguration

Das Frontend lädt die Konfiguration zur Laufzeit vom Backend-Endpoint /public/app_config. Für den Entwicklungsmodus wird die API-URL über VITE_API_URL gesteuert:

# frontend/.env (für lokale Entwicklung)
VITE_API_URL=http://localhost:8000