Fänge (Catches) - Administrator-Handbuch¶

Übersicht¶

Das Fänge-Modul verwaltet alle Fischfänge der Vereinsmitglieder. Hier können Fänge eingetragen, bearbeitet, gefiltert und verschiedene Statistiken erstellt werden.

Navigation im Admin-Interface¶

Um das Fänge-Modul zu erreichen:

1. Admin-Login → Hauptmenü
2. "FISCHEREIVEREIN_WANGEN" → "Catches" auswählen

Hauptfunktionen¶

1. Fänge anzeigen und verwalten¶

Wo: Admin → Fischereiverein_Wangen → Catches

Listenansicht¶

Die Hauptübersicht zeigt alle Fänge mit folgenden Informationen: - Fisch: Gefangene Fischart - Größe: Länge des Fisches in cm - Gewässer: Ort des Fangs - Fangdatum: Datum des Fangs (Format: TT.MM.JJJJ) - Nachts: Ob nachts gefangen (Ja/Nein) - Name: Mitglied, das gefangen hat (verlinkter Name) - Gast: Name des Gastes (falls vorhanden) - Gastgeber: Wer den Gast eingeladen hat (verlinkter Name)

Suchfunktion¶

Suchen Sie nach: - Mitgliedsnamen (Benutzername, Vor-/Nachname) - Gewässernamen - Fischarten - Gastnamen

Filterfunktionen¶

Verfügbare Filter: - Member: Nach spezifischem Mitglied filtern - Fish: Nach Fischart filtern
- Water: Nach Gewässer filtern - Season Filter: Nach Saison filtern - Catch date: Nach Fangdatum filtern

2. Einzelnen Fang bearbeiten¶

Wo: Listenansicht → Fisch oder Fangdatum anklicken

Bearbeitbare Felder:¶

• Member: Mitglied zuweisen/ändern
• Water: Gewässer auswählen (nur nicht gesperrte Gewässer verfügbar)
• Fish: Fischart auswählen (optional)
• Size: Größe in cm eingeben
• Weight: Gewicht in Gramm eingeben
• Catch date: Fangdatum festlegen
• Caught at night: Häkchen für Nachtfang
• Guest name: Name des Gastes
• Invited by: Gastgeber auswählen

3. Export-Funktionen¶

Verfügbare Exports:¶

In der Listenansicht (Actions-Dropdown): - Export fish catch by day: CSV-Export der täglichen Fangentwicklung - Export fish by water body to CSV: CSV-Export nach Gewässern

Als Button-Aktionen (oben in der Liste): - Statistiken (Saison): Excel-Report für aktuelle Saison - Statistiken (letzte Saison): Excel-Report für vorherige Saison
- Statistiken (Gesamt): Excel-Report für alle Daten

Excel-Statistik-Reports¶

Die Excel-Reports enthalten: - Gesamt-Tab: Zusammenfassung aller Monate - Monats-Tabs: Detaillierte Aufschlüsselung pro Monat - Automatische Diagramme: Visualisierung der Fangstatistiken - Angeltage-Berechnung: Echte Angeltage pro Gewässer - Kumulierte Angeltage: Aufsummierte Werte über die Saison

4. Neuen Fang hinzufügen¶

Wo: Listenansicht → "Catch hinzufügen" (oben rechts)

Pflichtfelder:¶

• Water: Gewässer muss ausgewählt werden (nur nicht gesperrte verfügbar)
• Catch date: Fangdatum muss gesetzt werden

Optionale Felder:¶

• Member: Kann leer bleiben für Gast-Fänge
• Fish: Kann leer bleiben (z.B. bei Schneidertouren)
• Size/Weight: Größe und Gewicht optional
• Guest name/Invited by: Nur bei Gast-Fängen

5. OCR-Digitalisierung (Optical Character Recognition)¶

Wo: Listenansicht → "OCR Upload" Button oder "OCR Dokumente" Tab

Was ist OCR?¶

OCR (Optical Character Recognition) ist eine Technologie zur automatischen Texterkennung in Bildern und Scans. Das System kann: - Handgeschriebene Fangprotokolle lesen - Gedruckte Tabellen analysieren - Text aus Fotos extrahieren - Daten strukturiert erfassen

