ATLAS — backend-first Telegram-система для режима, тренировок, восстановления, привычек, питания и прогресса.
Проект задуман как мультиагентный Telegram-ассистент: пользователь общается с одним ботом, а backend маршрутизирует запросы к специализированным агентам ATLAS.
Фронтенд, лендинг и веб-кабинет не входят в основную дорожную карту этого репозитория и могут развиваться отдельно позже.
- Telegram-first backend-продукт
- Spring Boot приложение с хранением данных в PostgreSQL
- оркестрация агентов для повседневных сценариев пользователя
- безопасная обработка Telegram-команд
- будущая абстракция LLM-провайдера
| Агент | Ответственность |
|---|---|
| ATLAS Core | оркестрация и маршрутизация |
| ATLAS Coach | спорт, тренировки, нагрузка |
| ATLAS Planner | планирование дня и недели |
| ATLAS Recovery | сон, усталость, восстановление |
| ATLAS Habits | привычки, дисциплина, ритм |
| ATLAS Fuel | поддержка питания |
| ATLAS Report | недельная аналитика и прогресс |
/start
/day
/week
/workout
/checkin
/recovery
/habits
/food
/report
/emergency
- Java 21
- Spring Boot
- Maven
- PostgreSQL
- Flyway
- JUnit 5
- Telegram Bot API
Запуск тестов:
mvn testЛокальный запуск с выключенной Telegram-интеграцией:
ATLAS_TELEGRAM_ENABLED=false mvn spring-boot:runЗапуск через Docker Compose:
cp .env.example .env
docker compose up --buildЭндпоинт состояния:
http://localhost:8080/actuator/health
Эндпоинт Telegram webhook:
POST /telegram/webhook
Telegram-интеграция по умолчанию выключена для локальной разработки.
Переменные, необходимые для включённого Telegram-режима:
ATLAS_TELEGRAM_ENABLED=true
ATLAS_TELEGRAM_BOT_TOKEN=<token>
ATLAS_TELEGRAM_BOT_USERNAME=<username>Не добавляй реальные секреты в репозиторий.
Основная продуктовая дорожная карта:
v0.3.0 — реальный Telegram-адаптер
v0.3.1 — стабилизация Telegram-интеграции
v0.4.0 — хранение данных пользователей, сообщений и чек-инов
v0.5.0 — онбординг и диалоговые сценарии
v0.6.0 — LLM-абстракция
v0.6.1 — первая интеграция реального LLM-провайдера
Служебные релизы:
v0.3.2 — очистка backend-only репозитория и выравнивание документации
ATLAS не является врачом, диетологом или медицинским специалистом. Система не должна ставить диагнозы, назначать лечение, рекомендовать тренироваться через боль, продвигать экстремальные диеты или игнорировать серьёзные симптомы.
Лицензия будет определена позже.