Module trong NestJS là gì?

Question

Accepted Answer

Một **module** là một class được trang trí bằng `@Module()`, dùng để **nhóm các thành phần liên quan** — controller, provider/service — thành một đơn vị gắn kết. Module là cách NestJS tổ chức một ứng dụng thành các tính năng, và mọi ứng dụng Nest đều có ít nhất một root `AppModule`.

## Định nghĩa một module

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

@Module({
  controllers: [UsersController],    // các controller thuộc về module này
  providers: [UsersService],          // các provider (service) mà module này tạo
  imports: [DatabaseModule],          // các module KHÁC mà module này cần exports của chúng
  exports: [UsersService],            // những gì module này cung cấp cho module import nó
})
export class UsersModule {}
```

## Bốn thuộc tính chính

```text
controllers → các controller (bộ xử lý request) trong module này
providers   → các provider/service được định nghĩa và khởi tạo ở đây (cho DI)
imports     → các module khác mà provider được EXPORT của chúng module này có thể dùng
exports     → tập con các provider CỦA module này được chia sẻ cho các module import
```

Module tạo thành một **DI scope**: một provider có sẵn trong module của nó, và đến các module khác chỉ khi được **export** (và module kia **import** nó).

## Root module

```ts
@Module({
  imports: [UsersModule, AuthModule, DatabaseModule],   // ghép các feature module
})
export class AppModule {}   // root — được bootstrap để khởi động ứng dụng
```

Mọi ứng dụng đều có một root `AppModule` import các feature module, ghép thành toàn bộ ứng dụng.

## Tổ chức theo tính năng

```text
src/
  app.module.ts            (root — import các feature module)
  users/
    users.module.ts        (nhóm users controller + service)
    users.controller.ts
    users.service.ts
  auth/
    auth.module.ts
  database/
    database.module.ts     (hạ tầng dùng chung)
```

Quy ước là **một module cho mỗi tính năng/lĩnh vực** (users, auth, products), giữ code liên quan ở cùng nhau và các dependency rõ ràng.

## Chia sẻ provider giữa các module

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

// ...để AuthModule có thể dùng nó bằng cách import UsersModule
@Module({ imports: [UsersModule] })   // giờ AuthModule có thể inject UsersService
export class AuthModule {}
```

Để dùng một provider từ module khác, module cung cấp phải **export** nó và module tiêu thụ phải **import** module cung cấp — làm cho các dependency trở nên rõ ràng.

## Tại sao điều này quan trọng

Module là xương sống tổ chức của mọi ứng dụng NestJS — chúng nhóm các controller và provider liên quan thành các đơn vị tính năng gắn kết và định nghĩa các ranh giới dependency-injection.

Hiểu bốn thuộc tính (`controllers`, `providers`, `imports`, `exports`) và đặc biệt là cơ chế **import/export** để chia sẻ provider giữa các module là thiết yếu: đó là cách NestJS đạt được kiến trúc module hóa, lỏng lẻo nơi mỗi tính năng tự chứa và các dependency rõ ràng.

Cấu trúc module theo tính năng (một module cho mỗi lĩnh vực) là cách chuẩn để tổ chức ứng dụng Nest cho khả năng mở rộng và dễ bảo trì.

Module, cùng với controller và provider, tạo nên kiến trúc cốt lõi của NestJS, khiến chúng trở thành kiến thức nền tảng — nắm vững cách cấu trúc một ứng dụng thành các module và kết nối provider giữa chúng qua imports/exports là cần thiết để xây dựng bất kỳ ứng dụng NestJS không tầm thường nào và là một điểm thường gây nhầm lẫn đáng để hiểu kỹ sớm.