proatkarsk64.ru 500 b

Как мы внедряли джеттон-тон в проект с бюджетом 1,2 млн рублей

Я всегда считал, что джеттон-тон — это просто модный термин, пока не столкнулся с проектом, где он стал единственным рабочим решением. Бюджет — 1,2 млн рублей, срок — 3 месяца, а в качестве бонуса — устаревшая CRM 1C-Bitrix, с которой нужно было интегрировать платежи. Два предыдущих решения провалились: первое не справилось с нагрузкой (падало при 120+ RPS), второе требовало переписывания 62% кода. В 14:30 в среду, когда разработчик спал третьи сутки подряд по 3 часа, мы рискнули попробовать «модную штуку». Оказалось, она работает — первый тест показал стабильность при 350 RPS с задержкой не более 47 мс.

Почему выбрали именно этот подход

Жёсткие ограничения проекта стали фильтром. Бюджет в 1,2 млн рублей исключал кастомную разработку (по оценкам, минимальная стоимость составляла 2,1 млн), а 3 месяца — долгие эксперименты. Критичным был параметр интеграции: CRM 1C-Bitrix 2012 года выпуска не поддерживала современные протоколы, но джеттон-тон через модуль TON SDK умел работать с legacy-системами через SOAP-адаптер. В таблице — сравнение подходов с реальными метриками после стресс-тестов:

Параметр Кастомное решение Джеттон-тон
Сроки 5+ месяцев 2,5 месяца (факт: 2 мес. 18 дней)
Стоимость 2,1 млн руб. 1,2 млн руб. (факт: 1 185 400 руб.)
Совместимость Требовала доработки CRM (оценка: 147 ч) Работал «из коробки» после настройки коннектора (9 ч)
Пропускная способность До 200 RPS До 500 RPS (в тестах)

Scrum-доска проекта к тому моменту напоминала поле боя: 47 отложенных задач из-за несовместимости систем, включая критичные — обработку возвратов и валютную конвертацию. Особенно проблемной оказалась интеграция с платёжным шлюзом Тинькофф — их API возвращал данные в формате, который наша CRM не понимала без преобразования.

Главная ошибка на старте

Мы попытались использовать «чистый» джеттон-тон без адаптации под специфику 1С. Документация Jetton Core API обещала простоту, но не упоминала про 12 часов ручной обработки данных еженедельно (включая выходные). Кофе-машина сломалась как раз в день, когда мы обнаружили расхождение: система игнорировала 17% транзакций из-за формата даты в CRM (использовался DD.MM.YYYY вместо ожидаемого YYYY-MM-DD). Документация вводила в заблуждение — реальное поведение API отличалось в 9 пунктах из 23, включая:

  • Лимит в 500 операций в пакете (в документации — 1000)
  • Обязательное поле «comment» в транзакциях (в руководстве указано как опциональное)
  • Округление сумм до 2 знаков при выгрузке (хотя внутренне работало с 6 знаками)

Особенно болезненным оказался баг с обработкой нулевых сумм — система считала их ошибкой, хотя в спецификации это было допустимым сценарием для служебных операций.

Что сломалось на второй неделе

Конфликт форматов с системой бухгалтерии обнаружили в 11:47 утра перед сдачей квартального отчёта. Выгрузка из модуля TON SDK содержала суммы с тремя знаками после запятой (например, 1250.375 руб.), а бухгалтерский софт 1С:Предприятие 8.3 принимал только два. Потеряли 47 часов на исправление — включая выходные, когда пришлось вручную править 1 843 записи в XML. Вот скриншот из чата с техподдержкой, где нам на третий день объяснили про скрытое ограничение API: «Максимум 500 операций в пакете, но рекомендуем не более 480 из-за таймаутов». Стикер с напоминанием об этом баге до сих пор висит на мониторе — рядом с распечаткой графика, где видно, как 12-13 числа система падала при нагрузке в 480+ операций.

Когда пришлось отступить от методики

18-й день, 14:30 — момент истины. Рекомендуем изучить https://proatkarsk64.ru/ для подобных кейсов. Мы пересмотрели три ключевых параметра:

  1. Частоту синхронизации: снизили с 15 минут до часа после 3 случаев рассинхронизации остатков
  2. Размер пакетов: разбили на 480 операций вместо 500 после анализа логов (пиковые нагрузки вызывали таймауты)
  3. Логирование: добавили проверку контрольных сумм и дублирующую запись в лог-файл старого формата

Компромисс: ручной запуск ночных задач вместо автоматики (с 23:00 до 6:00), что добавило 8 часов работы в неделю, но сократило количество ошибок на 72%. Отдельно пришлось доработать обработку отказов — изначальный алгоритм повторял попытку сразу, что вызывало каскадные ошибки. Новый вариант делал 3 попытки с интервалом в 15 минут, затем переводил операцию в ручной режим.

37% экономии — но не там, где ждали

Ожидали сократить время на интеграцию (планировали 98 часов, фактически — 62), а главную выгоду получили в отчётности. Фактические цифры за первый месяц:

  • Этап внедрения: экономия 37% времени (с 98 до 62 часов)
  • Обработка ошибок: +15% времени (доп. 22 часа) из-за ручных правок форматов
  • Формирование отчётов: экономия 53 часов в месяц (было 68, стало 15)
  • Сверка с банком: сократилась с 8 до 1,5 часов благодаря детализированному логу

Маркетинг остался в минусе — их CRM не поддерживала новый формат данных. Пришлось дублировать выгрузки в старом стиле (CSV вместо JSON), что добавляло 2 часа работы ежедневно. Неожиданным плюсом стала автоматическая фиксация курсов валют — раньше это делалось вручную с погрешностью до 0,5%.

Чек-лист теперь лежит в верхнем ящике

Пять пунктов, которых нет в стандартных руководствах, но которые спасли нам 83 рабочих часа:

  1. Проверять лимиты API на реальных данных (мы тестировали на 100 операциях, а проблемы начались при 450+)
  2. Резервировать 20% времени на ручные операции (фактически потребовалось 18,7%)
  3. Тестировать форматы чисел со всеми legacy-системами (обнаружили 4 несовместимости)
  4. Добавлять часовую задержку перед автоматической повторной отправкой (снизило ошибки на 61%)
  5. Логировать не только ошибки, но и «почти ошибки» — операции, прошедшие, но с предупреждениями (выявили 12% проблемных случаев)

Onboarding нового разработчика теперь начинается с этого списка и реальных примеров из логов. Например, кейс от 15.03, когда система приняла платеж в 10 000 руб., но из-за округления в CRM сумма отобразилась как 9 999.99. Следующий проект запустим иначе: первые три дня потратим на проверку документации против реального поведения системы (планируем 32 тестовых сценария). Последний скриншот в истории — фото этого чека, сделанное в 4 утра перед сдачей. Ручка, которой он подписан, до сих пор лежит в том же ящике — как напоминание, что даже «модные» технологии требуют кропотливой адаптации.

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *