ДВИЖОК (Engine) — Ядро магазина

Версия: 1.0.0
Дата: 2025-12-06

Принцип

Движок = минимальное ядро, которое нельзя отключить.
Всё остальное — модули или внешние сервисы.

1. КАТАЛОГ

Функции

Лучшие практики

• Slug — ЧПУ для категорий и товаров (/category/product)
• SKU — уникальный код товара/варианта
• Soft delete — не удалять, а архивировать
• Версионирование — история изменений цен/остатков

Структура данных

Category
├── id, slug, name, parent_id
├── image, description
├── position, status
└── seo (title, description)

Product
├── id, slug, name, category_id
├── price, old_price, cost
├── stock, sku, status
├── description, short_description
├── attributes[], variants[]
├── images[], videos[]
└── seo (title, description, keywords)

2. КОРЗИНА

Функции

Лучшие практики

• Гостевая корзина — хранить в cookie/localStorage (30 дней)
• Авторизованная — синхронизация с сервером
• Проверка актуальности — при открытии проверять цены/остатки
• Резервирование — опционально, на этапе checkout

API

POST   /cart/add      {product_id, variant_id, qty}
PATCH  /cart/update   {item_id, qty}
DELETE /cart/remove   {item_id}
GET    /cart          → {items[], total, discount}
POST   /cart/merge    (при авторизации)

3. ЗАКАЗ

Функции

Статусы заказа

new → confirmed → paid → processing → shipped → delivered → completed
         ↓                    ↓
      cancelled           returned

Лучшие практики

• Номер заказа — понятный формат (2025-001234)
• Атомарность — заказ создаётся целиком или не создаётся
• Идемпотентность — защита от дублей
• Аудит — полная история изменений

Структура данных

Order
├── id, number, user_id (nullable)
├── status, created_at, updated_at
├── items[] {product, variant, price, qty}
├── shipping {method, address, cost, tracking}
├── payment {method, status, transaction_id}
├── totals {subtotal, shipping, discount, total}
├── customer {name, phone, email}
└── history[] {status, date, comment, user}

4. ПОЛЬЗОВАТЕЛИ

Функции

Методы авторизации

Лучшие практики

• Phone-first — телефон как основной идентификатор
• Passwordless — SMS/звонок вместо пароля
• Гостевой checkout — покупка без регистрации
• Merge accounts — объединение при конфликте
• GDPR/152-ФЗ — согласие на обработку данных

Структура данных

User
├── id, phone (unique), email
├── name, created_at
├── addresses[] {title, address, city, zip, default}
├── oauth_connections[] {provider, provider_id}
└── settings {notifications, language}

5. ПОИСК (базовый)

Функции

Лучшие практики

• Базовый поиск в движке — простой LIKE или FTS
• Умный поиск — внешний сервис (Elasticsearch, Algolia)
• Индексация — асинхронная, при изменении товара

API

GET /search?q=...&category=...&price_min=...&sort=...
→ {products[], facets{}, total, page}

6. АДМИНКА

Функции

Лучшие практики

• Роли — admin, manager, operator
• Аудит — лог всех действий
• Bulk actions — массовые операции
• Фильтры/поиск — во всех списках

7. API

Принципы

Эндпоинты (основные)

# Каталог
GET    /api/v1/categories
GET    /api/v1/categories/:slug
GET    /api/v1/products
GET    /api/v1/products/:slug

# Корзина
GET    /api/v1/cart
POST   /api/v1/cart/items
PATCH  /api/v1/cart/items/:id
DELETE /api/v1/cart/items/:id

# Заказы
POST   /api/v1/orders
GET    /api/v1/orders
GET    /api/v1/orders/:id

# Пользователи
POST   /api/v1/auth/send-code
POST   /api/v1/auth/verify
GET    /api/v1/profile
PATCH  /api/v1/profile

8. SEO (базовый)

Функции

Лучшие практики

• Шаблоны meta — {product} купить в {city} | {shop}
• Уникальность — проверка дублей title/description
• Редиректы — 301 при изменении URL
• Микроразметка — Product, Offer, AggregateRating

Резюме

Версия: 1.0.0