# المشاريع

> أنشئ مشروعا في AI CodeOps: اربط مستودع Git أو ابدأ من الصفر، واضبط الفرع الافتراضي وأمر الاختبار، وتعرف على ما يتتبعه المشروع مع الوقت.

المصدر: https://aicodeops.dev/ar/docs/projects

المشروع قاعدة كود يعمل عليها AI CodeOps. تتبع كل جلسة ذكاء اصطناعي مشروعا، ويجمع المشروع ما يحدث لذلك الكود مع الوقت: الجلسات والتغييرات وعمليات النشر والحوادث وقوائم SBOM وسجلات القرارات.

## أنشئ مشروعا

1. افتح **Plan → Projects** واختر **New project** (مشروع جديد).
2. املأ النموذج (الحقول أدناه).
3. اختر **Create project** (إنشاء المشروع).

| الحقل                | ما تدخله                                                                                                                                                                |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Identifier**       | المعرف: أحرف صغيرة، بلا مسافات، مثل `billing-api`. يستخدم في العناوين والتقارير. ولا يمكن تغييره لاحقا.                                                                 |
| **Name**             | اسم مقروء، مثل "Billing API".                                                                                                                                           |
| **Type**             | النوع: service أو library أو frontend أو infra أو data pipeline أو model أو docs أو other.                                                                              |
| **Repository URL**   | اختياري. عنوان المستودع، مثل `https://github.com/acme/billing-api`.                                                                                                     |
| **Default branch**   | اختياري. الفرع الذي تعمل عليه الجلسات والطرفية. وتركه فارغا يعني الفرع الافتراضي للمستودع نفسه.                                                                         |
| **Test command**     | اختياري. يشغل بعد أن تكتب الجلسة الكود، على التغيير المقترح، في بيئة معزولة. وتركه فارغا يعني أنه يكتشف تلقائيا (سكربت test في `package.json`، وإلا pytest أو go test). |
| **Health check URL** | اختياري. نقطة نهاية https عامة تستخدمها المراقبة.                                                                                                                       |
| **Description**      | اختياري.                                                                                                                                                                |

### التحقق من الوصول إلى المستودع

بعد إدخال عنوان المستودع، اختر **Verify access** (التحقق من الوصول). يخبرك AI CodeOps هل يمكن الوصول إلى المستودع وما فرعه الافتراضي. وإذا كان لك [حساب Git مربوط](https://aicodeops.dev/ar/docs/git/github) لتلك الخدمة، تعمل المستودعات الخاصة، وتظهر الرسالة "Will use your GitHub account … private repos accessible." ومن دونه، تستنسخ المستودعات العامة مع ذلك، لكنك لا تستطيع فتح طلبات سحب.

ومع وجود حساب مربوط، يبين الفحص أيضا هل يستطيع ذلك الحساب **الدفع** إلى المستودع و**فتح طلبات السحب** فيه، وما الذي تغيره على خدمة استضافة Git لديك حين لا يستطيع. ولا يدفع شيء ولا ينشأ شيء: يسأل الخدمة فقط. ويحسن إجراؤه قبل أول جلسة، لأن الرمز الذي يستطيع قراءة المستودع دون الكتابة فيه لا يفشل بغير ذلك إلا عند فتح طلب السحب.

### كم مشروعا يمكن أن يكون لك

تتضمن خطتك عددا من المشاريع، يحتسب عبر كل مساحات العمل في مؤسستك. وتعرض صفحة Projects العدد بجانب **New project**، مثل "2 of 3 used". وحين لا يبقى أي مشروع متاح، تذكر الصفحة ذلك في موضع النموذج: أرشف مشروعا لتحرير مكانه (يحفظ تاريخه، ويمكن استعادته لاحقا)، أو رقّ الخطة.

### البدء من الصفر

اترك **Repository URL** فارغا لتبدأ قاعدة كود جديدة. فتولد الجلسات المصدر على المنصة، ويمكنك تصفحه في **Develop → Source**. وحين تريد إطلاقه، اختر **Add repo** (إضافة مستودع) في المشروع وأدخل مستودعا؛ فيمكن بعدها فتح التغييرات اللاحقة في صورة طلبات سحب.

### إيقاف الاختبارات

ضع علامة على **Don't run tests for this project** إذا لم تكن للمشروع مجموعة اختبارات. فتتخطى الجلسات خطوة الاختبار، وتبين صفحة التشغيل أن التغيير لم يجر التحقق منه. وبهذا أيضا تخبر بوابة الإصدار ألا تطلب نتيجة اختبار. ومن دونه، ترفض الجلسة التي غيّرت كودا وليست لها نتيجة اختبار فيها أعداد. راجع [بوابات الجودة](https://aicodeops.dev/ar/docs/quality-gates).

## صفحة المشروع

افتح مشروعا لترى:

- الأقسام **Deployments** (عمليات النشر) و **Open incidents** (الحوادث المفتوحة) و **Vulnerable components (latest SBOM)** (المكونات المعرضة للثغرات) و **Recent ADRs** (أحدث سجلات القرارات) في لمحة؛
- خطا زمنيا في **Activity** للجلسات وعمليات النشر والحوادث والقرارات؛
- قسمي **Recent deployments** و **Recent SBOMs**.

ومن هنا يمكنك اختيار **Run workflow** (صف مهمة وابدأ جلسة على هذا المشروع)، أو **Browse source** لتصفح المصدر، أو **Edit** لتعديل المشروع، أو **Archive** لأرشفته.

المشاريع التي تظهر في قوائم SBOM أو سجلات القرارات أو الحوادث لديك لكنها غير معدة بعد تظهر ضمن **Detected projects** في قائمة المشاريع، جاهزة للإضافة.

## الأرشفة والاستعادة

يخفي **Archive** المشروع من القائمة النشطة. يبقى تاريخه، لكنك لا تستطيع تشغيل جلسات عليه. والمشاريع المؤرشفة مسرودة ضمن **Archived**، ومعها **Restore** لإعادة أحدها.

## الخطوات التالية

- [شغّل جلسة](https://aicodeops.dev/ar/docs/sessions)
- [اربط مزود Git](https://aicodeops.dev/ar/docs/git/github)
- [الأمان و SBOM](https://aicodeops.dev/ar/docs/security-and-sbom)

## الأسئلة الشائعة

### هل يمكنني إنشاء مشروع دون مستودع؟

نعم. اترك عنوان المستودع فارغا فيبقى الكود الذي تولده الجلسة على المنصة. وأضف مستودعا لاحقا لإطلاقه في صورة طلب سحب.

### هل يمكنني حذف مشروع؟

يمكنك أرشفته. المشروع المؤرشف مخفي ولا يستطيع تشغيل جلسات، لكن تاريخه يبقى ويمكنك استعادته.
