This commit is contained in:
2025-06-08 20:55:08 +09:00
parent f7e0d17829
commit 7a75f79413
139 changed files with 10619 additions and 2340 deletions

View File

@@ -0,0 +1,83 @@
# ⚠️ Эта версия бота больше не обновляется!
Сейчас я переписываю бота, за обновлениями следите на ветке rewrite :)
<br>
## 🪲 В случае возникновения ошибок открывайте тикет во вкладке Issues :)
# Навигация
- [Навигация](#навигация)
- [Зачем нужен этот бот?](#зачем-нужен-этот-бот)
- [Установка](#установка)
- [Docker](#docker)
- [Python](#python)
- [Установка необходимых Python-пакетов](#установка-необходимых-python-пакетов)
- [Запуск установщика](#запуск-установщика)
- [Запуск бота](#запуск-бота)
- [Запуск с помощью скрипта](#запуск-с-помощью-скрипта)
- [Linux](#linux)
- [Macos](#macos)
- [Запуск вручную](#запуск-вручную)
- [Режим отладки](#режим-отладки)
# Зачем нужен этот бот?
Зачастую люди, желающие открыть маленький интернет-бизнес, делают это с помощью профиля в социальных сетях, что требует вручную обрабатывать каждую заявку. Этот бот позволит каждому быстро открыть автоматизированный магазин на базе телеграм бота, что значительно уменьшит время обработки заказов.
![overview](DOCS/bot_overview.gif)
# Установка
## Docker
Этот способ установки является основным и рекомендуемым. Он позволяет установить бота в репродуцируемом окружении, что упрощает его обновление и установку на сервер.
Для работы бота необходимо установить [Docker](https://docs.docker.com/get-docker/) и выполнить следущую команду:
```
docker run -d \
-e MAIN_ADMIN_ID='Ваш Telegram ID' \
-e TELEGRAM_TOKEN='token' \
w1png/shop-telegram-bot
```
## Python
Для работы бота необходимо установить [Python версии 3.10 и выше](https://www.python.org/downloads/).
### Установка необходимых Python-пакетов
python3 -m pip install -r requirements.txt
### Запуск установщика
Перед запуском установщика требуется [создать токен](https://youtu.be/fyISLEvzIec) для телеграм бота и [получить ваш ID](https://badcode.ru/kak-v-telegram-uznat-svoi-id/).
Установщик запускается с помощью команды:
python3 installer.py
## Запуск бота
### Запуск с помощью скрипта
#### Linux/MacOS
$ chmod +x start.sh
$ ./start.sh
#### Windows
$ start.cmd
### Запуск вручную
python3 main.py
# Режим отладки
Режим отладки можно активировать во вкладке "Основные настройки".
После активации в терминале начнут отображаться все сообщения и вызовы в формате:
DEBUG: <MESSAGE/CALL> [<user_id>] <Сообщение/вызов>
*Пример: `DEBUG CALL [462741] admin_itemManagement`*