USER_README.md

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