ПРАВДА — lideravto (2026-05-14)

Источник истины по проекту. Все окончательные решения, противоречия, нерешённые вопросы.
Составлен на основе: BRIEF.md, REQUIREMENTS.md, DESIGN.md v1.2.0, SITE_STRUCTURE.md v1.1.0,
SKETCH.md v1.0, CATALOG_ARCHITECTURE.md v1.0.0, MODEL_CONTENT.md, MODELS_MENU.csv, MODELS_ALL.csv, TAXONOMY.csv.

1. ОКОНЧАТЕЛЬНЫЕ РЕШЕНИЯ (подтверждённые)

Стек и инфраструктура

Интеграция учётной системы: Bazon (не 1С — 1С помечено устаревшим в DESIGN.md v1.2.0).

Кастомные модули: 9 штук, 684 KB кода, 205/205 тестов. Актуальный состав — на VPS 155.
Список в it/CLAUDE.md: dru_lider_catalog, dru_lider_models, dru_lider_importer, dru_lider_parts,
dru_lider_compatibility, dru_lider_seo, dru_lider_setup, dru_lider_products, dru_lider_frontend.

Иерархия каталога

Принята: две параллельные таксономии (DESIGN.md v1.2.0, REQUIREMENTS.md FR-1.1).

МАШИНЫ:    МАРКА → ПЛАТФОРМА (slug в URL) → МОДЕЛИ-АЛИАСЫ
ЗАПЧАСТИ:  СИСТЕМА → УЗЕЛ → ДЕТАЛЬ   ⏸ не утверждена

Четырёхуровневая иерархия Марка → Платформа → Модель → Система/Узел → Деталь из BRIEF.md (v1.2.0, FR-1.1) — устарела. DESIGN.md помечает её ~~УСТАРЕЛО~~.

Принцип: тип кабины и тип двигателя — атрибуты модели, не уровни URL.

URL структура

Финальная версия: SITE_STRUCTURE.md v1.1.0 (2026-05-13) — эталонный документ.

/zapchasti/ (префикс)

  /{marka}/                                              НАВИГАТОР-БРЕНД
  /{marka}/{platforma}/                                  НАВИГАТОР-ПЛАТФОРМА (nav, не в товарном URL)
  /{marka}/{model}/                                      НАВИГАТОР-МОДЕЛЬ (alias)
  /{marka}/{model}/{sistema}/                            НАВИГАТОР-СИСТЕМА+МОДЕЛЬ
  /{marka}/any/{sistema}/                                НАВИГАТОР-СИСТЕМА (nav)
  /{marka}/any/{sistema}/{uzel}/                         ЛИСТИНГ ПО УЗЛУ
  /{marka}/{model}/{sistema}/{uzel}/                     ЛИСТИНГ УЗЕЛ+МОДЕЛЬ
  /{marka}/{model}/{sistema}/{uzel}/{nazvanie}-{oem}/    КАРТОЧКА (canonical) — 5 уровней
  /{marka}/any/{sistema}/{uzel}/{nazvanie}-{oem}/        КАРТОЧКА ANY — 5 уровней

Карточка — 5 уровней: marka / platforma-или-any / sistema / uzel / nazvanie-oem.
Платформа — в URL карточки. Система и узел — тоже в URL карточки.

ANY-правило:
- 1 деталь + 1 модель → canonical с моделью: /{marka}/{model}/...
- 1 деталь + 2+ модели → canonical ANY: /{marka}/any/...

OEM в URL: при нескольких кросс-номерах — приоритет OEM производителя марки страницы → OEM Bazon → первый по алфавиту. Остальные — в поле кросс-номеров (индексируются).

Максимальная глубина URL: ~60 символов (Mercedes + 5 уровней), соответствует рекомендациям Яндекс/Google.

301 цепочки: максимум 2 хопа. Новый редирект — обновлять все предыдущие на финальный URL.

Таксономия машин

Ключевое различие: Платформа ≠ Модель

В товарном URL идёт MODEL slug (не платформа):

/zapchasti/volvo/fh4/dvigatel/forsunki/nasos-20499340/
/zapchasti/scania/r6/dvigatel/forsunki/nasos-1234567/

Источники:
- Платформы (25 меню-позиций): data/references/MODELS_MENU.csv (колонка url_slug)
- Модели (62+ позиции): data/references/MODELS_ALL.csv (колонки url_slug + canonical_model)

Таблица платформ (MODELS_MENU.csv) → модели под ними (MODELS_ALL.csv):

Правила формирования url_slug (SITE_STRUCTURE.md):
1. Без бренда в слаге (бренд уже в пути URL)
2. Без суффикса -series
3. Буква модели в слаге только если модель самостоятельная (Scania R/G/P одной серии → объединяем)

