Что такое модули в NestJS?

Question

Accepted Answer

**Модуль** — это класс, украшенный декоратором `@Module()`, который **группирует связанные компоненты** — контроллеры, провайдеры/сервисы — в единое целое. Модули — это способ, с помощью которого 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)
```

Конвенция — **один модуль на функцию/домен** (users, auth, products), что позволяет держать связанный код вместе и делает зависимости явными.

## Совместное использование провайдеров между модулями

```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-приложения — они группируют связанные контроллеры и провайдеры в единые функциональные блоки и определяют границы dependency-injection.

Понимание четырёх свойств (`controllers`, `providers`, `imports`, `exports`) и особенно **механизма import/export** для совместного использования провайдеров между модулями является необходимым: это способ, с помощью которого NestJS достигает модульной, слабо связанной архитектуры, где каждая функция автономна и зависимости явны.

Структура модулей по функциям (один модуль на домен) — это стандартный способ организации Nest-приложений для масштабируемости и поддерживаемости.

Модули вместе с контроллерами и провайдерами составляют ядро архитектуры NestJS, делая их фундаментальным знанием — овладение тем, как структурировать приложение на модули и связывать провайдеры между ними через imports/exports, необходимо для создания любого нетривиального NestJS-приложения и является частой точкой замешательства, которую стоит хорошо понять на начальном этапе.