ما معنى "مصدر واحد للحقيقة"؟

Question

Accepted Answer

**مصدر واحد للحقيقة** يعني أن كل بيانات يتم تخزينها في **مكان واحد بالضبط**، وكل شيء يحتاج إليها يقرأ منه — بدلاً من الاحتفاظ بنسخ متعددة التي يمكن أن تتباعد وتصبح غير متزامنة.

## المشكلة التي يمنعها: الحالة المكررة والمتباعدة

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

عندما تكون نفس المعلومة موجودة في حالتين، يجب أن يتذكر كل تحديث تغيير كليهما — وحتماً يتم نسيان أحدهما، مما ينتج عنه أخطاء حيث يُظهر الواجهة قيماً غير متسقة.

## الحل: مصدر واحد، اشتق الباقي

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

قم بتخزين القيمة الأساسية مرة واحدة؛ احسب أي شيء مشتق منها على الفور. لا يوجد شيء يجب إبقاؤه متزامناً.

## حيث ينطبق هذا المبدأ

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

## لماذا يهم

مصدر واحد للحقيقة هو مبدأ أساسي لإدارة الحالة الموثوقة — فهو يلغي فئة كاملة من الأخطاء الناجمة عن بيانات مكررة تتباعد.

هذا *السبب* الذي تشتق القيم من أجله بدلاً من تخزينها، و*السبب* الذي تتجنب به نسخ props إلى الحالة، و*السبب* الذي تركزيه فيه المتاجر العامة البيانات المشتركة.

عندما يكون للبيانات بيت سلطة واحد وكل شيء يقرأ منها، تبقى واجهتك متسقة بالبناء.