Toluwalope AkinkunmiЗагрузка…

Делаю наброски…

000
Перейти к содержимому
← Все заметки

· 2 мин чтения

Общая логика, а не общие экраны

Что попало в общий пакет между Next.js- и Expo-приложениями платформы мероприятий, что осталось снаружи и почему.

Платформа мероприятий начиналась как веб-приложение. Когда появилось мобильное, быстрее всего было скопировать запросы к API и правила. Уже через несколько недель приложения расходились в мелочах, которые важны: как форматировать сумму в найрах, какие статусы заказа считаются оплаченными, когда организатор может запросить выплату.

Один пакет, три правила

Оба приложения переехали в монорепозиторий на npm workspaces с одним общим пакетом. У него три правила:

  • Делить то, что обязано совпадать: сервисы API, хуки запросов, схемы валидации, форматирование валют, сопоставление статусов и бизнес-правила вроде права на выплату.
  • Не делить экраны. Интерфейс каждого приложения остаётся нативным для своей платформы, и ни одно не выглядит портом другого.
  • Никаких платформенных импортов в общем коде. Если модулю нужен DOM или нативный API, ему не место в пакете.
Два приложения, один общий пакет.Гости и организаторы → Веб-приложение; Гости и организаторы → Мобильное приложение; Веб-приложение → Общий пакет; Мобильное приложение → Общий пакет; Общий пакет → API платформы; API платформы ↔ ВыплатыГости и организаторыВеб-приложениеNext.jsМобильное приложениеExpoОбщий пакетnpm workspacesAPI платформыRESTВыплатыStripeимпортимпорттипизированные запросы
Два приложения, один общий пакет.

Самое сложное — зависимости

Код переехал легко. Версии — нет. React, TanStack Query и библиотека валидации должны разрешаться в одни и те же версии в обоих приложениях, а hoisting пакетов ведёт себя по-разному в Next.js и Metro. Версии выровнены в одном месте, а изменения lockfile проверяются на ревью.

Стоило ли оно того?

Да. Правило о том, когда можно запросить выплату, теперь меняется в одном файле, и оба приложения получают изменение. Веб и мобайл больше не могут разойтись в вопросах денег — уже одно это оправдало переезд.

Следующая заметкаОдин вход для многих приложенийКак семейство продуктов перешло на единый сервис входа на OAuth 2.0 и какие правила делают его безопасным.