Fischereiaufsicht - Kontrollen & Sanktionen - Administrator Handbuch¶

Was ist das Controlling-Modul?¶

Das Modul "Fischereiaufsicht - Kontrollen & Sanktionen" ermöglicht es Fischereiaufsehern und Gewässerwarten, Kontrollen durchzuführen, Verwarnungen zu erteilen, Sanktionen zu verwalten und Kontrollpläne mit automatischer Slot-Verteilung zu erstellen. Es bietet eine vollständige Nachverfolgung aller Kontrollen mit automatischem Sanktions-Workflow, Streifenprotokollen, Kilometer-Dokumentation und revisionssicherer Protokollierung.

Wo finde ich das Modul?¶

Navigation: Admin-Panel → Controlling

Nach dem Anmelden im Admin-Panel: 1. Klicken Sie auf "Controlling" im Hauptmenü 2. Verfügbare Module: - Fischereikontrollen - Hauptverwaltung der Fischereikontrollen - Streifenprotokolle - Leerkontrollen und Streifenfahrten ohne kontrollierte Personen - Tages-Kilometereinträge (Kilometer-Log) - Tägliche Kilometerdokumentation für Aufseher und Warte - Sanktionsstatus - Übersicht aller Verwarnungen und Sperren - Kontroll-Audit-Logs - Revisionssichere Protokollierung aller Änderungen - Gewässerkontroll-Pläne (Kontrollpläne) - Erstellung und Verwaltung von Kontrollplänen mit Zeitslots - Kontroll-Zeitslots - Übersicht aller generierten Zeitslots und deren Zuweisung - Slot-Tausch-Protokolle - Nachverfolgung aller Slot-Tauschvorgänge

Kontrollpläne (WaterControlPlan)¶

Was sind Kontrollpläne?¶

Kontrollpläne ermöglichen die strukturierte Planung und Organisation von Gewässerkontrollen. Ein Plan legt fest: - Welche Gewässer kontrolliert werden sollen - Welche Personen (Gewässerwarte oder Fischereiaufseher) kontrollieren - In welchem Zeitraum die Kontrollen stattfinden - In welchem Rhythmus die Zeitslots generiert werden (jährlich, halbjährlich, monatlich, halbmonatlich, 2-Wochen-Turnus, 3-Wochen-Turnus, wöchentlich oder frei)

Einen neuen Kontrollplan erstellen¶

Navigation: Controlling → Kontrollpläne → Kontrollplan hinzufügen

Schritt 1: Grunddaten festlegen¶

Schritt 2: Planzeitraum definieren¶

Schritt 3: Zeitplan-Typ wählen¶

Der Zeitplan-Typ bestimmt, wie die Zeitslots automatisch generiert werden:

Schritt 4: Gewässer zuordnen¶

Im Bereich "Gewässer" können Sie die zu kontrollierenden Gewässer auswählen: - Mehrfachauswahl möglich - Autovervollständigung nach Gewässername

Schritt 5: Personen (Warte/Aufseher) hinzufügen¶

Im Inline-Bereich "Plan-Personen-Zuordnungen" fügen Sie die Personen hinzu:

Schritt 6: Benachrichtigungs-Einstellungen¶

Slots generieren und Personen verteilen¶

Nach dem Speichern des Plans stehen in der Detailansicht drei Aktionen zur Verfügung:

Aktion 1: "Zeitslots generieren"¶

• Generiert automatisch Zeitslots basierend auf dem gewählten Zeitplan-Typ
• Berücksichtigt den Planzeitraum (Start- bis Endmonat/Jahr)
• Vorhandene Slots werden nicht überschrieben

Beispiel bei "Halbmonatlich" von Januar bis März: - Slot 1: 01.01. - 15.01. - Slot 2: 16.01. - 31.01. - Slot 3: 01.02. - 15.02. - Slot 4: 16.02. - 28.02. - Slot 5: 01.03. - 15.03. - Slot 6: 16.03. - 31.03.

Aktion 2: "Personen verteilen (Rotation)"¶

