Workout Logbook¶
The workout logbook is a different way for a patient to do a session: the whole workout on one screen, every set listed, and a box for what was actually done. It is for clinics whose patients train more like athletes than like a first-week post-op patient, and it comes with two new tools for the therapist: a different target for each set (12, 10, 8; a range such as 8–12; or "max") and a note for each block of the session.
It is switched on per clinic with the workoutLogbook feature flag (Admin → Feature Flags → Plans & HEP builder). Where it is off nothing changes: patients keep the guided exercise-by-exercise flow described in Workout Completion & Resume.
For patients¶
Start workout opens the session as one list, grouped into its blocks (Warm-up, Main, Supplemental, Cool-down), on the web and in the app.
- Every exercise shows its thumbnail, its name and its target, with the therapist's weight when there is one ("3 × 12 / 10 / 8 · 16 kg", "3 × 8–12", "3 × max", "2 × 30s"). Tapping the thumbnail or the name opens the exercise with its video; nothing plays on its own.
- Under each exercise, one line per set under a single header (Set, Reps or Seconds, and the weight unit when there is a weight): the set number, a box for the reps (or seconds) actually done, a box for the weight used when the exercise has one, and a tick. The plan sits in grey inside the boxes: the target ("10", "8–12", "max") and the therapist's weight. A weight typed in one set shows in grey in the sets below it that have no weight from the therapist, so a patient who keeps the same weight types it once.
- Ticking a set fills its empty boxes with their grey numbers, so a done set shows exactly what is saved; unticking turns them back into the plan. Typing the reps (or seconds) ticks the set; typing a weight does not, so it can be set up before the set. On a range or a max set the tick puts the cursor in the box to ask for the number. An empty box on a done set saves nothing and reads "—". Mark done ticks every set of an exercise in one tap.
- Weights are in kilograms in the Russian (OKTA) apps and sites and in pounds in the US (OTERA) ones, and take decimals with a comma or a point ("2,5"). The weight is optional: leave it empty for bodyweight. The weight column shows only when the therapist gave that day's exercise a weight (for the exercise or for any set), or the patient already logged a weight for it in the same session. Otherwise the exercise shows only reps (or seconds) and a small + weight link under the sets, which opens the column for that exercise in that session only; other days follow the therapist's plan for that day. Since 2026-10-28; before, every reps exercise had a weight box.
- Under the dose, Last: 4 × 5 · 35 lbs (in Russian «Было: 4 × 5 · 5 кг») says what was logged the last time this exercise was done, whichever day or plan it was in: the sets as reps or seconds (minutes in words: "3 × 1 min 30 s") and the weight, set by set when they differed ("5 / 5 / 4 · 5 / 5 / 6 kg"). When that was more than 30 days ago the line names the day ("Last, Aug 12: …"). An exercise done for the first time has no line; one skipped last time shows the time before. The grey weight in an empty box is the therapist's weight for that set, else a weight entered in a set above in this session, else the weight of the same set last time, and the weight column is there whenever one of the three exists. The line stays apart from the boxes, so it is always clear where a grey number comes from. Since 2026-10-30.
- Add a note under an exercise sends a note to the therapist with that exercise.
- The therapist's note for the session sits at the top, and the note for a block above the block. The title says "Today's workout", or the session's date when it is another day's.
- Everything saves as it is entered, and a save that fails for want of signal is tried again on its own (and when the app comes back to the front). Closing the screen loses nothing; the card on the home screen says how many exercises have something logged ("2 of 5 exercises done"), Start over clears the log.
- Finish workout asks once about pain and effort, both optional, and saves the session. Streaks, the therapist's feedback card and everything else that follows a finished session work exactly as before.
Under the logbook there is no camera recording, no circuit mode and no pain question after every exercise.
For therapists¶
Two controls appear on the web:
- Vary by set on an exercise's dose, in the plan builder and the classic plan editors (workout templates included). Each set gets its own target: a number of reps, a range (from–to) or Max (as many as the patient can). Adding a set copies the last one; changing the set count grows or trims the list. For a timed exercise each set gets its own seconds. Each set is a small card ("Set 2" and a remove cross, then the target), the cards sit in rows that wrap (three to a row in the plan builder's list, up to six in the wider editors), and + Set is the last, dashed card. On a reps exercise a small Reps / Range / Max switch sits in each card. While it is on, the single Reps (or Time) box reads By set. Since 2026-10-28 each set can also have its own weight (a 20 / 20 / 25 kg pyramid): the weight box appears in the cards once the exercise has a weight, or after + weight under the cards; an empty box means the exercise's weight, and a new set copies the weight of the one before. When the sets' weights differ, the Weight field reads By set and the line under the exercise shows the range ("20–25 kg"). Everywhere the plan is shown, the dose reads as the patient sees it: "3 × 12 / 10 / 8".
- Note for this block under each block header in the builder's list view. The note is written once for the week and stored on every day that has that block; when the days disagree, the field says Differs by day and saving it applies the note to all of them. The patient reads it above the block.
In the iPhone app the per-set targets show under the exercise ("By set: 12 / 10 / 8") with the weight range; changing that exercise's sets or reps in the app makes every set the same again and keeps the first set's weight, and changing the Weight there gives every set that weight. Switching a web row back to Same every set keeps the first set's weight the same way.
The Weight in the plan builder's Advanced section, or in the app's dosage editor, is the grey weight in each of the patient's sets that has no weight of its own. Weights read in the clinic's unit everywhere: kg for OKTA clinics, lbs for OTERA clinics, in the builder, the iPhone app, AI plan changes (the AI is told the unit too), the printed plan and the workout email.
In a patient's program, each exercise row says what the patient logged the last time they did that exercise, with the day: Last, Oct 24: 4 × 5 · 35 lbs («Было 24 окт: 4 × 5 · 5 кг»). It sits under the dose in the plan builder's list (and in a week card once it is opened), in the classic plan editor's day sheet, in a new session and in Edit session on the web, and in the app's Manage HEP in both the Sessions and the Program view. It reads across every session the patient logged, whatever plan it belonged to, shows wherever the patient has logged sets, flag or no flag, and never in a template, which belongs to no patient. Since 2026-10-30.
What the patient logged shows set by set in the session details on the web and in the app ("Logged: 12 / 9 / 7", "Logged: 10 / 10 / 8 @ 16 kg" when every set used the same weight, "10 @ 16 kg / 8 @ 18 kg" when they differ), next to the planned targets and the planned weight, with the session's pain, effort and note at the top (these also show for sessions finished with Mark as finished). The patient's own history shows the logged sets too.
Good to know¶
- A clinic that turns the flag off keeps the per-set targets and block notes it saved; they still show on plans and sessions, but the controls to change them are hidden.
- A weight is stored as the number typed, in the clinic's unit; it is never converted. A weight typed into a set that is never ticked is not saved.
- Older app versions show a varied exercise as its set count and the first set's target ("3 × 12"; a range as its lower bound, a plan of only max sets as the reps the exercise had before), and keep working.
- Plan continuation copies the per-set targets and block notes with the session. When the AI adapts a copy, an exercise with per-set targets keeps them exactly as the therapist wrote them; the AI adapts the other exercises as before.
- Templates carry their per-set targets into the plans made from them.
- Mobile needs the app update that ships with this feature; until then the app keeps the guided flow for everyone. The logbook and its weight box reach phones in the same app update, and the Last line with the update that follows it (2026-10-30).
See Workout Logbook (internals) for the data model and endpoints.