OCR-Workflow¶

1. Dokument hochladen¶

Navigation: Admin → Catches → "OCR Upload" oder "OCR Dokumente" Tab → "OCR Dokument hinzufügen"

Unterstützte Formate: - JPG/JPEG: Fotos von Fangprotokollen - PNG: Screenshots oder Scans - PDF: Mehrseitige gescannte Dokumente

Eingabefelder: - Original file: Datei auswählen (Scan/Foto) - For member: Mitglied auswählen, für das die Fänge sind - Document date: Datum des Protokolls (optional) - Notes: Notizen zum Dokument (optional)

2. Automatische Verarbeitung¶

Nach dem Upload: 1. Status wechselt zu "Processing" 2. OCR-Engine (Tesseract) analysiert das Dokument 3. System extrahiert erkannte Texte 4. Intelligente Zuordnung versucht: - Datumsangaben zu erkennen - Gewässernamen zu matchen (auch Abkürzungen) - Fischarten zu identifizieren (inkl. umgangssprachliche Namen) - Zahlen als Größe/Gewicht zu interpretieren 5. Status wechselt zu "Extracted" oder "Failed"

3. Manuelle Überprüfung¶

Navigation: OCR Dokumente → Dokument auswählen → "Review Entries" Action

Review-Interface: - Linke Seite: Original-Dokument zur Referenz - Rechte Seite: Erkannte Einträge in Tabellenform - Pro Eintrag bearbeitbar: - Datum korrigieren - Gewässer aus Dropdown wählen - Fischart aus Dropdown wählen - Größe/Gewicht anpassen - Nachtfang markieren - Gastname eintragen

Aktionen pro Eintrag: - ✓ Bestätigen: Eintrag ist korrekt - ✏️ Bearbeiten: Werte korrigieren - ✗ Löschen: Fehlerkennungen entfernen

4. Import ins System¶

Nach der Überprüfung: 1. "Approve All" → Alle Einträge für Import freigeben 2. "Import Approved" → Genehmigte Einträge als echte Fänge importieren 3. Status wechselt zu "Completed" 4. Importierte Fänge erscheinen in der normalen Fänge-Liste

OCR-Tabs Navigation¶

Das System bietet drei zusammenhängende Tabs:

1. Fänge: Normale Fänge-Verwaltung
2. OCR Dokumente: Hochgeladene Scans und deren Status
3. OCR Einträge: Einzelne erkannte Fangeinträge zur Detailbearbeitung

Intelligente Texterkennung¶

Das System versteht verschiedene Schreibweisen:

Gewässer-Erkennung: - "Weiher" → Vereinsweiher - "VW" → Vereinsweiher
- "Argen" → Untere/Obere Argen (kontextabhängig) - Abkürzungen und Varianten werden erkannt

Fischarten-Erkennung: - "Karpfen", "K" → Karpfen - "Forelle", "ReFo", "BaFo" → Regenbogenforelle/Bachforelle - "Hecht", "H" → Hecht - Umgangssprachliche Namen werden zugeordnet

Datums-Erkennung: - "15.03.2024", "15.03.24", "15/03/2024" - "15. März", "März 15" - Verschiedene Formate werden verstanden

Tipps für bessere OCR-Ergebnisse¶

Dokumentqualität: - Gute Beleuchtung bei Fotos - Gerader Winkel ohne Verzerrung - Hoher Kontrast (dunkle Schrift auf hellem Papier) - Mindestens 300 DPI bei Scans

Dokumentvorbereitung: - Knitterfreie Papiere - Saubere, leserliche Handschrift - Strukturierte Tabellen bevorzugt - Eindeutige Spaltenbeschriftungen hilfreich

Nachbearbeitung: - Immer alle Einträge kontrollieren - Bei unleserlichen Stellen Original konsultieren - Plausibilität prüfen (Datum, Größen)

OCR vs. Massen-Fangeingabe¶

