.env.example

# ====================================
# Novoboard – Beispiel-Konfigurationsdatei
# ====================================
# Diese Datei dient als Vorlage für Ihre eigene .env.
# Bitte nicht direkt in Produktion verwenden, sondern zuerst kopieren:
#
#   cp .env.example .env
#
# Anschließend die Werte in .env anpassen (insbesondere Passwörter).


# =========================
# Datenbank (App & MariaDB)
# =========================
# DB_HOST:
#   Hostname oder IP-Adresse des Datenbankservers aus Sicht der App.
#   - Im mitgelieferten Docker-Compose-Setup zeigt "db" auf den
#     MariaDB-Container.
#   - Wenn Sie eine externe MariaDB/MySQL-Instanz verwenden (z. B.
#     zentralen DB-Server), tragen Sie hier einfach den entsprechenden
#     Hostnamen oder die IP-Adresse ein (z. B. "mariadb.intern.local"
#     oder "192.168.1.50").
DB_HOST=db

# DB_PORT:
#   TCP-Port, unter dem der Datenbankserver erreichbar ist.
#   Standard für MariaDB/MySQL ist 3306 – dieser Wert funktioniert
#   sowohl für den mitgelieferten Container als auch für externe
#   Installationen, sofern dort ebenfalls der Standardport genutzt wird.
DB_PORT=3306

# DB_NAME:
#   Name der Datenbank, in der Novoboard seine Tabellen anlegt.
#   Die Initial-Skripte legen die Struktur in dieser Datenbank an.
DB_NAME=novoboard

# DB_USER:
#   Datenbankbenutzer für die Anwendung (NICHT root).
#   Für produktive Umgebungen sollte ein eigener Benutzer mit
#   eingeschränkten Rechten verwendet werden.
DB_USER=novoboard

# DB_PASS:
#   Passwort für DB_USER.
#   Unbedingt für jede Installation auf einen eigenen, sicheren Wert setzen.
DB_PASS=change_me

# DB_ROOT_PASS:
#   Root-Passwort für MariaDB.
#   Wird im Standard-Docker-Setup von MariaDB zur initialen
#   Einrichtung verwendet.
#   Achtung:
#     - Dieser Wert sollte streng geheim bleiben.
#     - Für jede Umgebung ein eigenes Root-Passwort verwenden.
DB_ROOT_PASS=change_me_root


# =====
# App
# =====
# APP_VERSION:
#   Zeigt die aktuelle Versionsnummer in der UI an
APP_VERSION=1.0.0-rc1

# SESSION_NAME:
#   Name des Session-Cookies der Anwendung.
#   Kann im Normalfall unverändert bleiben. Wenn mehrere Novoboard-
#   Instanzen unter derselben Domain laufen, kann hier ein eindeutigerer
#   Name sinnvoll sein.
SESSION_NAME=NOVOBOARD_SESSID

# APP_ENV:
#   Kennzeichnung der Umgebung.
#   Typische Werte wären:
#     - production  -> produktiver Betrieb (Standard)
#     - development -> Entwicklungsumgebung
#
#   Hinweis:
#     In der aktuellen Version von Novoboard ist dieser Wert primär
#     für zukünftige Erweiterungen vorgesehen (z. B. ausführlichere
#     Fehlermeldungen oder anderes Logging in der Entwicklung).
#     Wenn Sie nichts Besonderes planen, lassen Sie diesen Wert
#     einfach auf "production".
APP_ENV=production

# AUTH_MAX_ATTEMPTS:
#   Anzahl fehlgeschlagener Login-Versuche, bevor ein Account
#   vorübergehend gesperrt wird.
AUTH_MAX_ATTEMPTS=5

# AUTH_LOCK_MINUTES:
#   Dauer der Sperre (in Minuten) nach zu vielen Fehlversuchen.
AUTH_LOCK_MINUTES=10


# ==============================
# Passwort-Richtlinien (global)
# ==============================
# Diese Werte definieren die Mindestanforderungen für Passwörter
# von Superadmins und Tenant-Admins. Die Anwendung wertet diese
# Parameter zentral aus, um Passwortstärke zu prüfen.

# Superadmin-Passwort-Richtlinie
# -------------------------------
# PW_MIN_LENGTH_SUPERADMIN:
#   Minimale Länge des Passworts für Superadmins.
PW_MIN_LENGTH_SUPERADMIN=12

# PW_REQUIRE_UPPER_SUPERADMIN:
#   Mindestens ein Großbuchstabe erforderlich?
PW_REQUIRE_UPPER_SUPERADMIN=true

# PW_REQUIRE_LOWER_SUPERADMIN:
#   Mindestens ein Kleinbuchstabe erforderlich?
PW_REQUIRE_LOWER_SUPERADMIN=true

# PW_REQUIRE_NUMBER_SUPERADMIN:
#   Mindestens eine Ziffer erforderlich?
PW_REQUIRE_NUMBER_SUPERADMIN=true

# PW_REQUIRE_SPECIAL_SUPERADMIN:
#   Mindestens ein Sonderzeichen erforderlich?
PW_REQUIRE_SPECIAL_SUPERADMIN=true


# Admin-Passwort-Richtlinie (Tenant-Admins)
# -----------------------------------------
# PW_MIN_LENGTH_ADMIN:
#   Minimale Länge des Passworts für (Tenant-)Admins.
PW_MIN_LENGTH_ADMIN=10

# PW_REQUIRE_UPPER_ADMIN:
#   Mindestens ein Großbuchstabe erforderlich?
PW_REQUIRE_UPPER_ADMIN=true

# PW_REQUIRE_LOWER_ADMIN:
#   Mindestens ein Kleinbuchstabe erforderlich?
PW_REQUIRE_LOWER_ADMIN=true

# PW_REQUIRE_NUMBER_ADMIN:
#   Mindestens eine Ziffer erforderlich?
PW_REQUIRE_NUMBER_ADMIN=true

# PW_REQUIRE_SPECIAL_ADMIN:
#   Mindestens ein Sonderzeichen erforderlich?
PW_REQUIRE_SPECIAL_ADMIN=true