Редактор и версии

Работа до публикации

Текст отправляется через 250 мс после окончания ввода, переключатели — сразу. Сохранения выполняются последовательно: быстрый ввод объединяется, последнее значение не теряется. Статус «Сохранено» появляется после записи в PostgreSQL. Ошибка и конфликт сохраняют введенные данные для повторной попытки.

Товар и каждый вариант имеют отдельный черновик и отдельную публикацию. Показ варианта в каталоге, SEO, медиа и свойства восстанавливаются после открытия редактора. Публикация товара не публикует черновики вариантов. Цены, остатки и движения не участвуют в редакторских версиях.

Сохранение блокирует конкретную карточку, а не перечитывает весь магазин. Черновик и история пишутся одной транзакцией. После публикации надежная очередь обновляет поиск; изменение остатка не пересчитывает векторы.

Просмотр предыдущего значения перестраивает форму в прежнее состояние без перехода на другой товар. Возврат к редактированию сохраняет рабочие изменения. У каждого измененного поля есть кликабельное предыдущее значение, автор и время. Оно раскрывается рядом с полем без изменения текущего значения. Правки AI выделены отдельным цветом; публикация человеком сохраняет авторство AI.

SEO и история адресов

Вкладка SEO содержит title, description, H1, Open Graph, изображение для социальных сетей, canonical и настройку индексации. Используйте шаблоны {name}, {brand}, {category}, {price}, {store}. Для статей доступны {title}, {excerpt} и {author}.

Черновик не меняет метаданные опубликованного товара. Все прежние опубликованные адреса сохраняются и возвращают HTTP 301 сразу на текущий URL без цепочек. Черновые адреса не занимают публичные URL.

Варианты: таблица, поиск и редактирование

Настройка столбцов, их порядок и ширина сохраняются в браузере. Вся строка открывает отдельную страницу варианта. Для перестановки включите отдельный режим: строки перетаскиваются, навигация временно выключена. Есть перенос на заданную позицию с клавиатуры.

Фильтры по свойствам, цене, наличию и характеристикам товара выполняются на сервере. Умный поиск объединяет текстовое ранжирование OpenSearch и реальные векторы multilingual-e5-small (384 измерения). Можно выбрать только поиск по словам или по смыслу. Модель работает локально, данные не отправляются внешнему AI-провайдеру.

Страница варианта сохраняет черновик цвета, размера, фото, SEO и показа в каталоге. Цены и наличие редактируются в собственных разделах. Перед публикацией сервер сравнивает исходный вариант с текущим: чужая правка не затирается. История показывает изменения каждого поля. Фотографию можно загрузить, перетащить или вставить из буфера.

GET /api/v1/admin/products/p-021/variants?mode=hybrid&q=дождевая%20куртка
GET /api/v1/admin/products/p-021/variants/RR-021-1-01
PUT /api/v1/admin/products/p-021/variants/RR-021-1-01/draft
POST /api/v1/admin/products/p-021/variants/RR-021-1-01/publish

Защита совместной работы

baseRevision и draftRevision связывают сохранение с прочитанной версией. Если другой редактор уже изменил документ, сервер возвращает конфликт. Перед повторным сохранением нужно прочитать актуальный документ и согласовать изменения.

GET /api/v1/admin/editor/products/p-028
POST /api/v1/admin/editor/products/p-028

Предпросмотр по UUID

Несохраненные поля можно открыть отдельной вкладкой по ссылке с UUID. Предпросмотр доступен создавшему его администратору в той же сессии, живет до 20 минут и ограничен текущим состоянием стенда.

UUID не заменяет авторизацию. Обычный посетитель карточки видит опубликованный товар, а не рабочие поля редактора.

Загрузка фотографий

Единая форма по интерфейсу Adventure Vibe используется для галереи товара, фото варианта, обложки статьи, магазинов и Open Graph. Выбирайте файлы, вставляйте изображение из буфера, перетаскивайте его или загружайте по полной HTTP(S)-ссылке. Полей с серверными путями нет.

Принимаются JPG, PNG и WebP до 6 МБ и 16 мегапикселей. Галерея вмещает до 40 фотографий. Можно просмотреть полный кадр, удалить его, изменить порядок перетаскиванием или выбрать позицию. Первый кадр становится обложкой. При пакетной загрузке успешные файлы остаются, ошибку можно повторить отдельно.

Изображение по ссылке скачивается в хранилище магазина; доступ к внутренним адресам закрыт. Сохранение карточки ждет завершения загрузки. Неопубликованные фото доступны администраторам, публичные — только пока используются опубликованным контентом текущего сеанса.

Генерация адреса помогает получить читаемый slug. Изменения характеристик, изображений и вариантов проходят через редактор, а результат проверяется на витрине.