Добавил readme

.gitignore

@@ -38,4 +38,5 @@ screenlog.0
 
 # Секреты и конфиги (ВАЖНО!)
 .env
-config.py
+config.py
+start.sh

README.md

@@ -0,0 +1,50 @@
+# 🌑 МракоЗвон
+
+**МракоЗвон** — 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