🎈 Ballonflugbuch Professional

Digitales, browserbasiertes Flugbuch für Heißluftballonfahrer. Läuft kostenlos auf GitHub Pages, ohne Server und ohne Schlüssel.

Seiten (Menü links oben ☰)

• Übersicht: Fahrten, Landungen, Flugzeit, Kilometer, Aktivitätsmonitor, Rekorde
• Verfolger-Link: während der Aufzeichnung (mit Konto) einen Link fürs Rückholteam teilen; verfolgen.html zeigt Position (Aktualisierung etwa jede Minute), Spur, Höhe, Entfernung und Navigation – ohne Anmeldung, endet mit der Landung bzw. nach 12 Stunden
• Fahrt: Cockpit mit Geschwindigkeit, Höhe, Kurs, Genauigkeit, Karte, Höhenprofil, Steig-/Sinkrate; Aufzeichnung mit Landung und Markierungen
• Flugbuch: alle Fahrten mit Bearbeiten, Löschen und Anzeige auf der Karte; Fahrten ohne GPS lassen sich nachtragen
• Karte: ausgewählte Fahrten (je Fahrt eigene Farbe, Auswahl über „Fahrten wählen“) und Live-Standort, Stile Hybrid und Standard, zuschaltbare Luftfahrt-Ebene (open flightmaps, nicht amtlich), Link zur VFR/ICAO-Karte
• Wetter: Temperatur, Wind in 10 m und 80 m, Böen, Sonnenaufgang und -untergang
• Trajektoren: Winddrift-Simulation (ICON-D2 bis 180 m, GFS ab 200 m) für heute und morgen
• Einstellungen: Pilotenprofil (Name, Lizenznummer, Checkfahrt, Medical, eigene Einträge – alle Fristen mit Resttagen auf der Startseite), Pilot und Ballon (mit Auswahl zuletzt benutzter), Wartung, Aktivitätsmonitor, Backup und Import

Besonderheiten

• Alle Koordinaten werden als UTM angezeigt (gespeichert wird intern Breite/Länge)
• Laufende Fahrt wird laufend gesichert und kann nach Absturz oder Neuladen fortgesetzt werden
• Orte werden im Hintergrund ermittelt und bei fehlendem Netz später nachgeladen
• Offline-Start über Service Worker (Karten und Wetter brauchen Internet)
• GPS-Spuren liegen in IndexedDB (Platz für Tausende Fahrten), Fahrten und Einstellungen in localStorage; ältere Daten werden beim ersten Start automatisch umgezogen (mit Sicherung)
• JSON-Backup (inkl. Spuren) und -Import mit Duplikatprüfung
• Erste Schritte für neue Nutzer, Hinweis bei neuer Version, Datenschutzhinweis mit Löschfunktionen

Dateien im Hauptverzeichnis

index.html, style.css, geo.js (UTM und Entfernungen, gemeinsam mit der Verfolger-Ansicht), pdf.js (PDF der Fahrtplanung, ohne Bibliothek), app.js, trajektoren.js, sync.js, verfolgen.html, verfolgen.js, datenschutz.html, firebase-config.js, sw.js, favicon.svg, manifest.webmanifest, README.md sowie die Symbole apple-touch-icon.png, icon-192.png, icon-512.png, icon-maskable-512.png

Dazu fonts/ (Barlow, lokal statt Google Fonts, Lizenz OFL) und vendor/leaflet/ (Leaflet 1.9.4, lokal statt unpkg). Damit gehen beim Öffnen der App keine IP-Adressen an Google Fonts oder ein CDN.

Die Prüf-Workflows liegen in .github/workflows/ (validate.yml: Syntax, Dateien, CSP; tests.yml: Browser-Tests). tests/, package.json und .github/ werden nicht mit ausgeliefert (.vercelignore).

Neuerungen: Bei jeder Neuerung in app.js oben in NEUIGKEITEN einen Eintrag ergänzen (ID = Datum, neueste zuerst). Bestehende Nutzer sehen ihn einmal nach dem Update.

Impressum/Datenschutz: Betreiber und Kontakt stehen in datenschutz.html.

Dienste (alle kostenlos, ohne API-Key)

Leaflet (Karte), OpenStreetMap (Standardkarte, Ortssuche über Nominatim), Esri World Imagery mit Straßen und Ortsnamen (Hybridkarte), open flightmaps (Luftfahrt-Ebene, nicht-kommerziell, nicht amtlich), Open-Meteo (Wetter, ICON-D2 und GFS).

Voraussetzungen

HTTPS oder localhost und erteilte Standortberechtigung. Die Aufzeichnung sollte im Vordergrund bleiben, da mobile Browser Hintergrundprozesse pausieren können.

Installation (GitHub Pages)

1. Alle Dateien in das Hauptverzeichnis des Repositorys laden.
2. Settings → Pages: Branch main, Verzeichnis / (root).
3. Nach kurzer Zeit ist die App unter der angezeigten HTTPS-Adresse erreichbar.

Lokal testen

python3 -m http.server 8000

Danach http://localhost:8000 öffnen.

Automatische Tests

npm install && npx playwright install chromium
npm test              # alle Testreihen
node tests/run.js tor # nur eine Reihe

Die Tests starten einen eigenen Webserver (Port 8765), simulieren GPS, Wetter, Karten und Firebase (tests/fakefb/, mit den Firestore-Regeln aus diesem README) und prüfen Handy- und Desktop-Ansicht. Sie laufen bei jedem Pull Request automatisch.

Konto und Synchronisierung (optional, kostenlos)

Mit einem Konto (E-Mail und Passwort) sind Fahrten und Einstellungen auf jedem Gerät gleich. Ohne Einrichtung arbeitet die App nur lokal.

1. In der Firebase-Konsole ein Projekt anlegen und eine Web-App hinzufügen.
2. Die Werte apiKey, authDomain, projectId, appId in firebase-config.js eintragen.
3. Authentication → Anmeldemethode: E-Mail/Passwort aktivieren.
4. Firestore Database anlegen (Region eur3, Europa) und diese Regeln veröffentlichen:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{uid}/{document=**} {
      allow read, write: if request.auth != null && request.auth.uid == uid;
    }
  }
}

5. Authentication → Einstellungen → Autorisierte Domains: die GitHub-Pages-Domain (name.github.io) hinzufügen.

Freigabe für andere Benutzer (optional)

Mit adminUid in firebase-config.js darf zwar jeder ein Konto anlegen, die Cloud funktioniert aber erst nach Freischaltung durch den Administrator (Einstellungen → Freischaltung). Dazu in Firestore diese Regeln verwenden und ADMIN_UID durch die eigene Benutzer-ID (Einstellungen → Konto) ersetzen:

This is the beginning of the README. Read the rest at the original. Read the full README ↗