🇷🇺 Русский • 🇬🇧 English • 🇪🇸 Español • 🇮🇳 हिन्दी • 🇨🇳 简体中文

> ⚠️ **Важно:** Находимся на стадии **альфа-тестирования**. > Функционал может меняться, возможны ошибки и нестабильная работа. > Используйте с осторожностью и сообщайте о проблемах.

---

GraceHub Platform

GraceHub — это SaaS платформа, которая позволяет вам развернуть свою поддержку прямо в телеграм, а так же становиться поставщиком услуги по созданию ботов обратной связи и технической поддержки. **🌐 Сайт:** [gracehub.ru](https://gracehub.ru) **📢 Telegram канал:** [@gracehubru](https://t.me/gracehubru) **👨‍💻 Разработчик:** [@Gribson_Micro](https://t.me/Gribson_Micro) **🗺️ Roadmap:** [ROADMAP.md](./ROADMAP.md)

📱 Скриншоты


Стартовая страница	Дашборд	Добавление бота

Раздел оплаты, в котором было убито много времени	Главный бот, где можно привязать бота поддержки	Меню админа бота поддержки пользователей

Приходит месседж от клиента	Меню работы с тикетом	Ответ клиенту

## Функционал - **Главный бот** — центральная точка привязки всех ботов обратной связи - **Mini App личный кабинет** — интерфейс для управления ботами и клиентами - **Статистика и аналитика** — отслеживайте метрики по каждому боту - **Система биллинга** — рассчёт и управление платежами ## 🌍 Поддерживаемые языки - 🇷🇺 Русский - 🇬🇧 English - 🇪🇸 Español - 🇮🇳 हिन्दी - 🇨🇳 简体中文 ## 📁 Структура ``` gracehub/ ├── src/ │ └── master_bot/ │ ├── main.py # Точка входа мастер‑бота │ ├── api_server.py # REST API сервер │ └── worker/ # Воркеры для инстансов ├── frontend/miniapp_frontend/ # React приложение ├── config/ # Конфигурационные файлы ├── scripts/ │ └── launch.sh # Скрипт запуска ├── logs/ # Логи приложения └── .env # Переменные окружения ``` ### 💳 Платёжки Под капотом следующие шлюзы/системы: | Система | Способ оплаты | Технические особенности | | :--- | :--- | :--- | | **Telegram Stars** | Внутренняя валюта Telegram | Прямая интеграция с [Telegram Mini Apps Billing](https://core.telegram.org/bots/payments). Платежи обрабатываются внутри платформы Telegram. | | **TON Coin** | Криптовалюта (Toncoin) | Прямые переводы на TON-кошелек. Транзакции обрабатываются в блокчейне TON без использования смарт-контрактов на стороне платформы. | | **ЮKassa** | Платежный агрегатор (RU) | Прием платежей по 54-ФЗ (банковские карты, СБП, электронные кошельки). REST API с вебхуками для подтверждения платежей. | | **Stripe** | Банковские карты (и др. методы Stripe) | Прием международных платежей через Stripe API; подтверждение оплаты через вебхуки Stripe. | ## 📋 Требования | Компонент | Технология/Версия | |-----------|-------------------| | Backend | Python (FastAPI, Hypercorn) | | Frontend | React 19 + TypeScript + Vite | | Управление ботами | Telegram Bot API | | База данных | PostgreSQL 15+ | | Прокси | Nginx (опционально) | | Версия Python | 3.10+ | | Node.js | 20+ | | Доменное имя | | ## ⚙️ Подготовка окружения 1. В каталог проекта: ```bash cd /root/gracehub ``` 2. Создайте файл окружения и заполните его: ```bash cp .env-example .env nano .env ``` 3. Создайте виртуальное окружение: ```bash python3 -m venv venv source venv/bin/activate ``` ВНИМАНИЕ: На 3.13 python ошибка установки pydantic-core. Лучше пользоваться версией ниже. ## 🚀 Запуск для разработки ### Обычный режим (с логами в терминале) ```bash ./scripts/launch.sh dev ``` ### Фоновый режим ```bash ./scripts/launch.sh dev --detach ``` Запуск включает три процесса: - мастер‑бот - REST API сервер - frontend приложение ## 🔧 Продакшен‑деплой через systemd ### Первичная настройка и деплой ```bash ./scripts/launch.sh prod ``` ### Управление сервисами После развертывания управление осуществляется через systemd: ```bash # Проверка статуса systemctl status gracehub-master gracehub-api gracehub-frontend # Перезагрузка сервисов systemctl restart gracehub-master gracehub-api gracehub-frontend # Остановка сервиса systemctl stop gracehub-frontend ``` ## 📊 Логи и мониторинг ### Для режима разработки Логи находятся в каталоге `logs/`: ```bash tail -f logs/masterbot.log tail -f logs/api_server.log tail -f logs/frontend-dev.log ``` ### Для продакшена Просмотр логов systemd: ```bash journalctl -u gracehub-master -n 50 --no-pager journalctl -u gracehub-api -n 50 --no-pager journalctl -u gracehub-frontend -n 50 --no-pager ``` ## 🎯 Инструкция по использованию После успешного деплоя следуйте этим шагам для настройки вашей поддержки: ### Шаг 1: Подключение основного бота GraceHub 1. Найдите основного GraceHub Platform бота в Telegram (которого вы развернули на предыдущих шагах) 2. Нажмите **Start** или напишите `/start` 3. Бот предоставит вам личный кабинет и инструкции для управления ### Шаг 2: Регистрация вашего бота поддержки 1. В основном боте выберите опцию добавления нового бота 2. Получите токен своего Telegram бота через [@BotFather](https://t.me/botfather) 3. Отправьте токен боту GraceHub Platform 4. Ваш бот поддержки будет активирован в системе ### Шаг 3: Инициализация администратора 1. Напишите в ваш новый бот поддержки команду `/start` 2. Бот запомнит вас как администратора и даст доступ к управлению ### Шаг 4: Создание суперчата с топиками 1. Создайте новую группу в Telegram 2. В параметрах группы включите режим **"Обсуждения"** (Topics) 3. Добавьте вашего бота поддержки в эту группу с правами администратора 4. Убедитесь, что боту даны права на управление сообщениями и топиками ### Шаг 5: Привязка бота к топику General 1. Откройте топик **General** в вашем суперчате 2. Напишите команду привязки: ``` /bind @your_bot_username ``` Замените `@your_bot_username` на имя вашего бота поддержки. 3. После успешной привязки бот начнет принимать обращения клиентов в этом топике 4. Все сообщения от клиентов будут автоматически распределяться по топикам в суперчате ### ✅ Готово! Ваша система поддержки в Telegram полностью настроена. Клиенты вашего бизнеса смогут писать боту, а вы будете видеть все обращения в удобном интерфейсе суперчата с разделением по топикам. ## 📄 Лицензия MIT

GraceHub

Описание

Языки