Que signifie « single source of truth » ?

Question

Accepted Answer

**Single source of truth** signifie que chaque donnée est stockée dans **exactement un seul endroit**, et tout ce qui en a besoin la lit à partir de là — plutôt que de conserver plusieurs copies qui peuvent diverger.

## Pourquoi c'est important : état dupliqué et divergent

```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! 🐛
  }
}
```

Quand le même fait existe dans deux états, chaque mise à jour doit se souvenir de modifier les deux — et inévitablement l'une d'elles est oubliée, produisant des bugs où l'interface utilisateur affiche des valeurs incohérentes.

## La solution : une source, dériver le reste

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

Stockez la valeur canonique une seule fois ; calculez tout ce qui en est dérivable à la volée. Il n'y a rien à maintenir en synchronisation.

## Où ce principe s'applique

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

## Pourquoi c'est important

Single source of truth est un principe fondamental de la gestion fiable des états — il élimine toute une classe de bugs causés par les données dupliquées qui divergent.

C'est *pourquoi* vous dérivez des valeurs au lieu de les stocker, *pourquoi* vous évitez de copier les props dans l'état, et *pourquoi* les stores globaux centralisent les données partagées.

Quand les données ont une seule maison faisant autorité et que tout le reste la lit à partir de là, votre interface utilisateur reste cohérente par construction.