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

Кнопка «сохранить HTML» не решает весь вопрос. Редактор может случайно убрать ссылку действия, вставить неподдерживаемую переменную или изменить адрес назначения. Разделите черновик и опубликованную редакцию, а для очереди определите, какую версию она использует. Иначе письмо, поставленное в очередь вчера, неожиданно получит сегодняшний незавершённый текст.

Согласуйте полномочия по элементам письма

ЭлементДопустимое управление
Заголовок и пояснениеТекст в пределах задачи письма
Имя клиентаРазрешённая переменная с определённым fallback
Ссылка подтвержденияСоздаётся приложением, редактор меняет подпись кнопки
Получатель и FromПолитика отправителя, не содержимое шаблона
Служебные блокиУдаление только по утверждённому правилу

Описывайте переменные как небольшой контракт: тип, обязательность и допустимый способ отображения. Если нет необязательного имени, текст должен остаться естественным. Если отсутствует обязательная ссылка, публикация или сборка останавливается с объяснением. Нельзя отправлять письмо с видимым маркером переменной или пустой кнопкой в надежде исправить это на стороне клиента.

Шаблонизатор не становится безопасным от одной галочки

Twig 3 документирует sandbox с политикой разрешённых тегов, фильтров, функций и доступа к объектам. Документация проверена 21 октября 2026 года. Для собственного редактора это означает необходимость явного ограничения возможностей; sandbox не заменяет контроль переданных данных, ресурсов и бизнес-смысла ссылок. Используйте поддерживаемую версию движка и его актуальные рекомендации.

Условный контракт редактора:
разрешены: текст, изображение из разрешённого источника, кнопка
переменные: display_name, action_label
action_url: создаётся доверенным приложением
черновик -> проверка -> предпросмотр -> опубликованная версия
worker -> фиксированная версия + разрешённый набор данных

Не передавайте шаблону весь объект пользователя, контейнер сервисов или произвольные методы модели. Даже если интерфейс показывает несколько полей, сервер должен самостоятельно ограничивать вход. Экранирование данных выбирают по контексту вывода; разрешение raw-HTML для имени клиента не является способом сохранить красивое форматирование.

Проверяйте выпуск на наборе крайних данных

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

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

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

Проверенные источники