🔮 Mystical Bot - Telegram бот для эзотерики

Профессиональный Telegram бот для гаданий на картах Таро, расчета Матрицы Судьбы и Нумерологического анализа. Включает Telegram Mini App с интерактивным расчётом матрицы судьбы прямо внутри Telegram.

🌐 Мини-приложение (Telegram Mini App)

Встроенное веб-приложение, которое открывается прямо в Telegram без перехода в браузер.

Возможности мини-приложения

• 🔮 Матрица Судьбы — введи дату рождения и мгновенно получи полный расчёт по 22 арканам
• 🎴 Визуальная схема — интерактивная матрица с расположением арканов по точкам
• 📖 Описание каждого аркана — ключевые слова, плюсы, минусы, советы
• 📱 Адаптивный дизайн — оптимизировано под мобильные устройства

Архитектура мини-приложения

webapp/
├── client/          # React фронтенд
│   ├── src/
│   │   ├── App.jsx              # Главный компонент
│   │   └── components/          # UI компоненты
│   ├── build/                   # Собранный React билд
│   └── package.json
│
└── server/          # Node.js / Express бэкенд
    ├── index.js                 # API сервер (порт 3000)
    └── package.json

API эндпоинты

Метод	Путь	Описание
POST	/api/matrix	Расчёт матрицы судьбы по дате рождения ДД.ММ.ГГГГ
GET	/api/arcana	Список всех 22 арканов с описаниями
GET	/api/health	Health check сервера

Деплой мини-приложения на сервер

Требования: Node.js 18+, nginx, certbot (для HTTPS — обязателен для Telegram)

# 1. Установить зависимости сервера
cd webapp/server && npm install

# 2. Установить зависимости клиента и собрать билд
cd webapp/client && npm install --legacy-peer-deps && npm run build

# 3. Настроить nginx как reverse proxy (HTTP → HTTPS)
# Telegram Mini App требует HTTPS!

# 4. Получить SSL сертификат
certbot --nginx -d ВАШ_ДОМЕН --non-interactive --agree-tos -m ВАШ_EMAIL

# 5. Запустить через PM2
pm2 start webapp/server/index.js --name webapp
pm2 save

Переменные окружения (.env):

BOT_TOKEN=ваш_токен_бота
WEBAPP_URL=https://ваш-домен.com   # обязательно HTTPS!

⚠️ Важно: Telegram не позволяет открывать Mini App по HTTP — только HTTPS. Используйте nginx + Let's Encrypt (certbot) или ngrok для разработки.

---

✨ Возможности бота

🎴 Расклады Таро (78 карт Райдера-Уайта)

• 🌅 Карта дня — энергия текущего дня
• 🎴 Три карты — прошлое, настоящее, будущее
• ✨ Кельтский крест — глубокий анализ ситуации (10 карт)
• ❤️ Расклад на отношения — любовь и партнерство (5 карт)
• 💰 Расклад на финансы — денежные потоки (5 карт)
• 💼 Расклад на карьеру — профессиональный путь (6 карт)
• 🎯 Да/Нет — простой ответ на вопрос
• 🔄 Прямые и перевернутые значения карт

⭐ Матрица Судьбы (метод Натальи Ладини)

• 📊 Полный расчет по 22 арканам Таро
• 🎯 Предназначение и жизненный путь
• 💰 Линия денег — через что приходят деньги
• ❤️ Линия любви — модель отношений
• ✨ Линия таланта — врождённые способности
• 🔄 Кармические задачи — что нужно проработать
• 💑 Совместимость — анализ отношений с партнёром
• 👶 Детская матрица — потенциал ребёнка

🔢 Нумерология

• 🎯 Число Жизненного Пути — главная миссия
• 🌟 Число Судьбы — влияние имени
• 💫 Число Души — внутренние желания
• 🎭 Число Личности — внешнее восприятие
• 🧘 Число Зрелости — качества после 35–40 лет
• 📅 Персональный год — энергия текущего года
• 🔢 Квадрат Пифагора — психоматрица
• 🔄 Кармические числа — жизненные уроки
• 📊 Полный отчёт — все показатели сразу

---

🚀 Быстрый старт

Требования

• Python 3.8+
• Node.js 18+ (для мини-приложения)
• Telegram Bot Token (получить у @BotFather)

Установка

1. Клонируйте репозиторий:

git clone https://github.com/eduard03072000-png/Taro_bot.git
cd Taro_bot

2. Создайте виртуальное окружение:

python -m venv venv
source venv/bin/activate   # Linux/Mac
venv\Scripts\activate      # Windows

3. Установите зависимости Python:

pip install -r requirements.txt

4. Настройте переменные окружения:

cp .env.example .env
# Отредактируйте .env: вставьте BOT_TOKEN и WEBAPP_URL

5. Установите и соберите мини-приложение:

cd webapp/server && npm install
cd ../client && npm install --legacy-peer-deps && npm run build
cd ../..

6. Скачайте изображения карт Таро:

python download_cards.py

7. Запустите бота и веб-сервер:

# Через PM2 (рекомендуется)
pm2 start webapp/server/index.js --name webapp
pm2 start bot.py --name bot --interpreter python3
pm2 save

# Или вручную
node webapp/server/index.js &
python bot.py

---

📁 Структура проекта

Taro_bot/
├── bot.py                  # Главный файл бота
├── config.py               # Конфигурация
├── requirements.txt        # Зависимости Python
├── .env.example            # Пример файла окружения
│
├── data/
│   └── tarot_cards.json    # База данных карт Таро
│
├── images/
│   └── tarot/              # Изображения карт (78 штук)
│
├── modules/
│   ├── tarot.py            # Модуль раскладов Таро
│   ├── matrix.py           # Модуль Матрицы Судьбы
│   ├── matrix_chart.py     # Генерация схемы матрицы
│   └── numerology.py       # Модуль Нумерологии
│
├── webapp/
│   ├── client/             # React фронтенд мини-приложения
│   │   ├── src/
│   │   │   ├── App.jsx
│   │   │   └── components/
│   │   └── build/          # Собранный билд (генерируется)
│   │
│   └── server/             # Express API сервер
│       └── index.js
│
└── scripts/                # Вспомогательные скрипты

---

🛠️ Технологии

Бот:

• Python 3.8+, python-telegram-bot, python-dotenv, Pillow

Мини-приложение:

• Node.js 20+, Express.js — бэкенд API
• React 18, Telegram Web App SDK — фронтенд
• nginx + Let's Encrypt — HTTPS (обязателен для Telegram)
• PM2 — управление процессами на сервере

---

📖 Источники и методология

• Таро: колода Rider-Waite (Public Domain)
• Матрица Судьбы: метод Натальи Ладини, 22 старших аркана
• Нумерология: система Пифагора, западная традиция

---

⚠️ Дисклеймер

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

📄 Лицензия

MIT License — см. файл LICENSE

---

⭐ Если проект понравился — поставь звезду!

Сделано с ❤️ и магией ✨