MODX без документации → Битрикс24: подключились, не переписывая сайт

Сайт на MODX с самописными правками, разработчик недоступен,
документации нет. Проект опубликован обезличенно.

Что было

Классическая ситуация с легаси: сайт работает, приносит заявки и никому
не понятен. Формы собраны сниппетами, часть логики — в чанках, часть —
в файлах, которые правили поверх обновлений. Любой подрядчик на такой проект
отвечает одинаково: «надо переписать».

Переписать — действительно самое простое решение. И самое дорогое:
заказчику нужен был не новый сайт, а чтобы заявки попадали в CRM.

Что сделали

Сначала прочитали, потом трогали

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

Точка подключения вместо переделки

Нашли единственное место, через которое проходят все отправки, и повесили
на него свой обработчик. Существующая логика осталась нетронутой: письма
как уходили, так и уходят. Мы добавили ещё один путь — в CRM, — а не заменили
старый.

Журнал на стороне сайта

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

Оставили инструкцию

Написали короткое описание: где лежит обработчик, как посмотреть журнал,
что делать, если портал сменит вебхук. Следующему подрядчику не придётся
повторять наш путь с самого начала.

Что получилось

• заявки попадают в Битрикс24, сайт при этом не переписан и не переехал;
• работа заняла дни, а не месяцы, и стоила соответственно;
• у заказчика появился журнал, по которому видно каждую заявку;
• решение о переписывании сайта отложено до момента, когда оно
  действительно понадобится, — и будет принято на трезвую голову.

Почему мы про это рассказываем

«Чужой код — не повод переписывать» — не лозунг, а рабочий принцип.
Переписывание перекладывает риск на заказчика: он платит за то, чтобы
получить то же самое, но новое. Иногда это оправдано. Гораздо чаще —
нет, и достаточно найти правильную точку подключения.