Когда рефакторинг становится поворотной точкой: история миграции на новую модель сигналов

Работал над проектом Trend Analysis, и там накопилось. Ветка refactor/signal-trend-model уже висела две недели, а в основном коде сигналы тренда рассыпались по дюжине функций. Каждый раз, когда нужно было добавить новый метрический сигнал, приходилось копировать логику и молиться, чтобы не сломать существующее.

Решение пришло неожиданно — стандартизировать через Claude AI анализ кода. Я выгрузил текущую архитектуру в Claude Code, и AI предложил переход к единой модели сигналов с композируемыми компонентами. Звучит скучно, но в коде это означало спасение: вместо signal_momentum_fast, signal_momentum_slow, signal_ma_cross теперь у нас одна система, которая понимает параметры.

Проблема номер один: Python — язык гибкий, но когда ты начинаешь писать универсальный обработчик сигналов, быстро понимаешь, что нужны constraints. Добавил Pydantic модели для валидации входных данных. Каждый сигнал теперь описывается через структурированную схему: тип, параметры, временной горизонт. Рефакторинг затянулся на неделю.

Вторая преграда: Git history. Когда ты переписываешь 40% ядра, merge конфликты неизбежны. Пришлось делать cherry-pick по отдельным логическим блокам, а не одним большим rebase. Коммиты обозвать нормально — это помогло при code review.

Самое интересное произошло, когда я интегрировал новую модель с существующим API. Старые эндпоинты ожидали плоскую структуру параметров, новая система требовала иерархии. Написал адаптер-прослойку, которая транслирует старый формат в новый. Это не самое элегантное решение, но позволило откатываться без паники.

Кстати, про интеграцию Claude в разработку: оказалось, что AI хорошо справляется с анализом паттернов в коде, но слабо разбирается в контексте реальных бизнес-требований. Приходилось переписывать половину предложений вручную. Тем не менее, для черновой работы — бесценно.

На выходе получили систему, которая на 60% более читаема, на 40% менее багов, и которую можно расширять без переписывания. Ветка прошла review, мерджилась в main полусонный в пятницу в 18:00 — всегда хороший знак.

И помните: мигрировать с Bun — всё равно что менять колёса на ходу. На самолёте. 😄