DESIGN — lideravto-new

Версия: 1.1.0
Дата: 2026-03-05
Платформа: Drupal 11.3.3 + Commerce 3.x

Архитектура системы

Технический стек

Компонент	Технология	Версия
CMS	Drupal	11.3.3
E-commerce	Commerce	3.x
PHP	PHP	8.4.6
База данных	MySQL	8.0.45
Web Server	nginx	—
Hosting	Beget	shared

Архитектура каталога

Концепция навигации

Главная идея: Пользователь знает марку своего грузовика → начинает с неё

Три входа в каталог

Вход	Для кого	Путь
По марке	Владельцы, новички	Главная → Volvo → Модель → Система → Деталь
По системам	Опытные, СТО	Главная → Все системы → Система → Деталь
Поиск OEM	Профи	Поиск "20499340" → Товар

Иерархия (4 уровня)

МАРКА (taxonomy: brands)
  └─→ МОДЕЛЬ (taxonomy: models)
       └─→ СИСТЕМА (taxonomy: systems)
            └─→ ДЕТАЛЬ (content type: product)

Пример:
Volvo
  └─→ 4-FH
       └─→ Двигатель
            └─→ Амортизатор передний (OEM 20499340)

Узлы (61 шт.) — уточняющий уровень внутри систем, используется для фильтрации в sidebar. Не входит в URL.

┌─────────────────────────────────────────────────────────────────┐
│ БРЕНДЫ ГРУЗОВИКОВ          СИСТЕМЫ АВТОМОБИЛЯ    ПОПУЛЯРНОЕ     │
├────────────────────────┬───────────────────┬───────────────────┤
│                        │                   │                   │
│ 🚛 Volvo (58)          │ 🔧 Кабина         │ 🔥 Амортизаторы   │
│ 🚛 MAN (45)            │ ⚙️  Двигатель     │ 🔥 Турбины        │
│ 🚛 Scania (42)         │ 🔩 Трансмиссия    │ 🔥 Фары           │
│ 🚛 DAF (38)            │ 🛞 Шасси          │ 🔥 Тормозные диски│
│ 🚛 Mercedes-Benz (35)  │ 🛑 Электрика      │                   │
│ 🚛 Renault (28)        │ ⚡ Охлаждение     │ 📋 Все категории  │
│ 🚛 Iveco (22)          │ 🧊 В сборе        │                   │
│                        │                   │                   │
│ 📋 Все бренды          │ 📋 Все системы    │                   │
└────────────────────────┴───────────────────┴───────────────────┘

Модули (9 кастомных)

Список модулей

Модуль	Размер	Назначение
dru_lider_catalog	284 KB	Каталог товаров (Categories, Products)
dru_lider_models	120 KB	Модели грузовиков (Brand, Model, Modification)
dru_lider_importer	76 KB	Импорт из CSV
dru_lider_parts	72 KB	Запчасти + совместимость
dru_lider_compatibility	64 KB	Матрица совместимости деталь-модель
dru_lider_seo	28 KB	SEO (мета-теги, redirects)
dru_lider_setup	20 KB	Настройка окружения
dru_lider_products	16 KB	Расширение Commerce Product
dru_lider_frontend	4 KB	Frontend компоненты

Граф зависимостей модулей

dru_lider_setup (базовая настройка)
    ↓
dru_lider_catalog ← dru_lider_models
    ↓                      ↓
dru_lider_products   dru_lider_parts
    ↓                      ↓
    └─→ dru_lider_compatibility ←┘
             ↓
        dru_lider_seo
             ↓
        dru_lider_importer
             ↓
        dru_lider_frontend

Модель данных

Сущности

Brand (Taxonomy)

Марка грузовика (Volvo, MAN, Scania, ...)

Поле	Тип	Описание
tid	int	ID
name	string	Название (Volvo)
weight	int	Сортировка

Model (Taxonomy)

Модель грузовика (4-FH, TGX, R6, ...)

Поле	Тип	Описание
tid	int	ID
name	string	Название (4-FH)
brand	reference	Марка
platform	string	Платформа (4-series)

System (Taxonomy)

Система автомобиля (Двигатель, Трансмиссия, Кабина, ...)

Поле	Тип	Описание
tid	int	ID
name	string	Название (8 систем)
icon	string	Иконка

Node (Taxonomy)

Узел внутри системы (61 узел) — для фильтрации

Поле	Тип	Описание
tid	int	ID
name	string	Название
system	reference	Система

Product (Commerce Product)

Товар/деталь

Поле	Тип	Описание
product_id	int	ID
title	string	Название
sku	string	Артикул
oem	string	OEM номер
price	decimal	Цена
system	reference	Система
node	reference	Узел (уточнение)
compatible_models	reference[]	Совместимые модели

Фильтрация и поиск

Обоснование: Много фильтров (марка, модель, платформа, система, узел, поставщик, склад)

Типы фильтров

Фильтр	Тип	Формат
Марка	Checkbox	☑ Volvo (58)
Модель	Checkbox	☑ 4-FH (12)
Система	Checkbox	☑ Двигатель (45)
Узел	Checkbox	☑ Турбокомпрессор
Цена	Range	[500]──[10000]
Склад	Checkbox	☑ СПб (78)

Три режима поиска

1. УМНЫЙ ПОИСК (default):
   "амортизатор volvo" → продукты + категории + марки

2. ПОИСК ПО OEM:
   "20499340" → точное совпадение → карточка товара

3. ПОИСК ПО АРТИКУЛУ:
   "BAZON-2049" → поиск в SKU

SEO

Структура URL

/zapchasti/                                                      # каталог
/zapchasti/volvo/                                                # марка
/zapchasti/volvo/4-fh/                                           # модель
/zapchasti/volvo/4-fh/dvigatel/                                  # система
/zapchasti/volvo/4-fh/dvigatel/amortizator-20499340/             # товар

# ANY-правило (деталь совместима с 2+ моделями одного бренда):
/zapchasti/volvo/any/dvigatel/amortizator-20499340/

Мета-теги (шаблоны)

Марка:
  Title: "Запчасти {Brand} для грузовых автомобилей | Лидер Авто"
  Description: "Каталог запчастей для грузовиков {Brand}. {Count} товаров в наличии."

Модель:
  Title: "Запчасти {Brand} {Model} | Лидер Авто"
  Description: "Запчасти для {Brand} {Model}. {Count} товаров."

Система:
  Title: "{System} для {Brand} {Model} | Лидер Авто"
  Description: "Запчасти категории {System} для {Brand} {Model}. {Count} товаров."

Товар:
  Title: "{Title} OEM {OEM} для {Models} | Лидер Авто"
  Description: "Купить {Title}. OEM {OEM}. Совместимо с {Models}. Цена от {Price} руб."

Интеграции

1С (планируется)

Синхронизация товаров (двусторонняя)
Остатки (1С → Drupal)
Заказы (Drupal → 1С)

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

Родительские:
- BRIEF.md — техническое задание
- REQUIREMENTS.md — требования к системе
- DESIGN-analysis.md — анализ технических решений

Детали реализации (архив):
- ../docs/arh/superseded/CATALOG_ARCHITECTURE.md — детальная архитектура каталога (устарело)
- ../docs/arh/DESIGN_DESIGN-analysis.md — анализ UX решений
- ../docs/arh/COMPATIBILITY_SOLUTION.md — система совместимости
- ../docs/arh/IMPORT_ARCHITECTURE.md — система импорта

Реализация:
- ../lider-drupal/LOG.md — история разработки
- ../lider-drupal/README.md — Drupal проект

Версия: 1.1.0

← Назад в оглавление