أدلة التطوير

يستخدم الموقع Next.js مع App Router وReact وTypeScript وBootstrap 5، إلى جانب أنماط خاصة بـ BI3LYX. وتُنشأ الصفحات التحريرية من بيانات ذات أنواع محددة في المستودع.

app/

المسارات والتخطيطات والبيانات الوصفية وخريطة الموقع وموجز RSS ومسار الحالة.

components/

مكونات واجهة قابلة لإعادة الاستخدام، بما فيها التنقل والبطاقات والمستكشف.

lib/

بيانات تحريرية ذات أنواع محددة وإعداد الموقع ونماذج الواجهة البرمجية المخطط لها.

tests/

اختبارات المحتوى والتنقل والمكونات وعرض الصفحات.

• npm install — تثبيت التبعيات.
• npm run dev — تشغيل خادم التطوير.
• npm run typecheck — فحص TypeScript دون إنشاء ملفات.
• npm run lint — تحليل الشفرة باستخدام ESLint.
• npm test — تشغيل مجموعة الاختبارات.
• npm run build — إنشاء بناء الإنتاج.
• npm start — تشغيل بناء Next.js.

تُعرّف صفحات الوثائق والأخبار باستخدام كتل ذات أنواع محددة. ويجب أن يتضمن كل منشور جديد معرفًا فريدًا وعنوانًا ووصفًا وتاريخًا ومحتوى خاليًا من المعلومات غير المؤكدة.

• تحقق من الروابط الداخلية والبيانات الوصفية.
• حدّد بوضوح المعلومات قيد الإعداد.
• لا تنشر إحصاءات مختلقة أو لقطات شاشة محاكاة مطلقًا.
• اطلب مراجعة الادعاءات التقنية قبل النشر.

• أبقِ طبقة الوصول على الخادم منفصلة عن مكونات العرض.
• اضبط رابط الواجهة البرمجية عبر متغير بيئة فقط.
• وفّر مهلة زمنية وحالة خطأ واضحة.
• تحقق من مخططات الاستجابة قبل العرض.
• لا تكشف رابط RPC أو سرًا أو بيانات محفظة مطلقًا.

• لا تعدّل بنية الإنتاج مباشرة من مستودع الموقع.
• يجب أن يجتاز كل تغيير فحص الأنواع والتدقيق والاختبارات والبناء.
• تتطلب عمليات الالتزام والنشر موافقة مسؤول المشروع.
• لا تُنشر الملفات التنفيذية عبر الموقع دون تحقق وتوقيع مطلقًا.