CLAUDE.md

Тип: IT (e-commerce)
Платформа: Drupal 11.3.3 + Commerce 3.x
Статус: development
Обновлено: 2026-03-04

ЧТО ЭТО

IT-реализация интернет-магазина запчастей для грузовых автомобилей.

Задача: Замена устаревшего CS-Cart 4.x на современный Drupal 11 с сохранением всех функций + новые возможности (совместимость деталей с моделями грузовиков).

СТРУКТУРА

it/
├── CLAUDE.md              ← Ты здесь (IT контекст)
├── CACHE.yaml             ← Кеш данных для быстрого доступа
│
├── euroauto/              ← ⭐ ПОДПРОЕКТ: Парсинг euroauto.ru
│   ├── CLAUDE.md             Контекст подпроекта
│   ├── docs/                 ТЗ, анализ, иерархия
│   ├── scripts/              scraper.py v8, build.py
│   └── data/                 README (данные в S3)
│
├── design/                ← ПРОЕКТИРОВАНИЕ
│   ├── BRIEF.md              Краткое ТЗ
│   ├── REQUIREMENTS.md       Детальные требования
│   ├── DESIGN-analysis.md    Анализ решений
│   └── DESIGN.md             Архитектура решения
│
├── docs/                  ← ДОКУМЕНТАЦИЯ (техническая)
│   ├── site/                 Drupal: модули, деплой
│   ├── catalog/              Каталог: OEM, совместимость, именование
│   ├── oem/                  Архивные OEM документы → arh/
│   ├── import/               Импорт: алгоритм, ТЗ, гайд
│   └── arh/                  Архив устаревших документов
│
├── data/                  ← ДАННЫЕ
│   ├── CATALOG.csv           Основной каталог (18 304 строк)
│   ├── CATALOG_OEM.csv       Агрегат OEM (9 212 уникальных)
│   ├── parts_rename_working.csv  Маппинг bazon_name → canonical (1 237 строк)
│   ├── references/           ⭐ ЭТАЛОННЫЕ СПРАВОЧНИКИ
│   │   ├── TAXONOMY.csv          Таксономия каталога (8 систем / 61 узел)
│   │   ├── MODELS_MENU.csv    Отображение моделей грузовиков
│   │   ├── MODELS_ALL.csv  62 модели с платформами и группами совместимости
│   │   ├── COMPATIBILITY_GROUPS.csv  32 группы совместимости (PLT/ENG/CAB)
│   │   └── part_names_mapping.csv  Маппинг наименований
│   └── sources/              Исходные данные (CSV, схемы)
│
├── scripts/               ← СКРИПТЫ ОБРАБОТКИ
│   ├── parse_prices.py
│   ├── clean_data.py
│   └── ... (8 скриптов)
│
├── lider-drupal/          ← DRUPAL ПРОЕКТ
│   ├── LOG.md                История разработки (версии)
│   ├── README.md             Описание проекта
│   ├── .credentials.md       Доступы (НЕ в git)
│   ├── data/
│   │   └── parts_dictionary.csv  ⭐ Импорт Drupal: canonical names (1 244 строк)
│   ├── app/                  Production
│   ├── dev/                  Development
│   ├── tst/                  Testing
│   └── prd/                  Pre-production
│
└── testing/               ← ТЕСТИРОВАНИЕ
    ├── GUIDE-testing.md
    └── GUIDE-testing-results.md

СТЕК ТЕХНОЛОГИЙ

МОДУЛИ (9 кастомных)

ДАННЫЕ

Компонент	Технология	Версия
Backend	Drupal	11.3.3
E-commerce	Commerce	3.x
PHP	PHP	8.4.6
Database	MySQL	8.0.45
Frontend	Twig + Custom CSS	—
Сервер	@beget.server	Shared hosting

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

Объём:
- 18 304 строк в CATALOG.csv
- 9 212 уникальных OEM (CATALOG_OEM.csv)
- 62 модели грузовиков
- 2 907 OEM с совместимостью 2+ моделей (URL /any/)
- 2 599 OEM с кросс-номерами (28%)

Источники:
- Bazon прайс (CSV, основа каталога)
- CS-Cart старый сайт (БМ_ совместимость — добавлена)
- Ручная классификация

ТЕКУЩИЙ ФОКУС

Последние работы:
- 2026-03-05: ✅ Рефакторинг lider-drupal/ — навигация, версии, очистка (PHP 8.4, 9 модулей)
- 2026-03-04: ✅ Санация документации — GLOSSARY.md, реорганизация docs/, 97 ссылок исправлено
- 2026-03-03: ✅ Таксономия каталога утверждена (TAXONOMY.csv — 8 систем / 61 узел / 0 дублей)
- 2026-03-03: ✅ parts_dictionary.csv синхронизирован (1 244 строки, 100% покрытие)
- 2026-02-28: BRAND_COMPATIBILITY.md + DATA_BUILD_GUIDE.md
- 2026-02-27: Парсинг БМ_ совместимости (+4 683 строк), нормализация марок
- 2026-02-26: OEM_STANDARDS.md v1.1, правило ANY, рефакторинг URL-архитектуры
- 2026-02-12: Создание 9 модулей (205/205 тестов ✅)

СЕРВЕРЫ

КЛЮЧЕВЫЕ ДОКУМЕНТЫ

Проектирование

Каталог, OEM, совместимость

Данные и импорт

Парсинг euroauto.ru

Сайт и шаблоны

Таксономия (источники истины)

Структура таксономии

Среда	URL	Статус
Development	http://new.lideravto.ru	Active
Production (target)	http://lideravto.ru	Планируется миграция

8 систем: В сборе | Двигатель | Трансмиссия | Шасси
          Электрика | Кабина | Спецоборудование | Крепёж
61 узел, 0 дублей, 100% покрытие parts_rename

Устаревшие документы иерархии → docs/arh/superseded/

lideravto-new — IT направление