🚀 ممارسات متقدمة في NestJS لبناء واجهات برمجية قابلة للتوسع والصيانة

في هذا المقال، سأرشدك خطوة بخطوة إلى ممارسات متقدمة لكنها واضحة وسهلة الفهم، تساعدك في بناء مشاريع NestJS قابلة للتوسع وسهلة الصيانة.

لنبدأ 🔥

🧱 1. تنظيم المشروع باستخدام المعمارية المودولية (Modular Architecture)

📌 ما هو "الموديول" في NestJS؟

الموديول هو طريقة لتنظيم الكود في وحدات مستقلة. كل وحدة تمثل ميزة واحدة في التطبيق (مثلاً المستخدمين، المصادقة، المنتجات...).

👎 الخطأ الشائع:

الاعتماد على ملف AppModule فقط أو دمج جميع الخصائص في موديولات قليلة.

✅ الحل: تنظيم المشروع حسب الميزات

src/
├── auth/
│   ├── auth.controller.ts
│   ├── auth.service.ts
│   └── auth.module.ts
├── users/
│   ├── users.controller.ts
│   ├── users.service.ts
│   └── users.module.ts

لماذا هذا مهم؟

• يسهل اختبار كل جزء لوحده
• يمنع تشابك الأكواد
• يسهل توظيف فرق متعددة للعمل بالتوازي
• يسمح بإعادة استخدام الموديولات في أماكن أخرى

🧠 2. استخدام حقن التبعيات (Dependency Injection) بذكاء

📌 ما هو DI؟

بدلاً من إنشاء الكائنات (Objects) يدويًا، يقوم NestJS بحقنها تلقائيًا في الأماكن التي تحتاجها.

constructor(private userService: UserService) {}

NestJS يعرف أنك تحتاج إلى UserService ويزودك بها مباشرة.

✅ نصائح عملية:

• أنشئ خدمات مشتركة مثل LoggerService أو MailService بدلاً من التكرار
• تجنب إنشاء تبعيات دائرية عبر فصل الكود في موديولات مستقلة
• استعمل الواجهات (Interfaces) عند الإمكان، لتسهيل الاختبار

مثال:

@Injectable()
export class AppLogger {
  log(message: string) {
    console.log(`[APP] ${message}`);
  }
}

ثم استخدم AppLogger في أي مكان بدلاً من console.log.

🛡️ 3. فهم واستخدام Guards و Interceptors و Pipes

🛡️ مثال على Guard:

@Injectable()
export class AuthGuard implements CanActivate {
  canActivate(context: ExecutionContext): boolean {
    const req = context.switchToHttp().getRequest();
    return !!req.user; // السماح فقط إذا كان المستخدم موجود
  }
}

🔍 مثال على Pipe للتحقق من البيانات:

@UsePipes(new ValidationPipe())
@Post()
createUser(@Body() dto: CreateUserDto) {
  // يتم التحقق والتحويل تلقائيًا
}

🛠️ 4. إنشاء ديكوريترز مخصصة (Custom Decorators)

📌 ما هو Decorator؟

هو وسيلة لإضافة وظائف إلى المتغيرات أو الدوال بشكل سهل.

NestJS يوفر ديكوريترز جاهزة مثل: @Body(), @Param(), @Injectable()...

✅ مثال: @CurrentUser()

بدلًا من تكرار الكود:@Get()

get(@Req() req) {
  return req.user;
}

أنشئ ديكوريتر مخصص:

export const CurrentUser = createParamDecorator(
  (_, ctx: ExecutionContext) => {
    const req = ctx.switchToHttp().getRequest();
    return req.user;
  },
);

ثم استخدمه بسهولة:

@Get()
get(@CurrentUser() user) {
  return user;
}

يحسن قراءة الكود ويجعله أنظف.

🌐 5. التحقق من إعدادات البيئة (Environment Variables)

📌 لماذا مهم؟

تطبيقك يعتمد على متغيرات مثل PORT, DATABASE_URL من ملف .env. إذا كانت ناقصة أو خاطئة، التطبيق قد يتوقف.

✅ استخدم @nestjs/config مع Joi للتحقق:

ConfigModule.forRoot({
  isGlobal: true,
  validationSchema: Joi.object({
    DATABASE_URL: Joi.string().required(),
    PORT: Joi.number().default(3000),
  }),
});

هذا يضمن:

• منع التشغيل في حال وجود متغير ناقص
• التحقق من الصحة تلقائيًا
• تقليل الأخطاء في البيئة الحية (Production)

📄 6. إدارة الأخطاء بشكل مركزي (Global Exception Filters)

📌 الهدف:

إرجاع رسائل خطأ موحدة ومنظمة.

✅ مثال:

@Catch(HttpException)
export class GlobalHttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse();
    const status = exception.getStatus();
    const message = exception.getResponse();

    response.status(status).json({
      statusCode: status,
      message,
      timestamp: new Date().toISOString(),
    });
  }
}

سجل هذا الفلتر في main.ts ليُطبق على كل التطبيق.

🔢 7. إنشاء إصدارات للـ API (Versioning)

تريد تطوير API جديد دون كسر القديم؟ استخدم النسخ:

app.enableVersioning({
  type: VersioningType.URI,
});

ثم:

@Controller({ path: 'users', version: '1' })
export class UsersV1Controller {}

@Controller({ path: 'users', version: '2' })
export class UsersV2Controller {}

يسمح لك هذا بدعم عملاء قدامى وجدد في آنٍ واحد.

🧪 8. كتابة اختبارات فعالة

الاختبارات تحميك من الأخطاء، وتساعد في تطوير سريع وآمن.

✅ مثال على اختبار وحدة (Unit Test):

describe('UsersService', () => {
  let service: UsersService;

  beforeEach(async () => {
    const module = await Test.createTestingModule({
      providers: [UsersService],
    }).compile();

    service = module.get(UsersService);
  });

  it('should find a user', async () => {
    expect(await service.findOne(1)).toBeDefined();
  });
});

يمكنك استخدام أدوات مثل jest-mock-extended لمحاكاة الخدمات (Mocks).

⏱️ 9. استخدام الكاش والمهام الخلفية (Caching & Queues)

بعض العمليات مثل إرسال الإيميل أو توليد التقارير قد تكون بطيئة. الحل:

• استخدم Redis مع @nestjs/cache-manager للتخزين المؤقت
• استخدم @nestjs/bull لتنفيذ المهام بالخلفية
• استخدم @nestjs/event-emitter للفصل بين المهام

هذا يجعل التطبيق أسرع وأكثر استجابة.

🎯 10. تحسين تجربة التطوير

استخدم أدوات للحفاظ على جودة الكود:

• eslint + prettier للتنسيق التلقائي
• husky لتشغيل الأوامر قبل الحفظ أو الدفع (push)
• @nestjs/swagger لتوليد توثيق API تلقائيًا

✅ خاتمة

NestJS ليس مجرد إطار عمل، بل هو منصة قوية لإنشاء واجهات API قابلة للتوسع والتنظيم.

اتبع هذه الممارسات المتقدمة لبناء تطبيقات:

• نظيفة
• منظمة
• سهلة التوسع
• وممتعة في التطوير

ابدأ الآن بخطوة واحدة، وطور مشروعك تدريجيًا، وستلاحظ الفرق الكبير مع مرور الوقت.

🔗 مصادر مفيدة

• التوثيق الرسمي لـ NestJS
• مستودع Awesome NestJS على GitHub
• أفضل ممارسات تصميم API