Кейс / Product / Telegram Mini App / MAX Mini App / Backend / Automation
Собственный продукт · В активной разработке
FitAdventure
От фитнес-бота до полноценного кроссплатформенного продукта
FitAdventure начинался как инструмент для контроля питания, но постепенно вырос в полноценную кроссплатформенную систему для управления питанием, здоровьем, привычками, обучением, личными финансами и прогрессом пользователя.
Основной интерфейс работает как Mini App внутри Telegram и MAX, а боты отвечают за вход, быстрые действия и уведомления.
Объединить питание, здоровье и личное развитие в одном продукте, который работает внутри двух мессенджеров и развивается без дублирования предметной логики.
Подход
Как устроено решение
Общая сервисная архитектура, адаптивный Mini App, versioned API и отдельные адаптеры Telegram и MAX. Изменения проходят автоматические тесты и CI/CD.
01 / Продукт
13 продуктовых направлений в одной системе
Основная работа пользователя проходит в адаптивном Mini App. Боты отвечают за вход, быстрые действия, уведомления и поддержку.
Разные значения для тренировочных дней и дней отдыха, проверка опасных параметров и валидация пользовательских данных.
Ориентиры питания для пользователя. Система не позиционируется как медицинский инструмент.
02
03 / Система питания
От продукта до персонального рациона
Дневник питания, приёмы пищи, изменение граммовки и удаление записей. Каталог объединён с рецептами и персональными рационами.
Mini App
Питание в одной системе
Дневник питания632 продукта564 рецепта
FitAdventureMini App
Дневник питания
ДневникКаталогРецепты
ПитаниеИтог дня
Завтрак＋
Обед＋
Ужин＋
ГлавнаяМоя системаПрофиль
Продукта
632
Рецепта
564
Базовых вариантов рационов
6
Пользовательские продукты, избранное, домашние блюда, поиск и фильтры.
Ссылки на источники, редакционная проверка рецептов, изменение порций, замена продуктов и рецептов.
03
04 / Ежедневный прогресс
Понятная картина каждого дня
Mini App
Каждый день — прогресс
Вода и шагиВес и замерыАктивность
FitAdventureMini App
Моя система
Личный прогрессКаждый день — шаг
Привычки
Задачи
ПитаниеАкадемияПривычкиФинансы
ГлавнаяМоя системаПрофиль
Вода и шаги
Индивидуальная цель воды, быстрый ввод и прогресс. Текущий результат шагов, цель, streak и рекорд.
Вес и замеры
История и динамика веса, замеры тела, фотографии прогресса и сравнение до/после.
Активность
Тренировки, дополнительные активности, ориентировочный расход энергии и итог дня.
Расход от активности не используется для искусственного автоматического увеличения нормы питания.
04
05 / Моя система
Не только фитнес
Отдельный продуктовый слой для управления привычками, задачами, целями, обучением и финансами.
Mini App
Личные процессы в одном месте
Привычки и задачиЦели и финансыОбучение и самочувствие
FitAdventureMini App
Моя система
Личный прогрессКаждый день — шаг
Привычки
Задачи
ПитаниеАкадемияПривычкиФинансы
ГлавнаяМоя системаПрофиль
Привычки
Шаблоны, количественный прогресс, текущие и лучшие серии.
Задачи и цели
Ежедневные задачи, приоритеты и перенос. Сроки и прогресс целей.
Самочувствие
Настроение, энергия, сон и заметка дня.
Обучение
Чтение, английский и deep work.
Финансы
Доходы, расходы, категории, бюджет, цель накопления и план / факт.
Аналитика и награды
Недельная статистика, streaks, XP, coins, журнал наград, дневные лимиты и защита от повторного начисления.
Похудение, набор массы, дисциплина, самочувствие, работа, обучение и финансы.
Экспорт и полное удаление данных раздела.
05
06 / Академия и игры
Обучение связано с действием
Встроенная образовательная система и геймификация помогают объединить контент, привычки и личный прогресс.
Mini App
Знание → действие
26 направлений293 материала6 мини-игр
FitAdventureMini App
Академия
Поиск материалов ⌕
Питание и привычки
26 направлений293 материала
Избранное☆
Прогресс чтения↗
ГлавнаяМоя системаПрофиль
Тематических направлений
26
Материала
293
Мини-игр
6
Академия
Глобальный поиск, избранное, недавно просмотренные, персональные рекомендации и прогресс чтения. Связь материалов с игрой, собственные иллюстрации и карточки категорий.
HMAC verification Telegram init data, signed MAX parameters и ownership validation по user_id. MAX IDs изолированы от Telegram IDs.
Защита операций
Проверка размера HTTP requests, safe file path handling, versioned documents, защита от перезаписи более новых данных, mutation guards и request timeouts.
Обучение в интерфейсе
Первый запуск VYRON, затем FITRON. Интерактивный tour с подсветкой реальных UI elements, contextual hints для всех 13 разделов и повторным запуском.
Состояния интерфейса
Loading, empty, error, offline и retry. Учтены мобильные экраны, Telegram WebView и MAX WebView.
Telegram и MAX аккаунты пока не объединяются автоматически. Безопасная account linking система остаётся в roadmap.
09
10 / Архитектура
Общая архитектура для развития продукта
Telegram Bot, MAX Adapter и Mini App работают с одним сервисным слоем и versioned HTTP API /api/v1.
Telegram Bot
MAX Adapter
Mini App
↓
Shared ServicesОбщий сервисный слой
↓
Versioned HTTP API /api/v1/api/v1
↓
Business LogicПредметная логика
↓
SQLite-first StorageОсновной источник данных
↓
Backup / Migration / VersioningНадёжность и восстановление
Backend и API
Python 3.12, python-telegram-bot, custom webhook/API adapter для MAX. /api/v1, около 100 маршрутов.
Хранение
SQLite — основной источник данных. JSON — compatibility, export и restore. Document versioning, mutation log, ownership, limited server concurrency и migrations.
Frontend
Vanilla JavaScript, HTML и CSS.
Frontend сознательно построен без тяжёлого frontend framework: меньше bundle и runtime complexity, быстрый Mini App и контроль поведения WebView. Это архитектурное решение для данного продукта, а не универсальный рецепт.
10
11 / Автоматические тесты
Тестирование — часть архитектуры
Тестирование является частью архитектуры продукта, а не финальной проверкой перед релизом.
523passed
Технический snapshot тестирования
API & Nutrition Engine
Storage & migrations
Telegram & MAX
Notifications & security
Mini App & deployment
2 skipped by design · 62 test files
Теста пройдено
523
Пропущено по замыслу
2
Файла тестов
62
API, Nutrition Engine, storage, migrations, Mini App, Telegram, MAX, notifications, content, security и deployment.
11
12 / CI/CD и развёртывание
Проверить. Развернуть. Восстановить при сбое.
Production pipeline включает автоматическое развёртывание, healthcheck и rollback к предыдущей версии.
Healthcheck passedНовая версия работает
Ветка восстановления при ошибке
Healthcheck failed→Rollback→Previous version→Database restore при необходимости
01Git Push→
02GitHub Actions→
03Tests→
04Linux VPS→
05Service Restart→
06Healthcheck→
07Success
Если healthcheck не прошёл
Healthcheck Failed → Rollback → Previous Version → Database Restore при необходимости.
Инфраструктура
GitHub Actions, Linux VPS, Nginx, HTTP/2, systemd, bot service и Mini App service.
Работа с данными строилась с учётом возможных ошибок релиза и необходимости восстановления предыдущего состояния.
Резервирование
Automatic backup, SQLite native Backup API и integrity_check.
Восстановление и миграции
Recovery, migration, document versions и change log.
13
14 / Project snapshot
Технический масштаб продукта
Технический срез структуры проекта. Объём кода включает инструменты и тесты.
Backend-модулей
57
Экранов Mini App
13
Строк Python, включая tools/tests
~40 000
Строк JavaScript
~7 200
Строк CSS
~8 500
Migration / import / audit tools
49
API-маршрутов
~100
Автоматических теста
523
14
15 / В разработке
Открытый roadmap
Собственный продукт развивается поэтапно. Эти направления пока не представлены как готовые функции.
В разработке
Premium и Trial
Premium доступен только для предварительного просмотра. Пробный период на 5 дней и демо-модель описаны, но серверное ограничение доступа пока отключено.
В разработке
Оплата
Telegram Stars и внешняя оплата пока не подключены.
В разработке
Персонаж и идеи питания
Раздел «Мой персонаж» находится в подготовке. Система развития персонажа ещё не реализована; идеи питания — в разработке.
В разработке
Аккаунты и AI Coach
Безопасное объединение аккаунтов Telegram и MAX пока не реализовано. Генеративный AI Coach находится в разработке.
В разработке
Цели и финансы
Этапы достижения целей и переводы между финансовыми счетами пока не реализованы.
В разработке
Операционные проверки
Часть проверок восстановления production и отправки уведомлений выполняется вручную.
15
Результат
Из фитнес-бота — в полноценный full-stack продукт.
FitAdventure вырос из фитнес-бота в полноценный full-stack продукт с собственной предметной логикой, двумя messenger-платформами, Mini App, versioned API, SQLite-first storage, системой уведомлений, образовательным контентом, играми и production pipeline.
Проект используется как долгосрочная продуктовая разработка: новые функции добавляются поверх общей архитектуры, а изменения проверяются автоматическими тестами и проходят через CI/CD.