Обновлено описание BotShop v0.2.0

README.md

@@ -1,36 +1,53 @@
-# BotShop
+# BotShop v0.2.0
 
-BotShop — стартовый каркас мультибот-магазина для Telegram с веб-админкой.
+BotShop — локальная платформа для запуска нескольких Telegram-магазинов из одной панели управления.
+
+Проект рассчитан на легальную продажу цифровых и физических товаров: файлы, доступы, инструкции, мерч, услуги, коды, подписки, инфопродукты. В проекте нет механики тайников, скрытых адресов, обхода платёжных правил или автоподтверждения платежей по словам пользователя.
 
 ## Что заложено
 
 - подключение нескольких Telegram-ботов через токен;
 - локальный режим без домена через Telegram polling;
 - webhook-режим для сервера с HTTPS-доменом;
-- выбор города, района, товара и варианта в Telegram;
-- создание заказа без отправки чека;
-- выдача реквизитов и уникальной суммы `цена + случайная добавка`;
-- ручное подтверждение/отклонение оплаты в админ-панели;
-- управление городами, районами, товарами, вариантами и реквизитами;
-- базовые логи входящих Telegram-событий и ошибок;
+- главная бота: приветствие, выбор города, баланс, рефералка, последний заказ, поддержка;
+- последовательность заказа: город → продукт → район/зона → тип/вариант → итог → оплата/отмена;
+- оплата с баланса магазина;
+- карта/СБП/банк с уникальной суммой для ручной идентификации;
+- Bitcoin-реквизиты с подтверждением оператором;
+- баланс пользователя через ledger: рефералы, пополнения, возвраты, списания;
+- автовыдача товара после статуса `paid`;
+- управление городами, районами, товарами, вариантами, остатками, заказами, платежами;
+- базовые логи Telegram-событий и действий администратора;
 - автоустановщик `install.sh`.
 
-## Важно
+## Важная логика платежей
 
-Проект предназначен только для легального магазина товаров и услуг. В коде нет механики тайников, скрытых адресов, автоматической выдачи запрещённых товаров или обхода платёжных правил.
+Пользовательское нажатие `Я оплатил` не делает заказ оплаченным. Оно переводит платёж в проверку оператором. Автовыдача выполняется только после статуса `paid`.
+
+Для полностью автоматической оплаты нужен официальный платёжный API банка/эквайринга/крипто-провайдера. Уникальная сумма без API — это полуавтоматический режим с ручной проверкой.
+
+## Статусы заказа
+
+- `draft` — черновик;
+- `waiting_payment` — ожидает оплату;
+- `payment_review` — пользователь заявил оплату, оператор проверяет;
+- `paid` — оплата подтверждена;
+- `delivered` — товар выдан;
+- `cancelled` — отменён;
+- `refunded` — возвращён;
+- `expired` — истёк срок оплаты;
+- `rejected` — оплата отклонена.
 
 ## Требования
 
 - Ubuntu/Debian сервер или локальная VM;
 - PHP 8.1+;
-- MySQL 5.7+/8+;
+- MySQL 5.7+/8+ или MariaDB;
 - Nginx;
 - доступ в интернет для Telegram Bot API.
 
 ## Локальная установка без домена
 
-Самый простой вариант:
-
 ```bash
 sudo apt update
 sudo apt install -y git curl
@@ -72,36 +89,10 @@ sudo bash install.sh --local \
 4. В панели откройте «Боты».
 5. Добавьте токен.
 6. Поставьте статус `active`.
-7. В локальном режиме кнопку webhook нажимать не нужно.
-8. Добавьте город, район, товар, вариант и реквизиты.
+7. В локальном режиме webhook не нужен.
+8. Добавьте город, район, товар, вариант, остатки и реквизиты.
 9. Напишите `/start` своему Telegram-боту.
 
-## Обслуживание
-
-Перезапуск polling:
-
-```bash
-sudo systemctl restart botshop-polling
-```
-
-Логи polling:
-
-```bash
-sudo journalctl -u botshop-polling -f
-```
-
-Логи Nginx:
-
-```bash
-sudo tail -n 100 /var/log/nginx/botshop_error.log
-```
-
-Файл локальной конфигурации:
-
-```text
-/var/www/botshop/storage/config.php
-```
-
 ## Структура
 
 ```text
@@ -113,6 +104,14 @@ storage/config.php     # создаётся installer'ом, не хранитс
 storage/logs/          # логи
 ```
 
+## Ближайший roadmap
+
+- v0.2.1 — экран баланса, рефералки и последнего заказа в Telegram;
+- v0.2.2 — админ-раздел остатков и автовыдачи;
+- v0.2.3 — подтверждение платежа оператором с автоматической выдачей;
+- v0.2.4 — поддержка в панели;
+- v0.3.0 — аккуратный UI, роли операторов и журнал аудита.
+
 ## Версия
 
-`0.1.1`
+`0.2.0`