Rename the Fly-mode Warnings tab to System Messages, log connection/upload events

Renames DroneEvent/DroneEventSeverity/droneEventLogProvider/
DroneStatusWarningsPanel to SystemMessage/SystemMessageSeverity/
systemMessageLogProvider/DroneStatusMessagesPanel throughout, matching
what the tab now actually shows - general system messages, not just
drone-health warnings.

Adds a new SystemMessageSeverity.info level (blue) for messages that
aren't a warning/error, and three new message sources on top of the
existing battery/failsafe detection:
- "Connected", logged the first time telemetryProvider produces a frame
  after having none - the mirror image of the existing "Connection lost"
  detection (which already fires on the first stream error after having
  had data), so no new transport-specific dependency was needed.
- "Connection type changed to X", from watching connectionSettingsProvider
  (skips the initial load so it doesn't fire on every app start).
- "Mission sent (N waypoints)" / "Mission upload failed: ...", logged
  from FlyScreen's send handler via a new public log() method on the
  notifier, alongside the existing snackbar.

Verified on the Pixel_10a emulator: entering Fly mode logs "Connected"
once the mock telemetry starts, and tapping the send button logs
"Mission sent (3 waypoints)" right after the snackbar.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Constantin Leue
2026-08-06 10:47:38 +02:00
co-authored by Claude Sonnet 5
parent 13475cc4f3
commit b09d00ab9f
10 changed files with 386 additions and 144 deletions
@@ -1,64 +0,0 @@
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../domain/telemetry/drone_event.dart';
import '../../transport/flight_controller_link.dart';
import 'telemetry_provider.dart';
/// Fuehrt das Ereignis-Log fuer den neuen Warnings-Tab (Doku:
/// "log von kritischen ereignissen mit time stamp") - beobachtet
/// [telemetryProvider] dauerhaft (bewusst KEIN autoDispose, siehe
/// telemetry_provider.dart-Doku zur analogen Begruendung bei
/// flightControllerLinkProvider), damit ein Ereignis auch dann protokolliert
/// wird, wenn die Warnings-Ansicht selbst gerade nicht geoeffnet ist.
/// Beginnt zu beobachten, sobald irgendein Widget diesen Provider erstmals
/// liest (siehe FlyScreen) - vor diesem Zeitpunkt liegende Ereignisse
/// erscheinen nicht im Log, das ist fuer ein Live-Log erwartbar.
class DroneEventLogNotifier extends Notifier<List<DroneEvent>> {
TelemetryFrame? _previousFrame;
bool _hadData = false;
@override
List<DroneEvent> build() {
ref.listen<AsyncValue<TelemetryFrame>>(telemetryProvider, (previous, next) {
next.when(
data: (frame) {
final events = detectDroneEvents(
previous: _previousFrame,
current: frame,
now: DateTime.now(),
);
_previousFrame = frame;
_hadData = true;
if (events.isNotEmpty) {
state = [...events.reversed, ...state];
}
},
error: (error, stackTrace) {
// Nur melden, wenn zuvor bereits Frames flossen - sonst wuerde
// schon das (normale) Ausbleiben der allerersten Verbindung als
// "Connection lost" auftauchen.
if (_hadData) {
state = [
DroneEvent(
timestamp: DateTime.now(),
message: 'Connection lost',
severity: DroneEventSeverity.critical,
),
...state,
];
}
_previousFrame = null;
_hadData = false;
},
loading: () {},
);
});
return [];
}
void clear() => state = [];
}
final droneEventLogProvider =
NotifierProvider<DroneEventLogNotifier, List<DroneEvent>>(
DroneEventLogNotifier.new);
@@ -0,0 +1,110 @@
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../domain/telemetry/system_message.dart';
import '../../transport/connection_type.dart';
import '../../transport/flight_controller_link.dart';
import 'connection_settings_provider.dart';
import 'telemetry_provider.dart';
/// Fuehrt das System-Messages-Log fuer den gleichnamigen Tab im
/// Drohnen-Status-Menue (Doku: "aendere das warnings Menü in System
/// Messages ... Verbindung hergestellt/verloren, Verbindungstyp geaendert,
/// Wegpunkte uebertragen") - beobachtet [telemetryProvider] und
/// [connectionSettingsProvider] dauerhaft (bewusst KEIN autoDispose, siehe
/// telemetry_provider.dart-Doku zur analogen Begruendung bei
/// flightControllerLinkProvider), damit ein Ereignis auch dann protokolliert
/// wird, wenn die System-Messages-Ansicht selbst gerade nicht geoeffnet ist.
/// Beginnt zu beobachten, sobald irgendein Widget diesen Provider erstmals
/// liest (siehe FlyScreen) - vor diesem Zeitpunkt liegende Ereignisse
/// erscheinen nicht im Log, das ist fuer ein Live-Log erwartbar.
class SystemMessageLogNotifier extends Notifier<List<SystemMessage>> {
TelemetryFrame? _previousFrame;
bool _hadData = false;
@override
List<SystemMessage> build() {
ref.listen<AsyncValue<TelemetryFrame>>(telemetryProvider, (previous, next) {
next.when(
data: (frame) {
// Flankengetriggert wie "Connection lost" unten, nur umgekehrt -
// anders als dort ist hier kein Sonderfall fuer die allererste
// Verbindung noetig: der Uebergang "noch keine Daten" -> "erste
// Daten" ist immer ein echtes "Connected", auch beim allerersten
// Mal.
if (!_hadData) {
_log('Connected', SystemMessageSeverity.info);
}
final events = detectSystemMessages(
previous: _previousFrame,
current: frame,
now: DateTime.now(),
);
_previousFrame = frame;
_hadData = true;
if (events.isNotEmpty) {
state = [...events.reversed, ...state];
}
},
error: (error, stackTrace) {
// Nur melden, wenn zuvor bereits Frames flossen - sonst wuerde
// schon das (normale) Ausbleiben der allerersten Verbindung als
// "Connection lost" auftauchen.
if (_hadData) {
_log('Connection lost', SystemMessageSeverity.critical);
}
_previousFrame = null;
_hadData = false;
},
loading: () {},
);
});
// Verbindungsart-Wechsel (Doku: "Verbindungstyp geaendert") - nur ab dem
// zweiten geladenen Wert protokollieren, sonst wuerde bereits das
// erstmalige Laden der Einstellungen aus der DB als "Wechsel" erscheinen.
ConnectionType? previousType;
var sawFirstLoad = false;
ref.listen(connectionSettingsProvider, (previous, next) {
final type = next.value?.connectionType;
if (type == null) return;
if (!sawFirstLoad) {
sawFirstLoad = true;
previousType = type;
return;
}
if (type != previousType) {
_log('Connection type changed to ${_connectionTypeLabel(type)}',
SystemMessageSeverity.info);
previousType = type;
}
});
return [];
}
String _connectionTypeLabel(ConnectionType type) => switch (type) {
ConnectionType.wifi => 'WiFi mLRS UDP',
ConnectionType.mock => 'Mock (Test)',
};
/// Fuegt einen Eintrag manuell hinzu (Doku: "Wegpunkte uebertragen") - fuer
/// Ereignisse, die nicht aus der Telemetrie/den Einstellungen ableitbar
/// sind, sondern vom Aufloeser einer konkreten Aktion (z.B. FlyScreen nach
/// einem Missions-Upload) gemeldet werden.
void log(String message, {SystemMessageSeverity severity = SystemMessageSeverity.info}) {
_log(message, severity);
}
void _log(String message, SystemMessageSeverity severity) {
state = [
SystemMessage(timestamp: DateTime.now(), message: message, severity: severity),
...state,
];
}
void clear() => state = [];
}
final systemMessageLogProvider =
NotifierProvider<SystemMessageLogNotifier, List<SystemMessage>>(
SystemMessageLogNotifier.new);
+22 -15
View File
@@ -12,20 +12,21 @@ import '../../../domain/mission/mission_stats.dart';
import '../../../domain/mission/mission_warnings.dart';
import '../../../domain/mission/route_geometry.dart';
import '../../../domain/telemetry/drone_status.dart';
import '../../../domain/telemetry/system_message.dart';
import '../../../domain/waypoint/flat_waypoint_list.dart';
import '../../../domain/wind/wind_math.dart';
import '../../../services/mission_sync_service.dart';
import '../../../transport/flight_controller_link.dart';
import '../../providers/active_drone_profile_provider.dart';
import '../../providers/current_mission_provider.dart';
import '../../providers/drone_event_log_provider.dart';
import '../../providers/follow_drone_provider.dart';
import '../../providers/map_controller_provider.dart';
import '../../providers/system_message_log_provider.dart';
import '../../providers/telemetry_provider.dart';
import '../../providers/terrain_provider.dart';
import '../settings/settings_screen.dart';
import '../../widgets/drone_marker_icon.dart';
import '../../widgets/drone_status_warnings_panel.dart';
import '../../widgets/drone_status_messages_panel.dart';
import '../../widgets/mission_footer_bar.dart';
import '../../widgets/mission_map.dart';
import '../../widgets/waypoint_list_panel.dart';
@@ -122,9 +123,9 @@ class _FlyScreenState extends ConsumerState<FlyScreen> {
);
}
void _openDroneStatusWarningsPanel() {
void _openSystemMessagesPanel() {
Navigator.of(context).push(MaterialPageRoute<void>(
builder: (_) => const DroneStatusWarningsPanel.warnings(),
builder: (_) => const DroneStatusMessagesPanel.messages(),
));
}
@@ -134,7 +135,9 @@ class _FlyScreenState extends ConsumerState<FlyScreen> {
/// jeweiligen FlightControllerLink-Implementierung verweigert den Versand
/// bereits selbst im armed-Zustand (Doku 4.5); dieser Handler prueft nur
/// den trivialen Fall (keine Wegpunkte), um nicht unnoetig einen
/// Verbindungsversuch auszuloesen.
/// Verbindungsversuch auszuloesen. Protokolliert Erfolg/Fehlschlag
/// zusaetzlich im System-Messages-Log (Doku: "wenn ... Wegpunkte
/// übertragen werden").
Future<void> _onSendTap() async {
final waypoints = ref.read(currentMissionProvider);
final messenger = ScaffoldMessenger.of(context);
@@ -144,6 +147,7 @@ class _FlyScreenState extends ConsumerState<FlyScreen> {
}
setState(() => _sending = true);
final log = ref.read(systemMessageLogProvider.notifier);
try {
final service = MissionSyncService(
ref.read(flightControllerLinkProvider),
@@ -151,8 +155,10 @@ class _FlyScreenState extends ConsumerState<FlyScreen> {
);
await service.syncAndUpload(FlatWaypointList(waypoints));
messenger.showSnackBar(const SnackBar(content: Text('Mission sent')));
log.log('Mission sent (${waypoints.length} waypoints)');
} catch (e) {
messenger.showSnackBar(SnackBar(content: Text('Send failed: $e')));
log.log('Mission upload failed: $e', severity: SystemMessageSeverity.critical);
} finally {
if (mounted) setState(() => _sending = false);
}
@@ -164,15 +170,16 @@ class _FlyScreenState extends ConsumerState<FlyScreen> {
final droneProfile = ref.watch(activeDroneProfileProvider);
final telemetry = ref.watch(telemetryProvider).value;
final followDrone = ref.watch(followDroneProvider);
// Beobachtet das Ereignis-Log dauerhaft ab dem ersten Eintritt in den
// Fly-Modus (Doku: "log von kritischen ereignissen mit time stamp") -
// haelt drone_event_log_provider.dart's Notifier am Leben, solange
// dieser Screen existiert, siehe dessen Klassendoku. Der Rueckgabewert
// selbst wird hier nicht mehr gebraucht (der Warnungs-Knopf, der ihn
// frueher fuer forceShowWarningsButton auswertete, ist im Fly-Modus
// durch den Sende-Knopf ersetzt, siehe onSendTap unten) - Warnungen/
// Ereignis-Log bleiben ueber die Drohnen-Status-Pille erreichbar.
ref.watch(droneEventLogProvider);
// Beobachtet das System-Messages-Log dauerhaft ab dem ersten Eintritt in
// den Fly-Modus (Doku: "log von kritischen ereignissen mit time stamp",
// erweitert um Verbindungs-/Uebertragungsereignisse) - haelt
// system_message_log_provider.dart's Notifier am Leben, solange dieser
// Screen existiert, siehe dessen Klassendoku. Der Rueckgabewert selbst
// wird hier nicht mehr gebraucht (der Warnungs-Knopf, der ihn frueher
// fuer forceShowWarningsButton auswertete, ist im Fly-Modus durch den
// Sende-Knopf ersetzt, siehe onSendTap oben) - System Messages bleiben
// ueber die Drohnen-Status-Pille erreichbar.
ref.watch(systemMessageLogProvider);
// Solange der ueber den GPS-Knopf in der Kopfleiste (FlyMapControls)
// aktivierte Folgemodus aktiv ist, jede neue Telemetrie-Position
@@ -343,7 +350,7 @@ class _FlyScreenState extends ConsumerState<FlyScreen> {
onSendTap: _onSendTap,
sending: _sending,
onDetailsTap: _openWaypointList,
onWarningsTap: _openDroneStatusWarningsPanel,
onWarningsTap: _openSystemMessagesPanel,
onSettingsTap: () => Navigator.of(context).push(MaterialPageRoute(
builder: (_) => const SettingsScreen(),
)),
+6 -5
View File
@@ -10,7 +10,7 @@ import '../dmc_colors.dart';
import '../providers/active_drone_profile_provider.dart';
import '../providers/altitude_profile_provider.dart';
import '../providers/mission_meta_provider.dart';
import 'drone_status_warnings_panel.dart';
import 'drone_status_messages_panel.dart';
import 'missions_drones_panel.dart';
import 'mountain_peak_icon.dart';
import 'paper_plane_icon.dart';
@@ -90,9 +90,10 @@ class BottomStatsBar extends ConsumerWidget {
/// Nur im Fly-Modus gesetzt (Doku: "im fly screen den warnings button
/// durch einen wp send button ersetzen") - wenn gesetzt, ersetzt der
/// Sende-Knopf (Papierflieger, horizontal, pink) den runden Warnungs-
/// Knopf komplett, unabhaengig von [warnings]. Warnungen/Ereignis-Log
/// bleiben im Fly-Modus weiterhin ueber die Drohnen-Status-Pille
/// erreichbar (dort als eigener Tab), siehe DroneStatusWarningsPanel.
/// Knopf komplett, unabhaengig von [warnings]. System Messages (Doku:
/// "aendere das warnings Menü in System Messages") bleiben im Fly-Modus
/// weiterhin ueber die Drohnen-Status-Pille erreichbar (dort als eigener
/// Tab), siehe DroneStatusMessagesPanel.
final VoidCallback? onSendTap;
/// Zeigt einen Ladeindikator statt des Papierflieger-Icons und ignoriert
@@ -187,7 +188,7 @@ class BottomStatsBar extends ConsumerWidget {
// Profile werden waehrend des Fluges ohnehin
// nicht gewechselt.
onTap: () => Navigator.of(context).push(MaterialPageRoute(
builder: (_) => const DroneStatusWarningsPanel.status(),
builder: (_) => const DroneStatusMessagesPanel.status(),
)),
)
: _NameChip(
@@ -1,35 +1,35 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../domain/telemetry/drone_event.dart';
import '../../domain/telemetry/drone_status.dart';
import '../../domain/telemetry/system_message.dart';
import '../../domain/telemetry/telemetry_field_status.dart';
import '../dmc_colors.dart';
import '../providers/active_drone_profile_provider.dart';
import '../providers/drone_event_log_provider.dart';
import '../providers/system_message_log_provider.dart';
import '../providers/telemetry_provider.dart';
enum _PanelTab { status, warnings }
enum _PanelTab { status, messages }
/// Vollbild-Statusmenue fuer den Fly-Modus (Doku: "ein neues menue anlegen
/// fuer die neue drone status pille, nach dem vorbild des menues fuer
/// drones and missions, aber jetzt fuer drone status and warnings") -
/// drones and missions, aber jetzt fuer drone status and system messages") -
/// dieselbe Tab-Struktur wie [MissionsDronesPanel], nur mit den beiden
/// telemetriebezogenen Tabs Status/Warnings statt Missions/Drones.
/// telemetriebezogenen Tabs Status/System Messages statt Missions/Drones.
/// Erreichbar ueber die Drohnen-Status-Pille (Status-Tab) bzw. den
/// Warnungs-Knopf (Warnings-Tab) in der Fusszeile im Fly-Modus (siehe
/// bottom_stats_bar.dart/fly_screen.dart).
class DroneStatusWarningsPanel extends ConsumerStatefulWidget {
const DroneStatusWarningsPanel.status({super.key}) : _initialTab = _PanelTab.status;
const DroneStatusWarningsPanel.warnings({super.key}) : _initialTab = _PanelTab.warnings;
/// Sende-Knopf-Nachbarn/Warnungs-Knopf (System-Messages-Tab) in der
/// Fusszeile im Fly-Modus (siehe bottom_stats_bar.dart/fly_screen.dart).
class DroneStatusMessagesPanel extends ConsumerStatefulWidget {
const DroneStatusMessagesPanel.status({super.key}) : _initialTab = _PanelTab.status;
const DroneStatusMessagesPanel.messages({super.key}) : _initialTab = _PanelTab.messages;
final _PanelTab _initialTab;
@override
ConsumerState<DroneStatusWarningsPanel> createState() => _DroneStatusWarningsPanelState();
ConsumerState<DroneStatusMessagesPanel> createState() => _DroneStatusMessagesPanelState();
}
class _DroneStatusWarningsPanelState extends ConsumerState<DroneStatusWarningsPanel> {
class _DroneStatusMessagesPanelState extends ConsumerState<DroneStatusMessagesPanel> {
late _PanelTab _tab = widget._initialTab;
@override
@@ -45,7 +45,7 @@ class _DroneStatusWarningsPanelState extends ConsumerState<DroneStatusWarningsPa
children: [
const Expanded(
child: Text(
'Drone Status & Warnings',
'Drone Status & System Messages',
style: TextStyle(
color: Colors.white,
fontSize: 20,
@@ -63,14 +63,14 @@ class _DroneStatusWarningsPanelState extends ConsumerState<DroneStatusWarningsPa
Row(
children: [
_tabButton('Status', _PanelTab.status),
_tabButton('Warnings', _PanelTab.warnings),
_tabButton('System Messages', _PanelTab.messages),
],
),
const Divider(color: Colors.white24, height: 1),
Expanded(
child: switch (_tab) {
_PanelTab.status => _statusTab(),
_PanelTab.warnings => _warningsTab(),
_PanelTab.messages => _messagesTab(),
},
),
],
@@ -253,26 +253,30 @@ class _DroneStatusWarningsPanelState extends ConsumerState<DroneStatusWarningsPa
);
}
// --- Warnings ---
// --- System Messages ---
Widget _warningsTab() {
final events = ref.watch(droneEventLogProvider);
Widget _messagesTab() {
final events = ref.watch(systemMessageLogProvider);
if (events.isEmpty) {
return const Center(
child: Text('No events yet', style: TextStyle(color: Colors.white60, fontSize: 15)),
child: Text('No messages yet', style: TextStyle(color: Colors.white60, fontSize: 15)),
);
}
return ListView.builder(
padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
itemCount: events.length,
itemBuilder: (context, index) => _eventRow(events[index]),
itemBuilder: (context, index) => _messageRow(events[index]),
);
}
Widget _eventRow(DroneEvent event) {
final color = event.severity == DroneEventSeverity.critical
? DmcColors.warnRed
: DmcColors.pafAmber;
static const _severityColors = {
SystemMessageSeverity.critical: DmcColors.warnRed,
SystemMessageSeverity.warning: DmcColors.pafAmber,
SystemMessageSeverity.info: DmcColors.setBlue,
};
Widget _messageRow(SystemMessage event) {
final color = _severityColors[event.severity]!;
return Container(
margin: const EdgeInsets.symmetric(vertical: 4),
padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 12),