docs/wiki/4.19-Metrics.md
Metrics in Super Productivity are per-day and context-based data used to review how you worked: raw inputs you enter or that the app records (e.g. focus sessions, impact rating, energy check-in, reflections), and derived values computed from that data (e.g. productivity and sustainability scores, aggregates over a date range, trend indicators). The app persists the raw daily fields and computes scores, aggregates, and charts on demand so you can see both “what happened that day” and “how that compares over time.” Understanding what is stored vs computed, what each metric represents, and where metrics appear in the app helps you use the evaluation sheet, metrics view, and sharing effectively.
Reflections are one of the persisted daily fields; see [[4.18-Reflection]]. Focus sessions feed into both persisted data and the productivity/sustainability scores; see [[4.15-Timers-and-Focus-Mode]]. Evaluation and metrics settings are in [[3.02-Settings-and-Preferences]].
The app tracks per-day data in two categories: persisted (stored as part of that day’s record) and computed (calculated when you open a view or report).
Each day has a metric record identified by the date. The app stores:
So “what the app remembers for a day” is: date, focus sessions, notes/remind/reflections, impact, energy, and work/task totals. Everything else you see (scores, averages, trends, charts) is computed from this stored data plus worklog and task data when you open the relevant view.
The app does not store these; it calculates them when needed:
So when you open the metrics view or evaluation sheet, the app loads the stored daily records and then computes scores, aggregates, and chart series for the range and context you’re looking at.
That split keeps storage simple (one record per day with a fixed set of fields) while still giving you rich summaries and trends.
So: persisted data is edited and viewed in the evaluation sheet (and focus sessions are added automatically); computed aggregates, scores, trends, and charts are shown in the metrics view, evaluation sheet, and share summary.
The aggregate metrics table (time spent, task counts, averages, etc.) is context-sensitive:
The evaluation sheet and per-day scores are always per day (one date at a time). Productivity and sustainability trends and charts are computed over a date range (e.g. last 7 or 30 days) from the stored daily records and worklog; they are not restricted by project—they use the global daily metric records and worklog.