AI-секретарь и трекер целей, привычек и задач — Telegram-бот, PWA-веб-приложение и MCP-сервер в одном монорепо. Alfy помогает ставить цели, разбивать их на ежедневные привычки, честно отвечать на вопросы о прогрессе и управлять всем этим хоть из Telegram, хоть из браузера, хоть прямо из Claude.
🌐 Прод: tracker.rocketup.tech
- 🤖 AI-native через MCP. Отдельный MCP-сервер даёт Claude Desktop / Claude Code полный набор инструментов для управления задачами, целями и привычками. Можно сказать ассистенту «создай цель на квартал и распиши привычки» — и он сделает это через типизированные tools, а не парсинг текста. Транспорты stdio и Streamable HTTP, авторизация по API-токенам из настроек профиля или бота.
- 🎯 Цели → привычки → честный self-report. Цель раскладывается на вопросы-привычки с расписанием (ежедневно / по дням недели / с интервалом). Семь типов вопросов: текст, оценка числом, оценка смайликами, да/нет, число, затраченное время, фото. Данные опроса — основа для аналитики и коучинга, а не «галочка выполнено».
- 📱 Три поверхности, один бэкенд. Telegram-бот (telegraf), Telegram WebApp и обычный SPA — всё работает поверх одного REST API. Веб собран как PWA (offline, web-push, установка на домашний экран).
- 🧱 Чистая архитектура. Бэкенд — Clean Architecture по модулям (порты в
domain/, адаптеры вinfrastructure/, оркестрация в сервисах). Фронтенд — Feature-Sliced Design. Границы слоёв реальны, а не декоративны. - 🌍 Корректные таймзоны и локали. Все операции с датами уважают IANA-таймзону пользователя; даты в БД хранятся в UTC и сдвигаются к wall-clock пользователя на границе домена. Календарь, локаль и первый день недели — из настроек пользователя.
- 🗓 Богатый UI задач. Inbox, проекты со списками и board-колонками, повторяющиеся задачи, календарь с drag-create по сетке часов, Pomodoro-таймер, два независимых drag-and-drop-движка (кастомный на PointerEvents + vuedraggable). Agile-проекты включают эпики, истории, спринты и релизы; историю можно перенести в спринт целиком с задачами через меню или drag-and-drop. Стрелки ↑/↓ прямо на доске меняют порядок эпиков и историй внутри эпика; порядок сохраняется после перезагрузки. На доске отображаются группы текущего спринта. Историю или целый эпик можно вернуть в бэклог через меню или MCP
remove_group_from_sprint: структура сохраняется, задачи других спринтов не меняются. Описание задачи поддерживает Markdown и кликабельные ссылки; исходный текст редактируется по кнопке «Редактировать» с явным сохранением или отменой. Задачи (/tasks/:taskId), истории и эпики (/tasks/project/:projectId/group/:groupId) открываются на отдельных страницах по постоянным ссылкам. Из карточки можно скопировать ссылку или открыть страницу в новой вкладке; после входа сохраняется исходный адрес. Быстрый просмотр с доски использует тот же редактор. Истории на доске сворачиваются отдельной стрелкой; состояние сохраняется в браузере, добавление задачи раскрывает историю. - Спринты и истории. Настраиваемые статусы историй, блокеры и зависимости, бэклог с планированием по бюджету времени, предложения состава через MCP и сохранённые итоги спринтов. Инструменты планирования.
- Карта спринта. Вкладка «Карта» показывает mind map: выбранный спринт в центре, эпики расходятся влево и вправо, истории и задачи продолжают ветки наружу. Уровни «Эпики / Истории / Задачи» управляют детализацией; новый спринт открывается компактным обзором эпиков. Ветки сворачиваются, поиск раскрывает скрытый путь, полотно поддерживает масштабирование и перемещение. Прогресс считает только задачи выбранного спринта; статус истории и метки релизов показаны отдельно. Из карты доступны быстрый просмотр, постоянные ссылки и создание дочерних элементов.
- Зависимости задач. В карточке задачи поле «Зависит от» задаёт предшественников, включая свои задачи из других спринтов и проектов. Карта показывает направленные пунктирные связи и количество незавершённых предшественников. Завершение предшественников снимает ожидание, статус зависимой задачи остаётся прежним. Как пользоваться.
- 🔔 Уведомления. Web-push (VAPID) с подписками на устройство.
| Приложение | Стек | Порт | Назначение |
|---|---|---|---|
alfy-bot/ |
NestJS, TypeORM, SQLite, telegraf | 3002 | REST API (/api, Swagger на /api/docs), Telegram-бот, web-push, auth (JWT + API-токены) |
alfy-bot-frontend/ |
Vue 3, Vite, TS, Tailwind v4, Pinia | 5173 | SPA / Telegram WebApp / PWA |
alfy-mcp/ |
Node 22+, @modelcontextprotocol/sdk |
3003 | MCP-сервер — тонкая обёртка над REST для Claude |
Архитектурный гайд по всему репозиторию — в CLAUDE.md.
Требования: Node 22+, npm. Каждое приложение запускается независимо.
# 1. Бэкенд (порт 3002)
cd alfy-bot
npm install
npm run start:dev # nest start --watch
# 2. Фронтенд (порт 5173)
cd ../alfy-bot-frontend
npm install
npm run dev # vite
# 3. MCP-сервер (опционально, порт 3003)
cd ../alfy-mcp
npm install
npm run dev:http # Streamable HTTP, endpoint /mcpВеб доступен на http://localhost:5173, API и Swagger — на http://localhost:3002/api/docs.
Чтобы запустить бэкенд без Telegram-бота (только веб):
ENABLE_TELEGRAM=false npm run start:dev
Подробные команды (тесты, lint, type-check) — в README каждого приложения и в CLAUDE.md.