Add wind analysis: header pill, fetch/validate menu, speed-plot overlay

Portiert das Wind-System des HTML-Demonstrators (Doku 3.8) vollstaendig:
Open-Meteo-Winddaten, interpoliert zwischen Druckflaechen- und festen
Nabenhoehen-Stuetzpunkten auf die tatsaechliche Zielhoehe.

Domain (lib/domain/wind/wind_math.dart, reines Dart): Hoehen-
Interpolation (linear + zirkulaer fuer Windrichtung), Peilung zwischen
zwei Punkten, Kopf-/Rueckenwind-Komponente pro Flugleg - 1:1 uebernommen
aus interpolateWindAtHeight()/bearingBetween()/headTailwindComponent()
des Demonstrators, per Unit-Tests abgesichert.

Service (lib/services/wind/wind_service.dart): zwei getrennte,
fokussierte Open-Meteo-Requests statt eines kombinierten (Doku 4.10 -
ein 35-Variablen-Request verursachte im Demonstrator Modellauswahl-
Fehler). Drei Verbraucher: Kopfleisten-Pille (120 m AGL ueber
Referenzort), gebuendelter Wegpunkt-Fetch (ein Request fuer alle
Koordinaten via Open-Meteos Mehrfach-Location-Syntax) und das
Validierungspanel (rohe Messwerte je Nabenhoehe/Druckflaeche). Per
MockClient getestet (kein echter Netzwerkzugriff in Tests).

UI:
- HeaderWindPill (TopModeBar, nur ausserhalb Fly-Modus): zeigt
  Windrichtung/-geschwindigkeit, Antippen schaltet perspektivisch die
  Wind-Marker der Wegpunkte um (Zustand vorbereitet, HTML-Demonstrator:
  showPerWaypointWind).
- WaypointListPanel: "Fetch wind"/"Validate"-Buttons im Panel-Header,
  neue WIND-Spalte in der Liste.
- WindValidatePanel: neue Vollbild-Route (gleiches Muster wie
  WaypointListPanel) mit Rohdaten je Hoehenstufe inkl. Boeen (Doku 4.9:
  Boeen nur hier, nicht in der Wegpunktanzeige) und Interpolationsergebnis.
- FullValueChart (Speed-Tab): Kopf-/Rueckenwind-Diamanten pro Leg samt
  gestrichelter Nulllinie sowie gestrichelte Bodengeschwindigkeits-
  Stufenlinie.

Bug gefunden und gefixt waehrend der Emulator-Verifikation: die
Y-Achsen-Autoskalierung klemmte weiterhin auf den gueltigen Drehrad-
Wertebereich (13-25 m/s), wodurch nahe Null liegende Windkomponenten
(bei schwachem Wind der Normalfall) ausserhalb des sichtbaren Bereichs
lagen und weder Diamanten noch Nulllinie zu sehen waren. Der HTML-
Demonstrator klemmt computeSpeedChartRange() bewusst nicht auf SPD_MIN/
SPD_MAX; das Klemmen in FullValueChart._range() jetzt entsprechend
entfernt.

Waypoint-Modell um windSpeedMs/windDirFromDeg/windElevationM erweitert
(nullable, reine Planungshilfe - der Encoder liest diese Felder nie,
Doku 3.2). currentMissionProvider bekommt replaceAll() fuer den
gebuendelten Wind-Fetch, der alle Wegpunkte gleichzeitig aktualisiert.

