mirror of
https://github.com/kuhyx/diet-guard.git
synced 2026-11-10 19:27:14 +01:00
Krzysztof kuhy Rudnicki
e07284d3e1
The calendar already said which individual days went over budget, but not whether the week as a whole did. A run of small overages reads as four harmless yellow squares; averaged, it is the thing that actually moves the needle. Three rules are load-bearing, and are documented in CLAUDE.md because getting any of them wrong silently changes what "under budget" means: - The denominator is logged days, not elapsed days. An unlogged day is not a zero-kcal day, and averaging gaps in as zeros would make a badly-tracked week look like the best week of the year. - The yardstick is the mean of the per-day budgets over those same days, resolved through BudgetSchedule -- never today's budget, which would retroactively reclassify past weeks on every budget edit. - Today is excluded. A half-logged today drags the mean far enough to flip the band, so every period ends at yesterday. Band boundaries reuse the calendar's own OVER_BUDGET_YELLOW_CEILING by import rather than by copy, so a period and its days can never disagree about what "over" means; that constant loses its underscore to say so. The MCP get_averages tool returns the average and the band but drops the average budget, keeping the module's existing invariant that the budget number never leaves this machine. The CLI, the gate and the phone all show both, since it is hidden from the network, not from the user. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DjJqpcEsaV5WRhPXyxCThd
44 lines
1.4 KiB
Dart
44 lines
1.4 KiB
Dart
/// Weekly/monthly average-intake summary row for the History screen.
|
|
library;
|
|
|
|
import 'package:diet_guard_app/models/period_average.dart';
|
|
import 'package:flutter/material.dart';
|
|
|
|
/// Displays this week's and this month's average kcal/day and their bands.
|
|
///
|
|
/// Mirrors `_calendar_view.py`'s `averages_text`: "Avg/day (to yesterday):
|
|
/// week NNNN kcal (band) · month NNNN kcal (band)".
|
|
///
|
|
/// Both periods stop at yesterday, so this line does not swing every time a
|
|
/// meal is logged today -- it answers "how has this week gone", not "how am I
|
|
/// doing right now", which is what the Today progress card is for.
|
|
class AverageSummaryRow extends StatelessWidget {
|
|
/// Creates an [AverageSummaryRow].
|
|
const AverageSummaryRow({
|
|
required this.week,
|
|
required this.month,
|
|
super.key,
|
|
});
|
|
|
|
/// The current ISO week's average, through yesterday.
|
|
final PeriodAverage week;
|
|
|
|
/// The current calendar month's average, through yesterday.
|
|
final PeriodAverage month;
|
|
|
|
static String _part(PeriodAverage period) {
|
|
final avg = period.avgKcal;
|
|
if (avg == null) return bandLabel(period.band);
|
|
return '${avg.round()} kcal (${bandLabel(period.band)})';
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return Text(
|
|
'Avg/day (to yesterday): week ${_part(week)} · month ${_part(month)}',
|
|
textAlign: TextAlign.center,
|
|
style: Theme.of(context).textTheme.bodySmall,
|
|
);
|
|
}
|
|
}
|