Handbuch: Tenant-Konfiguration¶

Überblick¶

Das Tenant-Konfiguration-Modul verwaltet die systemweiten Einstellungen Ihres Fischereivereins. Hier können Sie alle wichtigen Parameter konfigurieren, die das Verhalten und Aussehen der Software beeinflussen.

Navigation¶

Menüpunkt: Admin-Interface → Tenant Config → Konfigurationen

Verfügbare Aktionen¶

Konfiguration bearbeiten¶

Wo: In der Konfigurationsübersicht den bestehenden Eintrag "Konfiguration" anklicken

Was passiert: Sie gelangen zur Bearbeitungsansicht mit allen verfügbaren Einstellungen

Konfiguration löschen¶

Wo: In der Konfigurationsübersicht die Checkbox vor "Konfiguration" markieren und "Ausgewählte Konfigurationen löschen" wählen

Konfigurationsbereiche¶

1. Allgemeine Einstellungen (General Settings)¶

Logo¶

• Anforderungen: Quadratisch, mindestens 400x400 Pixel, maximal 2MB
• Formate: JPEG, PNG, WebP
• Verwendung: Wird in der Anwendung als Vereinslogo angezeigt

Hintergrundbild¶

• Anforderungen: Hochformat, mindestens 1024 Pixel Höhe, maximal 2MB
• Formate: JPEG, PNG, WebP
• Verwendung: Hintergrundbild für die Anwendung

Kartenlink¶

• Zweck: Link zu einer externen Karte (z.B. Google Maps)
• Optional: Kann leer gelassen werden

Homepage-Link¶

• Zweck: Link zur Vereinshomepage
• Optional: Kann leer gelassen werden

Maßeinheit¶

• Optionen: Zentimeter oder Gramm
• Verwendung: Bestimmt das Format für Fangeinträge

2. Standort-Einstellungen (Location Settings)¶

Koordinaten (Breitengrad/Längengrad)¶

• Zweck: Standortkoordinaten des Vereins für Wetterdaten
• Format: Dezimalgrad (z.B. 47.683300 / 9.833300)
• Verwendung: Wird für wetterbasierte Funktionen genutzt

3. Saison-Einstellungen (Season Settings)¶

Angelsaison¶

• Format: TT.MM (z.B. 01.03 für 1. März)
• Standard: 01.01 bis 31.12 wenn leer gelassen
• Besonderheit: Wenn Enddatum vor Startdatum liegt, wird automatisch das Folgejahr angenommen

Arbeitssaison¶

• Format: TT.MM (z.B. 15.04 für 15. April)
• Standard: 01.01 bis 31.12 wenn leer gelassen
• Verwendung: Definiert den Zeitraum für Arbeitseinsätze

4. Fischereiaufseher-Einstellungen¶

Fischereiaufseher-Gruppen¶

• Zweck: Bestimmt welche Benutzergruppen als Fischereiaufseher gelten
• Auswahl: Mehrfachauswahl möglich
• Auswirkung: Benutzer in diesen Gruppen erhalten erweiterte Rechte

Aufseher können alle Kontrollen sehen¶

• Standard: Aktiviert
• Aktiviert: Fischereiaufseher können alle Kontrollen einsehen (nicht nur ihre eigenen)
• Deaktiviert: Fischereiaufseher sehen nur ihre eigenen Kontrollen
• Hinweis: Bearbeiten und Löschen ist weiterhin nur für eigene Kontrollen möglich

Finanzverwaltung-Gruppen¶

• Zweck: Bestimmt welche Benutzergruppen Zugriff auf Finanzdaten haben
• Auswahl: Mehrfachauswahl möglich (z.B. Kassierer, Schriftführer)
• Auswirkung: Benutzer in diesen Gruppen können Rechnungen, Zahlungen und Finanzberichte einsehen

5. Statistik-Einstellungen¶

Nachtfischen separat erfassen¶

• Standard: Aktiviert
• Aktiviert: Nachtfischen wird als separater Eintrag in Statistiken gezählt
• Deaktiviert: Nachtfischen wird nicht gesondert berücksichtigt

6. Tageskarten-Einstellungen¶

Standard-Kontingent¶

• Zweck: Anzahl Tageskarten pro Mitglied und Jahr
• Standard: 0 (unbegrenzt)