• Verteilt die zugeordneten Personen im Round-Robin-Verfahren auf die vorhandenen Slots
• Berücksichtigt nur aktive Personen (is_active = True)
• Die Verteilung folgt der Rotations-Reihenfolge
• Bei aktivierter Benachrichtigung werden Push-Nachrichten an die Personen gesendet (asynchron via Celery)

Beispiel Round-Robin mit 3 Personen (A, B, C) auf 6 Slots:

Aktion 3: "Slots generieren UND Personen verteilen" (Kombiaktion)¶

• Führt beide Aktionen in einem Schritt aus
• Achtung: Löscht zuerst alle bestehenden Slots und generiert sie komplett neu
• Nützlich wenn sich der Planzeitraum oder Zeitplan-Typ geändert hat

Kontrollplan-Workflow (Zusammenfassung)¶

1. Kontrollplan erstellen (Name, Typ, Zeitraum, Zeitplan-Typ)
2. Gewässer zuordnen
3. Personen hinzufügen (mit Rotations-Reihenfolge)
4. Plan speichern
5. Aktion "Zeitslots generieren" ausführen
6. Aktion "Personen verteilen (Rotation)" ausführen
   → Slots werden erstellt und Personen im Round-Robin zugewiesen
   → Push-Benachrichtigungen werden gesendet

Kontroll-Zeitslots (ControlSlot)¶

Übersicht¶

Navigation: Controlling → Kontroll-Zeitslots

Die Kontroll-Zeiträume zeigen alle generierten Zeitslots aller Pläne. Jeder Slot hat:

Status-Bedeutung¶

Slot-Tausch durchführen¶

Wenn eine zugewiesene Person verhindert ist, kann der Slot getauscht werden:

1. Öffnen Sie die Liste der Kontroll-Zeiträume
2. Verwenden Sie die Zeilen-Aktion "Tauschen" beim betreffenden Slot
3. Wählen Sie im Dialog den neuen Gewässerwart und optional einen Grund aus
4. Nach Speicherung:
5. Die ursprüngliche Zuordnung bleibt unter "Ursprüngliche Person" gespeichert
6. Der Status wechselt von "Geplant" auf "Getauscht"
7. Ein Eintrag im Tausch-Protokoll wird automatisch erstellt
8. Bei aktivierter Benachrichtigung werden Push-Nachrichten asynchron versendet

Slot-Tausch-Protokolle (SlotSwapLog)¶

Übersicht¶

Navigation: Controlling → Slot-Tausch-Protokolle

Das Tausch-Protokoll dokumentiert alle Slot-Tauschvorgänge revisionssicher:

Streifenprotokolle (PatrolLog)¶

Was sind Streifenprotokolle?¶

Navigation: Controlling → Streifenprotokolle

Streifenprotokolle dokumentieren Kontrollgänge und Streifenfahrten, bei denen keine Personen kontrolliert wurden. Sie dienen als Nachweis der Anwesenheit und Aktivität der Aufseher/Warte.

Typen¶

Erfassungsarten (source_type)¶

Felder¶

Tages-Kilometereinträge (DailyMileageLog)¶

Übersicht¶

Navigation: Controlling → Tages-Kilometereinträge

Das Kilometer-Log dokumentiert die täglichen Fahrkilometer von Fischereiaufsehern und Gewässerwarten für die Abrechnung und Nachweisführung.

Felder¶

Rollen¶

Gewässer-Status-Tags (WaterStatusTag)¶

Übersicht¶

Navigation: Gewässer → Gewässer-Status-Tags

Gewässer-Status-Tags sind konfigurierbare Labels, die den aktuellen Zustand eines Gewässers beschreiben. Sie werden bei Streifenprotokollen verwendet, um den Gewässerzustand zu dokumentieren. Das Modell ist im Modul waters definiert und wird im Admin unter Gewässer verwaltet.

Beispiele für Status-Tags¶

Tag-Konfiguration¶

Die Hauptansicht verstehen¶

Dense Mode - Kompakte Tabellenansicht¶

Die Listenansicht wurde für maximale Effizienz optimiert:

