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