Alias-страницы: имеют rel=canonical → canonical платформа. Ловят точные поисковые запросы без дублирования контента.

Карточка товара

Привязка: к OEM номеру (canonical). Один OEM = одна карточка.

Типы деталей на одной карточке:
- Б/у деталь (основная)
- Новые/брендовые аналоги (если есть в наличии)
- Аналоги по другим OEM (ссылки)

Обязательные поля:
- OEM номер (canonical, крупно, машиночитаемо)
- Кросс-номера (все видны на странице — SEO)
- Название, артикул (SKU)
- Цена, наличие
- Фото (минимум 1)
- Состояние, гарантия, срок доставки
- Совместимые модели с платформами — критично
- Тип двигателя (если применимо)

Действия: В корзину, Купить в 1 клик, В избранное.

Breadcrumb canonical: Главная / {Марка} / {Платформа} / {Система} / {Узел} / {Название OEM}
Breadcrumb ANY: Главная / {Марка} / {Система} / {Узел} / {Название OEM}

SEO

Приоритет: Яндекс первично, Google вторично (REQUIREMENTS.md, SITE_STRUCTURE.md, DESIGN.md).

Mobile-first: Must Have (не Should Have) — SITE_STRUCTURE.md. Google индексирует мобильную версию как основную.

Шаблоны meta title (SITE_STRUCTURE.md v1.1.0 — финальная версия):

Schema.org: Product+Offer (карточка), ItemList (листинг), BreadcrumbList (все страницы), Organization (главная).

Яндекс e-commerce — обязательные страницы:
- /dostavka/ — доставка и оплата
- /garantiya/ — гарантия
- Юридическое лицо в footer
- Цена + наличие на каждой карточке

Количество SEO-страниц (сейчас): ~9 300 (1 главная + 8 брендов + 25 платформ + 57 моделей-алиасов + 9 212 карточек + 5 доп. страниц).
После утверждения таксономии: ~12 000+.

Интеграции

Bazon (учётная система):
- Импорт остатков и цен Bazon → Drupal
- Импорт новых карточек товаров по OEM номеру
- Синхронизация при обновлении прайса

1С — помечено устаревшим в DESIGN.md v1.2.0. Заменено Bazon.

Заказы и оплата

Флоу: заказал → менеджер подтвердил → клиент оплатил.

Варианты оплаты: онлайн-эквайринг + выставление счёта (безнал, B2B).

Статусы заказа: Новый → Подтверждён → Оплачен → Отгружен → Завершён.

Скидки: учёт скидок для партнёров.

Режимы каталога

Два режима переключаются через конфиг lider_site.settings.yml:

Данные каталога (объём)

2. НЕРЕШЁННЫЕ ВОПРОСЫ ⏸

НВ-1. Таксономия запчастей (КРИТИЧНО)

Таксономия каталога — НЕ УТВЕРЖДЕНА (явно указано во всех документах: DESIGN.md, REQUIREMENTS.md, SITE_STRUCTURE.md).

Данные в TAXONOMY.csv (8 систем / 61 узел) существуют, но список систем для отображения на сайте не согласован.

Открытый вопрос из SKETCH.md:
- Вариант A (7 систем): Двигатель, Навесное ДВС, Трансмиссия, Кабина, Шасси/Подвеска, Электрика, Тормоза + В сборе
- Вариант B (8 систем, старые): Двигатель, Трансмиссия, Шасси, Электрика, Кабина, Спецоборудование, Крепёж, В сборе
- Вариант C (8 новых, рекомендовано в SKETCH.md): Вариант A + Спецоборудование

TAXONOMY.csv содержит: В сборе, Двигатель, Кабина, Крепёж, Спецоборудование, Трансмиссия, Шасси, Электрика (8 групп).

CATALOG_ARCHITECTURE.md v1.0.0 предлагает 14-15 систем (включая Двигатель DC9/DC13 как отдельные, Навесное, Подвеска, Тормоза, Рулевое, Кабина высокая, Кабина спальник, Интерьер). Это существенно расходится с TAXONOMY.csv.

Последствия: заблокированы:
- URL-структура для систем и узлов
- SEO шаблоны для систем/узлов
- Страницы НАВИГАТОР-СИСТЕМА, ЛИСТИНГ-УЗЕЛ
- ~300–3 000 дополнительных SEO-страниц
- Матрица внутренней перелинковки
- Мегаменю (узлы не показаны)

НВ-2. Слаги системы и узла в URL

После утверждения таксономии требуется согласовать URL-слаги систем и узлов.