Suchfunktion verwenden¶

Wo: Suchfeld oben rechts (Platzhaltertext: "Name, Mitgliedsnummer suchen") Was durchsucht wird: - Vorname / Nachname des Anglers - Mitgliedsnummer

Verwendung: Tippen Sie einen Begriff ein und drücken Sie Enter

Filter einsetzen¶

Wo: Rechte Seitenleiste "Filter"

Verfügbare Filter:¶

Angler-Filter: - Klicken Sie auf das Dropdown - Beginnen Sie mit der Eingabe des Namens oder der Mitgliedsnummer - Das System schlägt passende Mitglieder vor - Wählen Sie das gewünschte Mitglied aus

Aufseher-Filter: - Zeigt nur Benutzer mit Aufseher-Berechtigung - Autovervollständigung für Aufsehernamen

Gewässer-Filter: - Autovervollständigung für Gewässernamen - Zeigt nur Gewässer mit erfolgten Kontrollen

Zeitraum-Filter (Kontrolldatum): - "Von" und "Bis" für Datumsbereich (RangeDateFilter) - Format: DD.MM.YYYY - Zusätzlich steht oberhalb der Liste die Datums-Hierarchie ("date_hierarchy") für schnelle Navigation nach Jahr/Monat/Tag bereit.

Status-Filter: - "In Ordnung" - Grüne Kontrollen - "Auffällig" - Rote Kontrollen

Verwarnung erteilt-Filter: - Ja / Nein - Filtert Kontrollen mit/ohne erteilter Verwarnung

Archiviert-Filter: - Ja / Nein - Filtert aktive vs. archivierte Kontrollen

Mögliche Doppelkontrolle-Filter: - Ja / Nein - Filtert Kontrollen, die als Doppelkontrolle markiert wurden

Hinweis: Der Sanktions-Filter (1. Verwarnung / 2. Verwarnung / Gesperrt) befindet sich im separaten Bereich Controlling → Sanktionsstatus, nicht in der Kontrollen-Liste.

Aktionen ausführen¶

Neue Kontrolle erfassen¶

Wo: Schaltfläche "Kontrolle hinzufügen" (oben rechts)

Schritt-für-Schritt: 1. Klicken Sie auf "Kontrolle hinzufügen" 2. Das Formular öffnet sich mit folgenden Feldern:

Pflichtfelder (müssen ausgefüllt werden):¶

• Angler: Autovervollständigung - tippen Sie Name oder Mitgliedsnummer
• Aufseher: Dropdown-Auswahl (zeigt nur berechtigte Aufseher)
• Kontrollzeitpunkt: Datum und Uhrzeit (Standardwert: Jetzt)
• Status: "In Ordnung" oder "Auffällig"

Optionale Felder:¶

• Gewässer: Autovervollständigung für Gewässername
• Notizen: Freitextfeld für Verstoßdetails

• Verwarnung erteilen: Checkbox bei auffälligen Kontrollen

• Bei auffälliger Kontrolle:

• Aktivieren Sie "Verwarnung erteilen" falls angemessen
• System zeigt aktuelle Sanktionsstufe des Anglers

• Bei 3. Verwarnung erfolgt automatische Sperre

• Klicken Sie "Sichern" zum Speichern

• System prüft auf Duplikate (gleicher Angler am selben Tag)

Bestehende Kontrolle bearbeiten¶

Wo: Klick auf eine beliebige Zeile in der Tabelle

Schritt-für-Schritt: 1. Klicken Sie auf die gewünschte Kontrolle in der Liste 2. Das Bearbeitungsformular öffnet sich mit den aktuellen Daten 3. Ändern Sie die gewünschten Felder 4. Bei Statusänderung von "i.O." auf "Auffällig": - Option zur Verwarnungserteilung erscheint - Aktuelle Sanktionsstufe wird angezeigt 5. Klicken Sie "Sichern" oder "Sichern und weiter bearbeiten"

Batch-Aktionen (Mehrfachauswahl)¶

Wo: Checkboxen in der ersten Spalte der Listenansicht

