Skip to content
Sergey Novichkov edited this page Apr 27, 2024 · 1 revision

GigaShopBot

GigaShopBot - это программный продукт, основанный на Aiogram 3.x и SQLAlchemy, который позволяет автоматизировать продажу товаров в Telegram. Одним из преимуществ бота является то, что он реализует возможность пополнения с помощью Bitcoin, Litecoin, USDT TRC-20, что позволяет продавать цифровые товары по всему миру.

Содержание

Начало работы

1.1 Запуск GigaShopBot с помощью Docker-compose

Чтобы запустить GigaShopBot с помощью Docker-compose, выполните следующие шаги:

  1. Клонируйте проект из ветки master.
  2. Установите переменные окружения в файле docker-compose.yml, включая токен от @BotFather, токен ngrok, Telegram ID администраторов и ссылку на поддержку.
  3. Запустите команду docker-compose up.

1.2 Запуск GigaShopBot без шифрования базы данных SQLCipher

Чтобы запустить GigaShopBot без шифрования базы данных SQLCipher, выполните следующие шаги:

  1. Клонируйте проект из ветки master.
  2. Установите все необходимые пакеты с помощью pip install -r requirements.txt.
  3. Установите переменные окружения в файле .env.
  4. Запустите команду python run.py.

1.3 Запуск GigaShopBot с шифрованием базы данных SQLCipher

Чтобы запустить GigaShopBot с шифрованием базы данных SQLCipher, выполните следующие шаги:

  1. Клонируйте проект из ветки feature/sqlalchemy-sqlcipher.
  2. Установите пакет SQLCipher, например, с помощью sudo apt install sqlcipher в Ubuntu.
  3. Установите все необходимые пакеты с помощью pip install -r requirements.txt.
  4. Установите переменные окружения в файле .env, включая пароль для базы данных.
  5. Запустите команду python run.py.

Руководство пользователя

2.1 Регистрация

Регистрация происходит при первом обращении к боту с помощью команды /start. Каждому пользователю присваивается уникальная мнемоническая фраза для генерации адресов криптовалют BTC, LTC, USDT TRC20.

2.2 Пополнение баланса

Чтобы пополнить баланс, перейдите в "Мой профиль" -> "Пополнить баланс". Скопируйте адрес криптовалюты, которую хотите пополнить, и отправьте криптовалюту туда, затем вернитесь в "Мой профиль" и нажмите "Обновить баланс".

2.3 Покупка товаров

Чтобы купить любой товар, перейдите в "Все категории" -> Выберите любую категорию -> Выберите любую подкатегорию -> Выберите количество -> Подтвердите покупку. Если покупка прошла успешно, вы сразу же получите сообщение с данными о товаре.

2.4 История покупок

Чтобы доступ к истории ваших покупок, перейдите в "Мой профиль" -> "История покупок". Вам будет представлена инлайн-клавиатура со всеми вашими покупками, нажав на любую из покупок, вам будет отправлено сообщение с данными о товаре.

Руководство администратора

3.1 Добавление нового администратора

Чтобы добавить нового администратора, добавьте его Telegram ID в переменную окружения ADMIN_ID_LIST, разделенную запятыми, и перезагрузите бота.

3.2 Функциональность "Отправить всем пользователям бота"

Откройте панель администратора, введя команду /admin, затем нажмите на кнопку "Отправить всем". Напишите сообщение или перешлите боту, бот поддерживает отправку сообщений с картинками и разметкой Telegram.

3.3 Добавление новых товаров в бот

Откройте панель администратора, введя команду /admin. Нажмите на кнопку "Добавить новые товары". Отправьте .json файл с новыми товарами.

3.4 Отправить всем сообщение о пополнении

Откройте панель администратора, введя команду /admin. Нажмите на кнопку "Отправить сообщение о пополнении".

3.5 Получить новых пользователей

Откройте панель администратора, введя команду /admin. Нажмите на кнопку "Получить новых пользователей". Вы получите сообщение с инлайн-кнопками, которые переведут вас в чат с каждым новым пользователем.

3.6 Удалить категории и подкатегории

Откройте панель администратора, введя команду /admin. Нажмите на кнопку "Удалить категорию" или "Удалить подкатегорию".

3.7 Сделать возврат

Откройте панель администратора, введя команду /admin. Нажмите на кнопку "Сделать возврат".

3.8 Уведомления администратора

Бот отправляет уведомления администраторам о новых пользователях, пополнениях и других важных событиях.