OCR verwenden bei: - Großen Mengen (>50 Einträge) - Schwer lesbarer Handschrift - Bereits digitalisierten Dokumenten (Scans, PDFs) - Unstrukturierten Protokollen

Massen-Fangeingabe verwenden bei: - Kleinen Mengen (<50 Einträge) - Gut lesbaren Protokollen - Standardisierten Formularen - Wenn höchste Genauigkeit erforderlich

6. Massen-Fangeingabe (Bulk Entry)¶

Wo: Listenansicht → "Massen-Fangeingabe" Button (grün, oben in der Liste)

Die Massen-Fangeingabe ist optimiert für die schnelle Übertragung von Papier-Fangprotokollen in das digitale System.

Hauptfunktionen:¶

Tabellenansicht¶

• 10 Zeilen gleichzeitig bearbeitbar
• Spreadsheet-ähnliche Bedienung
• Dropdown-Suche für Mitglieder, Gewässer und Fischarten
• Echtzeit-Validierung der Eingaben

Effizienter Workflow:¶

1. Erste Zeile komplett ausfüllen
2. Enter drücken → springt zur nächsten Zeile
3. Ctrl+D drücken → kopiert ALLE Werte von der Zeile darüber
4. Nur abweichende Felder ändern
5. Ctrl+S oder "Alle Fänge speichern" → Speichert alle Einträge

Tastaturkürzel:¶

• Tab → Nächstes Feld (horizontal)
• Enter → Nächste Zeile (vertikal, gleiche Spalte)
• Ctrl+D → Kopiert alle Werte von der Zeile darüber
• Ctrl+N → Fügt neue Zeile hinzu
• Ctrl+S → Speichert alle Fänge

Intelligentes Speichern:¶

Bei unvollständigen Einträgen erscheint ein Dialog mit drei Optionen: - Nur vollständige speichern → Speichert nur korrekte Einträge - Alle speichern → Speichert auch unvollständige (für spätere Bearbeitung) - Weiter bearbeiten → Schließt Dialog, keine Aktion

Statistik-Anzeige:¶

• Heutige Fänge: Anzahl der heute eingetragenen Fänge
• Aktuelle Zeilen: Anzahl der ausgefüllten Zeilen
• Bereit zum Speichern: Anzahl der vollständigen Einträge

Auto-Speicherung:¶

• Entwürfe werden alle 30 Sekunden automatisch gespeichert
• Bei Browserproblemen gehen keine Daten verloren
• Wiederherstellung mit SweetAlert2-Dialog

Optimiert für Papier-Übertragung:¶

Typischer Anwendungsfall: Mitglieder geben Papier-Fangprotokolle ab, die nach Mitglied und Datum sortiert sind.

Effizienter Ablauf: 1. Sortieren Sie die Papiere nach Mitglied und Datum 2. Tragen Sie den ersten Fang komplett ein 3. Nutzen Sie Ctrl+D für gleiche Mitglieder/Daten 4. Ändern Sie nur Fischart, Größe, Gewicht 5. Speichern Sie regelmäßig zwischendurch

Hintergrundprozesse¶

Automatische Benachrichtigungen¶

Monatliche Top-10 Benachrichtigung: - Läuft automatisch am Monatsende - Sendet Push-Benachrichtigung an alle Mitglieder - Zeigt die 10 größten Fänge des vergangenen Monats - Erstellt automatisch einen Post im System

Monatlicher Email-Report: - Sendet Excel-Statistik per E-Mail an konfigurierte Empfänger - Verwendet aktuelle Saison als Datengrundlage - Läuft als Hintergrund-Task

Besondere Funktionen¶

Saisonale Filterung¶

Das System arbeitet mit konfigurierbaren Saisons: - Aktuelle Saison: Basiert auf Vereinskonfiguration - Vorherige Saison: Automatisch berechnet - Saison-Manager: Filtert automatisch nach konfigurierten Zeiträumen

Kohorten-Analyse¶

In der Admin-Ansicht wird eine Heatmap angezeigt: - Zeigt Fangverteilung nach Fischarten und Gewässern - Nur für aktuelle Saison - Farbkodierung basierend auf Fanganzahl - Automatische Sortierung nach Häufigkeit

