شرح MongoDB للمبتدئين: قاعدة بيانات NoSQL الأشهر

CREATE TABLE users (
  id SERIAL,
  name VARCHAR(100),
  email VARCHAR(200)
);

// لا schema — تُدخل ما تريد
{
  _id: ObjectId("..."),
  name: "أحمد",
  email: "[email protected]",
  preferences: { theme: "dark", lang: "ar" }, // ← كائن متداخل
  tags: ["vip", "early-adopter"],             // ← مصفوفة
}

# Windows: MongoDB Community من mongodb.com/download
# Mac
brew install mongodb-community
brew services start mongodb-community

# Linux
sudo apt install mongodb

npm install mongoose

import mongoose from "mongoose";

await mongoose.connect("mongodb://localhost:27017/myapp");
console.log("✓ متصل");

import mongoose from "mongoose";

const userSchema = new mongoose.Schema({
  name: { type: String, required: true, trim: true },
  email: { type: String, required: true, unique: true, lowercase: true },
  age: { type: Number, min: 0, max: 150 },
  tags: [String],
  profile: {
    bio: String,
    avatar: String,
  },
  createdAt: { type: Date, default: Date.now },
});

export const User = mongoose.model("User", userSchema);

// طريقة 1
const user = new User({ name: "سارة", email: "[email protected]" });
await user.save();

// طريقة 2
const created = await User.create({
  name: "محمد",
  email: "[email protected]",
});

// عدّة وثائق
await User.insertMany([
  { name: "علي", email: "[email protected]" },
  { name: "فاطمة", email: "[email protected]" },
]);

// كل الوثائق
const all = await User.find();

// بشرط
const adults = await User.find({ age: { $gte: 18 } });

// بمعرّف
const user = await User.findById("507f1f77bcf86cd799439011");

// واحد
const user = await User.findOne({ email: "[email protected]" });

// اختيار أعمدة
const lean = await User.find().select("name email").lean();

// ترتيب + تحديد
const top = await User.find()
  .sort({ createdAt: -1 })
  .limit(10);

// pagination
const page2 = await User.find()
  .skip(20)
  .limit(10);

// أكبر من
User.find({ age: { $gt: 18 } });

// بين قيمتين
User.find({ age: { $gte: 18, $lte: 65 } });

// موجود في قائمة
User.find({ role: { $in: ["admin", "editor"] } });

// بحث نصّي
User.find({ name: /أحمد/i });

// متعدّد الشروط
User.find({
  $or: [
    { role: "admin" },
    { age: { $lt: 25 } },
  ],
});

// واحد
await User.updateOne({ _id: id }, { $set: { age: 30 } });

// كل المطابقين
await User.updateMany(
  { role: "user" },
  { $set: { verified: true } }
);

// إضافة لمصفوفة
await User.updateOne(
  { _id: id },
  { $push: { tags: "premium" } }
);

// زيادة
await User.updateOne({ _id: id }, { $inc: { loginCount: 1 } });

// إرجاع المُحدَّث
const updated = await User.findByIdAndUpdate(
  id,
  { $set: { name: "اسم جديد" } },
  { new: true }
);

await User.deleteOne({ _id: id });
await User.deleteMany({ active: false });
await User.findByIdAndDelete(id);

const stats = await User.aggregate([
  // 1. صفِّ المستخدمين الفعّالين
  { $match: { active: true } },

  // 2. جمِّع حسب الدور
  {
    $group: {
      _id: "$role",
      count: { $sum: 1 },
      avgAge: { $avg: "$age" },
    },
  },

  // 3. رتِّب
  { $sort: { count: -1 } },
]);

const withOrders = await User.aggregate([
  {
    $lookup: {
      from: "orders",          // collection ثانية
      localField: "_id",
      foreignField: "userId",
      as: "orders",
    },
  },
]);

// فهرس فريد
userSchema.index({ email: 1 }, { unique: true });

// فهرس مركّب
userSchema.index({ role: 1, createdAt: -1 });

// فهرس نصّي للبحث
userSchema.index({ name: "text", bio: "text" });
User.find({ $text: { $search: "أحمد مطوّر" } });

const postSchema = new Schema({
  title: String,
  comments: [
    {
      author: String,
      text: String,
      createdAt: { type: Date, default: Date.now },
    },
  ],
});

const orderSchema = new Schema({
  userId: { type: Schema.Types.ObjectId, ref: "User" },
  items: [...],
});

// جلب المستخدم مع الطلب
const order = await Order.findById(id).populate("userId");
console.log(order.userId.name);