Cosa significa "single source of truth"?

Question

Accepted Answer

**Single source of truth** significa che ogni dato è memorizzato in **esattamente un luogo**, e tutto ciò che ne ha bisogno legge da lì — piuttosto che mantenere più copie che possono diventare non sincronizzate.

## Perché è importante

```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 lo stesso fatto esiste in due stati, ogni aggiornamento deve ricordarsi di modificare entrambi — e inevitabilmente uno viene dimenticato, producendo bug dove l'interfaccia utente mostra valori incoerenti.

## La soluzione: una fonte, derivare il 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
  }
}
```

Memorizza il valore canonico una volta; calcola qualsiasi cosa derivabile da esso al volo. Non c'è niente da mantenere sincronizzato.

## Dove questo principio si applica

```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
```

## Perché è importante

Single source of truth è un principio fondamentale della gestione dello stato affidabile — elimina un'intera classe di bug causati da dati duplicati che si allontanano.

È il *motivo* per cui derivare valori invece di memorizzarli, il *motivo* per cui evitare di copiare props nello stato, e il *motivo* per cui gli store globali centralizzano i dati condivisi.

Quando i dati hanno una casa autorevole e tutto legge da essa, la tua interfaccia utente rimane coerente per costruzione.