architect/_archive/2025-11-26-cleanup/drupal-shop-template/docs/MODULES_LIST.md

Список модулей для магазина пиротехники

Дата: 2025-11-16
Проект: Drupal Commerce Shop Template
Базовая платформа: Drupal 11 + Commerce Kickstart 5

🎯 Цель

Создать готовую сборку интернет-магазина пиротехники с:
- ✅ Доставкой (Почта РФ, курьеры СПб, Яндекс)
- ✅ Оплатой (карты, СберПей, Т-Банк, безнал)
- ✅ Интеграциями (Метрика, Директ, Маркет)
- ✅ Авторизацией (соцсети, телефон)
- ✅ Мессенджерами (Telegram, WhatsApp)

📦 Модули по категориям

1. БАЗА (уже установлено в Kickstart 5)

Drupal Core: 11.2.8
Commerce Core: 3.2.0
  - commerce_cart
  - commerce_checkout
  - commerce_order
  - commerce_payment
  - commerce_price
  - commerce_product
  - commerce_store
  - commerce_number_pattern

Темы:
  - gin: 3.0.0              # Админка
  - belgrade: 2.2.1         # Витрина

Kickstart модули:
  - commerce_shipping: 2.15.0
  - commerce_recurring: 1.0-rc3
  - physical: 1.5.0
  - search_api: 1.40.0
  - facets: 3.0.2
  - better_exposed_filters: 7.0.5
  - bootstrap_layout_builder
  - advancedqueue: 1.5.0

2. ДОСТАВКА

Почта России

composer require 'drupal/commerce_russianpost:^2.0'

Модуль: commerce_russianpost
Функции:
- Расчёт тарифов Почты РФ
- Трекинг посылок
- Печать форм

Курьерская доставка СПб

composer require 'drupal/commerce_flat_rate:^1.0'

Модуль: commerce_flat_rate
Функции:
- Фиксированная ставка по зонам
- Бесплатная доставка от суммы
- Зоны доставки (центр, окраины, область)

Настройка:
- Зона 1 (центр СПб): 500₽
- Зона 2 (окраины): 700₽
- Зона 3 (ЛО): 1000₽
- Бесплатно от: 10000₽

Яндекс.Доставка

composer require 'drupal/commerce_yandex_delivery:^1.0'

Альтернатива (если нет готового):

# Использовать API напрямую через custom модуль
# commerce_shipping + REST API Яндекс.Доставки

СДЭК (опционально)

composer require 'drupal/commerce_cdek:^1.0'

3. ОПЛАТА

Банковские карты (Тинькофф Acquiring)

composer require 'drupal/commerce_tinkoff:^1.0'

Альтернатива:

composer require 'drupal/commerce_payment_tinkoff:^2.0'

Функции:
- Приём карт Visa/MasterCard/Мир
- 3D-Secure
- Возвраты
- Рекуррентные платежи

СберПей

composer require 'drupal/commerce_sberpay:^1.0'

Альтернатива (если нет готового модуля):

# Использовать commerce_sberbank
composer require 'drupal/commerce_sberbank:^1.0'

Функции:
- Оплата через СберПей
- QR-коды
- Интеграция с СБП

ЮKassa (Яндекс.Касса)

composer require 'drupal/commerce_yookassa:^1.0'

Функции:
- Все методы оплаты (карты, СБП, Яндекс.Деньги)
- Автоплатежи
- Возвраты

Т-Банк (бывший Тинькофф)

# См. Тинькофф Acquiring выше
composer require 'drupal/commerce_tinkoff:^1.0'

Безналичный расчёт (для юрлиц)

composer require 'drupal/commerce_invoice:^2.0'

Функции:
- Выставление счетов
- Печать счёта на оплату
- Контроль оплаты
- Акты выполненных работ

Наложенный платёж (Почта РФ)

Модуль: Встроен в commerce_russianpost

4. ИНТЕГРАЦИИ

Яндекс.Метрика

composer require 'drupal/yandex_metrics:^2.0'

Функции:
- Счётчик Метрики
- E-commerce отслеживание
- Цели
- Вебвизор

Яндекс.Директ

