Добавил описание BotShop v0.1.0

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`