Verfügbare Batch-Aktionen:¶

CSV-Export: 1. Wählen Sie Kontrollen durch Anklicken der Checkboxen 2. Wählen Sie "CSV exportieren" aus dem Aktions-Dropdown 3. Klicken Sie "Ausführen" 4. CSV-Datei wird heruntergeladen

Als Verwarnung markieren: 1. Wählen Sie auffällige Kontrollen aus 2. Wählen Sie "Als Verwarnung markieren" 3. System aktualisiert Sanktionsstatus automatisch

Archivieren: 1. Wählen Sie alte i.O.-Kontrollen aus (>1 Jahr) 2. Wählen Sie "Archivieren" 3. Kontrollen werden ins Archiv verschoben

Löschen (nur mit Berechtigung): 1. Wählen Sie zu löschende Kontrollen 2. Wählen Sie "Ausgewählte Kontrollen löschen" 3. Bestätigen Sie die Löschung

Sanktions-System verstehen¶

Automatischer Eskalations-Workflow¶

Das System verwaltet automatisch die Eskalation von Verwarnungen:

Stufe 0 - Keine Sanktion: - ✅ Angler ohne Verwarnungen - Alle Kontrollen waren i.O. oder auffällig ohne Verwarnung

Stufe 1 - Erste Verwarnung (1️⃣): - ⚠️ Erste auffällige Kontrolle mit Verwarnung - Angler wird mündlich/schriftlich verwarnt - Status: WARN1

Stufe 2 - Zweite Verwarnung (2️⃣): - ⚠️⚠️ Zweite auffällige Kontrolle mit Verwarnung - Letzte Warnung vor Sperre - Status: WARN2 - Warnung im System: "Nächster Verstoß → Sperre"

Stufe 3 - Automatische Sperre (🚫): - 🚫 Dritte auffällige Kontrolle mit Verwarnung (konfigurierbar via controlling_warnings_before_suspension, Standard 3) - Automatische Sperre (Standarddauer 30 Tage; konfigurierbar via controlling_suspension_duration_days) - Voraussetzung: controlling_enable_automatic_suspension = True (Standard) - Status: SUSPENDED - Angler darf nicht mehr angeln - Sperre muss manuell aufgehoben werden

Verwarnungs-Verwaltung¶

Verwarnung erteilen: 1. Bei auffälliger Kontrolle Toggle "Verwarnung" aktivieren 2. System zeigt aktuelle Sanktionsstufe 3. Bei 3. Verwarnung erfolgt automatische Sperre

Sperre aufheben: 1. Navigation: Controlling → Sanktionsstatus 2. Betroffenes Mitglied suchen 3. "Sperre aufheben" wählen 4. Datum eingeben oder sofort aufheben

Steckbrief-Ansicht (Member Profile)¶

Nach QR-Code-Scan oder manueller Suche wird ein umfassender Angler-Steckbrief angezeigt:

Kopfbereich¶

• Name und Mitgliedsnummer
• Aktueller Sanktionsstatus (Farbcodiert)
• Schnellübersicht: Letzte Kontrolle, aktive Verwarnungen

Statistik-Kacheln¶

• Anzahl Kontrollen gesamt
• Anzahl Verwarnungen
• Letzte Auffälligkeit (Datum)
• Sperrhistorie (falls vorhanden)

Kontrollhistorie¶

Chronologische Liste aller Kontrollen mit: - Datum und Uhrzeit - Kontrollierender Aufseher - Gewässer - Status (i.O./Auffällig) - Verwarnungen - Notizen

Warnhinweise¶

Bei kritischen Status erscheinen prominente Warnungen: - Bei 2 Verwarnungen: ⚠️ "Nächster Verstoß führt zur automatischen Sperre!" - Bei Sperre: 🚫 "GESPERRT bis [Datum]"

Praktische Arbeitsabläufe¶

QR-Code Kontrolle (Mobile App)¶

Ausgangssituation: Kontrolle vor Ort mit QR-Code-Scanner

