re:re:actable
Урок 033 минуты чтения

Как спроектировать модель данных и состояние клиента

На этой странице
Кратко

На шаге Data model определяют сущности клиента и их поля, разделяют серверное состояние (данные с API — кешируются и синхронизируются) и клиентское (UI, черновики, выбор пользователя), решают, что хранить нормализованно, что — в URL, что — локально на устройстве. Хорошая модель минимальна: производные значения вычисляются, а каждая сущность хранится в одном месте.

Вопрос

Как спроектировать модель данных на клиенте? Как разделить серверное и клиентское состояние, когда нормализовать данные и что хранить в URL?

Сущности

Пример — чат:

type User = { id: UserId; name: string; avatarUrl: string; online: boolean };
 
type Conversation = {
  id: ConversationId;
  title: string;
  participantIds: UserId[];
  lastMessageId: MessageId | null;
  unreadCount: number;
};
 
type Message = {
  id: MessageId;              // для неотправленных — временный clientId
  conversationId: ConversationId;
  authorId: UserId;
  text: string;
  createdAt: string;          // ISO, с сервера
  status: "sending" | "sent" | "delivered" | "read" | "failed";
};

Виды состояния

ВидПримерГде хранить
Серверноебеседы, сообщения, профиликеш запросов (TanStack Query, RTK Query) или нормализованный store
Клиентское UIоткрыта ли панель, выбранная беседаuseState, локальный store
URL/chat/:conversationId, фильтры, поискроутер, searchParams
Формы и черновикитекст неотправленного сообщениясостояние формы + localStorage
Сессиятекущий пользователь, токенhttpOnly cookie, контекст
Офлайн-данныеистория для работы без сетиIndexedDB

Нормализация

type ChatState = {
  users: Record<UserId, User>;
  conversations: Record<ConversationId, Conversation>;
  messages: Record<MessageId, Message>;
  messageIdsByConversation: Record<ConversationId, MessageId[]>;  // порядок
};

Нормализуйте, если:

  • одна сущность встречается в нескольких местах (автор в сообщениях, списке участников, шапке);
  • данные часто обновляются точечно (статус сообщения, онлайн пользователя);
  • приходят realtime-события по id.

Для простой ленты «только чтение» достаточно массивов в кеше запросов.

Производные данные

Не храните то, что можно вычислить:

// плохо: хранить unreadTotal отдельно и синхронизировать вручную
// хорошо: селектор
const selectUnreadTotal = (s: ChatState) =>
  Object.values(s.conversations).reduce((sum, c) => sum + c.unreadCount, 0);

Что хранить в URL

  • текущий экран и выбранную сущность (/products/42);
  • фильтры, сортировку, поиск, страницу — чтобы можно было поделиться ссылкой и вернуться «назад»;
  • открытую вкладку или модалку, если на нее дают прямую ссылку.

Не храните в URL секреты и большие объекты.

Локальное хранение

ХранилищеОбъемДля чего
localStorage~5 МБ, синхронныйнастройки, маленькие черновики
sessionStorage~5 МБ, вкладкавременное состояние вкладки
IndexedDBсотни МБ, асинхронныйофлайн-кеш, большие данные, очередь отправки
Cache APIответы HTTPService Worker, офлайн-ресурсы
cookie~4 КБсессия (httpOnly)

Что важно помнить

  • Минимальное состояние: каждая сущность — в одном месте, производное — через селекторы.
  • Временные id для оптимистичных сущностей заменяйте на серверные после ответа.
  • Даты храните в ISO/UTC, форматируйте при отображении через Intl.
  • Указывайте, откуда берется «источник правды»: сервер, URL или клиент.
  • Связанные темы: нормализация в RTK, client-side и server-side state.

Мини-шпаргалка

Сущности с id и типами полей. Серверное состояние — в кеше запросов, UI — локально, навигация и фильтры — в URL, черновики — localStorage, офлайн — IndexedDB. Нормализовать при повторяющихся сущностях и точечных обновлениях. Производное — вычислять.

Документация

Redux: Normalizing State Shape, TanStack Query: Does this replace client state?, MDN: IndexedDB API, web.dev: Storage for the web.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам