Table of Contents
This file contains ambiguous Unicode characters
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
Визуальный конструктор email-рассылок. Позволяет собирать письма из Pug-блоков, рендерить в HTML с инлайнингом CSS, управлять несколькими проектами с разными шаблонами и фидами товаров.
Ссылки
- Приложение: app.aspekter.ru
- Coin Scout: coins.aspekter.ru
- Репозиторий: git.aspekter.ru/s.zotov/aspekter
Компоненты системы
| Компонент | Технология | Описание | Порт |
|---|---|---|---|
| z51-pug-builder | Svelte 5 + Vite 7 | SPA — визуальный редактор писем + API сервер | 5173 (контейнер) → 5175 (хост) |
| email-gen-api | Node.js 20 | HTTP-обёртка для рендерера Pug→HTML через email-templates + Juice | 8787 |
| coin-scout | Node.js 20 | Отдельный сервис подбора монет из YML-фидов | 5180 |
| nginx | 1.24 (хост) | Reverse proxy, SSL termination, раздача статики (картинки) | 80/443 |
Технологический стек
- Frontend: Svelte 5, Vite 7, моноширинный шрифт для Pug-редактора
- Backend API: Vite middleware в
vite.config.js(CRUD, авторизация, фиды, FTP, аудит) - Рендер писем: Pug → email-templates → Juice CSS inlining → HTML
- Хранение данных: JSON-файлы на диске (Docker volume)
- Авторизация: Cookie sessions, scrypt, роли admin/user
- Деплой: Docker Compose, Nginx на хосте, Let's Encrypt SSL
- Сервер: Ubuntu 24, VPS (2 GB RAM, 38 GB SSD)
Проекты
Каждый проект — независимая папка в data/ со своими блоками, настройками, письмами, фидами:
| Проект | Описание | Фид товаров | Хранение картинок |
|---|---|---|---|
| Реаспект | Агентство digital-маркетинга | — | SFTP selcdn.ru |
| AT (numizm.at) | Нумизматика | Mindbox YML (win-1251) | SFTP selcdn.ru |
| numizmatRU | Нумизматика | Mindbox YML (win-1251) | SFTP discobombulator.ru |
| z51 | Игровые кресла/столы | RetailCRM API | SFTP (z51.ru) |
| КБ (coinsbolshov) | Нумизматика | Mindbox YML (UTF-8) | SFTP selcdn.ru |
Возможности
- Сборка писем из Pug-блоков drag-and-drop
- Цветовые темы блоков (синий/белый/зелёный для Реаспект)
- Авто-подбор товаров из YML-фидов с учётом страны, серии, материала, цены
- Пометка недавно использованных товаров (красный 0-15 дней, жёлтый 15-25 дней)
- Типограф Лебедева, Яндекс.Спеллер
- Подсветка двойных пробелов при копировании из Figma
- Превью письма в iframe 600px
- Копирование HTML (as-is и очищенный)
- FTP/SFTP загрузка картинок + локальное хранение
- Пресеты (сохранённые сборки блоков)
- История изменений писем
- Календарь рассылок (план)
- Многопользовательский режим с ролями
- Аудит-логи всех действий
- Интеграция с Google Sheets
Страницы wiki
- Архитектура — структура проекта, потоки данных, модули
- Деплой — сервер, Docker, SSL, обновление, DNS
- API — полный список endpoints
- Безопасность — Pug injection, конкурентность, аудит
- Пользователи — роли, права, управление, аудит
- Блоки и парсинг — как работают блоки, schema, миксины
- Товары и фиды — авто-подбор, замена, кэш