<p style="color: #9fb0c7; font-size: 1.1rem;">ابدأ العمل على BrightAI Kernel خلال ساعات بدل أسابيع</p>مرحباً بك في فريق Kernel
هالدليل يخذك من الصفر لحد ما تقدر تساهم في Kernel باستقلالية. المطلوب منك:
- خبرة في TypeScript أو JavaScript
- فهم أساسي لأمان الويب
- تثبيت Node.js 18+ وpnpm
- حساب GitHub مرتبط بالمشروع
إعداد البيئة المحلية
- استنساخ المستودع:
git cloneمن GitHub - تثبيت الاعتماديات:
pnpm install - إعداد متغيرات البيئة: انسخ
.env.exampleإلى.env - تشغيل محلي:
pnpm dev - تشغيل الاختبارات:
pnpm test
بنية المشروع
| المجلد | المحتوى | ملاحظات |
|---|---|---|
src/pages/kernel/ |
صفحات Kernel | كل صفحة ملف Astro منفصل |
src/components/ |
المكونات المشتركة | استخدم المكونات الموجودة قبل الإنشاء |
src/content/docs/ |
ملفات التوثيق | Markdown مع frontmatter موحد |
public/kernel/ |
الأصول الثابتة للـ Kernel | CSS وJS خاص بالـ Kernel |
scripts/ |
سكربتات البناء والتحقق | لا تعدل بدون مراجعة |
سير العمل اليومي
- _pull latest_ من main
- أنشئ فرع جديد من main
- اكتب اختبارات أولاً (TDD)
- نفّذ التغيير
- شغّل الاختبارات وتأكد من النجاح
- أرسل Pull Request مع وصف واضح
- انتظر مراجعة الزميل
نصيحة يزيد
من تجربتي:
اقرأ بنية Kernel قبل ما تلمس كود. فهم الطبقات الأربع يوفر عليك ساعات من الارتباك.