🤖 Yonote Telegram Bot

Telegram-бот для управления заданиями и расписанием через Yonote API.

✨ Возможности

📋 Задания

• Просмотр всех заданий из базы данных
• Фильтры: сегодня / неделя / высокий приоритет / выполненные
• Добавление задания с названием, описанием, дедлайном, приоритетом, исполнителем
• Быстрое добавление — просто напишите текст боту
• Отметить выполненным / удалить / редактировать
• Комментарии к заданиям
• Прямые ссылки на задания в Yonote

📅 Расписание

• Просмотр расписания (поиск по документам)
• События на сегодня
• Добавление событий с датой, временем и заметками

🔍 Поиск

• Полнотекстовый поиск по всем документам Yonote

📊 Статистика

• Общее кол-во заданий / выполнено / в работе / просрочено
• Прогресс-бар

⚙️ Прочее

• Последние документы (/recent)
• Проверка соединения с API
• Быстрый ввод: написать любой текст → бот предложит создать задание или найти

---

🚀 Установка

1. Клонируйте проект

git clone <repo>
cd yonote_bot

2. Установите зависимости

pip install -r requirements.txt

3. Настройте .env

cp .env.example .env

Откройте .env и заполните:

Параметр	Где взять
TELEGRAM_TOKEN	@BotFather в Telegram
YONOTE_API_KEY	Yonote → Настройки → API
DATABASE_ID	ID вашей базы данных (из URL)
COLLECTION_ID	ID коллекции (из URL)

4. Запустите бота

python bot.py

---

📱 Команды бота

Команда	Описание
/start	Главное меню
/tasks	Список заданий
/add	Добавить задание
/today	Задания на сегодня
/schedule	Расписание
/event	Добавить событие
/search	Поиск
/stats	Статистика
/recent	Последние документы
/settings	Настройки
/help	Помощь

Быстрый ввод

Напишите боту любой текст — он предложит создать задание или найти совпадения.

Примеры:

• Сделать отчёт → создаст задание
• Встреча до 25.12 → создаст задание с дедлайном 25 декабря
• Позвонить клиенту завтра → создаст задание с дедлайном на завтра

---

🔧 Как найти ID базы данных

1. Откройте вашу базу данных в Yonote
2. Посмотрите URL: https://app.yonote.ru/doc/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
3. Скопируйте UUID — это и есть DATABASE_ID

То же самое для COLLECTION_ID — откройте коллекцию и возьмите ID из URL.

---

🐳 Запуск через Docker (опционально)

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "bot.py"]

docker build -t yonote-bot .
docker run --env-file .env yonote-bot

---

📝 Структура файлов

yonote_bot/
├── bot.py          # Основной файл бота (хендлеры, FSM, клавиатуры)
├── yonote.py       # Клиент Yonote API
├── config.py       # Конфигурация из .env
├── requirements.txt
├── .env.example    # Шаблон настроек
└── README.md