ما هو Mongoose ولماذا نستخدم ODM؟

Question

Accepted Answer

**Mongoose** هي مكتبة **ODM** (Object Data Modeling) الأكثر شيوعاً لـ MongoDB في Node.js — حيث تضيف **schemas**، **validation**، **type casting**، **middleware**، وطبقة نموذج منظمة فوق محرك MongoDB المرن وخالي من schemas. وهي تجلب البنية والراحة إلى MongoDB في تطبيقات Node.

## تحديد schema و model

```js
const userSchema = new mongoose.Schema({
  name: { type: String, required: true },           // type + validation
  email: { type: String, required: true, unique: true, lowercase: true },
  age: { type: Number, min: 0, max: 120 },
  role: { type: String, enum: ["user", "admin"], default: "user" },
  createdAt: { type: Date, default: Date.now }
});

const User = mongoose.model("User", userSchema);   // a model = an interface to the collection
```

ـ **schemas** في Mongoose تحدد البنية والأنواع والتحقق — مما يضيف فرض schema الذي ينقصه نموذج MongoDB المرن افتراضياً. تُوفر النماذج واجهة نظيفة للعمليات.

## استخدام النموذج (مع التحقق)

```js
// create — validation runs automatically
const user = await User.create({ name: "Ann", email: "ANN@X.COM", age: 30 });
// → email lowercased, validated, required fields checked; throws if invalid

// query — clean, typed interface
const users = await User.find({ age: { $gt: 25 } });
const one = await User.findById(id);
await User.findByIdAndUpdate(id, { age: 31 });
```

## ما يضيفه ODM عن المحرك الخام

```text
✓ SCHEMA + VALIDATION — enforce structure and rules MongoDB doesn't by default
  (required fields, types, ranges, enums) → consistency and data integrity
✓ TYPE CASTING — convert/validate types automatically
✓ MIDDLEWARE (hooks) — pre/post save/update logic (e.g. hash a password before saving)
✓ VIRTUALS, methods, statics — add computed properties and custom logic to models
✓ POPULATE — resolve references (join-like, similar to $lookup) conveniently
✓ A structured, convenient model layer (cleaner than raw driver calls)
```

## المقابلة

```text
✓ Structure, validation, convenience, productivity
✗ Abstraction overhead; can hide MongoDB details; schema rigidity reduces some of
  MongoDB's flexibility (which may be exactly what you want, or not)
→ Mongoose is very common in Node/MongoDB apps; some prefer the raw driver for
  flexibility/performance. Choose based on the project's needs.
```

## لماذا يهم هذا

فهم Mongoose ودور ODM قيّم لأن Mongoose هي الطريقة السائدة لاستخدام MongoDB في تطبيقات Node.js، لذا فهي معرفة عملية أساسية لهذا الـ stack الشائع.

القيمة الأساسية التي يوفرها ODM مثل Mongoose هي إضافة **بنية إلى نموذج MongoDB المرن وخالي من schemas**: **schemas مع validation** (فرض الحقول المطلوبة، الأنواع، النطاقات، enums — مما يجلب سلامة البيانات والاتساق الذي ينقصه MongoDB الخام افتراضياً، وهو أمر مهم للتطبيقات الموثوقة)، **type casting**، **middleware/hooks** (للمنطق المشترك مثل تجزئة كلمات المرور قبل الحفظ)، **methods/virtuals** (إضافة السلوك إلى النماذج)، و **populate** (حل المراجع بسهولة).

هذا يجعل MongoDB أكثر تنظيماً وتحققاً وإنتاجية للعمل معه في Node — معالجة مشكلة حقيقية وهي أن مرونة MongoDB، على الرغم من قوتها، قد تؤدي إلى بيانات غير متسقة بدون انضباط.

فهم **المقابلة** مهم أيضاً: Mongoose تضيف بنية وتحقق وراحة لكن تقدم نفقات abstraction وبعض الصلابة (تقليل مرونة MongoDB — وهي قد تكون مرغوبة أم لا)، لذا بعض المشاريع تفضل المحرك الخام للمرونة والأداء، والاختيار بناءً على احتياجات المشروع يعكس حكماً سليماً.

بما أن stack Node.js + MongoDB شائع جداً، وبما أن Mongoose (أو ODM) هي الطريقة القياسية لإضافة schema والتحقق والبنية إلى MongoDB في تطبيقات Node (مع schemas وvalidation وmiddleware وpopulate كونها أساسية لكيفية بناء معظم هذه التطبيقات)، فهم Mongoose ومفهوم ODM — ما تضيفه (schema/validation/structure فوق نموذج MongoDB المرن)، ميزاتها، ومقابلاتها — معرفة قيمة وعملية وذات صلة بـ stack Node/MongoDB الشائع، مما يعكس فهماً لكيفية استخدام MongoDB عادة في تطبيقات Node الحقيقية مع بنية وتحقق مناسب.