Files
oott/frontend/lib/widgets/device_summary_card.dart
T
rzuastiandClaude Opus 4.7 bb677aeebf Centralize status polling with last-known-good, stale, and error tiers
The four polling status cards (ARP, mDNS, scanners summary, devices
summary) each rolled their own Timer/_status/_error/_isLoading state and
flipped to a red 'Error' UI on the first failed poll, throwing away
last-known-good data that was still in memory. A momentary backend blip
made every card flash red.

Introduce PolledValue<T>, a ChangeNotifier that owns the periodic timer,
in-flight CancelToken, last value, last error, and a freshness
classification (initialLoading / fresh / stale / error). 'stale' kicks in
on the first failure but keeps the value visible; 'error' only takes over
after staleErrorAfter elapses without a success (30s for the 5s scanner
polls, 3min for the 1min device-summary poll). All four cards now branch
on freshness and show a small live-updating warning icon with a tooltip
('Last updated N ago — <error>') while stale, instead of flipping red.

Also threads CancelToken? through the three polled GET endpoints.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-31 10:03:19 -04:00

162 lines
4.7 KiB
Dart

import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import '../model/device_summary.dart';
import '../utils/oott_api.dart';
import '../utils/polled_value.dart';
import 'polled_stale_indicator.dart';
class DeviceSummaryCard extends StatefulWidget {
const DeviceSummaryCard({super.key});
@override
State<DeviceSummaryCard> createState() => _DeviceSummaryCardState();
}
class _DeviceSummaryCardState extends State<DeviceSummaryCard> {
late final PolledValue<DeviceSummary> _polled;
@override
void initState() {
super.initState();
_polled = PolledValue<DeviceSummary>(
fetch: ({cancelToken}) =>
BackendAPI.instance.getDeviceSummary(cancelToken: cancelToken),
pollInterval: const Duration(minutes: 1),
staleErrorAfter: const Duration(minutes: 3),
);
}
@override
void dispose() {
_polled.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Card(
clipBehavior: Clip.antiAlias,
child: InkWell(
onTap: () => context.go('/devices'),
child: Padding(
padding: const EdgeInsets.all(16),
child: ListenableBuilder(
listenable: _polled,
builder: (context, _) {
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
Text(
'Devices',
style: Theme.of(context).textTheme.titleLarge,
),
if (_polled.freshness == PolledFreshness.stale) ...[
const SizedBox(width: 6),
PolledStaleIndicator(polled: _polled),
],
],
),
const SizedBox(height: 12),
..._buildBody(context),
],
);
},
),
),
),
);
}
List<Widget> _buildBody(BuildContext context) {
switch (_polled.freshness) {
case PolledFreshness.initialLoading:
return const [Center(child: CircularProgressIndicator())];
case PolledFreshness.error:
return [
Text(
_polled.lastErrorMessage ?? 'Error loading device summary',
style: TextStyle(color: Theme.of(context).colorScheme.error),
),
];
case PolledFreshness.fresh:
case PolledFreshness.stale:
final summary = _polled.value!;
return [
_SummaryRow(
label: 'Registered in the system',
value: '${summary.totalRegistered}',
),
const Divider(height: 20),
Text(
'Seen in the last 24 hours',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: Theme.of(context).colorScheme.onSurface,
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 6),
_SummaryRow(
label: 'Registered',
value: '${summary.seenLastDayRegistered}',
),
_SummaryRow(
label: 'Unregistered',
value: '${summary.seenLastDayUnregistered}',
),
const Divider(height: 20),
Text(
'Seen in the last 7 days',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: Theme.of(context).colorScheme.onSurface,
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 6),
_SummaryRow(
label: 'Registered',
value: '${summary.seenLastWeekRegistered}',
),
_SummaryRow(
label: 'Unregistered',
value: '${summary.seenLastWeekUnregistered}',
),
];
}
}
}
class _SummaryRow extends StatelessWidget {
final String label;
final String value;
const _SummaryRow({required this.label, required this.value});
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.symmetric(vertical: 2),
child: Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
label,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: Theme.of(context).colorScheme.onSurfaceVariant,
),
),
Text(
value,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: Theme.of(context).colorScheme.onSurfaceVariant,
fontWeight: FontWeight.bold,
),
),
],
),
);
}
}