composer require 'drupal/google_tag:^2.0'

Настройка:
- Установка пикселя Директ
- Отслеживание конверсий
- Ретаргетинг

Яндекс.Маркет

composer require 'drupal/yandex_market:^1.0'

Альтернатива:

composer require 'drupal/feeds:^3.0'

Функции:
- Генерация YML фида
- Экспорт товаров
- Обновление остатков
- Синхронизация заказов

Google Analytics 4

composer require 'drupal/google_analytics:^4.0'

Google Tag Manager

composer require 'drupal/google_tag:^2.0'

Facebook Pixel

composer require 'drupal/facebook_pixel:^2.0'

VK Pixel

composer require 'drupal/vk_pixel:^1.0'

5. АВТОРИЗАЦИЯ

Через соцсети

composer require 'drupal/social_auth:^4.0'
composer require 'drupal/social_auth_vk:^4.0'
composer require 'drupal/social_auth_google:^4.0'
composer require 'drupal/social_auth_facebook:^3.0'
composer require 'drupal/social_auth_mailru:^1.0'
composer require 'drupal/social_auth_odnoklassniki:^1.0'

Соцсети:
- ✅ ВКонтакте
- ✅ Google
- ✅ Facebook (Meta)
- ✅ Mail.ru
- ✅ Одноклассники
- ✅ Telegram (см. ниже)

Через телефон (SMS)

composer require 'drupal/smsframework:^2.0'
composer require 'drupal/commerce_sms:^1.0'

Провайдеры SMS:

# SMS.ru
composer require 'drupal/smsru:^1.0'

# Альтернатива: Twilio
composer require 'drupal/sms_twilio:^1.0'

Функции:
- Регистрация по телефону
- Вход через SMS-код
- Подтверждение заказа

6. МЕССЕНДЖЕРЫ

Telegram

composer require 'drupal/telegram:^2.0'
composer require 'drupal/commerce_telegram:^1.0'

Функции:
- Уведомления о заказах
- Чат-бот для клиентов
- Авторизация через Telegram
- Поддержка через Telegram

WhatsApp

composer require 'drupal/whatsapp:^1.0'

Альтернатива (API):

# Использовать Twilio API для WhatsApp
composer require 'drupal/twilio:^3.0'

Функции:
- Уведомления о заказах
- Чат с клиентами
- Статус заказа

Виджет онлайн-чата

composer require 'drupal/livechat:^1.0'

Альтернативы:
- Jivo Chat
- Bitrix24
- Carrot Quest

7. ДОПОЛНИТЕЛЬНЫЕ МОДУЛИ ДЛЯ МАГАЗИНА

Управление товарами

# Вариации товаров
composer require 'drupal/commerce_variation_cart_form:^2.0'

# Массовые операции
composer require 'drupal/views_bulk_operations:^4.0'

# Импорт/экспорт
composer require 'drupal/commerce_feeds:^1.0'

Маркетинг

# Акции и скидки
composer require 'drupal/commerce_promotion:^2.0'  # Уже в Commerce

# Купоны
# Уже встроено в commerce_promotion

# Email маркетинг
composer require 'drupal/commerce_email:^2.0'
composer require 'drupal/mailchimp:^2.0'

# Программа лояльности
composer require 'drupal/commerce_loyalty:^1.0'

Отзывы и рейтинги

composer require 'drupal/fivestar:^1.0'
composer require 'drupal/votingapi:^3.0'

Сравнение товаров

composer require 'drupal/commerce_compare:^1.0'

Альтернатива:

composer require 'drupal/flag:^4.0'

Избранное (Wishlist)

composer require 'drupal/commerce_wishlist:^3.0'

Быстрый просмотр товара

composer require 'drupal/quicktab:^1.0'
composer require 'drupal/commerce_quick_view:^1.0'

Уведомления о наличии

composer require 'drupal/commerce_stock:^1.0'
composer require 'drupal/commerce_stock_notification:^1.0'

SEO

composer require 'drupal/metatag:^2.0'
composer require 'drupal/pathauto:^1.12'
composer require 'drupal/redirect:^1.9'
composer require 'drupal/simple_sitemap:^4.0'
composer require 'drupal/schema_metatag:^3.0'

