Технические подходы

Чтобы получить «работающий код», в индустрии хватит и способного начинающего разработчика (junior). «Работающий код» означает лишь правильный результат для одного спринта, одной функции, одного пользовательского сценария. Но жизнь ПО не ограничивается одним спринтом. Через три месяца, когда нужно добавить новую функцию, через полгода, когда приходится выдерживать всплеск трафика, через год, когда приходит счёт за технический долг, — вот тогда и становится видна пропасть между «работающим» и «качественным» кодом. Первый при каждом изменении порождает новую ошибку, второй продолжает спокойно расти. В инженерной культуре Partnerfy слово «работает» никогда не используется само по себе: оно превращается в письменное обязательство «работает и остаётся недорогим в сопровождении». Первый день и третий год — в равной мере часть нашего договора.

Есть истина, которую индустрия разработки годами не замечала: код, написанный наспех, со слабой структурой и без документации, в день сдачи «работает». Клиент доволен, агентство довольно, разработчик доволен. Но в этот день закладывается бомба замедленного действия. Конструкции, которые в индустрии называют «спагетти-кодом», даже если в первый день работают без ошибок, со временем превращаются в громоздкие, дорогие и хрупкие здания, в которые уже и гвоздя не вобьёшь. Добавить новую функцию значит «сначала разобраться в коде», исправить имеющуюся ошибку — «сначала понять, где вообще можно что-то трогать». В инженерной литературе это называется техническим долгом. В компании Partnerfy мы понимаем, какая ответственность лежит на каждом написанном нами модуле. Поэтому мы даём каждому классу одну задачу, делаем каждую функцию как можно меньше и для каждого имени применяем принятые в литературе стандарты. Через три года другой инженер, открыв проект, должен суметь прочитать, что делает код, даже если нас рядом уже не будет.

Экран подтверждения в панели ID.Partnerfy — самый конкретный результат нашей партнёрской архитектуры. По каждому разработанному модулю вы видите в панели четыре вещи: (1) staging-URL — ссылку для предпросмотра финальной версии проекта перед выпуском; (2) заметки о разработке — какие функции добавлены или исправлены в этом спринте; (3) отчёты о тестировании — результаты автоматических тестов; (4) кнопку «Запустить» — красную, большую, заметную. Пока вы не нажмёте эту кнопку, модуль не вносит никаких изменений в рабочую систему, которую видит ваш клиент. Как только вы её нажмёте, автоматически начнётся развёртывание, смена версии пройдёт без простоя (zero-downtime), а по завершении вы получите уведомление в панели. При желании право нажимать эту кнопку можно открыть отдельным сотрудникам вашей команды. Её может нажимать менеджер по работе с клиентами, продуктовый менеджер, даже ваш конечный клиент — это ваше организационное решение. Но кто бы её ни нажал, в момент нажатия цепочка полномочий фиксируется в журнале.