From 5e2072062de4c4d0ee35140a414880188a0ab30e Mon Sep 17 00:00:00 2001
From: MpakobecEx <tsunauyshi@gmail.com>
Date: Wed, 27 May 2026 22:28:35 +0500
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D0=BB=20re?=
 =?UTF-8?q?adme?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore |  3 ++-
 README.md  | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 52 insertions(+), 1 deletion(-)
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
index 9ebe06b..57dd67c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -38,4 +38,5 @@ screenlog.0
 
 # Секреты и конфиги (ВАЖНО!)
 .env
-config.py
\ No newline at end of file
+config.py
+start.sh
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..475b193
--- /dev/null
+++ b/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
\ No newline at end of file