VARICA
digital proposal bureau
VARICA / Документация v2

Импорт и медиа

В модалке «Создать из КП» можно вставить готовые HTML и CSS. Импорт не должен сразу менять холст: сначала результат становится `pendingImport`, затем пользователь выбирает:

Импорт HTML/CSS

В модалке «Создать из КП» можно вставить готовые HTML и CSS. Импорт не должен сразу менять холст: сначала результат становится pendingImport, затем пользователь выбирает:

  • создать новый шаблон;
  • обновить текущий шаблон.

После выбора импорт попадает в GrapesJS и может редактироваться как обычный шаблон. Для корректного импорта HTML и CSS нужно вставлять совместно: CSS отдельно, HTML отдельно. Готовая верстка должна быть самостоятельной и не рассчитывать на внешние скрипты.

Импорт PDF

PDF проходит конвейер:

  1. извлечение текста встроенным parser;
  2. OCR PDF в Yandex-контуре;
  3. LLM-преобразование в document_template_json по prompt из БД;
  4. рендер document_template_json в HTML/CSS для GrapesJS;
  5. подтверждение сохранения как нового или текущего шаблона.

OCR может не сработать. Тогда сервис использует parser fallback только если parser действительно извлёк текст. Изображения исходного PDF пока не гарантированно становятся активами шаблона автоматически.

Импорт PDF оплачивается как одна операция «Генерация AI»: внутри метаданных операции остаются расходы модели и OCR, но пользователю не показывается техническое дробление.

Загрузка изображений

Изображения загружаются через /api/v1/media/images в хранилище организации. В БД сохраняются путь, MIME-тип, размер и публичный URL. В редакторе эти URL вставляются в компонент изображения или галереи.

Прозрачный PNG остаётся прозрачным. Белый фон изображения — это свойство контейнера или секции, а не файла. Для публичного КП нужно проверять изображение на фактическом фоне шаблона.

Галерея и композиция

  • Галерея использует несколько обычных изображений и должна проверяться как на десктопе, так и на мобильной ширине.
  • Композиция предназначена для наложения изображения и текста. Внутренние слои имеют собственные координаты и порядок; не стоит использовать её для обычной линейной верстки.

Чего импорт не делает

  • не гарантирует пиксельное совпадение с оригинальным PDF;
  • не переносит сторонний JavaScript;
  • не угадывает семантику CRM-масок без явного задания;
  • не делает импортированный HTML автоматически адаптивным на телефоне.

После любого импорта обязательны предпросмотр, проверка мобильной ширины и сохранение отдельной версии шаблона до использования в рассылке.