Skip to content

Паттерны управления состоянием ​

В этом разделе собраны архитектурные приёмы и практические сценарии проектирования бизнес-логики на базе @pravosleva/reactive-engine v3.0.1.

Благодаря переходу ядра на интрузивный граф (NodeLink), пулинг памяти (LinkPool) и O(1)-трекинг по курсору, библиотека позволяет строить масштабируемые модульные приложения без накладных расходов на сборку мусора и сложного шаблонного кода.

Базовые паттерны ​

Ниже описаны фундаментальные подходы, с которых стоит начать проектирование слоя данных:

1. Кросс-сервисное взаимодействие и DI ​

Разделение приложения на изолированные домены-сервисы (AbstractService) и их связывание через встроенный DI-контейнер (this.engine.inject). Показывает, как строить реактивные цепочки между сервисами без глобального состояния и утечек памяти.

2. Автобатчинг и высокочастотные обновления ​

Использование встроенной группировки обновлений на микрозадачах (queueMicrotask). Разбирает, как движок склеивает множественные синхронные мутации в один проход по графу и когда имеет смысл применять явный engine.batch().

3. Динамические зависимости и переиспользование связей (LinkPool) ​

Проектирование вычислений с условными ветвлениями (if / else). Объясняет, как движок автоматически отписывает неактивные ветки, переиспользует рёбра графа через LinkPool без нагрузки на GC и сохраняет скорость O(1) с помощью курсора depsCursor.

4. Изоляция инстансов и кросс-движковые мосты ​

Запуск нескольких независимых экземпляров ReactiveEngine в одном приложении (микрофронтенды, изолированные виджеты, SSR) и настройка явных мостов синхронизации между ними через .subscribe() или effect.

5. Асинхронные ресурсы и защита от гонок запросов (resource) ​

Декларативное управление сетевыми запросами через engine.resource(): автоматический перезапуск при изменении зависимостей, отмена устаревших запросов через AbortController, предварительная проверка validateBeforeFetch и валидация ответа responseValidate.

6. Оптимизация больших реактивных форм через Proxy (reactive) ​

Гранулярное отслеживание изменений на уровне отдельных полей формы (engine.reactive()) без клонирования всего дерева состояния, дополненное синхронной и асинхронной валидацией через декораторы withValidationSync и withValidationAsync.

7. Оптимистичные обновления интерфейса (Optimistic UI) ​

Мгновенный отклик интерфейса на действия пользователя с сохранением снимка состояния (previousSnapshot), защитой от гонок при повторных кликах (AbortController) и автоматическим откатом при сетевых ошибках.

8. Стратегии кэширования запросов (withCache и withStaleWhileRevalidate) ​

Кэширование ответов с временем жизни (ttl), склеивание параллельных запросов (Request Collapsing) через withCache и отказоустойчивый фолбэк с LRU-вытеснением (maxSize) через withStaleWhileRevalidate.

9. Непрерывный опрос сервера и Exponential Backoff (withLongPolling) ​

Организация надёжного цикла Long Polling поверх engine.resource() с защитой от пересечения сессий (currentSessionToken), прогрессивным откатом при сбоях сети и двойным контуром отмены (AbortSignal + externalSignal).

10. Контроль частоты запросов и вычислений (withDebounce, withThrottle, withThrottleComputed) ​

Защита сетевого и вычислительного слоёв при частом вводе или потоке событий: отложенные запросы (withDebounce), троттлинг с Leading/Trailing фазами (withThrottle) и ограничение частоты тяжёлых вычислений в памяти (withThrottleComputed).

11. Интеграция с WebSockets и потоками данных в реальном времени ​

Инкапсуляция WebSocket внутри AbstractService с автобатчингом входящих пакетов, реактивным переподключением по смене параметров (effect), экспоненциальным откатом при обрывах и строгой валидацией входящих фреймов.

12. Интеграция с Socket.IO v4+ (типизированные события, Ack и Connection State Recovery) ​

Построение отказоустойчивого клиента Socket.IO v4+ поверх AbstractService с типизацией контрактов ServerToClientEvents / ClientToServerEvents, динамическим auth-колбэком, подтверждениями emitWithAck и проверкой socket.recovered.

13. Конечные автоматы (State Machines / FSM) на сигналах ​

Детерминированное управление сложными пошаговыми процессами без «невозможных состояний» через строгие Discriminated Unions, таблицу переходов send(event) и автоматическую отмену побочных эффектов при смене статуса.

14. Вынос тяжёлых вычислений в Web Workers ​

Инкапсуляция фоновых потоков Worker внутри AbstractService с корреляцией запросов (requestId), интеграцией с engine.resource(), отменой устаревших расчётов через AbortSignal и гарантированным завершением потока через terminate().

15. Персистентность состояния в localStorage и кросс-вкладочная синхронизация ​

SSR-безопасная гидратация настроек при старте, автосохранение через effect и мгновенная синхронизация между вкладками браузера через событие storage с защитой от циклических перезаписей.

16. Персистентность в IndexedDB и синхронизация вкладок через BroadcastChannel ​

Асинхронное хранение крупных офлайн-данных в IndexedDB поверх engine.resource() с мгновенным оповещением соседних вкладок браузера через BroadcastChannel и защитой от самоповторов.

17. Юнит-тестирование сервисов, сигналов и ресурсов (Vitest / Jest) ​

Детерминированное тестирование бизнес-логики без DOM: изоляция инстансов ReactiveEngine, мокирование зависимостей через DI, перемотка таймеров декораторов через vi.advanceTimersByTimeAsync() и проверка отмены запросов AbortSignal.

18. Подключение сервисов к UI-фреймворкам (View Layer Integration) ​

Обзорная схема связывания AbstractService со слоем представления без дублирования состояния и прямые ссылки на руководства по React, Vue 3 и Vanilla JS.

19. Ленивое подключение сервисов (Lazy Dependency Injection) ​

Отложенное создание вспомогательных сервисов через геттер get service() или динамический import() для ускорения холодного старта, экономии памяти и разрыва циклических зависимостей.

Общие принципы архитектуры ​

При проектировании состояния в @pravosleva/reactive-engine придерживайтесь трёх правил:

  • Чистота вычисляемых свойств (computed): Используйте computed только для получения производных данных без побочных эффектов и мутации других сигналов. Все сайд-эффекты, логирование и сетевые вызовы выносите в effect или resource.
  • Изоляция логики в сервисах: Инкапсулируйте сигналы и методы их изменения внутри классов AbstractService. Это делает бизнес-логику полностью независимой от UI-фреймворка (React, Vue, Angular) и упрощает юнит-тестирование.
  • Предсказуемый порядок чтения: В динамических computed считывайте базовые управляющие флаги до ветвлений if / else, чтобы курсор depsCursor всегда попадал в быстрый путь (fast path) за O(1).

Раздел дополняется

Список паттернов регулярно пополняется новыми сценариями из реальной практики: кэширование запросов с поддержкой TTL (withCache), оптимистичные обновления интерфейса (Optimistic UI) и интеграция со стейт-машинами.