Моя стая

Бот «Моя стая»

Напоминания о прививках, обработке от клещей, таблетках и визитах к врачу — в Telegram. Диалог без меню и кнопок: бот спрашивает, вы отвечаете. Питомцы и напоминания хранятся в FamilyOS API.

Статус: MVP собран, в Telegram не запущен — нужен токен BotFather

Команды

  • /startначать, короткая инструкция
  • /addpetдобавить питомца: имя и вид
  • /petsмои питомцы
  • /remindнапоминание: питомец, текст, дата и время
  • /listближайшие напоминания
  • /cancelотменить текущий шаг

Как это работает

  1. Добавляете питомца командой /addpet — бот запоминает имя и вид.
  2. Ставите напоминание /remind в формате ГГГГ-ММ-ДД ЧЧ:ММ, часовой пояс — Москва.
  3. Крон раз в 5 минут проверяет срок и присылает сообщение, после отправки помечает его отправленным.

Состояние диалога хранится в памяти процесса: после перезапуска бот попросит команду заново. Один процесс опроса, без вебхуков.

Что нужно для запуска

Код бота лежит в репозитории в каталоге bot/: длинный опрос Telegram, диалоги и хранение в FamilyOS API. Секретов в репозитории нет — токен и ключ API передаются только через переменные окружения:

TELEGRAM_BOT_TOKEN=…
FAMILYOS_API_URL=https://familyos.beliberde.net/api/v1
FAMILYOS_API_KEY=…

После выдачи токена бот запускается как отдельный процесс, а check_due.py ставится в крон раз в пять минут. Пока токена нет, кнопка «открыть в Telegram» не показывается — ссылка на неработающего бота хуже, чем её отсутствие.

Пока бот не запущен

Напоминания можно держать вручную: карточка питомца и заметки — в data/pets, точки для прогулок и врачей — на карте. Если потерялся питомец — доска потеряшек.