Files
bot/README.md
T

2.2 KiB

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».

Структура

public/index.php       # основной роутер и приложение v0.1.0
database/schema.sql    # схема базы
storage/config.php     # создаётся installer'ом, не хранится в git
storage/logs/          # логи

Версия

0.1.0