Tageskarten-Modul - Administrator-Handbuch¶

Überblick¶

Das Tageskarten-Modul verwaltet die komplette Ausgabe von Tageskarten für Gastangler. Es unterscheidet zwischen Mitglieder-Gästen (Gäste von Vereinsmitgliedern) und externen Käufen (Direktkäufe durch Gastangler).

Navigation im Admin-Bereich¶

Alle Tageskarten-Funktionen finden Sie unter: Admin-Hauptmenü → Tageskarten

Verfügbare Menüpunkte¶

Menüpunkt	Zweck	Häufigkeit der Nutzung
Tageskarten-Anträge	Bearbeitung von Mitglieder-Gastanträgen	Täglich
Ausgestellte Tageskarten	Übersicht aller erstellten Karten	Täglich
Externe Gastkarten-Käufe	Abwicklung direkter Käufe	Regelmäßig
Gewässer-Kontingente	Kontingent-Verwaltung pro Gewässer	Saisonbeginn
Individuelle Kontingente	Sonderkontingente für Mitglieder	Bei Bedarf
Gastkarten-Typen	Kartentypen (Tag, Woche, etc.)	Einmalige Einrichtung
Gewässer-PDF-Konfigurationen	PDF-Einstellungen pro Gewässer	Einmalige Einrichtung

Grundlegende Arbeitsabläufe¶

1. Mitglieder-Gäste Workflow¶

Schritt 1: Antragsprüfung¶

Wo: Admin → Tageskarten → Tageskarten-Anträge

Die Liste zeigt alle eingegangenen Anträge mit folgenden Informationen: - Gastname: Name des Gastes - Antragsteller: Welches Mitglied den Antrag gestellt hat - Angeldatum: Gewünschtes Datum - Gewässer: Gewähltes Gewässer - Status: Ausstehend / Genehmigt / Abgelehnt - Erstellt am: Zeitpunkt des Antrags

Schritt 2: Antrag bearbeiten¶

Verfügbare Aktionen in der Listenansicht:

1. Genehmigen (grüner Button)
2. Erstellt automatisch eine Tageskarte mit eindeutiger Nummer
3. Versendet E-Mail an das Mitglied mit Zahlungsdetails

4. Erstellt Rechnung im Hintergrund (falls kostenpflichtig)

5. Ablehnen (roter Button)

6. Antrag wird abgelehnt
7. E-Mail-Benachrichtigung an das Mitglied

8. Grund der Ablehnung kann in den Admin-Notizen eingetragen werden

9. PDF generieren (blauer Button)

10. Nur verfügbar nach Genehmigung
11. Erstellt druckfertige Tageskarte im PDF-Format

Detailansicht eines Antrags¶

Klicken Sie auf einen Antrag für weitere Details:

Gastinformationen - Persönliche Daten des Gastes - Hochgeladener Fischereischein

Angeldetails - Antragstellendes Mitglied - Gewähltes Datum und Gewässer

Antragsstatus - Aktueller Status und Notizen - Admin-Bearbeitung (wer hat wann bearbeitet)

2. Externe Käufe Workflow¶

Käufe verwalten¶

Wo: Admin → Tageskarten → Externe Gastkarten-Käufe

Die Liste zeigt: - Gastname: Name des Käufers - Gewässer: Gewähltes Gewässer - Kartentyp: Tag, Woche, Monat etc. - Angel-Zeitraum: Gültigkeitsdauer - Gesamtpreis: Berechneter Preis - Zahlungsstatus: Ausstehend / Bezahlt / Fehlgeschlagen / Erstattet

Zahlungsabwicklung¶

Verfügbare Aktionen:

1. Als bezahlt markieren
2. Ändert Status auf "Bezahlt"
3. Erstellt automatisch die Tageskarte

4. Gast erhält E-Mail mit Kartendetails

5. PDF generieren

6. Nur nach Zahlungseingang verfügbar

Tageskarten-Verwaltung¶

Übersicht aller Karten¶

Wo: Admin → Tageskarten → Ausgestellte Tageskarten

Diese zentrale Übersicht zeigt alle erstellten Tageskarten:

• Kartennummer: Format TK-JAHR-LAUFNUMMER (z.B. TK-2025-0001)
• Gastname: Name des Gastes
• Kartentyp: Badge zeigt "Mitglied" oder "Extern"
• Antragsteller: Mitgliedsname oder "Extern"
• Angeldatum: Mit Jahr-Markierung (aktuell/vergangen/zukunft)
• Gewässer: Zugewiesenes Gewässer
• Preis: Berechneter Betrag oder "Kostenlos"
• Rechnung: Status und Verlinkung zur Rechnung
• Ausgestellt am: Erstellungsdatum

Verfügbare Aktionen für Tageskarten¶

1. PDF generieren
2. Erstellt professionelle LaTeX-basierte Tageskarte
3. Enthält QR-Code zur Verifikation

4. Markiert Karte als "PDF generiert"

5. Kontrolle exportieren

6. CSV-Datei für Gewässeraufsicht
7. Enthält alle relevanten Kontrolldaten

QR-Code Verifikation¶

Jede Tageskarte erhält automatisch einen QR-Code: - Zweck: Mobile Kontrolle am Gewässer ohne Admin-Zugang - Funktionen: Status-Prüfung, Gültigkeits-Verifikation - Zugriff: Öffentlich verfügbar, kein Login erforderlich

Kontingent-Verwaltung¶

Gewässer-Kontingente einrichten¶

Wo: Admin → Tageskarten → Gewässer-Kontingente

Neue Kontingente erstellen¶

Gewässer und Zeitraum: - Gewässer: Aus vorhandenen Gewässern auswählen - Zeitraum-Typ: - Saison: Mit Start- und Enddatum (z.B. April bis September) - Jahr: Gesamtes Kalenderjahr - Jahr: Gültigkeitsjahr

Kontingente festlegen: - Externes Kontingent: Anzahl Karten für Direktkäufer - Mitglieder-Gäste Kontingent: Anzahl Karten für Vereinsmitglieder-Gäste

Preisgestaltung: - Grundpreis pro Tag: Basis-Tagespreis für externe Käufer - Mitglieder-Gäste Preis pro Tag: Preis für Mitglieder (oft 0 = kostenlos)

Kontingent-Überwachung¶

Die Liste zeigt live den Verbrauch: - Externes Kontingent: "Verbraucht/Gesamt" (z.B. "15/100") - Mitglieder-Gäste Kontingent: "Verbraucht/Gesamt" (z.B. "8/50")

Individuelle Mitglieder-Kontingente¶

Wo: Admin → Tageskarten → Individuelle Kontingente

Für Sonderfälle können einzelne Mitglieder abweichende Jahreskontingente erhalten: - Anwendungsfall: Vorstandsmitglieder, Ehrenmitglieder, besondere Verdienste - Einrichtung: Mitglied auswählen, Jahr und individuelle Anzahl festlegen - Notizen: Begründung für die Abweichung dokumentieren

Kartentypen-Verwaltung¶

Gastkarten-Typen definieren¶

Wo: Admin → Tageskarten → Gastkarten-Typen

Standard-Kartentypen erstellen¶

Kartentyp	Gültigkeitsdauer	Preis-Multiplikator	Beispielrechnung
Tageskarte	1 Tag	1.0	15€ × 1.0 = 15€
Wochenkarte	7 Tage	6.0	15€ × 6.0 = 90€
Monatskarte	30 Tage	25.0	15€ × 25.0 = 375€

Felder ausfüllen: - Name: Bezeichnung des Kartentyps - Gültigkeitsdauer (Tage): Anzahl gültiger Tage - Preis-Multiplikator: Faktor für Preisberechnung - Aktiv: Häkchen setzen für verfügbare Typen - Beschreibung: Zusätzliche Informationen (optional)

PDF-Konfiguration¶

Gewässer-spezifische Einstellungen¶

Wo: Admin → Tageskarten → Gewässer-PDF-Konfigurationen

Für jedes Gewässer können individuelle PDF-Einstellungen vorgenommen werden:

PDF-Konfiguration: - Besondere Bedingungen: Gewässer-spezifische Regelungen - Rechtlicher Hinweis: Überschreibt Standard-Rechtshinweise - Fang- und Gewässerordnung: Spezielle Fangregeln - Max. Handangeln: Anzahl erlaubter Ruten - Fang-Tabellen Zeilen: Zeilen in der Fangtabelle

Automatische Hintergrundprozesse¶

Was läuft automatisch ab?¶

