Santa Gym Bot v0.4.0

v0.4.0 — это релиз со статистикой тренировок, переработанной навигацией WebApp и разделением окружений для локальной разработки, server runtime и dev-стенда на сервере.

Основное

• Добавлена отдельная страница статистики с агрегатами по тренировкам и недельной активностью.
• На дашборде появились KPI за месяц, включая количество тренировочных дней.
• В корневой навигации WebApp появился tab bar для быстрого перехода между главной страницей и статистикой.
• Отображение дат тренировок стало учитывать timezone пользователя.

Что нового для пользователей

• Новая страница Статистика показывает сводку по завершенным тренировкам, подходам и активности по неделям.
• На главном экране теперь видны ключевые показатели за текущий месяц без перехода в историю.
• История и заголовки тренировок показывают даты в часовом поясе пользователя, что убирает сдвиги на границе суток.
• Интерфейс лучше адаптирован под Telegram WebApp: общий app shell, корректная работа safe area и более аккуратные overlay-экраны.

Что нового для разработки и деплоя

• Локальная разработка вынесена в отдельный local-стенд с hot reload для backend и frontend.
• Server deployment разделен на независимые prod и dev stack с отдельными env-файлами, compose project name и routing prefixes.
• Добавлен изолированный server-side dev deployment для автодеплоя ветки develop.
• Улучшена конфигурация frontend API base URL для server runtime.
• Расширены CI/CD-пайплайны: проверки frontend, backend и compose-конфигурации, а также dev deploy workflow.

Дополнительно

• Добавлен one-off импорт бэкапов GymTracker в текущую БД SantaGymBot.
• В проект добавлены runbook-документы для local/server стендов и переноса исторических данных.
• Исправлено обновление статистики после завершения тренировки.

Обновление до v0.4.0

1. Обновите код и пересоберите соответствующий compose stack.
2. Сверьте env-файлы с новыми шаблонами .env.local.example, .env.server.example и .env.dev.example.
3. Для локальной разработки используйте make local-init, затем make local-up.
4. Для server runtime проверьте конфигурацию через make server-config или make dev-server-config.
5. После обновления backend примените миграции: alembic upgrade head.

Кому особенно полезен этот релиз

• Пользователям, которым нужна базовая аналитика по тренировкам прямо в Telegram WebApp.
• Разработчикам, которым важны предсказуемые локальные и серверные окружения без смешивания dev/prod.
• Тем, кто переносит исторические данные из GymTracker в SantaGymBot.

Santa Gym Bot v0.3.0

What's Changed in v0.3.0

Realese v0.3.0 by @SantaRiver in #3

• В v0.3.0 приложение заметно продвинулось в сторону полноценного workout-flow: теперь активная тренировка сохраняется локально между перезапусками, экран тренировки переведён на локальную session-модель с inline-редактированием подходов, а backend получил API для обновления сетов. Это делает процесс записи тренировки заметно устойчивее и удобнее в реальном использовании.

• Сильно улучшен и сам интерфейс. Появилась страница настроек с управлением таймером отдыха, обновлены экран тренировки, каталог упражнений, модальные окна и состояния ошибок, добавлены более корректные accessibility-паттерны, focus states, toast announcements и более понятные recovery states. Отдельно улучшена мобильная работа с CTA, manage-mode и восстановлением активной тренировки после гидрации стора.

• С точки зрения качества продукта в релиз вошёл reproducible UX/UI audit workflow: проект получил локальный skill, скрипт для автоматического снятия скриншотов и сохранения audit reports. Это упрощает повторные UX/UI-ревью и делает их воспроизводимыми.

• На уровне инфраструктуры релиз добавляет полноценный CI/CD baseline: новый CI workflow проверяет frontend, backend и Docker-сборки, а production deploy стал безопаснее за счёт запуска только после успешного CI, применения миграций, health checks и усиления docker-compose конфигурации.

Full Changelog: v0.2.1...v0.3.0

Santa Gym Bot v0.2.1

v0.2.1

В релизе v0.2.1 мы существенно улучшили сценарий активной тренировки и каталог упражнений.

Что нового

• Добавлено полноценное управление активной тренировкой:
  • удаление упражнений из текущей сессии
  • изменение порядка упражнений
  • отдельный management flow с более аккуратным UX для мобильного интерфейса
• Улучшен lifecycle пустой тренировки:
  • если пользователь завершает тренировку без упражнений, она автоматически удаляется и не сохраняется в истории
• Существенно расширен каталог упражнений:
  • создание собственных упражнений из интерфейса
  • поиск похожих упражнений для предотвращения дублей
  • поддержка system/private/public visibility
• На backend добавлена инфраструктура для более умного поиска упражнений:
  • name_normalized
  • canonical_id
  • PostgreSQL pg_trgm + GIN index для fuzzy search
• Для локальной разработки открыты порты backend и frontend в docker-compose

Основной результат релиза

v0.2.1 переводит приложение от базового трекинга тренировки к более полноценному workflow:
пользователь теперь может не только логировать подходы, но и нормально управлять составом тренировки прямо во время сессии, а каталог упражнений стал заметно гибче и ближе к production-уровню.

v0.1.0 — Initial MVP Release

🎉 v0.1.0 — Initial MVP Release

First public release of SantaGymBot — a Telegram WebApp for tracking workouts.

✨ Features

• Seamless auth via Telegram initData (HMAC-SHA256) + JWT
• REST API on FastAPI with Clean Architecture (Domain / Application / Infrastructure / Presentation)
• React 19 + Zustand SPA inside Telegram WebApp
• PostgreSQL with async SQLAlchemy 2.0 + Alembic migrations
• Full Docker Compose setup with Traefik (SSL, multi-bot ready)
• CI/CD via GitHub Actions (SCP deploy to VPS)

🔧 Stack

Python 3.12 · FastAPI · aiogram 3 · PostgreSQL 16 · Redis 7 · React 19 · Vite · TailwindCSS v4

📦 Quick Start

See README for local dev and production deployment instructions.

⚠️ Known Limitations

• Active workout session UI — in progress
• Progress charts — planned
• Offline sync — planned

Full Changelog: https://github.com/SantaRiver/SantaGymBot/commits/v0.1.0