ما هي الوحدات (Modules) في NestJS؟

Question

Accepted Answer

**الوحدة** هي فئة مزينة بـ `@Module()` تقوم بـ **تجميع المكونات ذات الصلة** — المتحكمات (controllers)، مقدمي الخدمات (providers/services) — في وحدة متماسكة. الوحدات هي الطريقة التي ينظم بها NestJS التطبيق إلى ميزات، وكل تطبيق Nest له وحدة جذر `AppModule` على الأقل.

## تعريف الوحدة

```ts
import { Module } from "@nestjs/common";

@Module({
  controllers: [UsersController],    // controllers belonging to this module
  providers: [UsersService],          // providers (services) this module creates
  imports: [DatabaseModule],          // OTHER modules whose exports this module needs
  exports: [UsersService],            // what this module makes available to importers
})
export class UsersModule {}
```

## الخصائص الأربع الرئيسية

```text
controllers → the controllers (request handlers) in this module
providers   → the providers/services defined and instantiated here (for DI)
imports     → other modules whose EXPORTED providers this module can use
exports     → the subset of THIS module's providers shared with importing modules
```

تشكل الوحدات **نطاق DI**: يكون مقدم الخدمة متاحًا داخل وحدته، وللوحدات الأخرى فقط إذا تم **تصديره** (وقامت الوحدة الأخرى بـ **استيراده**).

## الوحدة الجذرية

```ts
@Module({
  imports: [UsersModule, AuthModule, DatabaseModule],   // compose feature modules
})
export class AppModule {}   // the root — bootstrapped to start the app
```

كل تطبيق له وحدة جذرية `AppModule` تستورد وحدات الميزات، مما يؤلف التطبيق بأكمله.

## التنظيم القائم على الميزات

```text
src/
  app.module.ts            (root — imports feature modules)
  users/
    users.module.ts        (groups users controller + service)
    users.controller.ts
    users.service.ts
  auth/
    auth.module.ts
  database/
    database.module.ts     (shared infrastructure)
```

الاتفاقية هي **وحدة واحدة لكل ميزة/مجال** (المستخدمون، المصادقة، المنتجات)، مما يحافظ على الكود ذي الصلة معًا والتبعيات واضحة.

## مشاركة مقدمي الخدمات عبر الوحدات

```ts
// UsersModule exports UsersService...
@Module({ providers: [UsersService], exports: [UsersService] })
export class UsersModule {}

// ...so AuthModule can use it by importing UsersModule
@Module({ imports: [UsersModule] })   // now AuthModule can inject UsersService
export class AuthModule {}
```

لاستخدام مقدم خدمة من وحدة أخرى، يجب على الوحدة المزودة أن **تصدره** وعلى الوحدة المستهلكة أن **تستورد** الوحدة المزودة — مما يجعل التبعيات واضحة.

## لماذا هذا مهم

الوحدات هي العمود الفقري التنظيمي لكل تطبيق NestJS — فهي تجمع المتحكمات ومقدمي الخدمات ذات الصلة في وحدات ميزات متماسكة وتحدد حدود حقن التبعيات.

فهم الخصائص الأربع (`controllers`, `providers`, `imports`, `exports`) وخاصة آلية **استيراد/تصدير** مقدمي الخدمات عبر الوحدات أمر ضروري: هذه هي الطريقة التي يحقق بها NestJS معمارية معيارية وضعيفة الاقتران حيث تكون كل ميزة مستقلة وتكون التبعيات واضحة.

بنية الوحدات القائمة على الميزات (وحدة واحدة لكل مجال) هي الطريقة القياسية لتنظيم تطبيقات Nest للقابلية للتوسع والصيانة.

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