# 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`