Go to file
MpakobecEx 5e2072062d Добавил readme 2026-05-27 22:28:35 +05:00
.gitignore Добавил readme 2026-05-27 22:28:35 +05:00
README.md Добавил readme 2026-05-27 22:28:35 +05:00
bot.py Первый комит 2026-05-27 22:26:23 +05:00
database.py Первый комит 2026-05-27 22:26:23 +05:00
example.env Первый комит 2026-05-27 22:26:23 +05:00
phone_utils.py Первый комит 2026-05-27 22:26:23 +05:00
qr_utils.py Первый комит 2026-05-27 22:26:23 +05:00
requirements.txt Первый комит 2026-05-27 22:26:23 +05:00
web_app.html Первый комит 2026-05-27 22:26:23 +05:00

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 Показать белый список (админ)

🃏 Как пользоваться бонусными картами

  1. Привязать карту к номеру — отправь в одном сообщении номер телефона и фото QR-кода
  2. Только номер — отправь номер текстом
  3. Только карта — отправь фото QR (без номера, карта не привяжется, нужен номер)

При запросе /get бот выдаёт номер и картинку бонусной карты (если она есть).

🌐 Веб-морда

Доступна по адресу: https://твой-домен/get_webapp

  • Просмотр всех номеров
  • Удаление номеров
  • Просмотр бонусных карт (кнопка "🃏 Карта")

📦 Установка и запуск

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

git clone https://github.com/ТВОЙ_НИК/MpakoPhoneBot.git
cd MpakoPhoneBot