docs align guide with current behavior

Document subjective feedback routes and persistence, the workout selector, excess-volume diagnostics, and the current deferred work.

Commit
b6a718eba0c385b42e91d9edbc994eebd6276b76
Author
Marius Peter <dev@marius-peter.com>
Author date
Committer
Marius Peter <dev@marius-peter.com>
Committer date
ARCHITECTURE.org
index a44fd91b..bbb6ec56 100644..100644
@@ -220,8 +220,8 @@
220 220
221 221 =Feedback= is a typed vocabulary for reported signals — sleep, appetite,
222 222 readiness, motivation, difficulty, pain, injury, insufficient preparation — with
223 Removed: duplicate categories rejected. It is defined and unit-tested in the core, and
224 Removed: nothing in =hito.app= or =hito.web= consumes it yet.
223 Added: duplicate categories rejected. The application stores reports independently of
224 Added: workouts, and the web tier records them through a sequential optional flow.
225 225
226 226 ** Progression — the judgment
227 227
@@ -231,8 +231,9 @@
231 231 prescribed band: below the floor is =Too_heavy=, twelve reps triggers
232 232 =Increase=, otherwise =Hold= — the ceiling of the authored band is deliberately
233 233 not a trigger, since =load_increase_trigger= is twelve regardless of the range.
234 Removed: =diagnose= reports habits HD1 names as causes of overtraining: extensions on
235 Removed: every stimulus, and training under-recovered.
234 Added: =diagnose= reports habits HD1 names as causes of overtraining: recorded volume
235 Added: beyond the prescription, extensions on every stimulus, and training
236 Added: under-recovered.
236 237
237 238 * Boundaries
238 239
@@ -370,6 +371,13 @@
370 371 | =/logbook/:id= | GET | A saved workout |
371 372 | =/logbook/:id/slots/:slot= | POST | Add a missing record |
372 373 | =/logbook/:id/slots/:slot/edit= | POST | Correct a saved slot |
374 Added: | =/feedback= | POST | Advance or save subjective feedback |
375 Added: | =/feedback/cancel= | POST | Discard the current feedback flow |
376 Added: | =/app-feedback= | GET | Write or review application feedback |
377 Added: | =/app-feedback/submit= | POST | Submit application feedback |
378 Added: | =/app-feedback/:id/upvote= | POST | Upvote another trainee's feedback |
379 Added: | =/app-feedback/:id/edit= | POST | Edit owned application feedback |
380 Added: | =/app-feedback/:id/remove= | POST | Remove owned application feedback |
373 381 | =/profile= | GET | Account profile: rename and change password |
374 382 | =/profile/username= | POST | Change the username |
375 383 | =/profile/password= | POST | Change the password (verifies the current one) |
@@ -386,14 +394,13 @@
386 394 ** The workout view
387 395
388 396 One page serves both the workout in progress and a saved record. It
389 Removed: shows one prescribed slot at a time under a vertical group of named
390 Removed: exercise buttons, each a server-rendered link carrying its slot in
391 Removed: =?slot==. The active link is marked =aria-current="page"=. A handler
392 Removed: clamps a requested slot against the prescription and otherwise opens
393 Removed: on the default: the first slot still awaiting a record, or the first
394 Removed: slot when all are filled.
397 Added: shows one prescribed slot at a time under a server-rendered exercise
398 Added: selector carrying its slot in =?slot==. The selected option identifies
399 Added: the active slot. A handler clamps a requested slot against the
400 Added: prescription and otherwise opens on the default: the first slot still
401 Added: awaiting a record, or the first slot when all are filled.
395 402
396 Removed: This is link navigation and route state, not an ARIA widget —
403 Added: This is form navigation and route state, not an ARIA widget —
397 404 deterministic, and correct with no client script at all.
398 405
399 406 ** Progressive enhancement
@@ -523,8 +530,6 @@
523 530
524 531 * Deferred
525 532
526 Removed: - =Evidence.Feedback= is modelled and tested but not yet recorded or
527 Removed: shown.
528 533 - =Progression.remedy= is computed but never applied to a routine —
529 534 the dashed arrow above.
530 535 - Equipment granularity, so a suggested load is one a bar can actually