architect/templates/arh/ideal-shop/requirements/3-MODULES.md

МОДУЛИ (Modules) — Расширения функций

Версия: 1.0.0
Дата: 2025-12-06


Принцип

Модули = опциональные функции. Можно включить/выключить.
Не влияют на ядро. Расширяют возможности.


1. ПРОМОКОДЫ И СКИДКИ

Функции

Функция Описание
Промокод Код на скидку
Скидка % Процент от суммы
Скидка фикс Фиксированная сумма
Бесплатная доставка Промокод на доставку
Условия Мин. сумма, категории, товары
Лимиты Количество использований
Срок действия Даты начала/окончания

Best Practices

Типы промокодов

Тип Пример Использование
Разовый WELCOME10 1 раз на пользователя
Многоразовый SALE20 Без ограничений
Персональный USER123-ABC Для конкретного клиента
Реферальный REF-IVAN Партнёрская программа

2. ИЗБРАННОЕ (WISHLIST)

Функции

Функция Описание
Добавить Сердечко на карточке
Удалить Из списка избранного
Список Страница избранного
В корзину Из избранного в корзину
Сохранение Для гостей — cookie, для авторизованных — DB

Best Practices


3. СРАВНЕНИЕ ТОВАРОВ

Функции

Функция Описание
Добавить Иконка на карточке
Удалить Из сравнения
Таблица Сравнение характеристик
Лимит Max 4 товара
Только различия Скрыть одинаковые

Best Practices


4. ОТЗЫВЫ И РЕЙТИНГИ

Функции

Функция Описание
Рейтинг 1-5 звёзд
Текст Комментарий
Фото/видео Прикрепление медиа
Модерация Проверка перед публикацией
Ответ магазина Реакция на отзыв
Полезность "Отзыв полезен?"
Фильтры По рейтингу, с фото

Best Practices

Структура

Review
├── rating (1-5)
├── title
├── text
├── pros, cons
├── photos[], videos[]
├── user_id, verified_purchase
├── created_at, status
├── helpful_count
└── reply {text, date}

5. БЫСТРЫЙ ПРОСМОТР (QUICK VIEW)

Функции

Функция Описание
Popup Модальное окно
Содержимое Фото, название, цена, кнопка
В корзину Добавить без перехода
Подробнее Ссылка на полную страницу

Best Practices


6. ВАРИАНТЫ ТОВАРА

Функции

Функция Описание
Атрибуты вариантов Размер, цвет, объём
SKU на вариант Уникальный код
Цена на вариант Может отличаться
Остаток на вариант Отдельный учёт
Фото на вариант Своя галерея

Best Practices

Типы отображения

Атрибут Отображение
Цвет Цветные кружки
Размер Кнопки (S, M, L)
Объём Dropdown (100мл, 200мл)
Комплектация Radio buttons

7. ПОХОЖИЕ И СОПУТСТВУЮЩИЕ ТОВАРЫ

Типы рекомендаций

Тип Описание Где показывать
Похожие Те же характеристики Страница товара
Сопутствующие Часто покупают вместе Страница товара, корзина
Недавно просмотренные История Везде
Хиты Популярные Главная, категория
Персональные На основе истории Главная

Best Practices


8. УВЕДОМЛЕНИЕ О НАЛИЧИИ

Функции

Функция Описание
Подписка Email/телефон
Уведомление При поступлении
Отписка Одним кликом

Best Practices


9. БОНУСНАЯ ПРОГРАММА

Функции

Функция Описание
Начисление % от покупки
Списание Оплата баллами
Баланс В личном кабинете
История Начисления/списания
Уровни VIP-статусы
Срок действия Сгорание баллов

Best Practices


10. МУЛЬТИВАЛЮТА

Функции

Функция Описание
Выбор валюты RUB, USD, EUR
Курс Ручной или ЦБ
Пересчёт Все цены в выбранной
Сохранение Cookie/профиль

Best Practices


11. МУЛЬТИЯЗЫЧНОСТЬ (i18n)

Функции

Функция Описание
Интерфейс Переводы UI
Контент Товары, категории
URL /en/product или product?lang=en
hreflang SEO для языков

Best Practices


12. ВИДЕО ТОВАРА

Функции

Функция Описание
YouTube embed Внешнее видео
Native video Загрузка на сервер
Галерея Вместе с фото
Autoplay При наведении (muted)
Preview Превью кадр

Best Practices


13. PWA (Progressive Web App)

Функции

Функция Описание
manifest.json Метаданные приложения
Service Worker Кэширование, офлайн
Установка "Добавить на главный экран"
Push-уведомления Браузерные нотификации
Offline-режим Работа без сети

Best Practices

Что кэшировать

Ресурс Стратегия
Статика (CSS, JS, шрифты) Cache First
Изображения Cache First
API (каталог) Network First
API (корзина) Network Only

14. УМНЫЙ ПОИСК

Функции

Функция Описание
Autocomplete Подсказки при вводе
Исправление опечаток "салфетки" → "салютики"
Синонимы "телефон" = "смартфон"
Поиск по атрибутам Цвет, размер, бренд
Поиск по SKU Артикул
Голосовой Speech-to-text
Популярные запросы Подсказки

Реализация

Движок Описание Когда использовать
PostgreSQL FTS Встроенный До 10к товаров
Elasticsearch Мощный, гибкий 10к+ товаров
Algolia SaaS, быстрый Любой объём
Meilisearch Open-source альтернатива 10к+ товаров
Typesense Open-source, быстрый 10к+ товаров

Best Practices


Резюме

Модуль Приоритет Сложность
Промокоды Высокий Средняя
Избранное Средний Низкая
Сравнение Низкий Средняя
Отзывы Высокий Средняя
Quick View Низкий Низкая
Варианты товара Высокий Высокая
Рекомендации Высокий Средняя
Уведомление о наличии Средний Низкая
Бонусная программа Средний Высокая
Мультивалюта Низкий Средняя
Мультиязычность Низкий Высокая
Видео товара Средний Низкая
PWA Высокий Средняя
Умный поиск Высокий Высокая

Версия: 1.0.0