نمذجة العلاقات المضمنة والمرجعية (Embedding vs Referencing)

db.users.insertOne({
  name: "جمال سالم",
  // كائن مضمن
  address: {
    city: "عمان",
    country: "الأردن",
    zipCode: "11118"
  },
  // مصفوفة كائنات
  contacts: [
    { type: "phone", value: "+962-79-1234567" },
    { type: "email", value: "[email protected]" }
  ]
});

// مجموعة users
db.users.insertOne({
  _id: ObjectId("6512a1"),
  name: "جمال سالم",
  email: "[email protected]"
});

// مجموعة orders — تشير للمستخدم عبر user_id
db.orders.insertOne({
  orderNumber: "ORD-100",
  user_id: ObjectId("6512a1"),  // مرجع
  total: 150.00,
  status: "pending"
});

// لجلب الطلبات مع بيانات المستخدم تحتاج aggregation بـ $lookup
// (سنتعلمها في الدرس الثالث)

// السيناريو 1: مدونة
// المقال + التعليقات تُقرأ معاً -> تضمين
db.posts.insertOne({
  title: "مقدمة في MongoDB",
  content: "...",
  comments: [   // مضمنة لأنها تُقرأ مع المقال
    { author: "أحمد", text: "مقال رائع!" },
    { author: "سارة", text: "شكراً على الشرح" }
  ]
});

// السيناريو 2: متجر إلكتروني
// المستخدم له آلاف الطلبات -> مرجعية
db.orders.insertOne({
  orderNumber: "ORD-500",
  user_id: "6512a1",  // مرجع
  total: 350,
  items: [ /* items مضمنة لأنها تُقرأ مع الطلب */ ]
});

// مستند طلب واقعي:
db.orders.insertOne({
  orderNumber: "ORD-101",
  
  // مرجعي: المستخدم كبير ومستقل
  user_id: "6512a2",
  
  // مضمن: عنوان الشحن ثابت مع الطلب
  shippingAddress: {
    city: "الرياض",
    country: "السعودية"
  },
  
  // مضمن: المنتجات جزء من الطلب
  items: [
    { product_id: 101, quantity: 2, unitPrice: 1500 },
    { product_id: 102, quantity: 5, unitPrice: 50 }
  ],
  
  total: 3250,
  status: "pending"
});

// لماذا هذا التصميم؟
// • user_id مرجعي -> لأن المستخدم له بيانات كثيرة مستقلة
// • shippingAddress مضمن -> لأن العنوان يُقرأ دائماً مع الطلب
// • items مضمنة -> لأنها جزء لا يتجزأ من الطلب