O que é normalização de estado?

Question

Accepted Answer

**Normalização** significa armazenar dados em uma estrutura flat, relacional — indexada por **id** em tabelas de consulta — em vez de objetos/arrays profundamente aninhados. É a mesma ideia que normalização de banco de dados, aplicada ao estado do cliente, e torna atualizações e buscas eficientes e consistentes.

## Por que isso importa

```js
// ❌ nested & duplicated — the same user appears in multiple posts
posts: [
  { id: 1, title: "A", author: { id: 10, name: "Ann" } },
  { id: 2, title: "B", author: { id: 10, name: "Ann" } }, // Ann duplicated
]
// To rename Ann, you must find and update EVERY copy → easy to miss one (drift)
// To find post #2, you must scan the array
```

Dados aninhados duplicados devem ser atualizados em muitos lugares (risco de inconsistência), e encontrar um item significa digitalizar arrays (O(n)).

## A forma normalizada

```js
// ✅ flat lookup tables keyed by id, with references by id
{
  posts: {
    byId: { 1: { id: 1, title: "A", authorId: 10 },   // reference the author by id
            2: { id: 2, title: "B", authorId: 10 } },
    allIds: [1, 2],                                     // order/iteration
  },
  users: {
    byId: { 10: { id: 10, name: "Ann" } },             // each user stored ONCE
  },
}
```

Cada entidade é armazenada uma vez, indexada por id; relações são apenas referências de id.

## Os benefícios

```js
state.users.byId[10];                        // ✅ O(1) lookup by id
state.users.byId[10] = { ...u, name: "Bob" }; // ✅ update Ann ONCE → reflected everywhere
state.posts.allIds.map(id => state.posts.byId[id]); // iterate via the id list
```

```text
✓ Single source of truth per entity → no duplication, no drift
✓ O(1) lookups/updates by id (vs scanning arrays)
✓ Easy to update one entity and have all references reflect it
✓ Simpler to manage relationships and merge new data
```

## Ferramentas

```text
Redux Toolkit's createEntityAdapter generates normalized { ids, entities }
structures + CRUD reducers automatically. normalizr can normalize API responses.
```

## Por que isso importa

Normalização é o padrão para gerenciar **dados relacionais/de coleção** no estado do cliente (especialmente no Redux).

Ele impõe uma fonte única de verdade por entidade (atualize uma vez, refletido em toda parte), oferece buscas rápidas baseadas em id e evita os bugs e problemas de desempenho de dados profundamente aninhados e duplicados.

Para aplicativos com listas de entidades relacionadas (usuários, posts, comentários) que são atualizadas e referenciadas cruzadas, normalizar a store — geralmente via `createEntityAdapter` — é uma técnica-chave para manter o estado consistente e eficiente.