PDF-Standardeinstellungen¶

• Rechtlicher Hinweis: Standardtext für alle Tageskarten-PDFs
• Fangordnung: Standard-Regeltext
• Max. Handangeln: Standardanzahl erlaubter Ruten (Standard: 2)
• Fangtabellen-Zeilen: Anzahl Zeilen in der PDF-Fangtabelle (Standard: 4)

7. QR-Code Export-Einstellungen¶

Diese Einstellungen beeinflussen den Export von Mitgliederlisten mit QR-Codes.

QR-Code Größe (Box Size)¶

• Standard: 6
• Bereich: Kleinere Werte (z.B. 4) erzeugen kleinere QR-Codes, größere Werte (z.B. 10) größere
• Verwendung: Beeinflusst die physische Größe der generierten QR-Codes

QR-Code Export-Pfad (Windows)¶

• Standard: C:\\tmp\\qr_codes
• Format: Windows-Pfad mit doppelten Backslashes
• Verwendung: Basis-Pfad für QR-Code-Bilder im Excel-Export

QR-Code Export-Pfad (Unix/macOS)¶

• Standard: /tmp/qr_codes
• Format: Unix/Linux/macOS-Pfadformat
• Verwendung: Basis-Pfad für QR-Code-Bilder im Excel-Export

8. Rechnungswesen¶

Grundeinstellungen¶

• Preisanzeige: Netto oder Brutto
• Firmenname: Name für Rechnungen
• Kontaktdaten: Telefon und E-Mail (E-Mail erforderlich für Tageskarten-Benachrichtigungen)

Adressdaten¶

• Rechnungsadresse: Vollständige Adresse des Vereins
• Standard-Land: Deutschland

Steuerinformationen¶

• Steuernummer: Optionale Angabe
• USt-IdNr.: Umsatzsteuer-Identifikationsnummer
• Standard-Steuersatz: Standard 19,00%

Bankverbindung¶

• Bankname, IBAN, BIC: Für Rechnungen und Zahlungshinweise

Rechnungseinstellungen¶

• Präfix: Standard "R" für Rechnungsnummern (R-2024-001)
• Zahlungsziel: Standard 14 Tage
• Fußzeile: Zusätzlicher Text am Rechnungsende

9. E-Mail-Einstellungen (Tenant-spezifisch)¶

E-Mail Backend¶

• Feld: email_backend
• Format: Vollständiger Python-Pfad zum E-Mail-Backend
• Beispiele:
• SMTP: django.core.mail.backends.smtp.EmailBackend
• Mailjet: anymail.backends.mailjet.EmailBackend
• SendGrid: anymail.backends.sendgrid.EmailBackend
• Optional: Leer lassen für globale Einstellung

SMTP-Konfiguration¶

• E-Mail Host: SMTP-Server-Adresse (z.B. smtp.gmail.com, mail.example.com)
• E-Mail Port: SMTP-Port (Standard: 587 für TLS, 465 für SSL, 25 für unverschlüsselt)
• Use TLS: Aktivieren für TLS-Verschlüsselung (empfohlen)
• Use SSL: Aktivieren für SSL-Verschlüsselung (alternative zu TLS)
• Host User: Benutzername für SMTP-Authentifizierung
• Host Password: Passwort für SMTP-Authentifizierung

Standard-Absenderadresse¶

• Feld: email_default_from
• Format: E-Mail-Adresse (z.B. verein@example.com)
• Verwendung: Überschreibt die globale Standard-Absenderadresse
• Wichtig: Diese Adresse wird für alle ausgehenden E-Mails verwendet

10. Anymail-Einstellungen (Erweiterte E-Mail-Dienste)¶

Anymail-Konfiguration¶

• Feld: anymail_settings
• Format: JSON-Objekt mit Dienstleister-spezifischen Einstellungen
• Zweck: Integration professioneller E-Mail-Dienstleister

Unterstützte E-Mail-Dienstleister¶

Mailjet¶

{
    "MAILJET_API_KEY": "ihr-api-schlüssel",
    "MAILJET_SECRET_KEY": "ihr-geheimer-schlüssel"
}

• Backend: anymail.backends.mailjet.EmailBackend

SendGrid¶

{
    "SENDGRID_API_KEY": "ihr-api-schlüssel"
}

