Миграция с Angular на React: 120+ отчётов без «большого взрыва»
Как я переносил систему аналитики и отчётности на React: общий фундамент из компонентов, логика данных отдельно от UI и перенос по одному отчёту.
С чего всё начиналось
В Life Transfers у нас была система аналитики и отчётности на Angular: больше 120 отдельных отчётов, у каждого свои фильтры, таблицы и графики. Ей пользовались каждый день, поэтому заморозить продукт на полгода и переписать всё с нуля было нельзя.
Задачу я сформулировал так: перенести фронтенд на React постепенно, чтобы пользователи заметили только одно изменение: интерфейс стал быстрее.
Сначала фундамент, потом отчёты
Прежде чем переносить первый отчёт, я выписал всё, что в них повторяется: выбор периода, фильтры, таблицы, графики, экспорт. Из этого выросла библиотека из 50+ UI-компонентов с описанием состояний в Storybook.
После этого отчёт перестал быть отдельной страницей с уникальной вёрсткой. Он стал описанием: какие данные загрузить, какие фильтры показать и в каком виде вывести результат. Переносить такие описания намного быстрее, чем переписывать вёрстку.
Логика данных отдельно от компонентов
Самое сложное в отчётах не вёрстка, а клиентская логика: сравнение показателей между периодами и объединение нескольких наборов данных. Я вынес её в чистые функции без зависимостей от React. Их легко покрыть тестами и сверить с результатами старой версии.
Компоненты при этом остались простыми: получили данные, отрисовали. Когда в отчёте находилось расхождение, искать причину приходилось в одном месте, а не в десятке компонентов.
type Row = Record<string, string | number>;
export function mergeByKey(left: Row[], right: Row[], key: string): Row[] {
const index = new Map(right.map((row) => [row[key], row]));
return left.map((row) => ({ ...row, ...index.get(row[key]) }));
}Что получилось
Весь фронтенд системы переехал на React. По нашей оценке, новая версия работает почти на 80% быстрее старой. Но главный результат для меня не цифра, а то, что новый отчёт теперь собирается из готовых частей, а не пишется с нуля.
Что я вынес
- Сначала общие компоненты, потом массовый перенос.
- Логика данных отдельно от UI и покрыта тестами.
- Каждый перенесённый отчёт сверяется со старой версией.