projects/org/ideal-shop/CLAUDE.md

Идеальный магазин

Версия: 2.0.0 (Д2Б)
Дата: 2026-03-23
Тип: solution


Версии

Версия Название Стек Статус
v2 Д2Б Drupal CMS + Bootstrap Barrio + ideal_theme ✅ Активная
v1 Drupal 11 + Preline UI + Tailwind v4 архив (V1-drupal11-preline/)

Что это

Универсальный шаблон интернет-магазина. Самостоятельный проект.
Также используется как основа для конкретных магазинов (pirofey, feyerverk, gipir).


Принципы

  1. Минимализм — только нужное, ничего лишнего
  2. Конверсия — каждый элемент ведёт к покупке
  3. Скорость — быстрая загрузка, PWA
  4. Мобильность — mobile-first
  5. Универсальность — любая категория товаров

Технологии (v2 Д2Б)

Слой Технология
Сборка Drupal CMS (Drupal 11)
Базовая тема Bootstrap Barrio (Bootstrap 5)
Наша тема ideal_theme (дочерняя к bootstrap_barrio)
Магазин Drupal Commerce 3
Фильтры Facets + Search API
Тестирование Playwright

Архитектура (v2 Д2Б)

ideal-shop = ТРЕБОВАНИЯ + ТЕМА

┌─────────────────────────────────────┐
│            ideal-shop               │
├──────────────────┬──────────────────┤
│  docs/           │  V2-drupal11-    │
│  ЧТО нужно       │  КАК делаем      │
│                  │                  │
│  • Чеклист       │  • Drupal CMS    │
│  • Требования    │  • Bootstrap     │
│  • Wireframes    │  • ideal_theme   │
│  • Дизайн        │  • Рецепты       │
└──────────────────┴──────────────────┘
           │
           ▼
┌─────────────────────────────────────┐
│       Конкретные магазины           │
│                                     │
│  • pirofey   (пиротехника, тема A)  │
│  • feyerverk (пиротехника, тема B)  │
│  • gipir     (пиротехника, тема C)  │
└─────────────────────────────────────┘

Структура проекта

projects/ideal-shop/
├── CLAUDE.md                 Ты здесь
├── PROJECT.md                Описание проекта

├── docs/                     ТРЕБОВАНИЯ (что нужно)
   ├── CHECKLIST.md          180 пунктов чеклиста
   ├── DESIGN.md             Дизайн-система
   ├── requirements/         Требования по слоям
      ├── 1-ENGINE.md
      ├── 2-THEME.md
      ├── 3-MODULES.md
      └── 4-SERVICES.md
   ├── wireframes/           Макеты страниц
      ├── HOME.md
      ├── CATEGORY.md
      ├── PRODUCT.md
      ├── CART.md
      └── CHECKOUT.md
   ├── FILTERS.md            Фильтры (sidebar/horizontal)
   ├── UX-DECISIONS.md       UX решения
   ├── LOYALTY.md            Лояльность, бонусы, UGC
   ├── AI-ASSISTANT.md       AI-помощник, guided tour
   ├── CATALOG.md            Каталог
   ├── CUSTOMERS.md          Клиенты, авторизация
   ├── PAYMENTS.md           Оплата
   ├── DELIVERY.md           Доставка
   ├── PROMOTIONS.md         Акции, скидки
   ├── SEO.md                SEO
   ├── ANALYTICS.md          Аналитика
   ├── MARKET-RESEARCH.md    Исследование рынка
   ├── LEGAL.md              152-ФЗ, оферта, cookie
   ├── NOTIFICATIONS.md      Email, SMS, Push
   ├── RETURNS.md            Возвраты и обмен
   ├── PERFORMANCE.md        Core Web Vitals
   ├── SECURITY.md           HTTPS, WAF, защита
   ├── ACCESSIBILITY.md      WCAG 2.1
   ├── SOCIAL.md             OAuth, соцсети, шеринг
   └── conversion/
       └── CONVERSION.md     Конверсия

├── V1-drupal11-preline/      РЕАЛИЗАЦИЯ v1 (архив)
   └── [код и документация Preline + Tailwind]

└── V2-drupal11-bootstrap/    РЕАЛИЗАЦИЯ v2 (активная)
    ├── CLAUDE.md             Навигация темы
    ├── STACK.md              Стек + обоснование
    ├── BUILD-PLAN.md         План сборки
    ├── THEME-SPEC.md         Спецификация темы
    └── RECIPES.md            Drupal рецепты

Чеклист (180 пунктов)

Группа Всего Must Nice
Движок 30 30 0
Тема 60 50 10
Модули 25 5 20
Сервисы 35 20 15
Конверсия 15 10 5
Технические 15 15 0
ИТОГО 180 130 50

Мультисайт

После завершения ideal-shop — Drupal multisite (3 магазина):

Сайт Интерфейс Описание
pirofey A Пиротехника, основной стиль
feyerverk B Пиротехника, альтернативный бренд
gipir C Пиротехника, третий интерфейс
ideal-shop (base theme)
     
     ├── pirofey/      sub-theme A
        └── colors, layout variant A
     
     ├── feyerverk/    sub-theme B
        └── colors, layout variant B
     
     └── gipir/        sub-theme C
         └── colors, layout variant C

Текущая разработка

Проект Стек Статус
ideal-shop v2 Д2Б Drupal CMS + Bootstrap + ideal_theme В разработке
ideal-shop v1 Preline UI + Tailwind архив

Как использовать

  1. Изучить docs/CHECKLIST.md — что нужно
  2. Использовать docs/wireframes/ — как выглядит
  3. Применить V2-drupal11-bootstrap/ — готовая тема Drupal
  4. Создать реализацию в V2-drupal11-bootstrap/

Ссылки

Требования (docs/)

Документ Описание
docs/CHECKLIST.md Полный чеклист
docs/DESIGN.md Дизайн-система
docs/FILTERS.md Фильтры (sidebar/horizontal, range/default)
docs/UX-DECISIONS.md UX решения (header, checkout, mobile)
docs/LOYALTY.md Лояльность (бонусы, подарки, UGC)
docs/AI-ASSISTANT.md AI-помощник (чат, голос, guided tour)
docs/LEGAL.md 152-ФЗ, оферта, cookie, касса
docs/NOTIFICATIONS.md Email, SMS, Push, Telegram
docs/RETURNS.md Возвраты и обмен
docs/SOCIAL.md OAuth, соцсети, шеринг
docs/CUSTOMERS.md Клиенты, авторизация
docs/requirements/ Требования по слоям
docs/wireframes/ Макеты страниц

Реализация (V2-drupal11-bootstrap/)

Документ Описание
V2-drupal11-bootstrap/CLAUDE.md Навигация темы
V2-drupal11-bootstrap/THEME-SPEC.md Спецификация файлов
V2-drupal11-bootstrap/BUILD-PLAN.md План сборки
V2-drupal11-bootstrap/STACK.md Стек + обоснование
V2-drupal11-bootstrap/RECIPES.md Drupal рецепты

Связанные проекты

Проект Описание
drupal-lab Тестовые магазины (не создан)

Версия: 2.0.0
Дата: 2026-03-24