50 lines
2.9 KiB
Markdown
50 lines
2.9 KiB
Markdown
# 🌑 МракоЗвон
|
||
|
||
**МракоЗвон** — Telegram бот для хранения номеров телефонов и бонусных карт (QR-кодов). Поддерживает белый список пользователей, веб-морду для управления и выдачу случайных номеров из самых старых/неиспользуемых.
|
||
|
||
## 📱 Возможности
|
||
|
||
- ✅ Хранение номеров телефонов (автоматическое приведение к формату `+7-xxx-xxx-xx-xx`)
|
||
- ✅ Хранение бонусных карт (QR-коды)
|
||
- ✅ Связывание номера с бонусной картой
|
||
- ✅ Выдача случайного номера из 10 самых старых (или 20% при большой базе)
|
||
- ✅ Белый список пользователей (только свои могут пользоваться)
|
||
- ✅ Веб-морда для просмотра и удаления номеров
|
||
- ✅ Поддержка QR-кодов (распознавание из фото)
|
||
- ✅ Автозапуск через systemd (Linux) или screen
|
||
|
||
## 🚀 Команды бота
|
||
|
||
| Команда | Описание |
|
||
|---------|----------|
|
||
| `/start` | Запустить бота, показать меню |
|
||
| `/get` | Получить случайный номер из базы (с картой, если есть) |
|
||
| `/stats` | Показать статистику базы |
|
||
| `/del <номер>` | Удалить номер из базы |
|
||
| `/adduser <id> [username]` | Добавить пользователя в белый список (админ) |
|
||
| `/removeuser <id>` | Удалить пользователя из белого списка (админ) |
|
||
| `/whitelist` | Показать белый список (админ) |
|
||
|
||
## 🃏 Как пользоваться бонусными картами
|
||
|
||
1. **Привязать карту к номеру** — отправь в одном сообщении номер телефона и фото QR-кода
|
||
2. **Только номер** — отправь номер текстом
|
||
3. **Только карта** — отправь фото QR (без номера, карта не привяжется, нужен номер)
|
||
|
||
При запросе `/get` бот выдаёт номер и картинку бонусной карты (если она есть).
|
||
|
||
## 🌐 Веб-морда
|
||
|
||
Доступна по адресу: `https://твой-домен/get_webapp`
|
||
|
||
- Просмотр всех номеров
|
||
- Удаление номеров
|
||
- Просмотр бонусных карт (кнопка "🃏 Карта")
|
||
|
||
## 📦 Установка и запуск
|
||
|
||
### 1. Клонируем репозиторий
|
||
|
||
```bash
|
||
git clone https://github.com/ТВОЙ_НИК/MpakoPhoneBot.git
|
||
cd MpakoPhoneBot |