• Backend: anymail.backends.sendgrid.EmailBackend

Postmark¶

{
    "POSTMARK_SERVER_TOKEN": "ihr-server-token"
}

• Backend: anymail.backends.postmark.EmailBackend

11. Kontrollen-Einstellungen (Sanctions)¶

Verwarnungen bis zur Sperre¶

• Standard: 3
• Zweck: Anzahl der Verwarnungen, bevor eine automatische Sperre erfolgt
• Empfehlung: 2-5 Verwarnungen je nach Vereinspolitik

Sperrdauer in Tagen¶

• Standard: 30 Tage
• Zweck: Standarddauer einer automatischen Sperre
• Anpassbar: Je nach Schwere des Verstoßes

Automatische Sperrung aktivieren¶

• Standard: Aktiviert
• Aktiviert: Mitglieder werden nach Erreichen der maximalen Verwarnungen automatisch gesperrt
• Deaktiviert: Verwarnungen werden nur dokumentiert, keine automatische Sperre

Verwarnungen zum Saisonende zurücksetzen¶

• Standard: Aktiviert
• Aktiviert: Alle Verwarnungen werden beim Saisonwechsel automatisch zurückgesetzt
• Deaktiviert: Verwarnungen bleiben über Saisongrenzen hinweg bestehen

Sperren beim Saisonwechsel beibehalten¶

• Standard: Aktiviert
• Aktiviert: Sperren bleiben auch nach dem Saisonwechsel bestehen
• Deaktiviert: Sperren werden beim Saisonwechsel aufgehoben

Kontrollen archivieren nach Tagen¶

• Standard: 365 Tage
• Zweck: Alte "In Ordnung"-Kontrollen werden nach dieser Zeit automatisch archiviert
• Empfehlung: Mindestens 365 Tage für Jahresstatistiken

Duplikatwarnung aktivieren¶

• Standard: Aktiviert
• Aktiviert: Warnt bei mehreren Kontrollen desselben Anglers am selben Tag
• Deaktiviert: Keine Warnung bei Mehrfachkontrollen

E-Mail für Sperrbenachrichtigungen¶

• Optional: E-Mail-Adresse für Benachrichtigungen bei automatischen Sperren
• Zweck: Vorstand wird über automatische Sperren informiert

12. Benachrichtigungen¶

Generischer Post-Account für Benachrichtigungen¶

• Zweck: Benutzer-Account, der als Autor für automatisch generierte Posts verwendet wird
• Verwendung: Wenn aus Benachrichtigungen automatisch Posts im Feed erstellt werden
• Empfehlung: Erstellen Sie einen speziellen "System" oder "Verein" Account

13. Öffentliche Tageskarten-Bestellung¶

Öffentliche Tageskarten-Bestellung aktivieren¶

• Standard: Deaktiviert
• Aktiviert: Externe Nutzer können Tageskarten online bestellen
• Deaktiviert: Nur registrierte Mitglieder können Tageskarten bestellen
• Wichtig: Erfordert konfigurierte E-Mail-Einstellungen für Benachrichtigungen

AGB für öffentliche Bestellungen¶

• Optional: Allgemeine Geschäftsbedingungen für öffentliche Bestellungen
• Wird angezeigt: Bei der Online-Bestellung durch externe Nutzer
• Empfehlung: Rechtlich geprüfte AGB verwenden

Datenschutzhinweise für öffentliche Bestellungen¶

• Optional: Datenschutzhinweise für externe Kunden
• Wird angezeigt: Bei der Online-Bestellung
• Wichtig: DSGVO-konforme Datenschutzhinweise empfohlen

Kontakt-E-Mail für Tageskarten-Bestellungen¶

• Zweck: E-Mail-Adresse für Rückfragen bei externen Bestellungen
• Wird angezeigt: In Bestätigungsmails und auf der Bestellseite

Benachrichtigungs-E-Mail für neue Bestellungen¶

• Zweck: E-Mail-Adresse für Benachrichtigungen bei neuen externen Bestellungen
• Empfehlung: An verantwortliche Person oder Verteiler senden

14. Arbeitsstatistiken-Konfiguration¶

Berechnungsmodus für Arbeitsstatistiken¶

Berechnungsgrundlage für Durchschnitt¶

Erforderliche Arbeitsstunden pro Saison¶

