Zum Inhalt

Ersteinrichtung

Nach der Installation von Bifolk befolgen Sie diese Schritte, um die Anwendung für die erste Verwendung einzurichten.

Zielgruppe: Systemadministratoren, neue Administratoren

Superuser erstellen

Der Superuser hat vollen Zugriff auf die Django-Admin-Oberfläche und alle Daten.

docker compose exec bifolk-app python manage.py createsuperuser

Sie werden aufgefordert, Folgendes einzugeben:

  • Benutzername: Admin-Benutzername
  • E-Mail: Admin-E-Mail-Adresse
  • Passwort: Sicheres Passwort

Beispieldaten laden

Für Test- oder Demonstrationszwecke laden Sie Beispieldaten:

docker compose exec bifolk-app python manage.py load_sample_data

Dies erstellt:

  • Beispielorganisationen mit verschiedenen Typen
  • Beispielbenutzer mit verschiedenen Rollen
  • Beispielbienenstöcke mit Durchsichten und Ernteaufzeichnungen
  • Beispielköniginnen mit Abstammung
  • Beispielarbeiten (Fütterung, Behandlungen, Wartung)
  • Beispiel-Lagerartikel
  • Beispiel-konfigurierbare Auswahlmöglichkeiten

Note

Beispieldaten sind nur für Tests gedacht. Laden Sie keine Beispieldaten auf einer Produktionsinstanz mit echten Daten.

Erste Anmeldung

  1. Öffnen Sie Bifolk unter http://localhost:8000 (oder Ihrer konfigurierten Domain)
  2. Melden Sie sich mit Ihren Superuser-Zugangsdaten an
  3. Eine persönliche Organisation wird automatisch für Sie erstellt

Erste Organisation erstellen

  1. Gehen Sie zu Organisationen in der Seitenleiste
  2. Klicken Sie auf Organisation erstellen
  3. Füllen Sie aus:
  4. Name: Organisationsname (z.B. "Familie Schmidt Imkerei")
  5. Typ: Persönlich, Familie, Verein, Genossenschaft oder Gewerblich
  6. Beschreibung: Optionale Beschreibung
  7. Klicken Sie auf Speichern

Mitglieder einladen

  1. Gehen Sie zur Detailseite der Organisation
  2. Klicken Sie auf Mitglied einladen
  3. Geben Sie die E-Mail-Adresse der Person ein
  4. Wählen Sie ihre Rolle (Inhaber, Administrator, Mitglied oder Betrachter)
  5. Klicken Sie auf Einladung senden

Die eingeladene Person erhält eine E-Mail mit einem Registrierungs-/Akzeptierungslink.

Systemauswahlmöglichkeiten konfigurieren

Bifolk verwendet konfigurierbare Auswahlmöglichkeiten für Dropdowns wie Bienenstocktypen, Honigsorten und Gesundheitsstatus. Standardauswahlmöglichkeiten werden automatisch erstellt, aber Sie können sie anpassen:

  1. Gehen Sie zu System > Systemkonfiguration in der Seitenleiste (erfordert Admin- oder Inhaber-Rolle)
  2. Fügen Sie Auswahlmöglichkeiten für jede Kategorie hinzu, bearbeiten oder deaktivieren Sie sie

Siehe Systemkonfiguration für Details.

Authentifizierung konfigurieren

Selbstregistrierung

Steuern Sie, ob sich Benutzer selbst registrieren können:

# In .env
ALLOW_SELF_REGISTRATION=True   # Offene Registrierung erlauben
ALLOW_SELF_REGISTRATION=False  # Nur Admin kann Benutzer erstellen

E-Mail-Verifizierung

Steuern Sie, ob E-Mail-Verifizierung erforderlich ist:

REQUIRE_EMAIL_VERIFICATION=True   # E-Mail-Verifizierung erforderlich
REQUIRE_EMAIL_VERIFICATION=False  # Verifizierung überspringen

Zwei-Faktor-Authentifizierung

Optional MFA erzwingen:

MFA_REQUIRED=none    # Optional für alle Benutzer (Standard)
MFA_REQUIRED=staff   # Erforderlich für Staff/Admin-Benutzer
MFA_REQUIRED=all     # Erforderlich für alle Benutzer
MFA_GRACE_PERIOD_DAYS=7  # Tage zum Einrichten von MFA vor Durchsetzung

Single Sign-On (OIDC)

Siehe Konfiguration für OIDC-Setup.

Nächste Schritte