Производительность

composer require 'drupal/redis:^1.7'
composer require 'drupal/memcache:^2.5'
composer require 'drupal/cdn:^4.0'

Безопасность

composer require 'drupal/captcha:^2.0'
composer require 'drupal/recaptcha:^3.0'
composer require 'drupal/antibot:^2.0'

Мобильное приложение (опционально)

composer require 'drupal/jsonapi_extras:^3.0'
composer require 'drupal/restui:^1.21'

8. СПЕЦИФИКА ПИРОТЕХНИКИ

Возрастная проверка

composer require 'drupal/age_checker:^2.0'

Настройка:
- Проверка 18+
- Блокировка доступа
- Cookie запоминание

Ограничения по регионам

composer require 'drupal/geofield:^1.52'
composer require 'drupal/geolocation:^3.12'

Функции:
- Определение региона клиента
- Блокировка запрещённых регионов
- Ограничение доставки

Сертификаты и декларации

# Использовать Entity Reference + Media
# Уже есть в Drupal Core

Настройка:
- Поле "Сертификат" (PDF)
- Поле "Декларация соответствия" (PDF)
- Отображение на странице товара

Техника безопасности

composer require 'drupal/pdf:^1.0'

Функции:
- Инструкции PDF
- Видео с YouTube
- Предупреждения

📋 Итоговый список для установки

Минимальный набор (обязательно)

# Доставка
composer require 'drupal/commerce_russianpost:^2.0'
composer require 'drupal/commerce_flat_rate:^1.0'

# Оплата
composer require 'drupal/commerce_tinkoff:^1.0'
composer require 'drupal/commerce_yookassa:^1.0'
composer require 'drupal/commerce_invoice:^2.0'

# Интеграции
composer require 'drupal/yandex_metrics:^2.0'
composer require 'drupal/google_tag:^2.0'
composer require 'drupal/yandex_market:^1.0'

# Авторизация
composer require 'drupal/social_auth:^4.0'
composer require 'drupal/social_auth_vk:^4.0'
composer require 'drupal/smsframework:^2.0'

# Мессенджеры
composer require 'drupal/telegram:^2.0'

# SEO
composer require 'drupal/metatag:^2.0'
composer require 'drupal/pathauto:^1.12'
composer require 'drupal/simple_sitemap:^4.0'

# Маркетинг
composer require 'drupal/commerce_email:^2.0'
composer require 'drupal/fivestar:^1.0'

# Специфика
composer require 'drupal/age_checker:^2.0'
composer require 'drupal/geofield:^1.52'

Расширенный набор (для полноценного магазина)

# Добавить к минимальному:

# Доставка расширенная
composer require 'drupal/commerce_cdek:^1.0'

# Оплата расширенная
composer require 'drupal/commerce_sberpay:^1.0'

# Авторизация расширенная
composer require 'drupal/social_auth_google:^4.0'
composer require 'drupal/social_auth_mailru:^1.0'

# Маркетинг расширенный
composer require 'drupal/mailchimp:^2.0'
composer require 'drupal/commerce_wishlist:^3.0'
composer require 'drupal/commerce_compare:^1.0'
composer require 'drupal/commerce_stock:^1.0'

# Безопасность
composer require 'drupal/recaptcha:^3.0'

# Производительность
composer require 'drupal/redis:^1.7'

🚀 Порядок установки

  1. Базовая установка Kickstart 5 (уже есть на pim.dev)
  2. Доставка и оплата (критичные модули)
  3. Интеграции (Метрика, Маркет)
  4. Авторизация (соцсети, SMS)
  5. Мессенджеры (Telegram, WhatsApp)
  6. Маркетинг (отзывы, купоны)
  7. SEO (мета-теги, карта сайта)
  8. Специфика (18+, регионы)

📊 Оценка размеров

Базовый Kickstart 5:        370 MB
+ Минимальный набор:        +50 MB
+ Расширенный набор:        +100 MB
────────────────────────────────────
Итого готовая сборка:       ~520 MB

🔗 Связанные документы

Создано: 2025-11-16
Автор: Claude Code
Статус: План модулей для разработки