Инструкция по BrainOS Bot

Пишите в свободной форме — бот поймёт намерение и направит в нужный модуль.

Бесплатные модули (Free)

На тарифе Free доступны 5 базовых модулей без ограничения по использованию. Лимит: 100 AI-запросов в месяц. Остаток смотрите в /settings.

✅ Task — Задачи

Что делает: Задачи с приоритетом, сроками и подзадачами.

Как вызвать: напишите задача, task или фразу вроде «купить молоко».

Действие	Примеры
Создать	`новая задача купить молоко`, `задача со сроком до завтра`
Статус	`задача готова`, `выполнено`, `отмени задачу`
Список	`покажи задачи`, `мои задачи`, `задачи на сегодня`

Приоритеты: высокий / средний / низкий. Статусы: сделать, в работе, готово, отменено.

📝 Note — Заметки

Что делает: Быстрые заметки с тегами.

Как вызвать: заметка, note или текст с тегом #слово.

Действие	Примеры
Сохранить	`заметка: идея для проекта`, `сохрани это #важное`
Теги	`#работа #срочно`, `#идеи` (теги через `#слово`)

Поиск по тегам и тексту — в разработке.

Wallet — Кошелёк (финансы)

Что делает: Учёт доходов и расходов, бюджеты, аналитика.

Как вызвать: wallet, кошелёк или фразы про деньги.

Действие	Примеры
Расход	`потратил 500 на еду`, `кофе 290`, `такси 450`
Доход	`+80000 зарплата`, `получил 5000`
Бюджет	`бюджет еда 15000`, `бюджет транспорт 5000`
Статистика	`покажи расходы`, `расходы за месяц`, `статистика`

Авто: еженедельный дайджест (воскр. 20:00), предупреждения о бюджете (ежедн. 18:00), прогноз на месяц (25-го в 10:00). Время — по вашему часовому поясу из настроек.

🏥 Health — Здоровье

Что делает: Записи о симптомах, лекарствах, анализах, визитах к врачу.

Как вызвать: health, здоровье, симптом, лекарство и т.п.

Действие	Примеры
Симптом	`симптом: головная боль`, `болит голова`
Лекарство	`лекарство аспирин`, `принял ибупрофен`
Анализ	`анализ крови`, `результаты анализов`
Врач	`был у врача`, `визит к терапевту`

Бот не даёт медицинских советов, только сохраняет записи.

👤 Contact — Контакты

Что делает: Простая книга контактов.

Как вызвать: contact, контакт или имя + телефон/email.

Действие	Примеры
Сохранить	`контакт Анна +79991234567`, `Иван anna@mail.ru`

Бонусный модуль (один на выбор)

При регистрации можно выбрать один дополнительный модуль из списка ниже. Выбор делается один раз при онбординге и в настройках не меняется.

⏰ Remind — Напоминания

Что делает: Напоминания разовые и повторяющиеся (раз, день, неделя, месяц, год). Время срабатывания — по вашему часовому поясу.

Команда/фраза: напомни, remind.

Действие	Примеры
Разовое	`напомни через 2 часа позвонить маме`
По времени	`напомни завтра в 10:00 встреча`
Повтор	`каждый понедельник в 9:00 зарядка`, `каждый день в 8:00 будильник`
Список	`мои напоминания`, `напоминания на сегодня`

📚 KB — База знаний

Что делает: Личная вики с семантическим поиском и ответами на вопросы по сохранённым материалам. Вики-ссылки [[Название страницы]] сохраняются для графа связей. Эмбеддинги — через OpenAI.

Команда/фраза: первая строка сообщения — заголовок страницы, дальше — текст.

Действие	Примеры
Создать страницу	Первая строка — заголовок, дальше текст. `OAuth 2.0` + текст про OAuth...
Поиск	`найди про Nginx`, `поиск OAuth`, `найди в базе docker`
Вопрос по базе	`что такое OAuth?`, `как настроить Nginx?`
Граф связей	`граф`, `связи`, `graph`

🔁 Habits — Привычки

Что делает: Трекер привычек со стриками и календарём.

Команда/фраза: привычка, habit.

Действие	Примеры
Создать	`привычка читать 20 минут`, `каждый день зарядка`
Отметить	`выполнил зарядка`, `сделал читать`, `done медитация`
Список	`список привычек`, `мои привычки`

📈 Investments — Инвестиции

