DEVLOG — История разработки lideravto-new

Проект: lideravto-new (Drupal 11)
Начало: 2026-02-09
Обновлено: 2026-02-23

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

ПРИНЦИП DEVLOG

После КАЖДОГО значительного изменения записывать:
1. Что сделано
2. Что работает (проверено!)
3. Как откатить

Формат:

## [vX.Y.Z] YYYY-MM-DD HH:MM — Название

СДЕЛАНО:
• Список изменений

РАБОТАЕТ:
✓ Что проверили и работает

ТЕСТЫ:
✓ N/N тестов прошли (если есть)

ОТКАТ:
git checkout vX.Y.Z-1

СОСТОЯНИЯ ПРОЕКТА

ZERO     →  VANILLA  →  WORKING  →  PRODUCTION
Установка   v0.0.0      v0.x.x      v1.0.0+

ИСТОРИЯ

[v0.0.0] 2026-02-09 14:00 — VANILLA (Установка Drupal)

СДЕЛАНО:
• Установлен Drupal 11.3.3 через Composer
• Подключена БД MySQL 8.0.45
• Включена русская локаль
• Базовые модули активированы (locale, dblog)

РАБОТАЕТ:
✓ /admin — админка доступна
✓ / — frontpage показывается
✓ БД подключена и работает
✓ PHP 8.4.6 совместим

ОТКАТ:
Точка отката — VANILLA (v0.0.0)
Если что-то сломается → вернуться сюда

Команда:

git checkout v0.0.0

[v0.1.0] 2026-02-10 16:30 — Модуль Catalog

СДЕЛАНО:
• Создан модуль dru_lider_catalog (284 KB)
• Добавлены entities: Category, Product
• Views для списков категорий и товаров
• Базовые формы управления

РАБОТАЕТ:
✓ /admin/catalog — админка каталога
✓ /catalog — публичный каталог
✓ Создание/редактирование категорий
✓ Создание/редактирование товаров

ТЕСТЫ:
✓ 45/45 тестов прошли

ОТКАТ:

git checkout v0.0.0  # вернуться к чистому Drupal

[v0.2.0] 2026-02-11 10:00 — Модуль Models

СДЕЛАНО:
• Создан модуль dru_lider_models (120 KB)
• Entities: Brand, Model, Modification
• Иерархия: Brand → Model → Modification
• Формы управления моделями

РАБОТАЕТ:
✓ /admin/models — управление моделями грузовиков
✓ Создание брендов (Volvo, MAN, Scania...)
✓ Создание моделей (FH12, TGA...)
✓ Связь Model → Brand работает

ТЕСТЫ:
✓ 35/35 тестов прошли

ОТКАТ:

git checkout v0.1.0

[v0.3.0] 2026-02-11 14:00 — Модуль Compatibility

СДЕЛАНО:
• Создан модуль dru_lider_compatibility (64 KB)
• Entity: CompatibilityRelation (Part ↔ Model)
• Логика поиска совместимых моделей для детали
• Обратный поиск: детали для модели

РАБОТАЕТ:
✓ /admin/compatibility — управление связями
✓ Создание связи Part ↔ Model
✓ Поиск "какие модели подходят для детали X"
✓ Поиск "какие детали подходят для Volvo FH12"

ТЕСТЫ:
✓ 40/40 тестов прошли

ОТКАТ:

git checkout v0.2.0

[v0.4.0] 2026-02-12 09:00 — Модуль Importer

СДЕЛАНО:
• Создан модуль dru_lider_importer (76 KB)
• Импорт Products из CSV
• Импорт Categories из CSV
• Импорт Models из CSV
• CLI команды для Drush

РАБОТАЕТ:
✓ drush import:products products.csv
✓ drush import:categories categories.csv
✓ drush import:models models.csv
✓ Валидация данных перед импортом

ТЕСТЫ:
✓ 30/30 тестов прошли

ОТКАТ:

git checkout v0.3.0
drush sql:drop && drush sql:cli < backup-v0.3.0.sql

[v0.5.0] 2026-02-12 14:00 — Остальные модули

СДЕЛАНО:
• Созданы модули:
- dru_lider_parts (72 KB)
- dru_lider_seo (28 KB)
- dru_lider_setup (20 KB)
- dru_lider_products (16 KB)
- dru_lider_frontend (4 KB)
• Интеграция всех модулей

РАБОТАЕТ:
✓ Все 9 модулей активированы
✓ Связи между модулями работают
✓ SEO мета-теги генерируются

ТЕСТЫ:
✓ 205/205 тестов прошли (все модули)

ОТКАТ:

git checkout v0.4.0

[v0.6.0] 2026-02-12 18:00 — Импорт данных

СДЕЛАНО:
• Импортировано 4626 товаров
• Импортировано 120 категорий
• Импортировано 45 моделей грузовиков
• Импортировано 8500 связей совместимости

РАБОТАЕТ:
✓ /catalog — все товары видны
✓ /catalog/volvo — фильтр по марке
✓ Поиск по совместимости работает
✓ Карточки товаров отображаются

ОТКАТ:

git checkout v0.5.0
drush sql:drop && drush sql:cli < backup-v0.5.0.sql

[v0.6.1] 2026-02-23 — Реорганизация проекта

СДЕЛАНО:
• Реорганизована структура проекта по стандарту
• Документы перемещены в правильные папки
• Создан DEVLOG.md (этот файл)
• Создан it/CLAUDE.md
• Создан it/CACHE.yaml

СТАТУС:
⚠️ Версия не изменилась (v0.6.0)
Только реорганизация файлов, код не менялся

[CURRENT] 2026-03-05 — Данные каталога + документация

СДЕЛАНО:
• Сформирован CATALOG.csv (18 304 строк, 7 брендов, 9 212 OEM)
• Создан parts_dictionary.csv (1 244 canonical names, 1 237 маппингов bazon_name→canonical)
• Создана TAXONOMY.csv (8 систем, 61 узел) — таксономический эталон
• Рефакторинг документации: 40+ файлов, навигация, INDEX.md
• Переработан DESIGN.md v1.1.0 — убран Агрегат, иерархия Марка→Модель→Система→Деталь
• Исправлены все перекрёстные ссылки в документации (0 битых)

РАБОТАЕТ:
✓ CATALOG.csv валиден (OEM нормализован, марки нормализованы)
✓ parts_dictionary.csv — 100% покрытие canonical names
✓ Документация — навигация во всех активных файлах

СЛЕДУЮЩИЕ ШАГИ:
1. Загрузка таксономии в Drupal (drush import:systems, import:nodes)
2. Загрузка моделей грузовиков (drush import:models)
3. Загрузка каталога товаров (drush import:products)
4. Разработка темы (frontend)

КОНТРОЛЬНЫЕ ТОЧКИ

ПРАВИЛА

1. НИКОГДА не править ядро Drupal
2. ВСЕГДА создавать git tag после изменений
3. ЗАПИСЫВАТЬ в DEVLOG после каждого шага
4. ТЕСТИРОВАТЬ перед git tag
5. BACKUP БД перед импортом данных

Текущая версия: v0.6.1 (данные готовы к загрузке)
Следующая: v0.7.0 (загрузка данных в Drupal)

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