Интеграция документа метрик (vision 1.3, Ф-13, правила координации 1–6, Safety-пороги, daily_log, RPE)
This commit is contained in:
parent
9243df024e
commit
842876802c
|
|
@ -6,8 +6,11 @@
|
||||||
> (`..\..\Техническое задание.md`), дизайн LLM-планирования (разд. 2–3,
|
> (`..\..\Техническое задание.md`), дизайн LLM-планирования (разд. 2–3,
|
||||||
> 6–8, 11 — шаг 1); изменение vision 1.1 (2026-10-17) — несколько
|
> 6–8, 11 — шаг 1); изменение vision 1.1 (2026-10-17) — несколько
|
||||||
> атлетов на сервере, разные модели часов.
|
> атлетов на сервере, разные модели часов.
|
||||||
> Версия 1.0 — **УТВЕРЖДЕНО** (2026-10-17; изменения vision 1.1, 1.2
|
> Версия 1.1 — **УТВЕРЖДЕНО** (2026-10-17; изменения vision 1.1, 1.2
|
||||||
> учтены; утверждение — 2026-10-17).
|
> учтены; утверждение — 2026-10-17). Изменение 1 (2026-10-17, указание
|
||||||
|
> пользователя): интегрирован документ
|
||||||
|
> `Метрики_тренировок_и_самоконтроля.md` — добавлена Ф-13, правила
|
||||||
|
> Ф-12 расширены (vision 1.3, БЦ-6, КУ-7).
|
||||||
|
|
||||||
## 1. Назначение и границы
|
## 1. Назначение и границы
|
||||||
|
|
||||||
|
|
@ -23,7 +26,9 @@
|
||||||
прогрессии (без LLM); поддержка нескольких атлетов на сервере —
|
прогрессии (без LLM); поддержка нескольких атлетов на сервере —
|
||||||
у каждого свои программы, профиль и данные (изменение vision 1.1);
|
у каждого свои программы, профиль и данные (изменение vision 1.1);
|
||||||
поддержка разных моделей часов Garmin (мультитаргет-сборка одного
|
поддержка разных моделей часов Garmin (мультитаргет-сборка одного
|
||||||
поля данных).
|
поля данных); самоконтроль и допуск к тренировке: дневник телеметрии,
|
||||||
|
предстартовые пороги АД/пульса, RPE/боль по сетам, правила
|
||||||
|
координации 1–6 (Ф-13, изменение 1).
|
||||||
- **Вне границ v1:** LLM-планирование — еженедельный контур (v2,
|
- **Вне границ v1:** LLM-планирование — еженедельный контур (v2,
|
||||||
опросник 4.6), мезоциклы и «генератор+ревьюер» (v2.x); wake-word
|
опросник 4.6), мезоциклы и «генератор+ревьюер» (v2.x); wake-word
|
||||||
«Феникс, записывай» (v2, опросник 4.5); iOS (v2, опросник 4.2);
|
«Феникс, записывай» (v2, опросник 4.5); iOS (v2, опросник 4.2);
|
||||||
|
|
@ -31,7 +36,8 @@
|
||||||
трековые виды спорта — бег/вело (v3+, опросник 4.7); полная
|
трековые виды спорта — бег/вело (v3+, опросник 4.7); полная
|
||||||
автоматическая смена программы без подтверждения (vision 2.4);
|
автоматическая смена программы без подтверждения (vision 2.4);
|
||||||
саморегистрация атлетов и публичный доступ (vision 2.4, изменение
|
саморегистрация атлетов и публичный доступ (vision 2.4, изменение
|
||||||
1.1).
|
1.1); контрольные тесты (Руфье, Штанге—Генчи, тест ходьбы) и полная
|
||||||
|
утренняя телеметрия с правилами 7–10 (v2/v3 — документ метрик, п. 5).
|
||||||
|
|
||||||
## 2. Состав системы, точки входа и режимы
|
## 2. Состав системы, точки входа и режимы
|
||||||
|
|
||||||
|
|
@ -105,6 +111,10 @@ Garmin штатно — Ф-2.5, Ф-2.6). Код поля данных перен
|
||||||
| `Progression.BaseStepKg` | шаг прогрессии веса, кг | `2.5` |
|
| `Progression.BaseStepKg` | шаг прогрессии веса, кг | `2.5` |
|
||||||
| `Progression.BackoffPercent` | снижение при недовыполнении, % | `5` |
|
| `Progression.BackoffPercent` | снижение при недовыполнении, % | `5` |
|
||||||
| `Deload.MaxWeeks` | недель между делоадами | `6` |
|
| `Deload.MaxWeeks` | недель между делоадами | `6` |
|
||||||
|
| `Safety.BpCancel` | порог отмены тренировки по АД (сист./диаст.) | `150/90` |
|
||||||
|
| `Safety.BpCardio` | порог «только кардио» по АД | `140/90` |
|
||||||
|
| `Safety.RestingHrSitting` | порог пульса сидя для переноса тренировки | `90` |
|
||||||
|
| `Safety.LightWeekHrRise` | рост пульса покоя (2 дня) для лёгкой недели | `+8` |
|
||||||
| `Log.Path / Log.Level` | логи | `logs\`, `Info` |
|
| `Log.Path / Log.Level` | логи | `logs\`, `Info` |
|
||||||
|
|
||||||
🛡 Пароль Garmin и API-ключ — только в настройках, не в коде; логи их
|
🛡 Пароль Garmin и API-ключ — только в настройках, не в коде; логи их
|
||||||
|
|
@ -341,11 +351,17 @@ Garmin штатно — Ф-2.5, Ф-2.6). Код поля данных перен
|
||||||
🛡 Метрики и правила считаются по каждому атлету независимо
|
🛡 Метрики и правила считаются по каждому атлету независимо
|
||||||
(изоляция, изменение vision 1.1).
|
(изоляция, изменение vision 1.1).
|
||||||
2. Микроправка весов на следующее занятие (правила, детерминированно):
|
2. Микроправка весов на следующее занятие (правила, детерминированно):
|
||||||
- все запланированные подходы закрыты «по плану» → вес +
|
- все запланированные подходы закрыты «по плану» при RPE ≤ 7
|
||||||
`Progression.BaseStepKg` на базовых, + `BaseStepKg`/2 на изоляции;
|
(2 тренировки подряд) → вес + `Progression.BaseStepKg` (базовые),
|
||||||
|
+ `BaseStepKg`/2 (изоляция);
|
||||||
|
- RPE ≥ 9 в 2+ сетах → вес − `Progression.BackoffPercent` %;
|
||||||
|
- повторения достигли верхней границы диапазона (15–20) → вес ↑,
|
||||||
|
повторения к 12;
|
||||||
- ≥ 2 подходов не дотянуты по повторениям → вес −
|
- ≥ 2 подходов не дотянуты по повторениям → вес −
|
||||||
`Progression.BackoffPercent` %;
|
`Progression.BackoffPercent` %;
|
||||||
- иначе (частичное выполнение) — вес без изменения.
|
- иначе (частичное выполнение) — вес без изменения.
|
||||||
|
Источник порогов — документ метрик («Метрики_тренировок_и_
|
||||||
|
самоконтроля.md», правила 3–5, МакРоберт).
|
||||||
3. Правила применяются только к `active` версии; результат —
|
3. Правила применяются только к `active` версии; результат —
|
||||||
предложение следующей версии программы со статусом `draft`
|
предложение следующей версии программы со статусом `draft`
|
||||||
(`author=rules`), показывается атлету в приложении диффом;
|
(`author=rules`), показывается атлету в приложении диффом;
|
||||||
|
|
@ -355,10 +371,49 @@ Garmin штатно — Ф-2.5, Ф-2.6). Код поля данных перен
|
||||||
4. Делоад: если `Deload.MaxWeeks` недель подряд без делоада, правило
|
4. Делоад: если `Deload.MaxWeeks` недель подряд без делоада, правило
|
||||||
предлагает делоад-версию (объём −40–50 %) — тем же механизмом
|
предлагает делоад-версию (объём −40–50 %) — тем же механизмом
|
||||||
диффа (дизайн LLM-планирования, разд. 6).
|
диффа (дизайн LLM-планирования, разд. 6).
|
||||||
|
5. Красные флаги и лёгкая неделя (документ метрик, правила 1, 6, v1):
|
||||||
|
- пульс покоя ≥ обычного +8 уд/мин два дня подряд или самочувствие
|
||||||
|
≤ 2 → следующая тренировка помечается лёгкой (60–70 % весов,
|
||||||
|
2 сета); 3+ дня — предложение отмены и совет к врачу;
|
||||||
|
- боль в колене ≥ 1 два занятия подряд → предложение замены
|
||||||
|
упражнения из той же группы (пара-замена из атрибутов упражнения).
|
||||||
|
|
||||||
|
io header fix
|
||||||
5. Офлайн-режим сервера: правила выполняются при следующем запуске
|
5. Офлайн-режим сервера: правила выполняются при следующем запуске
|
||||||
`serve`/`import` — телефон при этом полнофункционален (учёт и
|
`serve`/`import` — телефон при этом полнофункционален (учёт и
|
||||||
локальные планы работают без сервера).
|
локальные планы работают без сервера).
|
||||||
|
|
||||||
|
### Ф-13. Самоконтроль и допуск к тренировке (телефон; изменение 1)
|
||||||
|
|
||||||
|
Источник порогов — документ метрик
|
||||||
|
(`..\..\Метрики_тренировок_и_самоконтроля.md`, Жижин гл. 2–3, 6;
|
||||||
|
Аттия гл. 10, 13; МакРоберт; CDC). Состав v1 — MVP-приоритет документа
|
||||||
|
(его п. 5).
|
||||||
|
|
||||||
|
1. **Дневник-минимум (день, дом, 2–3 минуты):** АД (сист./диаст.),
|
||||||
|
вес тела; экран «Сегодня» с вводом за 2–3 касания. Данные —
|
||||||
|
в `LocalDb` и на сервер (`daily_log`), в сводку метрик атлета.
|
||||||
|
2. **Предстартовый допуск:** перед стартом силовой тренировки — экран
|
||||||
|
допуска: пульс сидя (с часов, если связаны, иначе ввод вручную)
|
||||||
|
и АД за сегодня. Пороги:
|
||||||
|
- АД > 150/90 → тренировка не начинается: предложение прогулки,
|
||||||
|
кнопка «Отменить» (🛡);
|
||||||
|
- АД 140–150/90–95 → только лёгкое кардио/дыхание (силовые заблокированы);
|
||||||
|
- пульс сидя > 90 уд/мин → предложение перенести тренировку
|
||||||
|
(старт — явным подтверждением «всё равно начать»).
|
||||||
|
3. **По сетам:** RPE (цель 6–8) — голосом «РПЭ **N**» для последнего
|
||||||
|
подхода или тапом 0–10; боль в колене 0–10 — тапом, только для
|
||||||
|
упражнений группы «ноги»; сохраняется с подходом (`workout_set`).
|
||||||
|
4. **После тренировки:** время возврата пульса к < 90 уд/мин — считается
|
||||||
|
автоматически из .fit (Record после последнего Lap); показывается
|
||||||
|
в карточке и попадает в метрики.
|
||||||
|
5. 🛡 Пороги допуска — конфигурируемые на сервере (`Safety.*`),
|
||||||
|
значения по умолчанию — из документа метрик; обход блокировки
|
||||||
|
«Отменить» логируется.
|
||||||
|
6. Полная утренняя телеметрия (пульс покоя, талия, сон, самочувствие)
|
||||||
|
и правила координации 7–10 — v2; контрольные тесты — v3
|
||||||
|
(документ метрик, п. 5).
|
||||||
|
|
||||||
### Логирование (телефон и сервер)
|
### Логирование (телефон и сервер)
|
||||||
|
|
||||||
1. `Info`: старт/остановка тренировки, каждая команда (Ф-1.5), пакеты
|
1. `Info`: старт/остановка тренировки, каждая команда (Ф-1.5), пакеты
|
||||||
|
|
@ -406,7 +461,10 @@ Garmin штатно — Ф-2.5, Ф-2.6). Код поля данных перен
|
||||||
| Ф-10 программы | БЦ-3 | КУ-5 | v1 |
|
| Ф-10 программы | БЦ-3 | КУ-5 | v1 |
|
||||||
| Ф-11 план/факт | БЦ-3 | КУ-5 | v1 |
|
| Ф-11 план/факт | БЦ-3 | КУ-5 | v1 |
|
||||||
| Ф-12 правила прогрессии | БЦ-3 | КУ-6 | v1 |
|
| Ф-12 правила прогрессии | БЦ-3 | КУ-6 | v1 |
|
||||||
|
| Ф-13 самоконтроль и допуск | БЦ-6 | КУ-7 | v1 |
|
||||||
| Ф-12 LLM-контур (еженедельно) | БЦ-3 | — | v2 |
|
| Ф-12 LLM-контур (еженедельно) | БЦ-3 | — | v2 |
|
||||||
|
| Ф-13 полная телеметрия, правила 7–10 | БЦ-6 | — | v2 |
|
||||||
|
| Контрольные тесты | БЦ-6 | — | v3 |
|
||||||
| Wake-word (Ф-1) | БЦ-1 | — | v2 |
|
| Wake-word (Ф-1) | БЦ-1 | — | v2 |
|
||||||
| iOS | БЦ-1, БЦ-2 | — | v2 |
|
| iOS | БЦ-1, БЦ-2 | — | v2 |
|
||||||
| Бег/вело | — | — | v3+ |
|
| Бег/вело | — | — | v3+ |
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,8 @@
|
||||||
# Vision: Феникс 6X — контроль силовых тренировок (телефон + Garmin Fenix 6 + личный сервер)
|
# Vision: Феникс 6X — контроль силовых тренировок (телефон + Garmin Fenix 6 + личный сервер)
|
||||||
|
|
||||||
> Версия 1.2 — **УТВЕРЖДЕНО** (2026-10-17; вопросы опросника 4.1–4.7
|
> Версия 1.3 — **УТВЕРЖДЕНО** (2026-10-17; вопросы опросника 4.1–4.7
|
||||||
> отвечены, ответы применены; утверждение — 2026-10-17; изменения
|
> отвечены, ответы применены; утверждение — 2026-10-17; изменения
|
||||||
> 1.1, 1.2 — указания пользователя от 2026-10-17).
|
> 1.1–1.3 — указания пользователя от 2026-10-17).
|
||||||
> Изменение 1.1: серверная часть
|
> Изменение 1.1: серверная часть
|
||||||
> поддерживает нескольких атлетов — у каждого свои программы, профиль
|
> поддерживает нескольких атлетов — у каждого свои программы, профиль
|
||||||
> и данные, с собственных телефона и часов (пп. 2.2, 2.4, 3.1);
|
> и данные, с собственных телефона и часов (пп. 2.2, 2.4, 3.1);
|
||||||
|
|
@ -16,6 +16,13 @@
|
||||||
> программ (версии, смена активной), управление атлетами (Ф-9, п. 2.2);
|
> программ (версии, смена активной), управление атлетами (Ф-9, п. 2.2);
|
||||||
> атлеты смотрят свои данные только на телефоне — веб-доступа для них
|
> атлеты смотрят свои данные только на телефоне — веб-доступа для них
|
||||||
> нет.
|
> нет.
|
||||||
|
> Изменение 1.3 (метрики тренировок и самоконтроля, документ
|
||||||
|
> «Метрики_тренировок_и_самоконтроля.md», 2026-10-17): добавлена Ф-13
|
||||||
|
> «Самоконтроль и допуск к тренировке» — дневник телеметрии (пульс
|
||||||
|
> покоя, АД, вес, талия, сон, самочувствие), предтренировочный допуск
|
||||||
|
> (пороги АД/пульса), RPE и боль в колене по сетам; правила
|
||||||
|
> координации Ф-12 расширены 11 детерминированными правилами по книгам
|
||||||
|
> (пп. 2.2, 2.3, 3.3).
|
||||||
> Источник идеи: техническое задание
|
> Источник идеи: техническое задание
|
||||||
> «Феникс 6X» (Garmin Edition) от 17.10.2026
|
> «Феникс 6X» (Garmin Edition) от 17.10.2026
|
||||||
> ([Техническое задание.md](../../Техническое%20задание.md)); требование
|
> ([Техническое задание.md](../../Техническое%20задание.md)); требование
|
||||||
|
|
@ -138,6 +145,12 @@ Garmin Connect, личный сервер; стандарт разработки
|
||||||
следующая программа формируется/корректируется на его основе
|
следующая программа формируется/корректируется на его основе
|
||||||
(сейчас: треки остаются в Garmin Connect, связь с результатами
|
(сейчас: треки остаются в Garmin Connect, связь с результатами
|
||||||
не анализируется).
|
не анализируется).
|
||||||
|
- **БЦ-6.** Нагрузка безопасна: каждая силовая тренировка проходит
|
||||||
|
предстартовый допуск (АД, пульс) — красные флаги (АД > 150/90,
|
||||||
|
пульс сидя > 90) ведут к отмене или замене лёгким кардио; признаки
|
||||||
|
перетренированности (пульс покоя +8 уд/мин два дня, самочувствие ≤ 2)
|
||||||
|
автоматически снижают план следующей тренировки (изменение 1.3,
|
||||||
|
документ метрик). (Сейчас: допуск определяется «на глазок».)
|
||||||
|
|
||||||
### 1.4. Критерии успеха
|
### 1.4. Критерии успеха
|
||||||
|
|
||||||
|
|
@ -163,6 +176,11 @@ Garmin Connect, личный сервер; стандарт разработки
|
||||||
2 подхода → −5 %. Предложение LLM (при включённом контуре) показывается
|
2 подхода → −5 %. Предложение LLM (при включённом контуре) показывается
|
||||||
диффом и не применяется без подтверждения; невалидное предложение
|
диффом и не применяется без подтверждения; невалидное предложение
|
||||||
отклоняется валидатором и не доходит до пользователя.
|
отклоняется валидатором и не доходит до пользователя.
|
||||||
|
- **КУ-7.** Тест красного флага: при введённом АД 160/100 приложение
|
||||||
|
не позволяет начать силовую тренировку и предлагает прогулку;
|
||||||
|
при RPE ≥ 9 в двух подходах правила формируют draft со снижением
|
||||||
|
веса −5 %; при пульсе покоя +8 уд/мин два дня подряд следующая
|
||||||
|
тренировка в плане помечается лёгкой (изменение 1.3).
|
||||||
|
|
||||||
### 1.5. Положение о концепции проекта
|
### 1.5. Положение о концепции проекта
|
||||||
|
|
||||||
|
|
@ -296,13 +314,26 @@ Garmin, наш продукт фиксирует результаты без р
|
||||||
пользователя (бюджет доверия для микроправок ±5 %); офлайн-fallback —
|
пользователя (бюджет доверия для микроправок ±5 %); офлайн-fallback —
|
||||||
правила; расчёт метрик (adherence, тоннаж, 1ПМ, пульс-метрики) —
|
правила; расчёт метрик (adherence, тоннаж, 1ПМ, пульс-метрики) —
|
||||||
детерминированный MetricsEngine (дизайн LLM-планирования, разд. 3–7).
|
детерминированный MetricsEngine (дизайн LLM-планирования, разд. 3–7).
|
||||||
|
- **Ф-13. Самоконтроль и допуск к тренировке** (изменение 1.3) —
|
||||||
|
дневник телеметрии (утренний пульс покоя, АД, вес тела, талия, сон,
|
||||||
|
самочувствие 1–5); предтренировочный допуск: пульс сидя > 90 уд/мин
|
||||||
|
или АД > 150/90 → предложение перенести/отменить тренировку,
|
||||||
|
АД 140–150/90–95 → только лёгкое кардио; по сетам — RPE и боль
|
||||||
|
в колене (0–10) для упражнений на ноги; после тренировки — время
|
||||||
|
возврата пульса (из .fit). Источник порогов и правил — документ
|
||||||
|
метрик («Метрики_тренировок_и_самоконтроля.md», Жижин, Аттия,
|
||||||
|
МакРоберт, CDC); состав v1 — MVP-приоритет документа (его п. 5):
|
||||||
|
дневник-минимум + правила координации 1–6; утренняя телеметрия
|
||||||
|
полностью и правила 7–10 — v2, контрольные тесты — v3.
|
||||||
|
|
||||||
### 2.2. Объём первоначально запланированной версии
|
### 2.2. Объём первоначально запланированной версии
|
||||||
|
|
||||||
Состав версии 1.0 (решения — опросники 4.4 и 4.6): **v1.0 = полный
|
Состав версии 1.0 (решения — опросники 4.4 и 4.6, изменение 1.3):
|
||||||
MVP-цикл ТЗ (Ф-1–Ф-9) + программы: Ф-10, Ф-11 и правила прогрессии
|
**v1.0 = полный MVP-цикл ТЗ (Ф-1–Ф-9) + программы: Ф-10, Ф-11 и правила
|
||||||
(основа Ф-12) — шаг 1 порядка внедрения LLM-планирования, без LLM;
|
прогрессии/координации (основа Ф-12) — шаг 1 порядка внедрения
|
||||||
LLM-контур Ф-12 — v2**.
|
LLM-планирования, без LLM; Ф-13 в MVP-составе документа метрик
|
||||||
|
(дневник-минимум, допуск по АД/пульсу, правила 1–6); LLM-контур
|
||||||
|
Ф-12 — v2**.
|
||||||
Разработка — в порядке перечня MVP ТЗ: часы → связь с телефоном → экран
|
Разработка — в порядке перечня MVP ТЗ: часы → связь с телефоном → экран
|
||||||
тренировки → голосовой ввод → локальная БД → сервер → забор .fit →
|
тренировки → голосовой ввод → локальная БД → сервер → забор .fit →
|
||||||
синхронизация → история и веб.
|
синхронизация → история и веб.
|
||||||
|
|
@ -331,19 +362,22 @@ LLM-контур Ф-12 — v2**.
|
||||||
|
|
||||||
### 2.3. Объём последующих версий
|
### 2.3. Объём последующих версий
|
||||||
|
|
||||||
- **v2** (состав по решениям опросников 4.5, 4.6): LLM-планирование —
|
- **v2** (состав по решениям опросников 4.5, 4.6; изменение 1.3):
|
||||||
еженедельные предложения с валидатором и дифф-подтверждением, журнал
|
LLM-планирование — еженедельные предложения с валидатором
|
||||||
`llm_calls` (шаг 2 порядка внедрения; опросник 4.6); wake-word
|
и дифф-подтверждением, журнал `llm_calls` (шаг 2 порядка внедрения;
|
||||||
«Феникс, записывай» (опросник 4.5); iOS-версия телефонного приложения
|
опросник 4.6); полная утренняя телеметрия и правила координации 7–10
|
||||||
(опросник 4.2); экспорт тренировок из приложения в FIT; доставка
|
(Ф-13); wake-word «Феникс, записывай» (опросник 4.5); iOS-версия
|
||||||
программ на часы (FIT workout через Garmin Connect — документ
|
телефонного приложения (опросник 4.2); экспорт тренировок из
|
||||||
|
приложения в FIT; доставка программ на часы (FIT workout — документ
|
||||||
форматов, п. 3/5.3).
|
форматов, п. 3/5.3).
|
||||||
- **v2.x:** мезоцикловое планирование LLM, схема «генератор+ревьюер»,
|
- **v2.x:** мезоцикловое планирование LLM, схема «генератор+ревьюер»,
|
||||||
опрос RPE после тренировки, бюджет доверия (шаг 3); аналитика
|
опрос RPE после тренировки, бюджет доверия (шаг 3); аналитика
|
||||||
прогресса (тоннаж, динамика по упражнениям, пульсовые тренды),
|
прогресса (тоннаж, динамика по упражнениям, пульсовые тренды),
|
||||||
шифрование архива, напоминания о тренировках.
|
шифрование архива, напоминания о тренировках.
|
||||||
- **v3+:** виды спорта с треками — бег, вело (GPX, ввод темпа/дистанции;
|
- **v3+:** контрольные тесты (обхваты, пробы Руфье/Штанге—Генчи,
|
||||||
опросник 4.7); полная автоматизация периодизации без подтверждений.
|
тест ходьбы) с напоминаниями, экспорт АД-журнала; трековые виды
|
||||||
|
спорта — бег, вело (GPX, опросник 4.7); полная автоматизация
|
||||||
|
периодизации без подтверждений.
|
||||||
|
|
||||||
Сроки последующих версий не фиксировались — привязываются к потребности.
|
Сроки последующих версий не фиксировались — привязываются к потребности.
|
||||||
|
|
||||||
|
|
@ -384,10 +418,13 @@ LLM-контур Ф-12 — v2**.
|
||||||
- **Пользователь-владелец (атлет, заказчик, владелец сервера).**
|
- **Пользователь-владелец (атлет, заказчик, владелец сервера).**
|
||||||
Ценность: ничего не теряется, тренировки идут по программе, прогресс
|
Ценность: ничего не теряется, тренировки идут по программе, прогресс
|
||||||
управляем; вероятное отношение — соавтор требований. Важные функции:
|
управляем; вероятное отношение — соавтор требований. Важные функции:
|
||||||
все — Ф-1–Ф-12.
|
все — Ф-1–Ф-13.
|
||||||
- **Другие атлеты (изменение 1.1)** — тренируются по своим программам
|
- **Другие атлеты (изменение 1.1)** — тренируются по своим программам
|
||||||
со своих телефона и часов; данные изолированы в рамках сервера.
|
со своих телефона и часов; данные изолированы в рамках сервера.
|
||||||
Важные функции: Ф-1–Ф-11 (кроме владения сервером).
|
Важные функции: Ф-1–Ф-13 (кроме владения сервером).
|
||||||
|
- **Врач/кардиолог (внешний консультант, изменение 1.3).** Получает
|
||||||
|
АД-журнал и сведения о нагрузках (выгрузка CSV из веб-консоли);
|
||||||
|
в системе ничего не делает.
|
||||||
- **Garmin (внешняя платформа, не пользователь).** Источник SDK, .fit,
|
- **Garmin (внешняя платформа, не пользователь).** Источник SDK, .fit,
|
||||||
ограничений (БР-1, БР-3, БР-4); с системой ничего не делает.
|
ограничений (БР-1, БР-3, БР-4); с системой ничего не делает.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,101 @@
|
||||||
|
# Метрики для координации тренировок: рекомендации по книгам
|
||||||
|
|
||||||
|
> Дата: 2026-10-17. Источники: Жижин «Бодибилдинг: личный опыт врача» (гл. 2–3, 6), Аттия «Пережить/Outlive» (гл. 10–13), МакРоберт «Думай! 2», CDC/Tufts «Growing Stronger» (PAR-Q, self-тесты, 12-week workbook), статьи об ошибках новичков.
|
||||||
|
> Назначение: спецификация метрик для MetricsEngine приложения «Феникс 6X» и правил координации (когда и как менять план). Связано: `program-trenirovok.json` (v4), `Архитектура_LLM_планирования_тренировок.md` (разд. MetricsEngine).
|
||||||
|
|
||||||
|
## 1. Три контура измерений
|
||||||
|
|
||||||
|
Книги сходятся в одном: координировать тренировку нужно **ежедневной дешёвой телеметрией** (пульс, АД, вес, самочувствие), **тренировочным дневником** (веса×повторы, RPE) и **редкими контрольными тестами** (раз в месяц-квартал). Никаких непрерывных дорогих измерений лактата/VO2max любителю не требуется (Аттия использует лактат-метр сам, но для обычных людей предлагает «тест на разговор»).
|
||||||
|
|
||||||
|
## 2. Метрики
|
||||||
|
|
||||||
|
### 2.1. Ежедневные (дом, 2–3 минуты)
|
||||||
|
|
||||||
|
| Метрика | Цель/норма | Источник | Зачем координатору |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Утренний пульс покоя (лёжа, до подъёма) | стабилен ±5 уд/мин; тренд вниз — хорошая адаптация | Жижин гл. 3 | +8–10 уд/мин 2 дня подряд = перетренированность/болезнь → лёгкая неделя или отмена |
|
||||||
|
| АД утром (сист./диаст.) | <140/90; отменa тренировки при >150/90 | Жижин гл. 3 | главный маркер безопасности при гипертонии; тренд −5–10 мм — эффект программы |
|
||||||
|
| Вес тела (утром, натощак) | −0,3–0,5 кг/нед | Жижин гл. 7 | быстрее − снижать дефицит, иначе потеря мышц и тестостерона |
|
||||||
|
| Талия (раз в неделю) | тренд вниз | Жижин гл. 1 | при стоящем весе — субъективный маркер рекомпозиции |
|
||||||
|
| Сон (часы, качество) | ≥8 ч | Аттия гл. 13; МакРоберт | <7 ч накануне тяжёлой → снизить интенсивность дня |
|
||||||
|
| Самочувствие/готовность (1–5) | — | Жижин гл. 2 | субъективный фидбек в сводку LLM |
|
||||||
|
|
||||||
|
### 2.2. Перед каждой тренировкой (зал)
|
||||||
|
|
||||||
|
| Метрика | Порог | Источник |
|
||||||
|
|---|---|---|
|
||||||
|
| Пульс сидя после 3–5 мин отдыха | >90 уд/мин → тренировка переносится/отменяется | Жижин гл. 3, 6 |
|
||||||
|
| АД перед занятием | >150/90 → отмена; 140–150/90–95 → только кардио/дыхание | Жижин гл. 3 |
|
||||||
|
|
||||||
|
### 2.3. Во время тренировки (с каждого подхода/упражнения)
|
||||||
|
|
||||||
|
| Метрика | Норма/правило | Источник |
|
||||||
|
|---|---|---|
|
||||||
|
| Факт: вес × повторения × число подходов | записывается каждый сет | все книги; CDC workbook |
|
||||||
|
| RPE по сету (цель 6–8, стоп за 1–2 повтора до отказа) | RPE ≥9 — вес завышен | МакРоберт «Думай! 2» |
|
||||||
|
| Пульс между подходами | <90 уд/мин перед следующим подходом | Жижин гл. 6 |
|
||||||
|
| Пульс в силовой части | ≤120 уд/мин | план v4 (АД) |
|
||||||
|
| Пульс на кардио (зона 2) | 110–130 уд/мин И «тест на разговор»: говорить полными предложениями можно, болтать — нет | Аттия гл. 10 |
|
||||||
|
| Боль в колене (0–10, по упражнениям с ногами) | 0; ≥1 два занятия подряд → замена упражнения | Шварценеггер кн. 5 гл. 4; план v4 |
|
||||||
|
| Отдых между подходами (сек) | по плану 90–150 | план |
|
||||||
|
|
||||||
|
### 2.4. После тренировки
|
||||||
|
|
||||||
|
| Метрика | Норма | Источник |
|
||||||
|
|---|---|---|
|
||||||
|
| Время возврата пульса к исходному | 3–5 мин (после подхода — к <90); не восстанавливается — нагрузка велика | Жижин гл. 3 |
|
||||||
|
| Возврат АД к исходному | 5–10 мин | Жижин гл. 3 |
|
||||||
|
| Суставная боль на следующий день | нет; есть — снизить вес/амплитуду | «10 ошибок» №4 |
|
||||||
|
|
||||||
|
### 2.5. Еженедельные (считает MetricsEngine)
|
||||||
|
|
||||||
|
- **Adherence** — % выполненных запланированных сессий (CDC: перерыв не повод бросать, «вернись и продолжай» — координатор снижает объём, а не отменяет план).
|
||||||
|
- **Тоннаж по мышечным группам** (Σ вес×повторы) — контроль баланса «толкай/тяни, верх/низ».
|
||||||
|
- **Динамика рабочих весов** — по правилу ворот прогрессии: вес +2,5–5% только если 2 тренировки подряд все подходы закрыты при RPE ≤7 (МакРоберт).
|
||||||
|
- **Суммарное кардио в зоне 2**, мин/нед — цель 60–90 мин (3×20–30); по Аттии это главный рычаг метаболического здоровья.
|
||||||
|
- **Изменение веса тела и талии за неделю** — проверка дефицита.
|
||||||
|
- **Число срабатываний красных флагов** (АД, пульс, колено) — сигнал пересмотреть план.
|
||||||
|
|
||||||
|
### 2.6. Ежемесячные / контрольные тесты
|
||||||
|
|
||||||
|
| Тест | Что меряет | Источник | Частота |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Обхваты (грудь, талия, бедро, рука, голень) + вес | состав тела | Жижин гл. 1–2 | 1 раз/мес |
|
||||||
|
| Проба Руфье или 20 приседаний за 30 сек | приспособляемость ССС к нагрузке | Жижин гл. 3 | 1 раз/мес |
|
||||||
|
| Ортостатическая проба | готовность/остаточное утомление | Жижин гл. 3 | 1 раз/мес или при сомнениях |
|
||||||
|
| Пробы Штанге/Генчи (задержка дыхания) | дыхательная система | Жижин гл. 3 | 1 раз/мес |
|
||||||
|
| Тест ходьбы/Купера (12 мин, низкоударный вариант — быстрая ходьба) | аэробная форма | Жижин гл. 3; Аттия | раз в 2–3 мес |
|
||||||
|
| Таблица Анфимова / теппинг-тест / Шульте—Платонов | умственная работоспособность, качество дозирования нагрузки (ухудшение >30% = нагрузка велика) | Жижин гл. 5 | опционально |
|
||||||
|
| Силовые вехи (отжимания от опоры ×N, жим ногами ×15 с весом, планка сек) | функциональный прогресс без предельных весов | CDC self-тест; Жижин гл. 5 тест | 1 раз/мес |
|
||||||
|
| VO2max (оценочно, по тесту ходьбы; не лаборатория) | аэробная база | Аттия гл. 10 | раз в квартал |
|
||||||
|
|
||||||
|
### 2.7. Медицинские (вне приложения, в сводку LLM вручную/из профиля)
|
||||||
|
|
||||||
|
- Биомаркеры крови раз в 3–6 мес (Аттия): глюкоза/HbA1c, липидный профиль (апоВ), тестостерон общий, ТТГ, креатинин, СРБ — именно они показывают, работает ли связка «дефицит + силовые» для веса и гормонов.
|
||||||
|
- АД-журнал у кардиолога — приложение отдаёт выгрузку CSV.
|
||||||
|
|
||||||
|
## 3. Правила координации (детерминированные, без LLM)
|
||||||
|
|
||||||
|
MetricsEngine вычисляет → правило меняет план:
|
||||||
|
|
||||||
|
1. `утренний пульс ≥ обычный +8` (2 дня) **или** `самочувствие ≤2` → следующая тренировка лёгкая (60–70% весов, 2 сета); 3+ дня — отмена + совет к врачу.
|
||||||
|
2. `АД до тренировки >150/90` → сессия отменяется (только прогулка).
|
||||||
|
3. `RPE ≥9 в 2+ сетах` → вес −5% на следующей тренировке этого упражнения.
|
||||||
|
4. `2 тренировки подряд все подходы закрыты при RPE ≤7` → +2,5–5% веса (ноги +2,5 кг, руки +0,5–1 кг).
|
||||||
|
5. `повторения достигли верхней границы диапазона (15–20)` → вес ↑, повторения к 12.
|
||||||
|
6. `боль в колене ≥1` два занятия подряд → упражнение из пары-замены (жим ногами ↔ разгибания малой амплитуды ↔ велотренажёр).
|
||||||
|
7. `адherence <50% за 2 недели` → план сокращается (2 дня/нед, 5 упражнений) вместо отмены программы (CDC).
|
||||||
|
8. `вес падает >0,9 кг/нед` → дефицит +150–200 ккал (Жижин: больше 900 г/нед нежелательно).
|
||||||
|
9. `вес стоит 3 недели, талия стоит` → дефицит −100–150 ккал или +10 мин кардио.
|
||||||
|
10. `6–8 недель подряд без лёгкой недели` → принудительный делоад (веса −30%).
|
||||||
|
11. `месяц 3+, АД стабильно, допуск кардиолога` → открыть опцию VO2max-интервалов 1×нед (Аттия: 4×4 мин).
|
||||||
|
|
||||||
|
## 4. Что хранить для LLM-планировщика (сводка, не сырьё)
|
||||||
|
|
||||||
|
По архитектуре LLM получает сжатую сводку: adherence, тоннаж по группам за неделю/мезоцикл, динамика рабочих весов и RPE, число красных флагов, тренды веса/талии/АД/пульса покоя, субъективный фидбек, результаты контрольных тестов месяца. Сырая история подходов LLM не отдаётся.
|
||||||
|
|
||||||
|
## 5. Приоритет внедрения в приложении
|
||||||
|
|
||||||
|
1. **MVP**: вес×повторы×RPE, пульс до/после, АД до, adherence, правила 1–6.
|
||||||
|
2. **v2**: утренний пульс/вес/талия/сон из профиля, правила 7–10, еженедельная сводка.
|
||||||
|
3. **v3**: контрольные тесты с напоминаниями, тренды, экспорт АД-журнала в CSV, интеграция пульса с Garmin (уже в ТЗ).
|
||||||
Loading…
Reference in New Issue