Что делает: Портфель акций/крипты и курсы. Цены акций — Alpha Vantage, крипта — CoinGecko (без ключа).

Действие	Примеры
Купить	`купил AAPL 10 по 150`, `купил BTC 0.5 по 45000`
Портфель	`портфель`, `мои инвестиции`, `portfolio`
Цена	`цена TSLA`, `сколько стоит BTC`, `курс ETH`

📧 Email — Черновики писем

Что делает: Генерация черновиков писем с ИИ (тема, тон, шаблон). Тон: формально / дружелюбно / неформально. Шаблоны: увольнение, жалоба, приглашение, благодарность, извинение, follow-up, знакомство.

Действие	Примеры
Сгенерировать	`письмо босу про отпуск`, `email resignation letter`, `жалобное письмо в поддержку`

Также в числе бонусных вариантов при онбординге: Подписки (sub), Книги (book), Новости (news).

Модули Pro / Team (премиум)

На тарифах Pro и Team доступны все модули и безлимит AI. Оплата — через /premium (Telegram Stars).

😴 Sleep — Сон

Что делает: Учёт сна и качества (оценка 1–10).

Действие	Примеры
Записать	`спал с 23:00 до 7:00`, `сон 23:00–7:00 качество 8/10`

💧 Water — Вода

Что делает: Учёт выпитой воды и цель на день (по умолчанию 2000 мл). Показывает прогресс за день.

Действие	Примеры
Добавить	`выпил 250`, `250 мл`, `стакан воды`

🍽️ Food — Питание

Что делает: Учёт приёмов пищи и калорий. Тип приёма (завтрак/обед/ужин/перекус) по времени, калории — по числу в сообщении.

Действие	Примеры
Записать	`завтрак: овсянка`, `съел пиццу 800 калорий`, `обед борщ`

🏋️ Workout — Тренировки

Что делает: Лог тренировок (тип и упражнения в свободной форме).

Действие	Примеры
Записать	`тренировка: отжимания 30`, `спорт бег 5 км`, `зал сегодня`

📚 Vocab — Словарь

Что делает: Карточки слов для изучения языка. Язык берётся из настроек бота.

Действие	Примеры
Добавить	`слово apple — яблоко`, `vocab hello - привет`

📖 Book — Книги

Что делает: Список книг и прогресс чтения. Статусы: хочу прочитать, читаю, прочитал.

Действие	Примеры
В список	`книга Война и мир — Толстой`
Читаю	`читаю Мастер и Маргарита`
Прочитал	`прочитал 1984`, `finished book Name`

📦 Sub — Подписки

Что делает: Учёт подписок и ежемесячных трат. Период — месяц или год; бот считает эквивалент в месяц.

Действие	Примеры
Добавить	`подписка Netflix 990 в месяц`, `Spotify 199 год`

🎯 Savings — Накопления

Что делает: Цели накоплений (сумма цели, при желании дедлайн — в разработке).

Действие	Примеры
Цель	`накопление на машину 500000`, `цель отпуск 100000`

📉 Debt — Долги

Что делает: Учёт долгов (кому и сколько). Отметка «погашено» — в разработке.

Действие	Примеры
Добавить	`долг Игорю 5000`, `одолжил Маше 3000`
Список	покажет общую сумму долгов

📰 News — Статьи

Что делает: Сохранение статей и ссылок «прочитать потом». Отметка «прочитано» — в разработке.

Действие	Примеры
Сохранить	`новость https://example.com/article`, `сохрани статью про AI`

💡 Idea — Идеи

