إعداد Prisma ORM

# إعداد Prisma ORM

تتحكم هذه المهارة في اختيار إصدار ORM لأعمال الإعداد والاتصال. حافظ على إصدار ORM الخاص بالتطبيق وقاعدة البيانات المقصودة. لا يتطلب إصلاح الاتصال ترقية رئيسية.

تستخدم التطبيقات الجديدة افتراضيا **Prisma ORM 8**. تنتمي تفاصيل إعداد Prisma 8، والاستعلامات، والترحيلات، ورمز وقت التشغيل إلى [مهارة prisma-8](https://github.com/prisma/orm/tree/main/skills/prisma-8) المرفقة مع حزمة ORM.

## 1. اكتشاف نقطة البداية

اقرأ بيان الحزمة، وملف القفل (lockfile)، وتكوين Prisma، والمخطط (schema)، واستيرادات التطبيق. حدد إصدار ORM، ومزود قاعدة البيانات، ووقت التشغيل. لا يحدد إصدار CLI وحده إصدار التطبيق: يمكن أن يتعايش Prisma 8 CLI مع عميل قديم، لذا افحص `@prisma/client` و`@prisma/prisma7` والمخطط والتكوين.

| نقطة البداية | المسار | | :---------------------------------------------------- | :--------------------------------------------------------- | | تطبيق Prisma 8 | الخطوة 4، بدون إعادة تهيئة | | تطبيق جديد بدون اختيار إصدار | الخطوة 3 | | تطبيق Prisma 6 أو 7، أو إصدار رئيسي سابق صريح | [الخطوة 5](#5-set-up-or-repair-an-earlier-version) |

بالنسبة لتطبيق جديد، تحقق من [دعم المزود](https://www.prisma.io/docs/orm/supported-databases) ومتطلبات وقت التشغيل لإصدار Prisma 8 المحدد قبل التثبيت. إذا كان المزود غير مدعوم، اشرح القيد وقدم إصدارا سابقا محددا بشكل صريح. حافظ على قاعدة البيانات المطلوبة؛ لا ترجع بصمت أو تختر هدفا مدعوما.

استخدم قاعدة بيانات موجودة عند توفرها. قم بتحميل `prisma-postgres-setup` فقط عندما تكون Prisma Postgres مطلوبة ولم يتم اختيار اتصال بعد؛ عد إلى هنا بمجرد الاتصال.

## 2. التعامل مع طلبات الترقية الرئيسية بشكل منفصل

عندما يطلب المستخدم ترقية رئيسية، قم بتحميل سير عمل يدعم الإصدار المصدر والمزود. لترقية PostgreSQL من 7 إلى 8، استخدم [دليل ترحيل Prisma](https://www.prisma.io/docs/guides/upgrade-prisma-orm/postgresql)؛ لترقية MongoDB من 6 إلى 8، استخدم [prisma-mongodb-upgrade](../prisma-mongodb-upgrade/SKILL.md). تتطلب المزودات الأخرى مسار ترحيل مدعوما بشكل صريح. يغطي `prisma-upgrade-v7` الترقية من **6 إلى 7**؛ ويغطي مرجع ترقية `prisma-8` المملوك للحزمة التحديثات ضمن الإصدار 8.

## 3. تهيئة تطبيق Prisma 8 جديد

تحقق من [متطلبات وقت التشغيل](https://www.prisma.io/docs/orm/release-status) و[دليل التهيئة](https://www.prisma.io/docs/cli/orm-init) للإصدار المحدد. قم بحل وتثبيت إصدار منشور من Prisma CLI **8**، بما في ذلك لاحقة الإصدار التجريبي إذا لزم الأمر؛ تحقق من إصداره قبل التهيئة. لا تعتمد على بقاء `latest` إصدارا 8.

استخدم مدير حزم المشروع لتشغيل CLI المثبت. ل PostgreSQL وتأليف لغة مخطط Prisma:

```bash prisma orm init --yes --target postgres --authoring psl ```

استخدم الهدف المدعوم للمزود المحدد. حافظ على ملفات التطبيق الحالية وتكوين الاتصال؛ لا تدع الإعداد يوفر قاعدة بيانات غير ذات صلة. تحقق من أن حزمة ORM المحلولة هي الإصدار 8 قبل المتابعة.

## 4. تحميل إرشادات Prisma 8 المثبتة

قم بتشغيل CLI المثبت عبر مدير حزم المشروع:

```bash prisma skills sync ```

ثم **اقرأ** `prisma-8/SKILL.md` المتزامن، على سبيل المثال `.agents/skills/prisma-8/SKILL.md`، واتبع شروطه المسبقة والمراجع المختارة. لا يؤدي التزامن وحده إلى تحميل التعليمات. إذا تعذر تحميل الإرشادات المملوكة للحزمة، أبلغ عن المعوق. تابع بالخطوة 6.

## 5. إعداد أو إصلاح إصدار سابق

لإعداد جديد يختار إصدارا سابقا بشكل صريح، قم بتثبيت الحزم على هذا الإصدار الرئيسي واستخدم متطلبات وقت التشغيل الخاصة به. حافظ على توافق إصدارات CLI والعميل ومحول SQL. لا تحتاج التبعيات الموجودة إلى التغيير لإصلاح الاتصال.

- **Prisma 7 SQL:** استخدم مرجع المزود أدناه و[إعداد العميل](references/v7-client-setup.md). - **Prisma 6 MongoDB:** استخدم [إعداد MongoDB](references/v6-mongodb.md). لا تنطبق محولات مشغل SQL. - **Prisma 6 SQL:** حافظ على مولده، وعنوان URL للمخطط، وتهيئة العميل. استخدم تفاصيل اتصال المزود أدناه و[وثائق Prisma 6](https://www.prisma.io/docs/orm/v6)؛ لا تنسخ تكوين Prisma 7 أو أمثلة المحول إليه.

| قاعدة البيانات | المرجع | | :----------------------------------- | :------------------------------------------------------ | | PostgreSQL | [PostgreSQL](references/v7-postgresql.md) | | MySQL / MariaDB / PlanetScale | [MySQL](references/v7-mysql.md) | | SQLite / Turso | [SQLite](references/v7-sqlite.md) |