1. QR-Code scannen mit mobiler App
2. Steckbrief wird automatisch angezeigt
3. Sanktionsstatus prüfen:
4. Grün = Alles OK
5. Gelb = Verwarnungen vorhanden
6. Rot = Gesperrt
7. Neue Kontrolle erfassen:
8. Button "Neue Kontrolle" im Steckbrief
9. Formular ist vorausgefüllt mit Angler-Daten
10. Status und Notizen eingeben
11. Speichern

Verwarnungs-Workflow durchführen¶

Ausgangssituation: Verstoß festgestellt, Verwarnung soll erteilt werden

1. Kontrolle erfassen als "Auffällig"
2. Verwarnungs-Toggle aktivieren
3. System zeigt:
4. Aktuelle Sanktionsstufe (0, 1 oder 2 Verwarnungen)
5. Warnung bei kritischer Stufe
6. Bei Erreichen der Sperrgrenze (Standard: 3. Verwarnung):
7. Automatische Sperre (Standarddauer 30 Tage, konfigurierbar)
8. Audit-Log-Eintrag mit Aktion "Sperre verhängt"
9. Angler-Status wird auf "Gesperrt" gesetzt
10. Dokumentation: Detaillierte Notizen zum Verstoß

Kontrollplan-Workflow (Neuen Plan einrichten)¶

Ausgangssituation: Für die neue Saison sollen die Gewässerkontrollen geplant werden

1. Navigation: Controlling → Kontrollpläne → Kontrollplan hinzufügen
2. Plan erstellen:
3. Name: z.B. "Sommerplan Seen 2025"
4. Typ: Gewässerwarte oder Fischereiaufseher
5. Zeitraum: z.B. April 2025 bis Oktober 2025
6. Zeitplan: z.B. Halbmonatlich
7. Gewässer zuordnen (alle relevanten Gewässer auswählen)
8. Personen hinzufügen (mit gewünschter Rotations-Reihenfolge)
9. Speichern
10. Aktion "Slots generieren UND Personen verteilen" ausführen → System erstellt alle Zeitslots → Personen werden per Round-Robin zugewiesen → Push-Benachrichtigungen werden gesendet
11. Ergebnis prüfen unter Controlling → Kontroll-Zeitslots

Saisonende-Reset durchführen¶

Ausgangssituation: Neue Saison beginnt, Verwarnungen sollen zurückgesetzt werden

Was passiert beim Saisonende-Reset:

• Verwarnungen werden auf 0 zurückgesetzt
• Alte i.O.-Kontrollen (>1 Jahr) werden archiviert
• Sperren bleiben standardmäßig bestehen (können optional aufgehoben werden)

Vorgehensweise:

1. Kontaktieren Sie den technischen Administrator mit der Anfrage zum Saisonende-Reset
2. Teilen Sie mit, ob bestehende Sperren beibehalten oder aufgehoben werden sollen
3. Nach Durchführung: Prüfen Sie unter Controlling → Sanktionsstatus, ob die Verwarnungen korrekt zurückgesetzt wurden

Export für Jahresbericht¶

Ausgangssituation: Jahresstatistik für Vereinsversammlung

1. Navigation: Controlling → Fischereikontrollen
2. Zeitraum-Filter: Komplettes Jahr einstellen
3. Alle Kontrollen auswählen (Checkbox im Header)
4. Aktion: "CSV exportieren"
5. Statistik-Endpoint nutzen für Zusammenfassung:
6. API: /api/v2/control-checks/statistics/
7. Zeigt: Anzahl Kontrollen, Verwarnungen, Sperren

Audit-Log System¶

Was wird protokolliert?¶

Das System protokolliert automatisch alle Änderungen:

Erfasste Aktionen: - CREATE: Neue Kontrolle angelegt - UPDATE: Kontrolle bearbeitet - DELETE: Kontrolle gelöscht - WARNING: Verwarnung erteilt - SUSPENSION: Sperre verhängt/aufgehoben

