Metadata-Version: 2.4
Name: bongram
Version: 0.1.0
Summary: Фреймворк для мгновенного создания Telegram-ботов на готовых шаблонах
Home-page: https://github.com/THWEDOKA/bongram
Author: Triazov Kirill
Author-email: contact@triazov.ru
Project-URL: Homepage, https://triazov.ru
Project-URL: Bug Reports, https://github.com/THWEDOKA/bongram/issues
Project-URL: Source, https://github.com/THWEDOKA/bongram
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiogram>=3.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Bongram

**Bongram** — фреймворк для мгновенного создания Telegram-ботов на готовых шаблонах. Экономьте часы разработки: магазин, поддержка, рассылка или опрос — соберите бота из модулей за минуты. Поддержка платежей, админки, аналитики и кастомизации из коробки. Python-стиль, документация и примеры. Создавайте, а не кодируйте повторно!

## 🚀 Быстрый старт

### Установка

```bash
pip install bongram
```

### Запуск бота за 5 минут

```bash
bongram support YOUR_BOT_TOKEN
bongram faq YOUR_BOT_TOKEN
bongram giveaway YOUR_BOT_TOKEN
```

Где `YOUR_BOT_TOKEN` — токен вашего бота от [@BotFather](https://t.me/BotFather).

## 📦 Доступные шаблоны

### Support (Поддержка)

Бот для обработки вопросов пользователей с админ-панелью.

**Возможности:**
- Пользователи могут задавать вопросы через кнопку
- Администраторы получают уведомления о новых вопросах
- Ответы администраторов автоматически отправляются пользователям
- Управление администраторами через команды

**Команды для пользователей:**
- `/start` — начать работу с ботом

**Команды для администраторов:**
- `/admin` — открыть админ-панель
- `/addadmin <user_id>` — добавить администратора

### FAQ (База знаний)

Бот с часто задаваемыми вопросами и поиском по базе знаний.

**Возможности:**
- Категории вопросов и ответов
- Поиск по базе знаний
- Админ-панель для управления вопросами
- Добавление, редактирование и удаление вопросов
- Статистика по категориям

**Команды для пользователей:**
- `/start` — открыть меню категорий
- `/search <запрос>` — поиск по базе знаний

**Команды для администраторов:**
- `/addadmin <user_id>` — добавить администратора
- Админ-панель доступна через меню

### Giveaway (Розыгрыши)

Бот для проведения розыгрышей и конкурсов.

**Возможности:**
- Создание розыгрышей с настраиваемым количеством победителей
- Регистрация участников
- Автоматическое определение победителей
- Таймер до окончания розыгрыша
- Статистика и управление розыгрышами

**Команды для пользователей:**
- `/start` — просмотр активных розыгрышей

**Команды для администраторов:**
- `/create` — создать новый розыгрыш
- `/addadmin <user_id>` — добавить администратора

**Настройка администраторов:**
После первого запуска используйте команду `/addadmin <ваш_user_id>` в боте, чтобы добавить себя в администраторы. Ваш user_id можно узнать у бота [@userinfobot](https://t.me/userinfobot).

## 📝 Примеры использования

### Запуск бота поддержки

```bash
bongram support 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
```

### Запуск FAQ бота

```bash
bongram faq 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
```

### Запуск бота розыгрышей

```bash
bongram giveaway 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
```

## 🛠 Разработка

### Установка для разработки

```bash
git clone https://github.com/THWEDOKA/bongram.git
cd bongram
pip install -e .
```

## 👨‍💻 Автор

**Triazov Kirill**

- 🌐 Сайт: [triazov.ru](https://triazov.ru)
- 💻 GitHub: [@THWEDOKA](https://github.com/THWEDOKA)

## 📄 Лицензия

MIT License

## 🤝 Вклад в проект

Мы приветствуем вклад в развитие Bongram! Создавайте issues и pull requests.

## 📞 Поддержка

Если у вас возникли вопросы или проблемы:
- Создайте [issue в репозитории](https://github.com/THWEDOKA/bongram/issues)
- Напишите на [triazov.ru](https://triazov.ru)