1. Rechnungserstellung
2. Bei kostenpflichtigen Tageskarten wird automatisch eine Rechnung erstellt
3. Erfolgt im Hintergrund über Celery-Tasks

4. Rechnung ist in der Tageskarten-Liste verlinkt

5. E-Mail-Benachrichtigungen

6. Mitglieder: Benachrichtigung bei Genehmigung/Ablehnung mit Zahlungsdetails
7. Admins: Info über neue Anträge

8. Externe Käufer: Bestätigung nach Zahlungseingang

9. Kartennummern-Generierung

10. Automatische eindeutige Nummerierung: TK-JAHR-LAUFNUMMER

11. System verhindert Duplikate

12. QR-Code Generierung

13. Jede Karte erhält automatisch einen sicheren Verifikations-Token
14. QR-Code wird in PDF integriert

Suche und Filter¶

Effiziente Listen-Navigation¶

Tageskarten-Anträge: - Suche: Nach Gastname, Mitglied oder Mitgliedsnummer - Filter: Status, Datum, Gewässer, Antragsteller

Ausgestellte Tageskarten: - Suche: Kartennummer, Gastname oder Mitglied - Filter: Kartentyp, Gewässer, Datum, PDF-Status

Externe Käufe: - Suche: Gastname, E-Mail oder Gewässer - Filter: Zahlungsstatus, Kartentyp, Gewässer, Datum

Fehlerbehebung¶

Häufige Probleme und Lösungen¶

"Kontingent für dieses Gewässer ist ausgeschöpft"¶

Ursache: Das Gewässer-Kontingent ist vollständig verbraucht Lösung: 1. Gewässer-Kontingent prüfen und bei Bedarf erhöhen 2. Oder anderen Gewässer vorschlagen

"Mitglied hat keine verfügbaren Tageskarten für dieses Jahr"¶

Ursache: Jahreskontingent des Mitglieds ist aufgebraucht Lösung: 1. Individuelles Kontingent für das Mitglied erstellen 2. Oder Standard-Jahreslimit in Mitgliedschafts-Konfiguration erhöhen

PDF-Generierung schlägt fehl¶

Mögliche Ursachen: - Gewässer-PDF-Konfiguration fehlt - LaTeX-Compiler-Fehler

Lösung: 1. PDF-Konfiguration für das Gewässer erstellen 2. Bei wiederholten Fehlern: IT-Support kontaktieren

E-Mail kommt nicht an¶

Lösung: 1. Spam-Ordner prüfen 2. E-Mail-Adresse des Mitglieds/Gastes überprüfen 3. Bei wiederholten Problemen: E-Mail-Konfiguration prüfen lassen

Rechnung wird nicht erstellt¶

Ursache: Hintergrund-Task funktioniert nicht Lösung: 1. Prüfen ob price_charged > 0 ist 2. IT-Support über Celery-Worker-Status informieren

System-Validierungen verstehen¶

Das System führt automatische Prüfungen durch:

Bei Antragstellung: - Angeldatum darf nicht in der Vergangenheit liegen - Mitglied muss verfügbare Tageskarten haben - Gewässer-Kontingent muss verfügbar sein - Fischereischein-Upload ist Pflicht

Bei externer Buchung: - Externes Kontingent muss verfügbar sein - Alle Pflichtfelder müssen ausgefüllt sein - Preisberechnung erfolgt automatisch

Workflow-Optimierung¶

Empfohlene Arbeitsreihenfolge¶

1. Saisonvorbereitung (einmalig):
2. Gastkarten-Typen aktualisieren
3. Gewässer-Kontingente für neues Jahr/Saison festlegen

4. PDF-Konfigurationen prüfen

5. Tägliche Routine:

6. Neue Tageskarten-Anträge bearbeiten
7. Externe Käufe bei Zahlungseingang abwickeln

8. PDFs für genehmigte Karten generieren

9. Regelmäßige Kontrolle:

10. Kontingent-Auslastung überwachen
11. Bei Engpässen rechtzeitig Kontingente anpassen

Tastaturkürzel und Effizienz-Tipps¶

• Listensortierung: Spaltenüberschriften anklicken
• Mehrfachauswahl: Strg+Klick für mehrere Einträge
• Schnellsuche: Suchfeld nutzen statt scrollen
• Filter kombinieren: Mehrere Filter gleichzeitig verwenden