Задача выглядела рутинной. Заказчик, сеть кафе на девять точек, попросил добавить НДС в печатные формы двух документов: «Заказ меню» и «Реализация блюд». Конфигурация отраслевая, для общепита, за десять лет плотно доработанная под заказчика. НДС появился у сети со сменой налогового режима, раньше печатные формы обходились без него. Я поправил формулы в модулях печати, добавил в макеты параметры «СуммаНДС» и «СтавкаНДС», вывел итоговые суммы в подвал таблицы и прогнал печать на копии базы. Часа три работы.
Я работаю один, штатного ревьюера у меня нет, поэтому ревью собственных правок делаю сам, по процедуре, о которой расскажу ниже. Так вот, на следующий день, во время этого ревью, я нашёл критическую ошибку в коде, который не менялся четыре года и которого в моём diff не было вовсе. Накануне она никому не мешала. После моей правки она встала на пути внедрения и превратилась в блокер. Статья не про сам баг, он банальный. Она про то, каким образом он вообще попался мне на глаза и почему без второго прохода ревью не попался бы никогда.
Задача на три часа и 21 критерий приёмки
Сначала о самих правках, без этого история не сложится. НДС в печатной форме не сводится к одной формуле. Нужно посчитать налог по каждой строке, свернуть итог по документу, вывести ставку в шапке таблицы, не сломать вариант печати без цен и учесть скидки, которые в этой конфигурации применяются до налога.
По задаче я написал короткий план и выписал из него критерии приёмки. Получился 21 пункт. Критерии там приземлённые, в духе «в варианте печати без цен колонка НДС не выводится» или «итог по документу сходится с суммой строк до копейки». Звучит бюрократично для трёх часов работы, но я делаю так на любой задаче крупнее получаса, потому что план потом превращается в чек-лист для ревью, и проверка идёт по списку, а не по памяти.
Привычка к самостоятельному ревью появилась у меня не от хорошей жизни. Лет восемь назад я отдал заказчику правку, где перепутал условие в соединении запроса, и ошибку нашла бухгалтерия в конце квартала. С тех пор я считаю, что фрилансер без ревьюера обязан заменить его себе сам, иначе весь контроль качества сводится к фразе «вроде работает».
Ревью собственного кода я делаю в два прохода. Они устроены по-разному и ловят разное.
Первый проход сверяет diff с планом. Открываю сравнение с хранилищем и по каждому критерию ищу подтверждение: формула налога в модуле «Заказа меню» на месте, параметры в макете прописаны, порядок вывода областей не нарушен, вариант печати без цен не задет. Заодно проверяю обратное: не уехали ли изменения за рамки задачи, не осталось ли в diff случайного мусора и отладочных сообщений. Этот проход закрылся чисто. 21 из 21.
Второй проход устроен иначе. Я закрываю окно сравнения и читаю изменённые модули целиком, сверху вниз, как чужой код, который вижу впервые. Без подсветки изменённых строк и без плана перед глазами. Вопрос к себе на этом проходе один: понимаю ли я, как мои новые функции живут среди старых, и не тянет ли старый код мои правки в неожиданную сторону.
Второй проход: модуль целиком
Модуль формы «Заказа меню» занимает около 1200 строк. На чтение ушло минут сорок. Ближе к середине я дошёл до команды «Пересчёт», которая обновляет цены и суммы по всем строкам таблицы. Моя правка её не касалась. Но суммы я как раз трогал, поэтому читал этот кусок внимательно. И увидел вот что:
&НаКлиенте
Процедура Пересчет(Команда)
Для Каждого Стр Из Объект.Товары Цикл
ПересчетСтроки(Стр);
КонецЦикла;
КонецПроцедуры
&НаКлиенте
Процедура ПересчетСтроки(Ид)
Стр = Объект.Товары.НайтиПоИдентификатору(Ид);
Стр.Количество = Макс(Стр.Количество, 1);
// дальше пересчёт цены и суммы
КонецПроцедуры
Цикл передаёт в процедуру строку табличной части. А процедура написана в расчёте на числовой идентификатор: параметр называется «Ид», и первым действием она ищет строку заново через «НайтиПоИдентификатору». Вызов и сигнатура не согласованы между собой. Судя по всему, когда-то процедуру переписали под идентификатор, чтобы вызывать её ещё и из обработчиков «ПриИзменении», а старый цикл в команде поправить забыли, и с тех пор он лежал в модуле в нерабочем виде.
Читаю я в таких случаях в устоявшемся порядке: сперва обработчики событий, затем команды и служебные процедуры внизу модуля. Порядок не догма, просто так видно, кто кого вызывает. На команде «Пересчёт» я задержался ещё и потому, что моя формула налога живёт в той же процедуре пересчёта строки, которую эта команда дёргает.
Дальше начинается специфика платформы. «НайтиПоИдентификатору» ждёт число. Получив вместо числа строку данных формы, метод не ругается на несоответствие типа, а молча возвращает Неопределено. На этой строке ничего не падает. Падает следующая: присвоение «Стр.Количество» останавливается с ошибкой «Значение не является значением объектного типа». В синтакс-помощнике, к слову, описан только случай «строка не найдена», про неверный тип параметра там ни слова.
Ошибка всплывает не там, где возникла, а на шаг позже, и по тексту сообщения о причине не догадаешься. Похожие грабли я разбирал в истории о том, как API БСП молча возвращает пустоту вместо того, чтобы честно упасть на месте.
Вывод из находки простой. Команда «Пересчёт» не работала вообще. Любое нажатие заканчивалось окном ошибки на первой же строке таблицы. И это не мой регресс: я этот код не трогал, он был сломан задолго до меня.
Почему баг четыре года никому не мешал
Я полез в историю хранилища. Последнее изменение этого куска датировано 2022 годом. Четыре года команда лежала в форме сломанной, и за всё это время ни одного обращения по ней я в переписке с заказчиком не нашёл, хотя тикеты у нас сохраняются все до единого. Автора уже не спросить: до меня систему сопровождали две разные команды, и хранилище помнит только обезличенные имена вроде «Разработчик2».
Разгадка оказалась житейской. Массовый пересчёт операторам был не нужен. Цены подтягиваются при подборе номенклатуры, а когда что-то менялось задним числом, операторы шли по таблице вручную: встал на строку, нажал Enter, платформа пересчитала. На типичном заказе в двадцать строк это быстрее, чем искать кнопку в подменю «Ещё». Команду никто не запускал. Баг спал.
Для чистоты эксперимента я поднял архивную копию базы годичной давности и нажал ту же кнопку там. Та же ошибка, слово в слово. Значит, дело не в свежих обновлениях платформы, команда была мертва давно, просто некому было об этом узнать.
Ошибка, которая годами ждёт своего часа, в моей практике не редкость: я уже рассказывал про баг, который сломала новая привычка пользователя. Там код тоже был неправильным с первого дня и тоже не проявлялся, пока люди не начали нажимать кнопки в другом порядке. Общая черта у этих историй одна: код не менялся, поменялось то, как его используют.
Теперь главное. Моя правка добавила налог в расчёт суммы строки. Новые документы считаются правильно с первого дня. Но у сети висело около двухсот незакрытых «Заказов меню» на будущие даты, банкеты бронируют сильно заранее, и все их нужно было пересчитать уже с учётом налога.
Прощёлкивать их вручную — это порядка четырёх тысяч нажатий Enter, по двадцать строк на каждый из двухсот документов, и предлагать такое операторам я бы не рискнул. Команда «Пересчёт» впервые за четыре года стала нужна. И она не работала.
Мне нравится описывать это через категории. До правки баг жил в категории «никому не мешает». После правки он переехал в категорию «блокирует внедрение», не изменившись ни на символ. Переезд организовала моя правка, хотя она этот код даже не задевала.
Заказчику я показал находку в тот же день. Реакция была характерной: удивило его не то, что баг есть, а то, что кнопка вообще существует. Про неё не знал даже администратор, который работает с системой с самого запуска. Это заодно и ответ на вопрос, почему сломанный код живёт в проде годами: то, чем не пользуются, не тестирует никто.
Diff показывает изменения, но не последствия
Хочу заступиться за первый проход ревью. Он не промахнулся. У него другая работа: проверить покрытие плана и границы изменений, и эту работу он выполнил полностью, весь список из 21 пункта закрыт. Код команды «Пересчёт» в diff не входил, а значит, по определению не входил и в зону внимания первого прохода. Ревью по diff не видит того, чего в diff нет. Это свойство инструмента, а не небрежность человека, и никакая внимательность его не отменяет.
Командной разработки это касается в той же мере. Когда ревью делает другой человек, он почти всегда смотрит именно diff, потому что в интерфейсе гитхаба или гитлаба другого представления по умолчанию и нет. Хороший ревьюер откроет соседний код, если что-то заподозрит. Но подозрение должно сначала возникнуть, а зацепиться взгляду в аккуратном списке изменённых строк не за что.
Проблема глубже, и она не про инструменты. Правка меняет не только строки, помеченные в отчёте сравнения. Она меняет вес окружающего кода. Функция, которую никто не вызывал, становится единственной дорогой к цели. Ветка условия, в которую никто не заходил, начинает выполняться на каждом документе. Сам код не меняется ни на символ, меняется контекст вокруг него, и вот этот сдвиг в отчёте сравнения не виден в принципе, в какой бы системе контроля версий вы ни работали.
Автоматика здесь тоже не спасает. Синтаксически код команды корректен, проверка конфигурации его пропускает, а несоответствие «строка вместо числа» в динамически типизированном языке статикой не ловится. Автотестов на эту кнопку не существовало, потому что кнопкой никто не пользовался. Когда я собирал свой конвейер CI/CD для 1С, я быстро понял, что конвейер проверяет ровно то, о чём его попросили, и такой код проходит все стадии зелёным.
Отсюда и берётся второй проход. Его предмет не изменения, а модуль целиком, вместе с кодом, которого правка не касалась. Замечу честно: я не искал баги в старом коде и не занимался аудитом. Я читал модуль, чтобы понять, как устроен пересчёт, который трогают мои формулы. Несогласованность вызова и сигнатуры зацепила глаз сама: процедура с параметром «Ид», в которую кладут строку таблицы, выглядит подозрительно ещё до всякой отладки. Дальше две минуты в отладчике, и диагноз был готов.
Одна строка исправления
Сам фикс получился скучным:
ПересчетСтроки(Стр.ПолучитьИдентификатор());
Одна строка. У строки данных формы есть метод «ПолучитьИдентификатор», он возвращает ровно то число, которое ждёт «НайтиПоИдентификатору». Команда ожила. Тестовый заказ на двадцать восемь строк пересчитался мгновенно, операторы за два дня прошли свои двести незакрытых заказов, и внедрение налога доехало до конца. Итоговая смета по времени: три часа правок, сорок минут второго прохода ревью, десять минут на фикс и ещё вечер на выборочную сверку уже пересчитанных операторами документов.
Сверял я не глазами. Запросом сравнил налог по строкам с итогом по каждому из двухсот заказов, расхождений не нашлось ни на копейку. Такая проверка занимает минут десять и снимает страх, что массовая операция где-то тихо округлила не туда.
Из этой истории выросло правило, которое я с тех пор соблюдаю жёстко. Если правка задевает общий код, модуль читается целиком, а не только изменённые места. Под общим кодом я понимаю процедуры, которые вызываются больше чем из одного места: обработчики событий, служебный пересчёт, функции печати, всё, что переиспользуется. На модуль в тысячу строк уходит тридцать-сорок минут чтения. В девяти задачах из десяти второй проход не находит ничего, и время выглядит потраченным зря. Десятая окупает все десять.
Есть и граница применимости. На модулях в пять тысяч строк читать всё подряд уже нереально, там я сужаю круг до процедур, которые вызывают изменённый код или вызываются из него напрямую. Это компромисс, и осознанный: полное чтение таких модулей стоило бы дороже самой правки.
Отдельный вопрос, кто за это платит. Сорок минут чтения я не выставляю заказчику отдельной строкой, они сидят внутри оценки задачи, как сидит там и тестирование. Если из-за этого моя оценка выглядит выше, чем у соседа по рынку, то разница и есть цена вот таких находок.
Если захотите примерить приём на себя, вот конкретный шаг. В следующей задаче, где правка попадает в модуль с общими процедурами, закройте окно сравнения и прочитайте модуль сверху вниз, засекая время. Отдельно смотрите на пары из вызова и сигнатуры: если параметр называется «Ид» или «Идентификатор», а в него кладут строку таблицы, перед вами тот же баг, который я разбирал выше. Именно так ловится ошибка, которой нет в diff: не поиском багов, а честной попыткой понять код, среди которого будет жить ваша правка.