Пример из SKETCH.md: dvigatel, forsunki
Пример из CATALOG_ARCHITECTURE.md: dvigatel-dc13, navesnoe, kabina-vysokaya

Финального списка нет.

НВ-3. Импорт каталога в Drupal (Фаза 10)

Фаза 10 не завершена:
- Таксономия каталога не загружена (блокировано НВ-1)
- Иерархия машин (Марка → Платформа → Модель) не загружена
- ~13 000–18 304 товаров не импортированы
- Drupal модули не запущены в production

НВ-4. Расширение платформ (PENDING)

В MEMORY.md помечено как ⏸ PENDING — создать expand_platforms.py + CATALOG_EXPANDED.csv.

Архитектурные решения приняты (утверждено):
- URL: scania-5r, volvo-fh4, man-tgx1
- Volvo + Renault T: отдельные бренды, общий товар через 742-prefix
- Mercedes MP2+MP3 / MP4+MP5: отдельные пути → одна товарная страница

Скрипт не написан.

НВ-5. Состав мегаменю (Системы)

DESIGN.md указывает: "Узлы в мегаменю — после утверждения таксономии каталога".

Левая колонка мегаменю (по машинам) — определена в MODELS_MENU.csv.
Правая колонка (по системам) — не определена.

НВ-6. Дизайн (ожидает утверждения оператором)

SKETCH.md v1.0 помечен "На утверждение". Открытые вопросы:
- Системы каталога — финальный список (см. НВ-1)
- Дизайн-направление: оранжевый #e8760a (уже в коде) или красный #e63946 из старых мокапов — рекомендовано оранжевый
- Сайдбар: постоянный или drawer — рекомендован постоянный на desktop / drawer на mobile
- Мегаменю: hover или click — рекомендован hover на desktop / click на mobile

НВ-7. URL для брендовых деталей и аналогов

REQUIREMENTS.md FR-6.2: "⏸ URL для брендовых и аналогов — требует SEO-исследования".

НВ-8. Фильтры сайдбара

REQUIREMENTS.md FR-3.2: "⏸ Состав фильтров — после утверждения таксономии каталога".
Предварительно: Система/Узел (Checkbox), Цена (Range), Наличие (Toggle).

НВ-9. Мегаменю — содержимое для Scania (системы по двигателям)

CATALOG_ARCHITECTURE.md предлагает разделить системы по типу двигателя: Двигатель DC9, Двигатель DC13. Это не согласовано с TAXONOMY.csv (там один раздел Двигатель).

НВ-10. Страница совместимости (P10)

SKETCH.md описывает "Страницу донора / совместимости" (P10). В SITE_STRUCTURE.md и REQUIREMENTS.md этой страницы нет. Статус неясен.

НВ-11. Электрические и новые модели

MODEL_CONTENT.md содержит контент для 12 моделей (электрических/перспективных). Их место в каталоге не определено: нет в MODELS_MENU.csv, нет в MODELS_ALL.csv (кроме косвенных ссылок через cross_platform).

Затронутые модели: Scania Super BEV, Volvo FH Electric, Volvo FM Electric, Mercedes eActros 600, Mercedes GenH2, MAN eTGX, DAF XD Electric, DAF XF Electric, Renault T E-Tech Electric, Iveco eS-Way, Iveco S-Way NP, Liebherr LTM 1230-5.1.

3. ПРОТИВОРЕЧИЯ ⚠️

П-1. Глубина URL карточки товара

Разрешение: SITE_STRUCTURE.md v1.1.0 (2026-05-13) — финальный эталон. 5 уровней.
Более ранние документы (BRIEF.md, REQUIREMENTS.md, DESIGN.md SEO-блок, CATALOG_ARCHITECTURE.md) устарели в части URL.

П-2. Slug для Renault T

Противоречие: MODELS_ALL.csv исправил слаг на t, MODELS_MENU.csv и SITE_STRUCTURE.md остались с renault-t.

Требуется решение: выбрать один slug и синхронизировать все файлы.
- Аргумент за t: бренд уже есть в пути /renault/, поэтому /renault/renault-t/ избыточен (SITE_STRUCTURE.md правило 1)
- Аргумент за renault-t: уже использован в документах и может быть в коде

П-3. Список систем каталога

Противоречие существенное. CATALOG_ARCHITECTURE.md предлагает принципиально иной (детализированный) подход — 14-15 систем против 8 в TAXONOMY.csv.

TAXONOMY.csv — единственный утверждённый эталон (статус "утверждено" в it/CLAUDE.md, it/lider-drupal/data/parts_dictionary.csv синхронизирован). CATALOG_ARCHITECTURE.md — неутверждённое предложение.

