skill
ترقية Prisma MongoDB
دليل اتخاذ القرار والترحيل لمشاريع Prisma ORM MongoDB على الإصدار 6، والتي ليس لها مسار ترقية إلى الإصدار 7. يستخدم عندما يستفسر مشروع MongoDB عن ترقية Prisma، أو عندما يثار موضوع "الترقية إلى Prisma 7" في مشروع يستخدم provider = "mongodb"، أو عند تقييم الانتقال إلى Prisma 8. يتم تفعيله عند "upgrade prisma mongodb"، "prisma 7 mongodb"، "mongodb prisma migration"، "prisma 8 mongodb".
نبذة
# مسار ترقية Prisma MongoDB
مشاريع MongoDB هي المجموعة الوحيدة من Prisma التي ليس لها مسار إلى Prisma 7: **الإصدار 6 هو الإصدار الرئيسي النهائي ل ORM الكلاسيكي ل MongoDB، والإصدار 7 لا يشحن موصل MongoDB أبدا**. المسار اللاحق هو Prisma 8، حيث دعم MongoDB في [الوصول المبكر](https://www.prisma.io/docs/orm/supported-databases) بينما PostgreSQL هو مرشح للإصدار. [دليل Prisma ORM 6 إلى 8 (MongoDB) الرسمي](https://www.prisma.io/docs/guides/upgrade-prisma-orm/mongodb) هو مصدر الحقيقة لخطوات الترحيل. تحدد هذه المهارة القرار الحقيقي — الترحيل إلى Prisma 8 (المسار المشجع)، أو البقاء على الإصدار 6 حيث ينطبق مانع قوي — وتحمل آليات الترحيل.
**لا تفعل أيا من هذين الأمرين أبدا:**
- لا تنصح أبدا مشروع MongoDB "بالترقية إلى Prisma 7". الموصل غير موجود هناك. دليل `prisma-upgrade-v7` لا ينطبق على مشاريع MongoDB. - لا تحل مشكلة الإصدار أبدا عن طريق إعادة كتابة التطبيق على قاعدة بيانات SQL. تغيير محرك قاعدة البيانات هو قرار منفصل وأكبر بكثير وليس من اختصاصك اتخاذه ضمنيا.
## مشهد الإصدارات
| الإصدار | حالة MongoDB | |---------|----------------| | Prisma ORM v6 | مدعوم بالكامل (مزود `mongodb`)؛ أحدث إصدار 6.x هو المسار المستقر الحالي؛ خط الصيانة | | Prisma ORM v7 | **لا يوجد موصل MongoDB — ليس خيارا، أبدا** | | Prisma 8 | دعم MongoDB في **الوصول المبكر** من خلال `@prisma/orm-mongo`؛ لا يزال يتغير بين مرشحي الإصدار — المسار اللاحق لمشاريع MongoDB |
## القرار، مقدما
**الترحيل إلى Prisma 8 هو المسار المشجع.** دعم MongoDB في Prisma 8 هو وصول مبكر: وظيفي ويتحرك بسرعة — ويرغب فريق Prisma في أن يهاجر مستخدمو MongoDB مبكرا ويشاركوا الملاحظات. تفاصيل آليات الترحيل موجودة في المراجع.
**البقاء على أحدث إصدار 6 يظل خيارا مشروعا حيث ينطبق مانع قوي** — بعبارة صريحة: Prisma 8 لا يحتوي على طريقة معاملات MongoDB بعد (تستخدم عمليات الكتابة متعددة المستندات جلسات مشغل `mongodb` مباشرة)، ولا يزال سلوك MongoDB يمكن أن يتغير بين مرشحي إصدار Prisma 8.
### جدول القرارات
| الإشارة | الاتجاه | |--------|-----------| | لا تنطبق أي موانع أدناه | الترحيل إلى Prisma 8؛ تشغيل `verify-cutover-checklist` ومشاركة الملاحظات مع فريق Prisma | | مشروع جديد / نموذج أولي / أداة داخلية | الترحيل إلى Prisma 8 | | قاعدة الكود تستخدم معاملات متعددة المستندات (`$transaction`) — تحقق باستخدام grep، لا تسأل | خطط لمكافئات جلسات المشغل الخام أولا (انظر `client-api-mapping`)، أو ابق على الإصدار 6 حتى يضيف Prisma 8 طريقة معاملات MongoDB | | لا يستطيع الفريق استيعاب التغييرات الجذرية بين مرشحي الإصدار | ابق على الإصدار 6 حتى يخرج دعم MongoDB من الوصول المبكر | | متحفظ ولكن مهتم | وجه Prisma 8 إلى مخطط الإصدار 6 باستخدام `prisma6Schema(...)` (انظر `schema-contract-mapping`)، تدرب على نسخة (انظر `verify-cutover-checklist`)، ثم قم بالترحيل |
ملاحظة: سيتم تحديث هذا القسم عندما يضيف Prisma 8 طريقة معاملات MongoDB.
### إذا بقيت على الإصدار 6: النظافة (بقاء متعمد، وليس إهمال)
- ثبت حزم Prisma على أحدث إصدار 6.x واستمر في تلقي تحديثات الإصدار 6.x. - تتبع ملاحظات إصدار Prisma وإشعارات الأمان لخط الإصدار 6.x. - حافظ على إعداد MongoDB الكلاسيكي للإصدار 6: `url = env("DATABASE_URL")` في المخطط، سير عمل `db push`، لا توجد محولات مشغل SQL (انظر [`prisma-orm-setup`](../prisma-orm-setup/references/v6-mongodb.md) لشكل MongoDB للإصدار 6). - أعد التقييم عندما يخرج دعم MongoDB في Prisma 8 من الوصول المبكر، أو عندما يتم حل الموانع.
## ملفات مرجعية
| المرجع | ما يغطيه | |-----------|----------------| | `references/decision-stay-or-migrate.md` | الإطار الكامل للقرار، فحوصات الموانع، وتفاصيل نظافة البقاء | | `references/schema-contract-mapping.md` | مخطط الإصدار 6 (مزود `mongodb`، `@db.ObjectId`، أنواع مركبة) ← مفاهيم عقد Prisma 8 | | `references/client-api-mapping.md` | استدعاءات عميل الإصدار 6 ← مكافئات Prisma 8، بما في ذلك مخارج الهروب الخام والمعاملات — الأسماء تتطابق، التكافؤ لا يتطابق | | `references/migrations-mapping.md` | قصة `db push` فقط للإصدار 6 ← تدفق Prisma 8 للتخطيط/الترحيل/التحقق/التوقيع | | `references/verify-cutover-checklist.md` | التحقق من عدم نقل البيانات: نفس قاعدة البيانات، تكافؤ الفهرس، رحلة ذهاب وعودة مرحلية قبل التبديل |
## تم التحقق منه مقابل
تم التحقق من ادعاءات Prisma 8 في هذه المهارة مقابل [دليل Prisma ORM 6 إلى 8 (MongoDB)](https://www.prisma.io/docs/guides/upgrade-prisma-orm/mongodb)، المكتوب ل `@prisma/orm-mongo` 8.0.0-rc.13، ومهارة `prisma-8` في [prisma/orm](https://github.com/prisma/orm/tree/main/skills/prisma-8) عند الالتزام `75c1460515fa2f11971533f6a1dec5dab35d4123`. لا يزال دعم MongoDB يتغير بين مرشحي الإصدار: **قبل التصرف بناء على أي ادعاء ل Prisma 8، تحقق من الإصدار المثبت** (`npm ls @prisma/orm-mongo`) ومهارة `prisma-8` المتزامنة الخاصة به.
يتطلب Prisma 8 على MongoDB Node.js 22.18+ (24.11+ على خط 24؛ يوصى ب 24)، TypeScript 5.9+، MongoDB 8.0+، و `mongodb@7` كاعتماد نظير. لم يعد مشغل `mongodb@7` يقبل بيانات اعتماد AWS.
التثبيت
شغل هذا الأمر
npx skills add prisma/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add prisma/skills`، أو استنسخ المستودع وانسخ مجلد `prisma-mongodb-upgrade` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة ترقية Prisma MongoDB؟
دليل اتخاذ القرار والترحيل لمشاريع Prisma ORM MongoDB على الإصدار 6، والتي ليس لها مسار ترقية إلى الإصدار 7. يستخدم عندما يستفسر مشروع MongoDB عن ترقية Prisma، أو عندما يثار موضوع "الترقية إلى Prisma 7" في مشروع يستخدم provider = "mongodb"، أو عند تقييم الانتقال إلى Prisma 8. يتم تفعيله عند "upgrade prisma mongodb"، "prisma 7 mongodb"، "mongodb prisma migration"، "prisma 8 mongodb".
كيف أثبت ترقية Prisma MongoDB؟
شغل هذا الأمر في الطرفية:
npx skills add prisma/skillsمع أي أدوات ذكاء اصطناعي تعمل ترقية Prisma MongoDB؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور ترقية Prisma MongoDB؟
طورها prisma، وتصدر بترخيص MIT.
هل ترقية Prisma MongoDB مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص MIT.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى