استعلامات التعديل وإدارة المصفوفات ($addToSet, $pull, $push)

// إضافة مهارة جديدة (نجحت)
db.users.updateOne(
  { name: "جمال" },
  { $addToSet: { skills: "Next.js" } }
);
// النتيجة: skills = ["React", "Node.js", "MongoDB", "Next.js"]

// إضافة نفس المهارة (لن تُضاف)
db.users.updateOne(
  { name: "جمال" },
  { $addToSet: { skills: "Next.js" } }
);
// النتيجة: skills تبقى كما هي — لا تكرار!

// إضافة مهارة (تُضاف دائماً)
db.users.updateOne(
  { name: "سارة" },
  { $push: { skills: "Python" } }
);

// إضافة نفس المهارة مرة أخرى
db.users.updateOne(
  { name: "سارة" },
  { $push: { skills: "Python" } }
);
// النتيجة: skills = ["Python", "Python"] — تكرار!

// الفرق الجوهري:
// $addToSet -> فريد (Set semantics)
// $push     -> دائم (List semantics)

// حذف مهارة معيّنة
db.users.updateOne(
  { name: "جمال" },
  { $pull: { skills: "Node.js" } }
);
// النتيجة: Node.js تُحذف من المصفوفة

// حذف جميع العناصر المطابقة
db.users.updateMany(
  {},
  { $pull: { skills: "React" } }
);
// النتيجة: React تُحذف من جميع المستخدمين

// $pull يعمل بـ "مطابقة دقيقة" (Exact Match)
// لحذف عناصر أكثر تعقيداً، يمكن استخدام شروط:
db.users.updateMany(
  {},
  { $pull: { skills: { $in: ["HTML", "CSS"] } } }
);

// سيناريو واقعي: إدارة مهارات مستخدم
// 1. إضافة مهارة فريدة
db.users.updateOne(
  { name: "جمال" },
  { $addToSet: { skills: "TypeScript" } }
);

// 2. إضافة نشاط للسجل (يُسمح بالتكرار)
db.users.updateOne(
  { name: "جمال" },
  { $push: { activities: "تسجيل دخول" } }
);

// 3. حذف مهارة قديمة
db.users.updateOne(
  { name: "جمال" },
  { $pull: { skills: "jQuery" } }
);