infra/work-center/PROJECTS_SUMMARY.md

🎆 Пиротехника СПб - Обзор всех проектов

Дата: 2025-12-26
Компания: Пиротехника СПб
Телефон: +7 921 938-91-12


📊 Общая картина

У вас есть 3 взаимосвязанных проекта для продажи пиротехники:

┌─────────────────────────────────────────────────────────────┐
│                    ПИРОТЕХНИКА СПБ                          │
│                  База: 4,711 клиентов                       │
│                  VIP/Премиум: 283 клиента                   │
└─────────────────────────────────────────────────────────────┘
                              │
                ┌─────────────┼─────────────┐
                │             │             │
                ▼             ▼             ▼
        ┌───────────┐  ┌───────────┐  ┌───────────┐
        │ Пирофей.рф│  │ VIP Shop  │  │  UserBot  │
        │  (Drupal) │  │ (Telegram)│  │(Рассылка) │
        └───────────┘  └───────────┘  └───────────┘

1️⃣ Пирофей.рф - Интернет-магазин (Drupal)

Местоположение: /opt/claude-workspace/projects/org/drupal-lab/pirofey/

Статус: Planning (в разработке)

Технологии:
- Drupal 11 + Commerce 3
- ЮKassa (оплата)
- SMS.ru (авторизация)
- 1C (интеграция)

Описание:
Премиальный интернет-магазин пиротехники для розничных покупателей.

URL: пирофей.рф / pirofey.ru

Ключевые фичи:
- ✅ Каталог ~470 SKU
- ✅ Система групп (скидки до -30%)
- ✅ Ночная доставка (до 03:00 СПб)
- ✅ Ретробонус (кэшбэк)
- ✅ Промокоды

Категории товаров:
- Салюты (200 SKU)
- Петарды (50 SKU)
- Фонтаны (80 SKU)
- Ракеты (30 SKU)
- Римские свечи (40 SKU)
- Наборы (30 SKU)

Целевая аудитория:
- Семьи (50%)
- Молодёжь (25%)
- Организаторы (15%)
- B2B мелкий (10%)


2️⃣ VIP Shop - Telegram Mini App

Местоположение: /opt/claude-workspace/infra/work-center/telegram-vip-shop/

Статус: ✅ ЗАПУЩЕН (2025-12-26)

Технологии:
- Python 3.11 + FastAPI
- Telegram Bot API
- Nginx
- Docker Compose

Описание:
Эксклюзивный магазин пиротехники для VIP клиентов в Telegram.

URL: http://91.218.142.168:8095
Bot: @piroopt_bot

Сервисы:
- ✅ Telegram Bot (команды: /start, /catalog, /cart, /orders)
- ✅ API Backend (8 endpoints, порт 8094)
- ✅ WebApp Frontend (Telegram Mini App)

Товары (mock данные):
1. Салют PREMIUM 100 залпов - 15,000₽
2. Фонтан VIP Золотой дождь - 8,500₽
3. Римская свеча LUXE 50 выстрелов - 5,000₽
4. Комплект VIP Праздник - 45,000₽
5. Петарды PREMIUM Корсар - 3,500₽

Целевая аудитория:
- 283 VIP/Премиум клиента из CRM1

Как использовать:

cd /opt/claude-workspace/infra/work-center/telegram-vip-shop
./scripts/status.sh    # Проверить статус
./scripts/logs.sh      # Логи

В Telegram:
- Найти бота: @piroopt_bot
- Команда: /start
- Откроется магазин


3️⃣ UserBot - Рассылка клиентам

Местоположение: /opt/claude-workspace/infra/work-center/telegram-userbot/

Статус: ⚠️ Требует настройки

Технологии:
- Python 3.11 + Pyrogram
- Telegram UserBot API
- NocoDB (CRM интеграция)

Описание:
Рассылка сообщений VIP клиентам от вашего имени (+7 921 938-91-12).

Возможности:
- ✅ Отправка от личного аккаунта
- ✅ Загрузка VIP клиентов из CRM (283 человека)
- ✅ Защита от Flood
- ✅ Статистика отправки
- ✅ Персонализация