Что делает: Банк идей с тегами (#). Идеи можно помечать и архивировать (в разработке).

Действие	Примеры
Сохранить	`идея: создать бот для трекинга`, `идея #startup новый сервис`

💬 Quote — Цитаты

Что делает: Сохранение цитат с автором. Автор указывается после — или -.

Действие	Примеры
Сохранить	`Жизнь — то, что происходит... — Джон Леннон`, `цитата "текст" — Автор`

✈️ Trip — Поездки

Что делает: Планирование поездок (направление, даты). Детали и статус — в разработке.

Действие	Примеры
Добавить	`поездка в Париж`, `trip Москва 15 марта`

📍 Place — Места

Что делает: Список мест (кафе, достопримечательности). Адрес, категория, оценка — в разработке.

Действие	Примеры
Сохранить	`место Эрмитаж`, `place кофейня на углу`

🛒 Buy — Список покупок

Что делает: Список того, что нужно купить. Отметка «куплено» — в разработке.

Действие	Примеры
Добавить	`купить молоко`, `в список хлеб сыр`, `buy eggs`
Список	покажет активные пункты

📌 Read Later (@later)

Что делает: Закладки статей/видео с авто-метаданными (как Pocket). Отправьте ссылку — бот вытащит title/description. Можно теги: #tutorial.

Действие	Примеры
Сохранить	Отправьте ссылку в чат
Список	`покажи список`, `несмотренное`, `list`

📚 Courses — Курсы

Что делает: Прогресс по онлайн-курсам.

Действие	Примеры
Добавить	`курс React на Udemy`, `course English B2`
Прогресс	`урок 15`, `progress 20`, `lesson 5`
Список	`курсы`, `list courses`

🐾 Pets — Питомцы

Что делает: Питомцы, прививки, визиты к вету. Авто: напоминания о прививках (ежедневно в 9:00 по вашему часовому поясу).

Действие	Примеры
Добавить	`питомец Барсик кошка`, `pet Rex dog`
Прививка	`прививка бешенство`, `vaccination DHPP`
Список	`питомцы`, `list pets`

📂 Projects — Проекты

Что делает: Проекты и этапы (milestones).

Действие	Примеры
Создать	`проект Новый сайт`, `project Mobile app`
Этап	`этап Дизайн`, `milestone Beta release`
Список	`проекты`, `list projects`

🚗 Car — Машина

Что делает: Авто, сервис, заправки.

Действие	Примеры
Добавить	`машина Toyota Camry 2020`, `car BMW X5 2019`
Заправка	`заправка 40 л 2500 руб`, `fuel 50L 3000`
Сервис	`сервис замена масла`, `масло замена`
Список	`машины`, `list cars`

Интеграции и сервисы

BrainOS подключается к внешним сервисам и даёт доступ к ним из Telegram. Ниже — команды, уведомления и дополнительные возможности.

🔔 Уведомления (Notify)

Что делает: Умные уведомления с учётом вашего часового пояса (настраивается в /settings).

Дайджест — накопленные уведомления от модулей (задачи, кошелёк и т.д.) приходят одним сообщением в выбранное время (например 20:00 по вашему времени).
Режим «Не беспокоить» (DND) — в заданный интервал (например 22:00–08:00) обычные уведомления не отправляются, а накапливаются в дайджесте; срочные (URGENT) доставляются сразу.

Настройки дайджеста и DND задаются в боте (соответствующие пункты в настройках уведомлений).

Notion

Команда: /notion — подключить аккаунт (OAuth). После авторизации привяжите базы:

/notion_link tasks <id> — база для задач (id из URL базы в Notion)
/notion_link notes <id> — база для заметок

Синхронизация идёт по расписанию (ежедневно), задачи и заметки синкаются в обе стороны.

Gmail / Inbox

Команда: /inbox — письма из Gmail, триаж (срочно / важно / обычное / спам). Сначала нужно подключить Gmail (кнопка или ссылка в боте).

📅 Meeting — Встречи (Google Calendar)

Что делает: Напоминания о встречах. Бот за час до события присылает краткую повестку в Telegram. События подтягиваются из Google Calendar или создаются вручную.

Подключение календаря: откройте в браузере ссылку вида https://ваш-домен/auth/calendar?userId=... (userId выдаёт поддержка или можно посмотреть в БД/настройках) и авторизуйтесь в Google. После этого события синхронизируются автоматически.

🔬 Research — Исследование

Команда: /research. Разбивка запроса на подвопросы, поиск по разным источникам, итоговый отчёт. Доступно на премиум-тарифах.

🎤 Голосовые сообщения (Voice)

Отправьте голосовое или видео-ноту — бот распознаёт речь (Whisper) и обрабатывает текст как обычное сообщение (задачи, заметки, поиск и т.д.). Модуль voice работает поверх выбранного вами модуля.

📊 Дашборд и аналитика (Analytics)

Веб-страница с графиками и сводками: финансы, задачи, привычки, здоровье и др. Вход через Telegram Login. URL и настройку даёт администратор. Модуль analytics формирует обзор по вашим данным.

💳 Тарифы и оплата (Premium / Team)

Команда: /premium. Тарифы Free / Pro / Team, оплата через Telegram Stars, отмена подписки, переход Pro→Team, допокупка мест для Team. Модули premium и team управляют доступом и подписками.