Verifiziert: flutter analyze (0 issues), flutter test (44/44, davon 14
neue Wind-Mathematik- und 6 neue WindService-Tests), manuell auf
Pixel_10a-Emulator mit echtem Open-Meteo-Netzwerkzugriff - Kopfleisten-
Pille zeigt Live-Wind, Fetch/Validate fuellen Liste bzw. oeffnen das
Validierungspanel mit echten Messwerten, Speed-Plot zeigt nach dem Fix
Diamanten/Nulllinie/Bodengeschwindigkeit korrekt skaliert.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Constantin Leue
2026-07-28 13:32:15 +02:00
co-authored by Claude Sonnet 5
parent 7a26002a63
commit 1b13c45cac
14 changed files with 1473 additions and 12 deletions
@@ -14,6 +14,13 @@ class CurrentMissionNotifier extends Notifier<List<Waypoint>> {
state = [...state, waypoint];
}
/// Ersetzt die gesamte Liste (z.B. nach "Fetch wind", das alle Wegpunkte
/// gebuendelt in einem Schritt aktualisiert - anders als die uebrigen
/// Setter hier, die genau einen Wegpunkt betreffen).
void replaceAll(List<Waypoint> waypoints) {
state = waypoints;
}
/// Aktualisiert die Position eines Wegpunkts (Drag-to-Reposition im
/// Editier-Modus: Kartenverschieben bewegt den Zielpunkt live mit).
void moveWaypoint(int index, double lat, double lon) {
+91
View File
@@ -0,0 +1,91 @@
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../domain/wind/wind_math.dart';
import '../../services/wind/wind_service.dart';
import 'current_mission_provider.dart';
import 'map_controller_provider.dart';
final windServiceProvider = Provider<WindService>((ref) => WindService());
/// Zustand der Kopfleisten-Wind-Pille (Doku 3.8).
class HeaderWindState {
const HeaderWindState({
this.sample,
this.loading = false,
this.showPerWaypoint = false,
});
final WindSample? sample;
final bool loading;
/// Umschaltbar per Antippen der Pille (HTML-Demonstrator:
/// showPerWaypointWind) - blendet Wind-Marker an jedem Wegpunkt ein/aus.
final bool showPerWaypoint;
HeaderWindState copyWith({
WindSample? sample,
bool? loading,
bool? showPerWaypoint,
}) {
return HeaderWindState(
sample: sample ?? this.sample,
loading: loading ?? this.loading,
showPerWaypoint: showPerWaypoint ?? this.showPerWaypoint,
);
}
}
/// Haelt den fuer die Kopfleiste interpolierten Wind (120 m AGL ueber dem
/// Referenzort: erster Wegpunkt, sonst aktuelles Kartenzentrum) - analog
/// refreshHeaderWind()/headerWindLocation() im HTML-Demonstrator.
class HeaderWindNotifier extends Notifier<HeaderWindState> {
@override
HeaderWindState build() => const HeaderWindState();
Future<void> refresh() async {
final waypoints = ref.read(currentMissionProvider);
(double, double)? location;
if (waypoints.isNotEmpty) {
location = (waypoints.first.lat, waypoints.first.lon);
} else {
try {
final center = ref.read(mapControllerProvider).camera.center;
location = (center.latitude, center.longitude);
} catch (_) {
// Kamera noch nicht bereit (Karte noch nicht gemountet/gelayoutet).
location = null;
}
}
if (location == null) return;
state = state.copyWith(loading: true);
final sample =
await ref.read(windServiceProvider).fetchHeaderWind(location.$1, location.$2);
state = state.copyWith(loading: false, sample: sample);
}
void toggleShowPerWaypoint() {
state = state.copyWith(showPerWaypoint: !state.showPerWaypoint);
}
}
final headerWindProvider =
NotifierProvider<HeaderWindNotifier, HeaderWindState>(HeaderWindNotifier.new);
/// Referenzort fuer Windabfragen ohne festen Bezugspunkt (Wind-
/// Validierungspanel aus der Wegpunktliste): erster Wegpunkt, sonst
/// aktuelles Kartenzentrum - analog headerWindLocation() im HTML-
/// Demonstrator. Null, wenn die Karte noch nicht gemountet/gelayoutet ist.
(double, double)? windReferenceLocation(WidgetRef ref) {
final waypoints = ref.read(currentMissionProvider);
if (waypoints.isNotEmpty) {
final first = waypoints.first;
return (first.lat, first.lon);
}
try {
final center = ref.read(mapControllerProvider).camera.center;
return (center.latitude, center.longitude);
} catch (_) {
return null;
}
}