Налаштування State Management (Redux) для React-застосунку

Налаштування State Management (Redux) для React-застосунку

Redux — передбачуваний контейнер стану з однонаправленим потоком даних. Одне глобальне сховище, чисті reducer-функції, явні action-об'єкти. Для застосунків зі складною бізнес-логікою, розділеною між багатьма компонентами, Redux дає повний контроль над тим, як і коли змінюється стан.

Налаштовуємо Redux із сучасним стеком: Redux Toolkit для елімінації boilerplate, RTK Query для серверного стану, Redux DevTools для відладки.

Коли Redux виправданий

Redux потрібен не для кожного проекту. Ознаки, що він підходить:

• Стан розділяється між 5+ несв'язаними компонентами
• Складні переходи між станами з бізнес-правилами
• Потрібна повна історія змін (time-travel debugging)
• Кілька джерел даних оновлюють один стан
• Команда 5+ розробників, потрібна передбачуваність

Для локального стану компонента — useState. Для серверних даних — TanStack Query або RTK Query. Redux — тільки для глобального клієнтського стану.

Структура сховища

src/
  store/
    index.ts          # Конфігурація store
    hooks.ts          # Типізовані useAppDispatch, useAppSelector
    slices/
      authSlice.ts
      cartSlice.ts
      uiSlice.ts
    api/
      productsApi.ts  # RTK Query endpoints

// store/index.ts
import { configureStore } from '@reduxjs/toolkit';
import { authSlice } from './slices/authSlice';
import { cartSlice } from './slices/cartSlice';
import { uiSlice } from './slices/uiSlice';
import { productsApi } from './api/productsApi';

export const store = configureStore({
  reducer: {
    auth: authSlice.reducer,
    cart: cartSlice.reducer,
    ui: uiSlice.reducer,
    [productsApi.reducerPath]: productsApi.reducer,
  },
  middleware: (getDefault) =>
    getDefault().concat(productsApi.middleware),
});

export type RootState = ReturnType<typeof store.getState>;
export type AppDispatch = typeof store.dispatch;

// store/hooks.ts — типізовані хуки
import { useDispatch, useSelector } from 'react-redux';
import type { RootState, AppDispatch } from './index';

export const useAppDispatch = useDispatch.withTypes<AppDispatch>();
export const useAppSelector = useSelector.withTypes<RootState>();

Slice з бізнес-логікою

// store/slices/cartSlice.ts
import { createSlice, createSelector, type PayloadAction } from '@reduxjs/toolkit';

interface CartItem {
  id: string;
  name: string;
  price: number;
  qty: number;
  image: string;
}

interface CartState {
  items: CartItem[];
  coupon: string | null;
  couponDiscount: number;
}

const initialState: CartState = {
  items: [],
  coupon: null,
  couponDiscount: 0,
};

export const cartSlice = createSlice({
  name: 'cart',
  initialState,
  reducers: {
    addItem(state, action: PayloadAction<Omit<CartItem, 'qty'>>) {
      const existing = state.items.find(i => i.id === action.payload.id);
      if (existing) {
        existing.qty += 1;
      } else {
        state.items.push({ ...action.payload, qty: 1 });
      }
    },
    removeItem(state, action: PayloadAction<string>) {
      state.items = state.items.filter(i => i.id !== action.payload);
    },
    updateQty(state, action: PayloadAction<{ id: string; qty: number }>) {
      const item = state.items.find(i => i.id === action.payload.id);
      if (item) {
        item.qty = Math.max(1, action.payload.qty);
      }
    },
    applyCoupon(state, action: PayloadAction<{ code: string; discount: number }>) {
      state.coupon = action.payload.code;
      state.couponDiscount = action.payload.discount;
    },
    clearCart(state) {
      state.items = [];
      state.coupon = null;
      state.couponDiscount = 0;
    },
  },
});

// Мемоізовані селектори
export const selectCartItems = (state: RootState) => state.cart.items;

export const selectCartTotal = createSelector(
  selectCartItems,
  (state: RootState) => state.cart.couponDiscount,
  (items, discount) => {
    const subtotal = items.reduce((sum, item) => sum + item.price * item.qty, 0);
    return subtotal * (1 - discount / 100);
  }
);

export const selectCartCount = createSelector(
  selectCartItems,
  items => items.reduce((sum, item) => sum + item.qty, 0)
);

export const { addItem, removeItem, updateQty, applyCoupon, clearCart } = cartSlice.actions;

RTK Query для серверного стану

// store/api/productsApi.ts
import { createApi, fetchBaseQuery } from '@reduxjs/toolkit/query/react';

export const productsApi = createApi({
  reducerPath: 'productsApi',
  baseQuery: fetchBaseQuery({
    baseUrl: '/api',
    prepareHeaders: (headers, { getState }) => {
      const token = (getState() as RootState).auth.token;
      if (token) headers.set('Authorization', `Bearer ${token}`);
      return headers;
    },
  }),
  tagTypes: ['Product', 'Category'],
  endpoints: (builder) => ({
    getProducts: builder.query<Product[], ProductFilters>({
      query: (filters) => ({ url: '/products', params: filters }),
      providesTags: ['Product'],
    }),

    updateProduct: builder.mutation<Product, Partial<Product> & { id: string }>({
      query: ({ id, ...body }) => ({ url: `/products/${id}`, method: 'PUT', body }),
      invalidatesTags: ['Product'],
    }),
  }),
});

export const { useGetProductsQuery, useUpdateProductMutation } = productsApi;

Використання в компонентах

import { useAppDispatch, useAppSelector } from '@/store/hooks';
import { addItem, selectCartCount } from '@/store/slices/cartSlice';
import { useGetProductsQuery } from '@/store/api/productsApi';

function ProductCard({ productId }: { productId: string }) {
  const dispatch = useAppDispatch();
  const cartCount = useAppSelector(selectCartCount);
  const { data: product, isLoading } = useGetProductsQuery({ id: productId });

  if (isLoading) return <Skeleton />;

  return (
    <div>
      <h3>{product.name}</h3>
      <button onClick={() => dispatch(addItem(product))}>
        У корзину ({cartCount})
      </button>
    </div>
  );
}

Redux DevTools та відладка

Redux DevTools Extension дозволяє:

• Переглядати історію всіх actions
• Переходити до будь-якого попередного стану (time-travel)
• Експортувати/імпортувати стан для відтворення помилок

// store/index.ts — додаткова конфігурація DevTools
configureStore({
  ...
  devTools: process.env.NODE_ENV !== 'production' && {
    name: 'MyApp',
    trace: true, // Трасування викликів action
    traceLimit: 25,
  },
});

Строки реалізації

• Тиждень 1: налаштування store, slices для основних доменів, типізовані хуки
• Тиждень 2: RTK Query endpoints, інтеграція з компонентами
• Тиждень 3: мемоізовані селектори, оптимізація ре-рендерів (React.memo + reselect), тести reducer-функцій
• Тиждень 4: документація архітектури стану, code review, налаштування Redux DevTools у dev