П-4. Наличие/отсутствие уровня "Платформа" в URL

Разрешение: Платформа и модель — разные сущности с разными slug-ами.
- Платформа (fh-fm-4) — nav-страница, группирует несколько моделей, не входит в товарный URL
- Модель (fh4, fm4) — входит в товарный URL как {model}
- Формулировки в DESIGN.md ("платформа/slug в URL") вводили в заблуждение — имелась в виду модель.
- Финальная истина: товарный URL = /{marka}/{model-slug}/{sistema}/{uzel}/{nazvanie}-{oem}/

П-5. Иерархия машин (4 уровня vs 2)

Разрешение: DESIGN.md v1.2.0 — более поздний. Платформа = поколение с url_slug. Отдельной "Модели" как URL-уровня нет, есть только алиасы (/fh4/ → /fh-fm-4/).

П-6. CATALOG_ARCHITECTURE.md противоречит SITE_STRUCTURE.md в URL карточки

CATALOG_ARCHITECTURE.md (v1.0.0, 2026-03-10):

/{marka}/{model}/{sistema}/{nazvanie}-{oem}/   (без узла в URL)

SITE_STRUCTURE.md v1.1.0 (2026-05-13):

/{marka}/{model}/{sistema}/{uzel}/{nazvanie}-{oem}/   (с узлом)

Разрешение: SITE_STRUCTURE.md v1.1.0 новее и является финальным эталоном. CATALOG_ARCHITECTURE.md устарел в этой части.

4. ЭТАЛОННЫЕ ДОКУМЕНТЫ

Устаревшие в части URL/иерархии:
- BRIEF.md (URL-формула устарела)
- CATALOG_ARCHITECTURE.md (URL без узла, 14-15 систем не утверждены)
- SEO-блок DESIGN.md v1.1.0 (3-уровневые URL устарели до v1.2.0 + SITE_STRUCTURE.md)

5. ЧТО ДЕЛАТЬ ДАЛЬШЕ

Приоритизированный список, от блокирующих к второстепенным:

Приоритет 1 — Блокирует всё остальное

1.1 Утвердить таксономию запчастей (НВ-1, НВ-2)
- Выбрать: 8 систем из TAXONOMY.csv или 7/8 из SKETCH.md или 14+ из CATALOG_ARCHITECTURE.md
- Утвердить url-слаги систем и узлов
- После этого разблокируются: URL страниц систем/узлов, SEO-шаблоны, мегаменю (системы), ~3 000 SEO-страниц, фильтры сайдбара
- Рекомендация: взять 8 систем из TAXONOMY.csv как основу (данные уже подготовлены), добавить Навесное ДВС (или объединить с Двигателем), уточнить Шасси vs Подвеска vs Тормоза

1.2 Синхронизировать url_slug Renault T (П-2)
- MODELS_MENU.csv: renault-t, MODELS_ALL.csv: t
- Выбрать один и обновить оба файла + SITE_STRUCTURE.md

Приоритет 2 — Требуется для MVP

2.1 Написать expand_platforms.py (НВ-4)
- Архитектурные решения уже приняты
- Создать CATALOG_EXPANDED.csv

2.2 Загрузить таксономию машин в Drupal (Фаза 10)
- drush import:systems, import:nodes, import:models
- 62+ моделей

2.3 Импортировать ~13 000 товаров (Фаза 10)
- drush import:products

Приоритет 3 — Для запуска сайта

3.1 Утвердить дизайн (НВ-6, SKETCH.md)
- Подтвердить оранжевый #e8760a, постоянный сайдбар, hover-мегаменю

3.2 Определить место электрических моделей в каталоге (НВ-11)
- MODEL_CONTENT.md готов (12 моделей)
- Добавить в MODELS_ALL.csv / MODELS_MENU.csv

Приоритет 4 — После MVP

4.1 SEO-исследование для URL брендовых деталей и аналогов (НВ-7)

4.2 Решить вопрос страницы совместимости P10 (НВ-10)

4.3 301 redirects со старого CS-Cart сайта

4.4 1С — фактически исключён (заменён Bazon), но в REQUIREMENTS.md числится как Should Have.

Версия: 1.0.0
Дата: 2026-05-14
Составлен на основе: BRIEF.md v1.2.0, REQUIREMENTS.md v1.1.0, DESIGN.md v1.2.0, SITE_STRUCTURE.md v1.1.0, SKETCH.md v1.0, CATALOG_ARCHITECTURE.md v1.0.0, MODEL_CONTENT.md v1.0, MODELS_MENU.csv, MODELS_ALL.csv, TAXONOMY.csv

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