Birthday Bot (bdbot)

Telegram-бот для отслеживания дней рождения и отправки тематических поздравлений в чатах.

Возможности

• 📅 Отслеживание дней рождения пользователей
• 🎉 Автоматическая отправка тематических поздравлений
• 📊 Статистика по чатам
• 🔔 Уведомления о предстоящих днях рождения
• 🎨 12 тем для персонализации поздравлений

Требования

• Python 3.12+
• PostgreSQL 14+
• Docker и Docker Compose (опционально)

Установка

Локальная установка

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

git clone <repository-url>
cd bdbot

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

pip install uv
uv pip install -e .

3. Создайте файл .env на основе .env.example:

cp .env.example .env

4. Заполните .env файл:

BOT_TOKEN=your_bot_token_here
DATABASE_URL=postgresql://user:password@localhost:5432/bdbot
NOTIFICATION_TIME=09:00
TIMEZONE=Europe/Moscow

5. Создайте базу данных PostgreSQL и убедитесь, что она доступна.

6. Запустите бота:

python main.py

Docker Compose

1. Создайте файл .env (см. выше).

2. Запустите с помощью Docker Compose:

docker-compose up -d

Использование

Для администраторов чата

1. Добавьте бота в чат
2. Выдайте боту права администратора
3. Бот автоматически покажет статистику и предложит участникам поделиться днем рождения

Для пользователей

1. Напишите боту в личку /start
2. Отправьте свой день рождения в формате ДД.ММ или ДД.ММ.ГГГГ (например: 15.03 или 15.03.1990)
3. Выберите тему предпочтений из предложенных вариантов
4. Готово! Бот будет поздравлять вас во всех чатах, где вы состоите

Команды в чатах

• /stats - Показать статистику: сколько человек поделились днем рождения
• /week - Показать дни рождения на ближайшие 7 дней
• /month - Показать дни рождения на ближайшие 30 дней
• /help - Показать справку по командам

Обновление данных

Используйте команду /update в личке с ботом, чтобы обновить свой день рождения или тему предпочтений.

Темы предпочтений

1. Автомобили
2. Спорт
3. Танцы
4. Музыка
5. Аниме
6. Игры
7. Книги
8. Кино
9. Путешествия
10. Еда
11. Технологии
12. Искусство

Конфигурация

Все настройки находятся в файле .env:

• BOT_TOKEN - токен Telegram бота (получить у @BotFather)
• DATABASE_URL - строка подключения к PostgreSQL
• NOTIFICATION_TIME - время отправки поздравлений (формат: HH:MM, по умолчанию 09:00)
• TIMEZONE - часовой пояс (например: Europe/Moscow, UTC)

Структура проекта

bdbot/
├── main.py                 # Точка входа
├── bot.py                  # Основной класс бота
├── config.py               # Конфигурация
├── database.py             # Модели базы данных
├── messages.py             # Тематические поздравления
├── handlers/               # Обработчики событий
│   ├── group_handlers.py   # Обработка событий в группах
│   ├── private_handlers.py # Обработка команд в личке
│   ├── command_handlers.py # Обработка команд в группах
│   └── scheduler.py        # Планировщик поздравлений
├── Dockerfile              # Docker образ
├── docker-compose.yml      # Docker Compose конфигурация
└── .env.example            # Пример конфигурации

Разработка

Проект использует:

• Python 3.12+
• pyTelegramBotAPI для работы с Telegram API
• SQLAlchemy для работы с базой данных
• APScheduler для планирования задач
• PostgreSQL как основную БД

Лицензия

from olly & cursor with <3