add manual report

MANUAL_SEND_DOCUMENTATION.md

@@ -0,0 +1,108 @@
+# Manuelle "Sofort senden" Funktion für Automatische Reports
+
+## Übersicht
+
+Die neue "Sofort senden" Aktion im Django Admin ermöglicht es Administratoren, automatische Reports manuell und sofort zu versenden, ohne auf den geplanten Zeitpunkt warten zu müssen.
+
+## Verwendung
+
+1. **Admin-Bereich öffnen**: Navigieren Sie zu `/admin/reports/automaticreport/`
+2. **Reports auswählen**: Wählen Sie einen oder mehrere automatische Reports aus der Liste aus
+3. **Aktion ausführen**: Wählen Sie aus dem Aktions-Dropdown "Ausgewählte Reports sofort senden"
+4. **Bestätigen**: Klicken Sie auf "Ausführen"
+
+## Funktionalität
+
+### Automatische Zeitraumberechnung
+Die Aktion berechnet automatisch den Zeitraum basierend auf der Frequenz des Reports:
+
+- **Wöchentlich**: Letzte 7 Tage
+- **Monatlich**: Letzter Monat (vom 1. des Vormonats bis heute)
+- **Vierteljährlich**: Letztes Quartal (3 Monate zurück)
+
+### Validierung und Filterung
+Vor dem Versenden wird überprüft:
+
+- ✅ **Aktivierung**: Report muss aktiv sein (`is_active = True`)
+- ✅ **E-Mail-Adressen**: Mindestens eine E-Mail-Adresse muss konfiguriert sein
+- ✅ **Filter**: Die konfigurierten Filter (Naturschutz-/Jagdbehörde) werden angewendet
+
+### Rückmeldungen
+Das System gibt detaillierte Rückmeldungen:
+
+- ✅ **Erfolgreich**: Anzahl gesendeter E-Mails, Zeitraum, Patientenzahl
+- ⚠️ **Übersprungen**: Grund für das Überspringen (deaktiviert, keine E-Mail-Adressen)
+- ❌ **Fehler**: Detaillierte Fehlermeldungen bei Problemen
+
+### Protokollierung
+- Alle versendeten Reports werden in `ReportLog` protokolliert
+- Das `last_sent` Feld des AutomaticReport wird aktualisiert
+- CSV-Dateien werden gespeichert und können später heruntergeladen werden
+
+## Technische Details
+
+### Implementierung
+- **Datei**: `/app/reports/admin.py`
+- **Methode**: `send_report_now()`
+- **Service**: Verwendet `ReportGenerator` aus `reports.services`
+
+### Sicherheit
+- Nur Administratoren mit entsprechenden Berechtigungen können diese Aktion ausführen
+- Deaktivierte Reports werden automatisch übersprungen
+- Umfassende Fehlerbehandlung verhindert Systemausfälle
+
+## Beispiel-Ausgaben
+
+### Erfolgreicher Versand
+```
+✅ Report 'Monatlicher Naturschutzbericht' erfolgreich gesendet (letzter Monat, 15 Patienten, 3 Empfänger).
+✅ Zusammenfassung: 1 Report(s) erfolgreich gesendet.
+```
+
+### Übersprungener Report
+```
+⚠️ Report 'Deaktivierter Report' ist deaktiviert und wurde übersprungen.
+ℹ️ Alle 1 ausgewählten Reports wurden übersprungen (deaktiviert oder keine E-Mail-Adressen).
+```
+
+### Fehler beim Versand
+```
+❌ Fehler beim Senden von 'Fehlerhafter Report': SMTP-Server nicht erreichbar.
+❌ Alle 1 Reports konnten nicht gesendet werden.
+```
+
+## Troubleshooting
+
+### Häufige Probleme
+
+1. **"Report ist deaktiviert"**
+   - Lösung: Report in der Detail-Ansicht aktivieren (`is_active = True`)
+
+2. **"Keine E-Mail-Adressen"**
+   - Lösung: E-Mail-Adressen im Report konfigurieren
+
+3. **"'Emailadress' object has no attribute 'email'"**
+   - Technischer Fehler: Das Emailadress-Model verwendet `email_address` statt `email`
+   - Lösung: Wurde in Version 1.1 behoben
+
+4. **"SMTP-Fehler"**
+   - Lösung: E-Mail-Konfiguration in `settings.py` überprüfen
+
+5. **"Keine Patienten gefunden"**
+   - Normal: Report wird trotzdem versendet, zeigt 0 Patienten an
+
+### Log-Überprüfung
+- Alle Versandaktivitäten werden in `/admin/reports/reportlog/` protokolliert
+- Bei Fehlern die Django-Logs überprüfen
+
+## Entwickler-Hinweise
+
+### Anpassungen
+- Zeitraumberechnung kann in der `send_report_now()` Methode angepasst werden
+- Zusätzliche Validierungen können hinzugefügt werden
+- E-Mail-Templates befinden sich in `/templates/reports/email/`
+
+### Erweiterungen
+- Mögliche Erweiterung: Benutzerdefinierte Zeiträume
+- Mögliche Erweiterung: Vorschau vor dem Versand
+- Mögliche Erweiterung: Stapelverarbeitung mit Fortschrittsanzeige