node-api-boilerplate

لماذا وُجد هذا المشروع

كل مشروع Node يبدأ بالثلاثة أيام نفسها من العمل المتكرر: المصادقة، والتحقق، ومعالجة الأخطاء، والاختبارات. هذا المستودع هو جوابي الشخصي — الهيكل الذي أنشره قبل كتابة أي سطر من منطق العمل.

ما الذي يتضمنه

• TypeScript في الوضع الصارم، من ملف الإعداد إلى آخر مسار
• مصادقة JWT مع تدوير رموز التحديث، جاهزة للاستخدام
• غلاف أخطاء موحد حتى لا يضطر العملاء أبدًا إلى تحليل الاستثناءات
• تحقق Zod عند كل حدود
• مجموعة اختبارات Vitest تغطي المسارات الحرجة، لا الزخرفية منها

بداية سريعة

استنسخ المستودع، اضبط متغيري بيئة، وسيمنحك npm run dev واجهة API موثّقة مع مسار مصادقة يعمل في أقل من دقيقة.

الفلسفة

الهيكل الجيد يكسب مكانته بأن يكون مملًا. لا توجد هنا أي تجريدات بارعة — الكود يُقرأ كما تُقرأ وثائق الإطار نفسه، لتكون أول خطوة تقوم بها هي وصف مجالك، لا فكّ شفرة مجالي.