Апгрейд — программа тренировок (PWA)
Личное веб-приложение с программой силовых тренировок v3: 2–3 тренировки в неделю, режимы на 60, 90 и 120 минут, три блока по 5 недель, журнал подходов и замеров, база из 1324 упражнений. Работает офлайн, ставится на телефон как приложение и синхронизирует данные через Neon (Postgres + Neon Auth + Neon Function).
Дни тренировок выбираешь сам, неделя программы закрывается по выполнению, циклом нагрузки можно управлять вручную. В журнале — графики прогресса, объёма и замеров. Данные выгружаются для анализа агентом, а его корректировки программы импортируются обратно с предпросмотром. Что дальше — в ROADMAP.md.
Установка на телефон
- iPhone: открой сайт в Safari → «Поделиться» → «На экран „Домой“».
- Android: Chrome предложит «Установить приложение» (или меню ⋮ → «Установить»).
Структура репозитория
docs/ готовое приложение — его раздаёт GitHub Pages
index.html оболочка
css/app.css стили (светлая и тёмная темы)
js/store.js хранение на устройстве (localStorage) + хуки для синхронизации
js/config.js адрес API (сгенерировано из src/app-config.json)
js/program.js программа + шаги из базы упражнений (сгенерировано)
js/sync.js вход по коду из письма и синхронизация с базой
js/charts.js графики (SVG без библиотек)
js/plan.js правки программы: замены, порядок, добавленные упражнения (без DOM)
js/app.js интерфейс
data/program.json программа в JSON — для будущего бэкенда
data/exercises-ru.json база упражнений (выжимка exercises-dataset)
sw.js service worker: офлайн и обновления
manifest.webmanifest манифест PWA
src/ исходники
data.js публичная программа: упражнения, блоки, тренировки, тексты, источники
ds-map.json связь упражнений программы с базой exercises-dataset
ds-names-ru.json русские названия всех 1324 упражнений базы (id → название; сборка проверяет полноту)
app-config.json адрес Neon Function
app.js, plan.js, store.js, sync.js, charts.js, style.css, index.tpl.html, sw.tpl.js, manifest.webmanifest, icons/
backend/ Neon Function (TypeScript) и neon.ts
build.py сборка src/ → docs/
ROADMAP.md план развития и форматы данных
private/ личная версия программы — в git не попадает (см. ниже)
Сборка
git clone --depth 1 https://github.com/hasaneyldrm/exercises-dataset vendor/exercises-dataset
python3 build.py # нужны Python 3 и Node.js
Каждая сборка получает новую версию: установленное приложение покажет «Доступна новая версия» и обновится одной кнопкой.
Данные и синхронизация
- На устройстве. Всё, что вводится, сначала пишется в
localStorage (префикс upg3:), поэтому приложение работает офлайн и без входа.
- Вход. «Ещё → Настройки → Аккаунт»: код на почту (Neon Auth, Managed Better Auth). Cookie сессии хранятся в
localStorage (префикс upg3~) и ходят к функции в заголовках — сторонние cookie не нужны, поэтому вход держится и в PWA на iPhone.
- Синхронизация. Изменения копятся в очереди и уходят в базу, когда есть сеть. Журнал синхронизируется по тренировкам, замеры — по датам, настройки, цели, цикл, корректировки и правки программы (
plan) — целиком. Конфликты решает время изменения записи.
- Доступ. API пускает только участников из таблицы
app.members; почты из MEMBER_EMAILS добавляются туда при первом входе.
- Правки программы. «План → Тренировки»: изменённая тренировка хранится полной копией (
plan.s), упражнения из базы — в plan.x; неизменённые тренировки берутся из src/data.js. Подробнее — в ROADMAP.md.
- Резервная копия: «Настройки → Экспорт JSON».
Бэкенд (Neon)
backend/src/index.ts — одна Neon Function:
| Путь | Что делает |
|---|
/auth/* | прокси к Neon Auth: cookie ↔ заголовки X-Auth-Cookies / X-Auth-Set-Cookies |
POST /sync | отправка изменений и получение новых (по курсору rev), JWT Neon Auth проверяется по JWKS |
GET /me | кто вошёл и есть ли доступ |
GET /health | проверка без обращения к базе |
Таблицы создаются функцией сама при первом запросе: app.kv (данные по пользователю и ключу) и app.members.
cd backend && npm install
neon link --project-id <id> # один раз
neon deploy --env deploy.env # в файле: ALLOWED_ORIGINS, MEMBER_EMAILS (не в git)
neon functions get api # invocation_url → src/app-config.json
Личные заметки
Публичная программа (src/data.js) не содержит медицинских подробностей. Личная версия лежит в private/data.private.js (в .gitignore). python3 build.py сравнивает их и пишет private/overlay.json — эти поля загружаются в базу как запись srv:overlay владельца и после входа накладываются на программу только на его устройствах.
Источники и лицензии
- Обоснование программы — «Ещё → Почему так» (43 исследования со ссылками).
- База упражнений: hasaneyldrm/exercises-dataset. Данные (названия, мышцы, оборудование, инструкции) — MIT, см.
THIRD_PARTY_NOTICES.md. Русские названия упражнений переведены для этого проекта (src/ds-names-ru.json).
- Анимации упражнений — © Gym visual (https://gymvisual.com/). В репозиторий они не включены; приложение подгружает их по ссылке из исходного репозитория, только если пользователь сам включит это в настройках.
