From 0ab8ceb4ba92fe768bdf506e01bd2e52b9571861 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80?=
 <78488229+viktor138irk@users.noreply.github.com>
Date: Mon, 18 May 2026 08:46:46 +0900
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D0=BB=20?=
 =?UTF-8?q?=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5=20BotShop=20v0?=
 =?UTF-8?q?.1.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..afecfa9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+# BotShop
+
+BotShop — стартовый каркас мультибот-магазина для Telegram с веб-админкой.
+
+## Что уже заложено в v0.1.0
+
+- подключение нескольких Telegram-ботов через токен;
+- один webhook endpoint для всех ботов: `/webhook/{secret}`;
+- выбор города, района, товара и варианта товара в Telegram;
+- создание заказа без отправки чека;
+- выдача реквизитов и уникальной суммы `цена + случайная добавка`;
+- ручное подтверждение/отклонение оплаты в админ-панели;
+- управление городами, районами, товарами, вариантами и реквизитами;
+- базовые логи входящих Telegram-событий и ошибок;
+- простой installer `/install`.
+
+## Важно
+
+Проект предназначен только для легального магазина товаров и услуг. В коде нет механики тайников, скрытых адресов, автоматической выдачи запрещённых товаров или обхода платёжных правил.
+
+## Требования
+
+- PHP 8.1+
+- MySQL 5.7+/8+
+- HTTPS-домен для Telegram webhook
+- Apache/Nginx с rewrite на `public/index.php`
+
+## Быстрый запуск
+
+1. Залейте проект на сервер.
+2. Направьте web-root домена на папку `public`.
+3. Создайте MySQL-базу и пользователя.
+4. Откройте `/install`.
+5. Укажите доступы к базе и создайте администратора.
+6. Войдите в `/login`.
+7. Добавьте Telegram-бота в разделе «Боты».
+8. Нажмите «Установить webhook».
+
+## Структура
+
+```text
+public/index.php       # основной роутер и приложение v0.1.0
+database/schema.sql    # схема базы
+storage/config.php     # создаётся installer'ом, не хранится в git
+storage/logs/          # логи
+```
+
+## Версия
+
+`0.1.0`