# Tarot Spirit AI

> Платформа тематических Telegram-ботов с LLM и собственным платёжным контуром.

Статус: Платформа.

![Tarot Spirit AI](https://vasilev-aleksandr.ru/tarot-spirit-ai.jpg)


## О проекте

- **Формат:** Собственный продукт
- **Сфера:** Тематические Telegram-сервисы
- **Роль:** Архитектура и разработка платформы



## Контекст

Каждый тематический Telegram-бот требовал одинаковой инфраструктуры: обработки сообщений, хранения пользователей, меню, доступа к LLM и развёртывания. Если копировать backend для каждой темы, исправления и развитие пришлось бы повторять в нескольких кодовых базах.

## Задача

Отделить общую механику платформы от тематики конкретного бота, чтобы новые сценарии запускались через конфигурацию, инструкции и параметры генерации без переписывания основного backend.

- общее ядро для нескольких Telegram-ботов
- конфигурация тематики, стиля ответа и параметров генерации
- system prompt и сценарии в объектном хранилище
- выбор инструкции перед обращением к LLM
- панель управления инструкциями и документация
- Docker-запуск платформы

## Проблема

Нужно было запускать ботов разных тематик без переписывания общего backend.

## Решение

Создана универсальная оболочка, где инструкции управляют моделью и меню, а платёжный модуль синхронизирует статусы.

## Как решал задачу

- **Конфигурация вместо копирования backend.** Общая логика обработки запросов вынесена в единое ядро, а тематика бота, стиль ответа и параметры генерации хранятся отдельно. Новый сценарий не требует отдельной версии всей платформы. Результат: Одна кодовая база обслуживает разные тематические продукты и получает общие исправления одновременно.
- **Инструкции отделены от кода.** System prompt и прикладные сценарии хранятся в S3 и выбираются перед генерацией ответа. Содержательную часть можно менять без пересборки контейнера. Результат: Поведение бота настраивается независимо от релизного цикла backend.
- **Управление без правки исходников.** Для инструкций сделана административная панель, а устройство и запуск платформы описаны в документации. Операционные изменения не требуют работы непосредственно с кодом. Результат: Добавление и обновление сценариев стало отдельной управляемой операцией.



## Результат

Одна кодовая база запускает ботов разных тематик через конфигурацию.

## Метрики

- Отдельные метрики не опубликованы.



## Технологии

- Python
- Telegram
- LLM
- WebSocket
- Redis Pub/Sub
- Docker

## Материалы

[Открыть дополнительные материалы](https://profi.ru/profile/VasilyevAA210/?photoId=32993246)

## Связанные услуги

- [Telegram-боты и AI](https://vasilev-aleksandr.ru/services/telegram-bots/index.md)
- [Платёжные системы](https://vasilev-aleksandr.ru/services/payment-systems/index.md)
- [API и интеграции](https://vasilev-aleksandr.ru/services/api-integrations/index.md)

## Следующий кейс

[ExamGuide AI](https://vasilev-aleksandr.ru/cases/examguide-ai/index.md)


## Есть похожая задача?

Опишите исходный процесс и результат, который хотите получить.

[Обсудить похожую задачу](https://t.me/wyndace)
