البدء السريع

تنتقل بك هذه الصفحة من "ليس لديّ شيء" إلى "أنظر إلى نتائج فحص مستودعي" خلال نحو عشر دقائق. ستحتاج إلى:

• مستودع مستضاف على Forgejo أو GitHub أو GitLab أو Bitbucket.
• متصفّح ويب.
• للمستودعات الخاصة: رمز وصول شخصي (PAT) بصلاحية القراءة على المستودع.

1. إنشاء حسابك

افتح https://patchwire.app/register واملأ:

الحقل	ما تُدخله
اسم المنظمة	الاسم الظاهر على لوحة التحكم.
معرّف المنظمة (slug)	معرّف مناسب للروابط — حروف وأرقام وشرطات فقط. لا يمكن تغييره لاحقاً — اختر اسماً دائماً.
البريد الإلكتروني	عنوان تسجيل الدخول.
كلمة المرور	8 أحرف على الأقل.

يصبح الـslug جزءاً من كل رابط داخل التطبيق وكل نقطة نهاية webhook، لذا اسم مثل acme أو my-team أفضل من me-test-1.

عند الضغط على إنشاء الحساب، يقوم الـAPI بثلاث خطوات بشكل ذرّي:

1. يُنشئ صف المنظمة.
2. يُنشئ سجل المستخدم بدور admin.
3. يُصدر JWT (صالح 24 ساعة) ويخزّنه في localStorage داخل المتصفّح.

ستصل إلى /dashboard وأنت مسجَّل الدخول مسبقاً.

2. تسجيل أول مشروع

المشروع في Patchwire هو مستودع واحد تريد فحصه.

1. من لوحة التحكم أو /projects، اضغط + مشروع جديد.
2. املأ:
   • slug: عادةً يطابق اسم المستودع، مثل web للمستودع acme/web.
   • الاسم: اسم ظاهر مفهوم.
   • رابط المستودع: رابط HTTPS للنسخ. سيستخدمه Patchwire لتعبئة "ابدأ الفحص الآن" تلقائياً.
   • الفرع الافتراضي: القيمة المعتادة main.
3. إذا كان مستودعك خاصاً، وسِّع قسم "مستودع خاص؟" وألصق رمز وصول. راجع المستودعات الخاصة للتفاصيل حسب كل مزوِّد.
4. اضغط إنشاء.

3. تشغيل أول فحص

هناك مساران لإطلاق فحص: دفع commit (webhook) أو الضغط على الزر (يدوي).

فحص يدوي

1. افتح صفحة المشروع.
2. اضغط + ابدأ الفحص الآن.
3. رابط النسخ والفرع مُعبّآن مسبقاً من المشروع. أكِّد وأرسل.
4. يظهر صف الفحص بحالة pending ← running ← completed. مستودع نموذجي بحجم 1000 ملف ينتهي خلال نحو 60 ثانية.

فحص مُطلَق بـwebhook

سير العمل الأفضل بكثير — كل دفع إلى الفرع الافتراضي يُطلق فحصاً تلقائياً.

راجع Webhooks للإعداد حسب كل مزوِّد.

4. مراجعة النتائج

عند اكتمال الفحص:

• عدد النتائج يظهر في صف الفحص، موزَّعاً حسب درجة الخطورة.
• اضغط على الفحص لرؤية كل نتيجة مع الماسح الذي رصدها (semgrep أو gitleaks)، ومسار الملف، ورقم السطر، ووصف القاعدة.
• اضغط تصدير PDF للحصول على تقرير قابل للطباعة ومُقسَّم على صفحات — مفيد للتسليم لمراجِع غير تقني أو إرفاقه بتذكرة.

5. ماذا بعد

• المفاهيم الأساسية — ما هي "المنظمة" و"المشروع" و"الفحص" و"النتيجة" فعلياً في نموذج البيانات.
• Webhooks — فحوصات تلقائية عند الدفع.
• المستودعات الخاصة — رموز وصول آمنة للمستودعات غير العامة.
• مرجع الـAPI — كل نقطة نهاية مع طلبات نموذجية.