LarsHoliday / USER_README.md
phhttps
feat: fresh start - repository cleanup and updated gitignore
88678e4
# Vacation Deal Finder - Benutzeranleitung
## Schnellstart
### Schritt 1: API-Key einrichten (KOSTENLOS)
1. Gehe zu **https://openweathermap.org/api**
2. Klicke auf "Sign Up" und erstelle einen kostenlosen Account
3. Nach der Anmeldung findest du deinen API-Key im Dashboard
4. Kopiere den API-Key
### Schritt 2: Konfiguration
1. Benenne die Datei `.env.example` um zu `.env`
2. Öffne die Datei mit einem Texteditor (Notepad)
3. Ersetze `your_openweather_api_key_here` mit deinem API-Key:
```
OPENWEATHER_API_KEY=dein_key_hier
```
4. Speichere die Datei
### Schritt 3: Programm starten
- Doppelklick auf `VacationDealFinder.exe`
- Falls Windows eine Warnung zeigt:
- Klicke auf "Weitere Informationen"
- Dann auf "Trotzdem ausführen"
---
## Verwendung
### Suchparameter eingeben
| Feld | Beschreibung | Beispiel |
|------|--------------|----------|
| **Destinations** | Städte oder Regionen (Komma-getrennt) | `Amsterdam, Berlin, Ardennes` |
| **Check-in** | Anreisedatum (YYYY-MM-DD) | `2026-02-15` |
| **Check-out** | Abreisedatum (YYYY-MM-DD) | `2026-02-22` |
| **Adults** | Anzahl Erwachsene | `4` |
| **Max Budget** | Maximale Kosten pro Nacht (EUR) | `250` |
| **Allow Dogs** | Hundefreundliche Unterkünfte | Häkchen setzen |
### Suche starten
1. Klicke auf **"Search Best Deals"**
2. Warte auf die Ergebnisse (kann 1-2 Minuten dauern)
3. Die besten Deals werden in der Liste angezeigt
### Ergebnisse nutzen
- **Open HTML Report**: Öffnet detaillierte Übersicht im Browser
- **Export PDF**: Speichert Ergebnisse als PDF-Datei
- Klicke auf einen Deal, um mehr Details zu sehen
---
## Häufige Probleme
### "Keine Ergebnisse gefunden"
**Lösungen:**
- Prüfe, ob das Datum in der Zukunft liegt
- Erhöhe das Budget
- Probiere andere Städte
- Prüfe die Internetverbindung
### "Wetter-Daten konnten nicht geladen werden"
**Lösungen:**
- Prüfe, ob der API-Key korrekt in `.env` eingetragen ist
- Warte 10 Minuten nach der Registrierung (Key muss aktiviert werden)
- Prüfe die Internetverbindung
### "Programm startet nicht"
**Lösungen:**
- Windows Defender: "Weitere Informationen" → "Trotzdem ausführen"
- Als Administrator ausführen (Rechtsklick → "Als Administrator ausführen")
- Prüfe, ob Antivirus das Programm blockiert
### "Fehler beim Suchen"
**Lösungen:**
- Internetverbindung prüfen
- Andere Städte probieren
- Programm neu starten
---
## Systemanforderungen
- **Betriebssystem**: Windows 10 oder 11
- **Internet**: Erforderlich für Suche
- **Speicher**: ca. 100 MB
---
## Tipps für die besten Deals
1. **Wochentage sind günstiger**: Dienstag-Donnerstag oft 30% billiger
2. **Schulferien vermeiden**: Kurz davor oder danach buchen
3. **Last-Minute**: 7 Tage vorher oft die besten Preise
4. **Center Parcs**: Hunde bleiben meist kostenlos
5. **Wetter beachten**: Frühling/Sommer haben besseres Wetter
---
## Support
Bei Problemen wende dich an den Absender dieser Software.
---
## Technische Informationen
- **Version**: 1.0
- **Quellen**: Booking.com, Airbnb, Center Parcs
- **Wetter**: OpenWeather API