Table of Contents

Aspekter VA — Визуальный конструктор email

Навигация по документации
Стек технологий
Быстрый старт

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Aspekter VA — Визуальный конструктор email

Внутренний инструмент для сборки email-рассылок VipAvenue. Позволяет собирать письма из готовых блоков, рендерить Pug-шаблоны в HTML, управлять рассылками через интеграцию с Yonote, загружать картинки на FTP/SFTP, проверять орфографию и ссылки.

Навигация по документации

Раздел	Описание
Архитектура	Структура проекта, цепочка рендера, хранение данных
Блоки и шаблоны	Типы блоков, поля, схемы, шаблоны, кастомные блоки
Гендерная сегментация	Жен/Муж версии, flip, swapCenter, ID pool
Рендер и постобработка	PUG→HTML, кэш, Mindbox, nowrap, preheader
Фид товаров	YML-фид, кэш, подстановка Mindbox-тегов, замена товаров
FTP/SFTP галерея	Загрузка картинок, галерея, автонумерация
План рассылок	Yonote интеграция, календарь, карточка сборки
Редактор хедера/футера	Парсинг pug, редактирование кнопок и ссылок
Проверки качества	Спеллчекер, проверка ссылок, типограф
Пользователи и безопасность	Авторизация, роли, аудит, защита от инъекций
API Reference	Полный список эндпоинтов бэкенда
Docker и деплой	Контейнеры, volumes, сборка, деплой на сервер
Frontend State	Все переменные состояния, localStorage, cookies
Парсинг и утилиты	Библиотека parsing.js — разбор Pug, миксинов, секций

Стек технологий

Frontend: Svelte 5 (SPA, один файл App.svelte ~6500 строк)
Backend: Vite 7 middleware plugin (vite.config.js ~1600 строк) — НЕ Express/Koa, а встроенный в Vite
Шаблоны: Pug (email-gen — репозиторий коллег)
Рендер: email-gen-api — отдельный микросервис на Node.js (порт 8787)
Хранение: файловая БД (JSON-файлы в data/)
Деплой: Docker, nginx, Let's Encrypt
Сервер: Timeweb Cloud VPS, Ubuntu 24.04
Домен: va.aspekter.ru

Быстрый старт

git clone https://git.aspekter.ru/s.zotov/va-aspekter.git
cd va-aspekter
docker compose up -d
# Открыть http://localhost:6001
# Пароль admin — в логах: docker logs vaaspekter-builder-1 2>&1 | grep "Временный пароль"