• Standard: 10 Stunden
• Verwendung: Nur bei Modus "Feste SOLL-Stunden"
• Zweck: Basis-Sollstunden für alle Mitglieder

Ausschluss-Konfigurationen¶

Diese Mitglieder werden von der "Allgemeinheit" in Statistiken ausgeschlossen:

Altersgruppen-Format:

[
    {"min": null, "max": 16},
    {"min": 70, "max": null}
]

Event-Typen für Arbeitsstatistik¶

Welche Event-Typen fließen in die Berechnung ein?

• Standard: ["WA"] (nur Arbeitseinsätze)
• Format: JSON-Array mit Event-Typ-Codes

Arbeitsstatistiken in App anzeigen¶

• Standard: Deaktiviert
• Aktiviert: Mitglieder können ihre Arbeitsstatistiken in der App sehen
• Deaktiviert: Statistiken sind nur im Admin-Bereich sichtbar

15. Hierarchische Arbeitsstunden-Konfiguration¶

Menüpunkt: Admin-Interface → Arbeitsstunden-Konfiguration

Gruppen-Sollstunden¶

• Navigation: Arbeitsstunden-Konfiguration → Gruppen-Sollstunden
• Zweck: Sollstunden für alle Mitglieder einer bestimmten Gruppe festlegen
• Felder:
• Gruppe: Auswahl der Mitgliedergruppe
• Sollstunden pro Saison: Anzahl der erforderlichen Stunden
• Gültig ab: Startdatum der Konfiguration
• Gültig bis: Optionales Enddatum
• Aktiv: Ein-/Ausschalten der Konfiguration
• Beispiel: Jugendgruppe = 4 Stunden, Vorstand = 0 Stunden

Status-Sollstunden¶

• Navigation: Arbeitsstunden-Konfiguration → Status-Sollstunden
• Zweck: Sollstunden basierend auf Mitgliedschaftsstatus festlegen
• Felder:
• Mitgliedschaftsstatus: Auswahl des Status
• Sollstunden pro Saison: Anzahl der erforderlichen Stunden
• Gültig ab: Startdatum der Konfiguration
• Gültig bis: Optionales Enddatum
• Aktiv: Ein-/Ausschalten der Konfiguration
• Beispiel: Ehrenmitglied = 0 Stunden, Passivmitglied = 0 Stunden

Individuelle Sollstunden¶

• Navigation: Arbeitsstunden-Konfiguration → Individuelle Sollstunden
• Zweck: Sollstunden für einzelne Mitglieder individuell festlegen
• Felder:
• Mitglied: Auswahl des Mitglieds
• Sollstunden pro Saison: Anzahl der erforderlichen Stunden
• Gültig ab: Startdatum der Konfiguration
• Gültig bis: Optionales Enddatum
• Aktiv: Ein-/Ausschalten der Konfiguration
• Notiz: Optionale Begründung für die individuelle Regelung
• Beispiel: Max Mustermann = 0 Stunden (Gesundheitliche Gründe)

Prioritätsbeispiel¶

Ein Mitglied kann in mehreren Konfigurationen erfasst sein: - Allgemeine Konfiguration: 8 Stunden - Gruppe "Rentner": 4 Stunden - Status "Ehrenmitglied": 0 Stunden - Individuelle Konfiguration: 2 Stunden

→ Resultat: Das Mitglied muss 2 Stunden leisten (individuelle Konfiguration hat höchste Priorität)

Validierung und Konflikte¶

• Eindeutigkeit: Pro Gruppe/Status/Mitglied kann nur eine aktive Konfiguration existieren
• Überlappende Zeiträume: Das System verwendet automatisch die neueste aktive Konfiguration
• Inaktive Konfigurationen: Werden bei der Berechnung ignoriert

16. UI/UX Branding-Konfiguration¶

Diese Einstellungen ermöglichen eine individuelle Gestaltung der App-Oberfläche für Ihren Verein.

Farben¶