Gespeicherte Informationen: - Zeitstempel (sekundengenau) - Benutzer (wer hat die Änderung vorgenommen) - IP-Adresse - Alte Werte (JSON) - Neue Werte (JSON) - Betroffener Angler - Aktionstyp

Audit-Log einsehen¶

Navigation: Controlling → Kontroll-Audit-Logs

Filter-Optionen: - Nach Benutzer - Nach Aktionstyp - Nach Zeitraum - Nach betroffenem Angler

Sanktionsstatus-Verwaltung¶

Übersicht Sanktionen¶

Navigation: Controlling → Sanktionsstatus

Tabellenansicht zeigt: - Angler-Name - Anzahl Verwarnungen (0-2) - Status (Keine/WARN1/WARN2/SUSPENDED) - Gesperrt bis (Datum oder "-") - Letzte Änderung

Batch-Aktionen für Sanktionen¶

Verwarnungen zurücksetzen: 1. Mitglieder auswählen 2. Aktion "Verwarnungen zurücksetzen" 3. Bestätigen

Sperren aufheben: 1. Gesperrte Mitglieder auswählen 2. Aktion "Sperren aufheben" 3. Optional: End-Datum eingeben

Wichtige Hinweise für Administratoren¶

RBAC - Rollenbasierte Zugriffskontrolle¶

Gruppenberechtigungen: - Fischereiaufseher-Gruppe: Kann Kontrollen erfassen und bearbeiten - Gewässerwart-Gruppe: Kann Streifenprotokolle und Kilometer erfassen - Admin-Gruppe: Vollzugriff inkl. Löschungen, Sanktionsverwaltung und Kontrollpläne - Normale Mitglieder: Kein Zugriff auf Controlling-Modul

Mandantentrennung: - Jeder Mandant sieht nur seine eigenen Kontrollen - Keine mandantenübergreifende Einsicht möglich - Aufseher können nur Mitglieder ihres Mandanten kontrollieren

Performance-Optimierungen¶

Bei großen Datenmengen (>1000 Kontrollen): - Nutzen Sie Zeitraum-Filter für bessere Performance - Archivieren Sie alte i.O.-Kontrollen regelmäßig - CSV-Exporte werden bei >500 Einträgen gepuffert

Indizierung: - Datenbankindizes auf: angler, inspector, checked_at, status - Volltextsuche optimiert für Namen und Notizen - Caching von Sanktionsstatus für schnellere Anzeige

Datenschutz & DSGVO¶

Personenbezogene Daten: - Kontrollen enthalten personenbezogene Daten - Löschfristen gemäß DSGVO beachten - Archivierung nach 3 Jahren empfohlen - Vollständige Löschung nach 10 Jahren

Exportfunktionen: - CSV-Exporte nur für berechtigte Personen - PDF-Steckbriefe enthalten sensible Daten - Downloads werden im Audit-Log protokolliert

Backup & Wiederherstellung¶

Troubleshooting¶

Häufige Probleme:

Problem: Duplikatsmeldung bei Kontrolle Lösung: Prüfen Sie, ob bereits eine Kontrolle am selben Tag existiert

Problem: Verwarnung wird nicht gezählt Lösung: Stellen Sie sicher, dass der Toggle "Verwarnung" aktiviert ist

Problem: Sperre wird nicht automatisch verhängt Lösung: Prüfen Sie den SanctionState des Anglers - evtl. manuell zurückgesetzt?

Problem: Archivierte Kontrollen werden nicht angezeigt Lösung: Archiv-Filter auf "Alle Kontrollen" setzen

Problem: Slots werden nicht generiert Lösung: Prüfen Sie, ob Start- und Endzeitraum korrekt gesetzt sind und der Zeitplan-Typ nicht "Freie Vergabe" ist

Problem: Personen erscheinen nicht in der Plan-Auswahl Lösung: Stellen Sie sicher, dass der Plan-Typ (Gewässerwart/Fischereiaufseher) zur Person passt

Problem: Push-Benachrichtigungen werden nicht gesendet Lösung: Prüfen Sie ob "Benachrichtigung bei Zuweisung" aktiviert ist und der Celery-Worker läuft