mirror of
https://github.com/kuhyx/screen-locker.git
synced 2026-11-20 03:34:24 +01:00
- Per exercise: weight / reps / double progression (n=12, m=6), one pure rule shared by Finish and every preview; streaks and next step shown on the tile. Warmup is the first circle of the set row and can be turned off. - Pause an exercise for n days (default 14): shown as paused, recorded as FAILED every workout so it steps down; skipped by the notification. - App bar removed: Reset/Finish live in the rest strip, no rest labels. - Schema v5 (progression_mode, reps_high, reps_low, has_warmup, paused_until), synced through the Firebase progression record; NULL warmup = plan default. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeVXsWTuwjmZK5uvbw6vqF
181 lines
5.0 KiB
Dart
181 lines
5.0 KiB
Dart
/// Per-exercise progression state, as stored in SQLite and synced to
|
|
/// Firebase.
|
|
library;
|
|
|
|
import 'dart:developer';
|
|
|
|
import 'package:workout_app/models/exercise.dart';
|
|
import 'package:workout_app/models/progression.dart';
|
|
|
|
/// Per-exercise progression state stored in SQLite.
|
|
///
|
|
/// Every field is `required` deliberately: a state rebuilt field by field
|
|
/// (a threshold edit, a restore) that forgot one would silently reset it,
|
|
/// and a required parameter makes the compiler find every such site.
|
|
class ExerciseState implements ProgressionInputs {
|
|
/// Creates an [ExerciseState] with all progression fields.
|
|
ExerciseState({
|
|
required this.name,
|
|
required this.weight,
|
|
required this.reps,
|
|
required this.successStreak,
|
|
required this.failStreak,
|
|
required this.maxWeight,
|
|
required this.successThreshold,
|
|
required this.failThreshold,
|
|
required this.mode,
|
|
required this.repsHigh,
|
|
required this.repsLow,
|
|
required this.hasWarmup,
|
|
required this.pausedUntil,
|
|
});
|
|
|
|
/// The state a never-trained [ex] starts from.
|
|
factory ExerciseState.initial(Exercise ex) => ExerciseState(
|
|
name: ex.name,
|
|
weight: ex.weight,
|
|
reps: ex.reps,
|
|
successStreak: 0,
|
|
failStreak: 0,
|
|
maxWeight: ex.maxWeight,
|
|
successThreshold: 3,
|
|
failThreshold: 2,
|
|
mode: ProgressionMode.weight,
|
|
repsHigh: kDefaultRepsHigh,
|
|
repsLow: kDefaultRepsLow,
|
|
hasWarmup: ex.hasWarmup,
|
|
pausedUntil: null,
|
|
);
|
|
|
|
/// Exercise name (matches [Exercise.name], used as primary key).
|
|
final String name;
|
|
|
|
/// Current working weight in kg.
|
|
@override
|
|
double weight;
|
|
|
|
/// Current target reps per set.
|
|
@override
|
|
int reps;
|
|
|
|
/// Consecutive successful workouts since last progression.
|
|
int successStreak;
|
|
|
|
/// Consecutive failed workouts since last regression.
|
|
int failStreak;
|
|
|
|
/// Weight cap; reps increase instead of weight when this is reached.
|
|
@override
|
|
final double maxWeight;
|
|
|
|
/// Successes needed in a row before the target goes up.
|
|
int successThreshold;
|
|
|
|
/// Failures needed in a row before the target goes down.
|
|
int failThreshold;
|
|
|
|
/// How the target goes up and down.
|
|
@override
|
|
final ProgressionMode mode;
|
|
|
|
/// Double progression: reps at which the weight goes up (`n`).
|
|
@override
|
|
final int repsHigh;
|
|
|
|
/// Double progression: reps the heavier weight starts at (`m`).
|
|
@override
|
|
final int repsLow;
|
|
|
|
/// Whether this exercise gets a warmup set (and its rest).
|
|
final bool hasWarmup;
|
|
|
|
/// The first day the exercise is back after an injury pause (a local
|
|
/// midnight), or null when it is not paused. While paused it is recorded
|
|
/// as FAILED in every workout, so progression steps down instead of the
|
|
/// exercise coming back at the load it left with.
|
|
final DateTime? pausedUntil;
|
|
|
|
/// Whether the exercise is paused at [now].
|
|
bool isPausedAt(DateTime now) {
|
|
final until = pausedUntil;
|
|
return until != null && now.isBefore(until);
|
|
}
|
|
|
|
/// Returns a copy with the given fields replaced.
|
|
ExerciseState copyWith({
|
|
double? weight,
|
|
int? reps,
|
|
int? successStreak,
|
|
int? failStreak,
|
|
int? successThreshold,
|
|
int? failThreshold,
|
|
ProgressionMode? mode,
|
|
int? repsHigh,
|
|
int? repsLow,
|
|
bool? hasWarmup,
|
|
DateTime? pausedUntil,
|
|
bool resume = false,
|
|
}) => ExerciseState(
|
|
name: name,
|
|
weight: weight ?? this.weight,
|
|
reps: reps ?? this.reps,
|
|
successStreak: successStreak ?? this.successStreak,
|
|
failStreak: failStreak ?? this.failStreak,
|
|
maxWeight: maxWeight,
|
|
successThreshold: successThreshold ?? this.successThreshold,
|
|
failThreshold: failThreshold ?? this.failThreshold,
|
|
mode: mode ?? this.mode,
|
|
repsHigh: repsHigh ?? this.repsHigh,
|
|
repsLow: repsLow ?? this.repsLow,
|
|
hasWarmup: hasWarmup ?? this.hasWarmup,
|
|
// `resume` exists because a null argument cannot mean "clear it".
|
|
pausedUntil: resume ? null : (pausedUntil ?? this.pausedUntil),
|
|
);
|
|
}
|
|
|
|
/// First local midnight [days] days after [now]: the day a pause started at
|
|
/// [now] ends.
|
|
DateTime pauseEnd(DateTime now, int days) =>
|
|
DateTime(now.year, now.month, now.day + days);
|
|
|
|
/// `2026-10-11` for storage; the inverse of [parsePauseDate].
|
|
String formatPauseDate(DateTime d) =>
|
|
'${d.year.toString().padLeft(4, '0')}-'
|
|
'${d.month.toString().padLeft(2, '0')}-'
|
|
'${d.day.toString().padLeft(2, '0')}';
|
|
|
|
/// Reads a stored pause date; null means not paused.
|
|
///
|
|
/// Anything unreadable is reported and treated as "not paused": the
|
|
/// exercise then shows up in the workout, which is the visible failure.
|
|
DateTime? parsePauseDate(Object? raw) {
|
|
if (raw == null) return null;
|
|
final parsed = raw is String ? DateTime.tryParse(raw) : null;
|
|
if (parsed == null) {
|
|
log(
|
|
'ExerciseState: unreadable paused_until "$raw" — treating the '
|
|
'exercise as not paused.',
|
|
level: 900,
|
|
);
|
|
}
|
|
return parsed;
|
|
}
|
|
|
|
const _months = [
|
|
'Jan',
|
|
'Feb',
|
|
'Mar',
|
|
'Apr',
|
|
'May',
|
|
'Jun',
|
|
'Jul',
|
|
'Aug',
|
|
'Sep',
|
|
'Oct',
|
|
'Nov',
|
|
'Dec',
|
|
];
|
|
|
|
/// `11 Oct`: how a pause's end date is shown.
|
|
String formatShortDate(DateTime d) => '${d.day} ${_months[d.month - 1]}';
|