СтатьиEsc
Антон Ишинкин2 мин чтения

Миграция с Angular на React: 120+ отчётов без «большого взрыва»

Как я переносил систему аналитики и отчётности на React: общий фундамент из компонентов, логика данных отдельно от UI и перенос по одному отчёту.

  • Life Transfers
  • React
  • Angular
  • Migration
  • Frontend Architecture

С чего всё начиналось

В Life Transfers у нас была система аналитики и отчётности на Angular: больше 120 отдельных отчётов, у каждого свои фильтры, таблицы и графики. Ей пользовались каждый день, поэтому заморозить продукт на полгода и переписать всё с нуля было нельзя.

Задачу я сформулировал так: перенести фронтенд на React постепенно, чтобы пользователи заметили только одно изменение: интерфейс стал быстрее.

Сначала фундамент, потом отчёты

Прежде чем переносить первый отчёт, я выписал всё, что в них повторяется: выбор периода, фильтры, таблицы, графики, экспорт. Из этого выросла библиотека из 50+ UI-компонентов с описанием состояний в Storybook.

После этого отчёт перестал быть отдельной страницей с уникальной вёрсткой. Он стал описанием: какие данные загрузить, какие фильтры показать и в каком виде вывести результат. Переносить такие описания намного быстрее, чем переписывать вёрстку.

Логика данных отдельно от компонентов

Самое сложное в отчётах не вёрстка, а клиентская логика: сравнение показателей между периодами и объединение нескольких наборов данных. Я вынес её в чистые функции без зависимостей от React. Их легко покрыть тестами и сверить с результатами старой версии.

Компоненты при этом остались простыми: получили данные, отрисовали. Когда в отчёте находилось расхождение, искать причину приходилось в одном месте, а не в десятке компонентов.

TypeScript · упрощённый пример объединения наборов
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 и покрыта тестами.
  • Каждый перенесённый отчёт сверяется со старой версией.