Verknüpfungen¶

Klickbare Links in der Liste: - Mitglieder-Namen: Führen zur Mitglieder-Detailansicht - Gastgeber-Namen: Führen zur Gastgeber-Detailansicht - Fisch/Datum: Führen zur Fang-Bearbeitung

Wichtige Hinweise¶

Datenlöschung¶

Datenintegrität¶

• Fänge bleiben bestehen, auch wenn das zugehörige Mitglied gelöscht wird
• Bei Löschung von Gewässern werden auch alle Fänge in diesem Gewässer gelöscht
• Fischart kann nachträglich geändert oder entfernt werden

Gewässersperrungen (NEU)¶

• Validierung auf API-Ebene: Verhindert Fang-Einträge über die mobile App
• Validierung auf Datenbank-Ebene: Zusätzliche Sicherheit im Backend
• Fehlermeldungen: Zeigen immer den Sperrgrund an
• Bestehende Fänge: Bleiben erhalten, auch wenn Gewässer nachträglich gesperrt wird
• Automatische Aufhebung: Sperrungen mit Enddatum werden automatisch aufgehoben

Performance¶

• Große Datenmengen können Export-Vorgänge verlangsamen
• Nutzen Sie Filter vor dem Export für bessere Performance
• Saisonale Filter reduzieren die Datenmenge erheblich

Häufige Arbeitsabläufe¶

Monatsstatistik erstellen¶

1. Admin → Catches aufrufen
2. "Season Filter" auf gewünschte Periode setzen
3. Button "Statistiken (Saison)" klicken
4. Excel-Datei wird heruntergeladen

Papier-Fangprotokolle digitalisieren¶

Option 1: Manuelle Massen-Fangeingabe¶

1. Admin → Catches → "Massen-Fangeingabe" klicken
2. Papiere nach Mitglied und Datum sortieren
3. Ersten Fang komplett eintragen
4. Enter → nächste Zeile
5. Ctrl+D → kopiert alle Daten von oben
6. Nur abweichende Felder ändern (meist nur Fisch, Größe, Gewicht)
7. Nach 10 Einträgen → Ctrl+S zum Speichern
8. Fortfahren bis alle Papiere erfasst sind

Option 2: OCR-basierte Digitalisierung (NEU)¶

1. Admin → Catches → "OCR Upload" klicken oder zu "OCR Dokumente" Tab wechseln
2. Scan/Foto des Papier-Protokolls hochladen
3. System extrahiert automatisch die Fangdaten
4. Manuelle Überprüfung und Korrektur der erkannten Einträge
5. Import der bestätigten Fänge ins System

Mehrere Fänge eines Mitglieds erfassen¶

1. "Massen-Fangeingabe" öffnen
2. Mitglied in erster Zeile auswählen
3. Alle Daten des ersten Fangs eingeben
4. Enter → nächste Zeile
5. Ctrl+D → kopiert Mitglied, Datum, Gewässer
6. Nur Fisch und Größe/Gewicht anpassen
7. Wiederholen für alle Fänge
8. Ctrl+S zum Speichern aller Einträge

Gast-Fang eintragen¶

1. "Catch hinzufügen" klicken
2. Invited by auswählen (Gastgeber)
3. Guest name eingeben
4. Member LEER lassen
5. Weitere Daten wie gewohnt eingeben

Fang nachträglich korrigieren¶

1. In der Liste den gewünschten Fang finden
2. Auf Fisch oder Datum klicken
3. Daten korrigieren
4. "Sichern" klicken

Fehlerhafte Fänge finden¶

1. Suchfunktion nutzen für spezifische Kriterien
2. Nach Datum sortieren für chronologische Suche
3. Filter kombinieren für gezielte Suche

Unvollständige Einträge nachbearbeiten¶

1. Massen-Fangeingabe öffnen
2. Bei der Speicherung "Alle speichern" wählen (auch unvollständige)
3. Später: Admin → Catches
4. Nach leeren Feldern filtern
5. Fehlende Daten ergänzen