Требуется для запуска:
1. API_ID и API_HASH (получить на https://my.telegram.org)
2. Авторизация по телефону +7 921 938-91-12

Быстрый старт:

cd /opt/claude-workspace/infra/work-center/telegram-userbot
cat QUICKSTART.txt
cat README.md

Пример использования:

# Рассылка VIP клиентам о новом магазине
python3 userbot.py

🗄️ CRM1 - База клиентов (NocoDB)

URL: https://data.0kt.ru:8443
Base ID: pkxgq45k5mwsdwh

Статистика:
- Всего клиентов: 4,711
- VIP: 139 (2.9%)
- Премиум: 144 (3.1%)
- Средний: 633 (13.4%)
- Мелкий: 796 (16.9%)
- Холодный: 2,999 (63.7%)

География:
- Санкт-Петербург: ~955
- Москва: ~1,020
- Другие города

Интеграция:
- ✅ VIP Shop загружает данные из CRM
- ✅ UserBot загружает VIP клиентов для рассылки
- ⚠️ Пирофей.рф - планируется интеграция


🔗 Как всё работает вместе

Сценарий 1: Привлечение VIP клиентов

  1. UserBot отправляет персональное приглашение VIP клиентам:
    🎆 Эксклюзивный магазин для VIP клиентов! Откройте: @piroopt_bot Промокод VIP2025 - скидка 10%

  2. Клиент переходит в VIP Shop (@piroopt_bot)

  3. Telegram Mini App открывается с каталогом
  4. Клиент оформляет заказ
  5. Данные сохраняются в CRM1

Сценарий 2: Розничные покупатели

  1. Клиент находит сайт Пирофей.рф
  2. Выбирает товары из каталога
  3. Оформляет заказ через Drupal Commerce
  4. Оплата через ЮKassa
  5. Данные попадают в CRM1 (через 1C)

Сценарий 3: Уведомления и рассылки

  1. Новая акция или поступление товара
  2. UserBot делает рассылку сегментированным клиентам:
    - VIP → эксклюзивные предложения
    - Премиум → персональные скидки
    - Средний → стандартные акции

📂 Структура директорий

/opt/claude-workspace/
├── projects/org/
│   ├── drupal-lab/pirofey/          # Пирофей.рф (Drupal)
│   └── pirotehnika/                 # Общие данные компании
│
└── infra/work-center/
    ├── telegram-vip-shop/           # VIP Shop (Telegram Mini App) ✅
    ├── telegram-userbot/            # UserBot (рассылка) ⚠️
    └── crm-production/              # CRM1 Production (pending)

🎯 Текущий статус проектов

Проект Статус Готовность Следующий шаг
Пирофей.рф Planning 20% Разработка Drupal
VIP Shop ✅ Running 90% HTTPS + NocoDB токен
UserBot Setup 100% Настроить API ключи
CRM1 Active 100% -

🚀 Следующие шаги

Для VIP Shop (Telegram):

  1. Запущен - работает на http://91.218.142.168:8095
  2. ⚠️ Настроить HTTPS (для production)
  3. ⚠️ Получить NocoDB API Token (для реальных данных)
  4. ⚠️ Настроить WebApp URL в @BotFather

Для UserBot (Рассылка):

  1. ⚠️ Получить API_ID и API_HASH на https://my.telegram.org
  2. ⚠️ Создать .env файл
  3. ⚠️ Авторизоваться по телефону +7 921 938-91-12
  4. ✅ Запустить рассылку VIP клиентам

Для Пирофей.рф (Drupal):

  1. ⚠️ Завершить разработку Drupal
  2. ⚠️ Настроить домен и SSL
  3. ⚠️ Интеграция с ЮKassa
  4. ⚠️ Загрузить каталог товаров

📞 Контакты

Пиротехника СПб
- Телефон: +7 921 938-91-12
- Email: admin@kt.ru
- Telegram Bot: @piroopt_bot
- Сайт: пирофей.рф (в разработке)


💡 Рекомендации

  1. Запустите UserBot для рассылки VIP клиентам о новом магазине
  2. Протестируйте VIP Shop в Telegram (@piroopt_bot)
  3. Соберите обратную связь от первых VIP клиентов
  4. Доработайте функционал на основе отзывов
  5. Запустите Пирофей.рф для розничных клиентов

Обновлено: 2025-12-26
Статус: VIP Shop запущен, UserBot готов к настройке, Пирофей.рф в разработке