O que significa "single source of truth"?

Question

Accepted Answer

**Single source of truth** significa que cada dado é armazenado em **exatamente um lugar**, e tudo que precisa dele lê a partir dali — em vez de manter várias cópias que podem ficar desincronizadas.

## Por que isso importa: estado duplicado e divergente

```jsx
// ❌ the same data stored in two places → they can disagree
function Profile() {
  const [user, setUser] = useState({ name: "Ann" });
  const [displayName, setDisplayName] = useState("Ann"); // a COPY of user.name

function rename(newName) {
    setUser({ ...user, name: newName }); // updated user...
    // ...but forgot to update displayName → now they're out of sync! 🐛
  }
}
```

Quando o mesmo fato existe em dois estados, cada atualização deve lembrar de alterar ambos — e inevitavelmente um é esquecido, produzindo bugs onde a interface exibe valores inconsistentes.

## A solução: uma fonte, derive o resto

```jsx
// ✅ user.name is the single source; displayName is DERIVED, not stored
function Profile() {
  const [user, setUser] = useState({ name: "Ann" });
  const displayName = user.name.toUpperCase(); // computed on render — always in sync

function rename(newName) {
    setUser({ ...user, name: newName }); // one update, everything stays consistent
  }
}
```

Armazene o valor canônico uma vez; calcule qualquer coisa derivável dele sob demanda. Não há nada para manter em sincronização.

## Onde este princípio se aplica

```text
✓ Don't copy props into state (the prop is the source)
✓ Don't store derived values (compute them: totals, filtered lists, formatted text)
✓ Global stores (Redux/Pinia): one store is the source for shared data
✓ Server data: cache it once (React Query) rather than copying into many components
✓ URL as source: filters/page in the URL, read from there
```

## Por que isso importa

Single source of truth é um princípio fundamental do gerenciamento de estado confiável — elimina uma classe inteira de bugs causados por dados duplicados que divergem.

É *por que* você deriva valores em vez de armazená-los, *por que* evita copiar props para o estado e *por que* lojas globais centralizam dados compartilhados.

Quando os dados têm um lar autoritativo e tudo lê a partir dele, sua interface permanece consistente por construção.