Format: HEX-Farbcode (z.B. #0066cc)

Schriftarten¶

Format: CSS-Schriftfamilie (Font-Stack)

Visuelle Effekte¶

17. Technische Details zur E-Mail-Konfiguration¶

Wie funktioniert die Tenant-spezifische E-Mail-Konfiguration?¶

1. Middleware-Integration: Das System verwendet TenantEmailMiddleware zur automatischen Anwendung der Einstellungen
2. Celery-Tasks: Hintergrundprozesse rufen get_tenant_email_settings() auf
3. Fallback-Mechanismus: Ohne konfigurierte Einstellungen werden globale Defaults verwendet

Prioritätsreihenfolge¶

1. Tenant-Einstellungen (höchste Priorität)
2. Globale Einstellungen (Fallback)
3. Django-Defaults (letzte Option)

Integration in verschiedene Module¶

Rechnungsversand¶

• Nutzt tenant-spezifische Einstellungen für Rechnungs-E-Mails
• Absenderadresse wird aus email_default_from verwendet
• Fehler bei fehlender Konfiguration werden protokolliert

Mitglieder-Benachrichtigungen¶

• E-Mail-Templates nutzen tenant-spezifische SMTP-Einstellungen
• Massenversand erfolgt über konfigurierten E-Mail-Dienstleister

Tageskarten-System¶

• Bestätigungsmails an externe Kunden
• PDF-Anhänge werden über konfiguriertes Backend versendet
• Benötigt funktionierende E-Mail-Konfiguration für öffentliche Bestellungen

Arbeitseinsatz-Kalender¶

• iCal-Dateien werden per E-Mail versendet
• Nutzt tenant-spezifische Absenderadresse

Hintergrundprozesse¶

Das Tenant-Konfiguration-Modul führt keine Hintergrundprozesse aus. Alle Änderungen werden sofort wirksam.

Validierung und Fehlerbehandlung¶

Automatische Validierung¶

• Logo/Hintergrundbild: Automatische Prüfung von Format, Größe und Abmessungen
• Datumsformate: Überprüfung der TT.MM-Eingaben
• E-Mail-Adressen: Validierung der E-Mail-Format
• Farbcodes: HEX-Format Validierung

Fehlermeldungen¶

• Bei ungültigen Dateiformaten erhalten Sie eine Fehlermeldung
• Überschreitung der Dateigrößen wird verhindert
• Falsche Datumsformate werden abgelehnt

Häufige Administrationsaufgaben¶

Vereins-Logo ändern¶

1. Admin-Interface → Tenant Config → Konfigurationen aufrufen
2. "Konfiguration" anklicken
3. Unter "General Settings" neues Logo hochladen
4. Speichern

E-Mail-Versand konfigurieren¶

Für Standard SMTP-Server¶

1. Zu "E-Mail-Einstellungen" navigieren
2. E-Mail Backend auf django.core.mail.backends.smtp.EmailBackend setzen
3. SMTP-Daten eingeben:
4. Host: SMTP-Server Ihres Providers
5. Port: 587 (TLS) oder 465 (SSL)
6. Use TLS oder Use SSL aktivieren (je nach Provider)
7. Host User und Password eingeben
8. Standard-Absenderadresse festlegen
9. Speichern und testen

Für Mailjet (empfohlen für Massenversand)¶

1. Bei Mailjet registrieren und API-Schlüssel generieren
2. E-Mail Backend auf anymail.backends.mailjet.EmailBackend setzen
3. In Anymail-Einstellungen JSON eingeben: json { "MAILJET_API_KEY": "ihr-api-key", "MAILJET_SECRET_KEY": "ihr-secret-key" }
4. Standard-Absenderadresse festlegen
5. Speichern

Angelsaison anpassen¶

1. Zu "Season Settings" navigieren
2. Start- und Enddatum im Format TT.MM eingeben
3. Speichern

Kontroll-System konfigurieren¶

1. Zu "Kontrollen-Einstellungen" navigieren
2. Anzahl Verwarnungen und Sperrdauer festlegen
3. Automatische Sperrung aktivieren/deaktivieren
4. E-Mail für Benachrichtigungen hinterlegen
5. Speichern

Öffentliche Tageskarten aktivieren¶

1. Sicherstellen, dass E-Mail-Einstellungen konfiguriert sind
2. Zu "Öffentliche Tageskarten-Bestellung" scrollen
3. "Öffentliche Tageskarten-Bestellung aktivieren" ankreuzen
4. AGB-Text und Datenschutzhinweise eingeben
5. Kontakt- und Benachrichtigungs-E-Mail konfigurieren
6. Speichern

Vereinsfarben anpassen¶

1. Zu "UI/UX Branding-Konfiguration" navigieren
2. Primär- und Sekundärfarbe auf Vereinsfarben setzen
3. Akzentfarbe für Highlights festlegen
4. Vorschau in der App überprüfen
5. Speichern

Problembehandlung¶

"Konfiguration kann nicht erstellt werden"¶

Ursache: Es existiert bereits eine Konfiguration Lösung: Vorhandene Konfiguration bearbeiten statt neue zu erstellen

"Logo wird nicht angezeigt"¶

Mögliche Ursachen: - Datei ist nicht quadratisch - Datei ist zu klein (unter 400x400 Pixel) - Datei ist zu groß (über 2MB) - Falsches Dateiformat

"E-Mail-Versand funktioniert nicht"¶

SMTP-Probleme¶

Prüfpunkte: - Backend-Pfad korrekt? (django.core.mail.backends.smtp.EmailBackend) - SMTP-Host und Port stimmen mit Provider überein? - TLS/SSL-Einstellung passt zum Port? (587→TLS, 465→SSL) - Benutzername und Passwort korrekt? - Standard-Absenderadresse eingetragen? - Firewall blockiert ausgehende Verbindungen?

Häufige Provider-Einstellungen: - Gmail: smtp.gmail.com, Port 587, TLS aktiviert, App-Passwort erforderlich - Office 365: smtp.office365.com, Port 587, TLS aktiviert - Strato: smtp.strato.de, Port 465, SSL aktiviert

Mailjet/Anymail-Probleme¶

Prüfpunkte: - Backend-Pfad korrekt? (z.B. anymail.backends.mailjet.EmailBackend) - API-Schlüssel und Secret korrekt in JSON-Format? - Absenderadresse bei Mailjet verifiziert? - JSON-Syntax korrekt? (Anführungszeichen, Kommas)

Beispiel korrektes JSON:

{
    "MAILJET_API_KEY": "abcd1234",
    "MAILJET_SECRET_KEY": "efgh5678"
}

Tenant-spezifische Probleme¶

Symptome: E-Mails werden mit falschen Einstellungen versendet Lösung: 1. Prüfen Sie die E-Mail-Konfiguration unter Vereinskonfiguration → E-Mail-Einstellungen 2. Stellen Sie sicher, dass alle Pflichtfelder (API-Key, Secret-Key, Absender-E-Mail) korrekt ausgefüllt sind 3. Kontaktieren Sie den IT-Support, falls das Problem nach Korrektur der Einstellungen weiterhin besteht

Debug-Tipps¶

1. Prüfen Sie unter Vereinskonfiguration → E-Mail-Einstellungen ob die SMTP/API-Daten korrekt hinterlegt sind
2. Nutzen Sie die Test-E-Mail-Funktion (falls vorhanden) im E-Mail-Manager, um die Konfiguration zu überprüfen
3. Bei anhaltenden Problemen wenden Sie sich an den technischen Administrator

"Automatische Sperren funktionieren nicht"¶

Mögliche Ursachen: - Automatische Sperrung ist deaktiviert - Anzahl Verwarnungen noch nicht erreicht - E-Mail für Benachrichtigungen fehlt (optional) Lösung: Kontrollen-Einstellungen überprüfen

"Öffentliche Tageskarten nicht verfügbar"¶

Mögliche Ursachen: - Option ist deaktiviert - E-Mail-Einstellungen fehlen - Kontakt-E-Mail (billing_contact_email) nicht konfiguriert Lösung: E-Mail-Konfiguration vervollständigen und Option aktivieren

"Arbeitsstatistiken zeigen falsche Werte"¶

Mögliche Ursachen: - Falscher Berechnungsmodus gewählt - Ausschluss-Konfigurationen nicht korrekt - Event-Typen nicht richtig konfiguriert Lösung: 1. Berechnungsmodus überprüfen 2. Ausgeschlossene Status/Gruppen/Mitglieder prüfen 3. Event-Typen-Liste validieren (JSON-Format!)

"Vereinsfarben werden nicht angezeigt"¶

Mögliche Ursachen: - Ungültiger HEX-Farbcode - Browser-Cache - App-Cache Lösung: 1. Farbcodes auf korrektes Format prüfen (z.B. #0066cc) 2. Browser-Cache leeren 3. App neu starten