# Workout App Context ## Current Task Implementing design_v2.md improvements. ## Key Decisions - Active session persisted to SQLite on every tap so force-kill is safe - Back button: PopScope is still present and pins the route in lock mode (workout_screen.dart) — the older "PopScope removed" note here was wrong - Auto-resume: HomeScreen auto-navigates to workout on first load if session exists - Break timing is wall-clock (`BreakClock`), never a tick counter: Android throttles and Doze suspends timers in a backgrounded isolate - A `flutter_foreground_task` service owns the deadline for the whole workout and shows the status-bar notification; notification presses go through a durable prefs queue, never straight into sqflite (the CRDT sync layer owns that database's ordering) ## GPS runs (foundation, 2026-11-10) - The app records one mode: every GPS activity is a run (25 km/h jump cap, `Sport="Running"`, `_Running.tcx`); the PC credits all with one rule. No run/walk toggle. `decodeTcx` still reads old `_Walking.tcx` imports. Optional pace target (`pace_band.dart`, picker `run_pace_picker.dart`); idle map follows the user's fix (`idle_location.dart`, display-only); location refused = no map and no start, only the red icon. The app uploads a TCX the PC credits unchanged. Contract = the PC parser, pinned by `screen_locker/tests/fixtures/run_tcx/` (Dart `test/services/tcx_golden_fixture_test.dart` <-> pytest `screen_locker/tests/test_run_tcx_golden.py`). Regenerate after a deliberate codec change: `UPDATE_GOLDEN=1 flutter test test/services/tcx_golden_fixture_test.dart`. - File name `RunnerUp_YYYY-MM-DD-HH-MM-SS_.tcx` (historic: `Walking`), stamp in LOCAL time; ``/`