🌌 Aurora Pro Dashboard

Ein Echtzeit-Dashboard zur Überwachung und Vorhersage von Polarlichtern (Aurora Borealis) in Deutschland.

✨ Features

🎯 Echtzeit-Überwachung

• Kp-Index - Aktuelle geomagnetische Aktivität
• Bz-Wert - Magnetfeldrichtung (negativ = gut für Aurora!)
• Sonnenwind - Geschwindigkeit und Dichte
• Wolkenbedeckung - Lokale Wetterbedingungen

📍 Standort-Verwaltung

• Eigene Beobachtungsstandorte hinzufügen
• Standorte aktivieren/deaktivieren
• Lokale Wetterdaten pro Standort
• Sichtbarkeits-Index für jeden Standort

🔮 3-Tage Prognose

• Kp-Index Vorhersage (NOAA SWPC)
• Wahrscheinlichkeitsberechnung
• Beste Beobachtungszeitfenster
• Automatische Empfehlung

🤖 KI-Analyse (Optional)

• Groq API Integration (Llama-3.3-70B)
• Automatische Fallback-Analyse ohne API-Key
• Detaillierte Wetterinterpretation

📊 Visualisierung

• Interaktive Karte mit Aurora-Oval
• Live-Charts (Kp, Wahrscheinlichkeit, Magnetfeld)
• Dashboard mit allen wichtigen Werten
• Responsive Design

🚀 Installation

Voraussetzungen

• Node.js 18+
• Python 3.8+
• SQLite3

1. Repository klonen

git clone https://github.com/DEIN_USERNAME/aurora.git
cd aurora

2. Python-Abhängigkeiten installieren

python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# oder: venv\Scripts\activate  # Windows
pip install -r requirements.txt

3. Node.js-Abhängigkeiten installieren

npm install

4. Umgebungsvariablen konfigurieren

Erstelle eine .env Datei:

cp .env.example .env

Bearbeite .env:

# Optional: Groq API Key für KI-Analysen
GROQ_API_KEY=gsk_xxxxxxxxxxxxxxxxxxxx

# Server Port
PORT=3000

5. Datenbank initialisieren

Die Datenbank (aurora.db) wird automatisch beim ersten Start erstellt.

🏃‍♂️ Starten

Server starten

node server.js

Zugriff

Öffne http://localhost:3000 in deinem Browser.

CLI Monitor (Optional)

python main.py

📁 Projektstruktur

aurora/
├── public/
│   └── index.html          # Frontend Dashboard
├── api/
│   └── ...                 # Python API Module
├── core/
│   ├── aggregator.py       # Daten-Aggregator
│   └── settings.py         # Einstellungen
├── models/
│   └── ...                 # Datenmodelle
├── main.py                 # CLI Monitor
├── server.js               # Node.js Server
├── seeder.js               # Datenbank Seeder
├── requirements.txt        # Python Dependencies
├── package.json            # Node.js Dependencies
└── README.md               # Diese Datei

🔧 Konfiguration

Standorte verwalten

1. Gehe zum Tab "⚙️ Einstellungen"
2. Scrolle zu "📍 Standorte verwalten"
3. Gib Name, Breitengrad und Längengrad ein
4. Klicke "Standort hinzufügen"

API-Key hinterlegen

1. Gehe zu "⚙️ Einstellungen"
2. Gib deinen Groq API Key ein
3. Klicke "Speichern"

📊 Datenquellen

Daten	Quelle
Kp-Index	NOAA SWPC
Magnetfeld (Bz, By, Bt)	NOAA SWPC
Sonnenwind	NOAA SWPC
Wetter	Open-Meteo
Prognose	NOAA SWPC

🎨 Dashboard Tabs

Tab	Beschreibung
🗺️ Karte	Standorte, Aurora-Oval, Wetter
📊 Dashboard	Alle Werte auf einen Blick
📈 Charts	Verlauf der letzten 24h
🔮 Prognose	3-Tage Vorhersage
❓ Hilfe	Erklärungen für Einsteiger
⚙️ Einstellungen	API-Key, Standorte

💡 Tipps für Einsteiger

Checkliste für Aurora-Sichtung

• ✅ Wahrscheinlichkeit über 40%
• ✅ Kp-Index mindestens 4-5
• ✅ Bz-Wert negativ
• ✅ Wenig Wolken (unter 50%)
• ✅ Dunkler Ort (weg von Städten)
• ✅ Geduld (30+ Min. beobachten)

Kamera-Einstellungen

• Manueller Modus (M)
• Blende: f/2.8 oder niedriger
• ISO: 1600-3200
• Belichtung: 10-25 Sekunden
• Stativ (wichtig!)

🔌 API-Endpoints

Daten

• GET /api/current - Aktuelle Daten
• GET /api/history - Historische Daten
• GET /api/forecast - Prognose

Standorte

• GET /api/locations - Alle Standorte
• POST /api/locations - Standort hinzufügen
• DELETE /api/locations/:id - Standort löschen
• PUT /api/locations/:id/toggle - Aktiv/Deaktiv

Einstellungen

• GET /api/settings - API-Key Status
• POST /api/settings - API-Key speichern

🛠️ Entwicklung

Server im Development-Modus

npm install nodemon --save-dev
nodemon server.js

Datenbank zurücksetzen

rm aurora.db
node seeder.js

📝 Lizenz

MIT License - siehe LICENSE

🤝 Contributing

Pull Requests sind willkommen! Bitte beachte:

1. Fork das Repository
2. Erstelle einen Feature-Branch (git checkout -b feature/AmazingFeature)
3. Commit deine Änderungen (git commit -m 'Add some AmazingFeature')
4. Push zum Branch (git push origin feature/AmazingFeature)
5. Öffne einen Pull Request

📧 Kontakt

Bei Fragen oder Problemen öffne bitte ein Issue auf GitHub.

🙏 Danksagungen

• NOAA SWPC für Weltraumwetter-Daten
• Open-Meteo für Wetterdaten
• Groq für KI-Analysen
• Leaflet für Karten
• Chart.js für Diagramme
• Tailwind CSS für Styling

---

Viel Erfolg bei der Aurora-Jagd! 🌟