|
|
||
|---|---|---|
| .gitignore | ||
| README.md | ||
| bot.py | ||
| database.py | ||
| example.env | ||
| phone_utils.py | ||
| qr_utils.py | ||
| requirements.txt | ||
| web_app.html | ||
README.md
🌑 МракоЗвон
МракоЗвон — Telegram бот для хранения номеров телефонов и бонусных карт (QR-кодов). Поддерживает белый список пользователей, веб-морду для управления и выдачу случайных номеров из самых старых/неиспользуемых.
📱 Возможности
- ✅ Хранение номеров телефонов (автоматическое приведение к формату
+7-xxx-xxx-xx-xx) - ✅ Хранение бонусных карт (QR-коды)
- ✅ Связывание номера с бонусной картой
- ✅ Выдача случайного номера из 10 самых старых (или 20% при большой базе)
- ✅ Белый список пользователей (только свои могут пользоваться)
- ✅ Веб-морда для просмотра и удаления номеров
- ✅ Поддержка QR-кодов (распознавание из фото)
- ✅ Автозапуск через systemd (Linux) или screen
🚀 Команды бота
| Команда | Описание |
|---|---|
/start |
Запустить бота, показать меню |
/get |
Получить случайный номер из базы (с картой, если есть) |
/stats |
Показать статистику базы |
/del <номер> |
Удалить номер из базы |
/adduser <id> [username] |
Добавить пользователя в белый список (админ) |
/removeuser <id> |
Удалить пользователя из белого списка (админ) |
/whitelist |
Показать белый список (админ) |
🃏 Как пользоваться бонусными картами
- Привязать карту к номеру — отправь в одном сообщении номер телефона и фото QR-кода
- Только номер — отправь номер текстом
- Только карта — отправь фото QR (без номера, карта не привяжется, нужен номер)
При запросе /get бот выдаёт номер и картинку бонусной карты (если она есть).
🌐 Веб-морда
Доступна по адресу: https://твой-домен/get_webapp
- Просмотр всех номеров
- Удаление номеров
- Просмотр бонусных карт (кнопка "🃏 Карта")
📦 Установка и запуск
1. Клонируем репозиторий
git clone https://github.com/ТВОЙ_НИК/MpakoPhoneBot.git
cd MpakoPhoneBot