Apakah itu modules dalam NestJS?

Question

Accepted Answer

**Module** ialah satu kelas yang didekorasi dengan `@Module()` yang **mengumpulkan komponen-komponen berkaitan** — controllers, providers/services — ke dalam satu unit yang padu. Modules ialah cara NestJS menyusun sesuatu aplikasi kepada ciri-ciri (features), dan setiap aplikasi Nest mempunyai sekurang-kurangnya satu root `AppModule`.

## Mentakrifkan satu module

```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 {}
```

## Empat sifat utama

```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
```

Modules membentuk satu **skop DI**: sesuatu provider tersedia dalam module-nya, dan tersedia kepada modules lain hanya jika **di-export** (dan module lain itu **mengimport**-nya).

## Root module

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

Setiap aplikasi mempunyai satu root `AppModule` yang mengimport feature modules, lalu mengadunkan keseluruhan aplikasi.

## Penyusunan berasaskan feature

```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)
```

Konvensyennya ialah **satu module bagi setiap feature/domain** (users, auth, products), supaya kod berkaitan dikekalkan bersama dan dependencies dinyatakan secara jelas.

## Berkongsi providers merentas modules

```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 {}
```

Untuk menggunakan satu provider daripada module lain, module pembekal mesti **meng-export**-nya dan module pengguna mesti **mengimport** module pembekal tersebut — menjadikan dependencies nyata dan jelas.

## Mengapa ia penting

Modules ialah tulang belakang penyusunan bagi setiap aplikasi NestJS — ia mengumpulkan controllers dan providers berkaitan ke dalam unit feature yang padu dan menentukan sempadan dependency injection.

Memahami empat sifat (`controllers`, `providers`, `imports`, `exports`) dan teristimewanya **mekanisme import/export** untuk berkongsi providers merentas modules adalah penting: itulah cara NestJS mencapai seni bina yang modular dan longgar gandingannya (loosely-coupled), di mana setiap feature berdiri sendiri dan dependencies dinyatakan secara jelas.

Struktur module berasaskan feature (satu module bagi setiap domain) ialah cara standard menyusun aplikasi Nest untuk kebolehskalaan dan kebolehselenggaraan.

Modules, bersama-sama controllers dan providers, membentuk seni bina teras NestJS, menjadikannya pengetahuan asas — menguasai cara menstruktur sesuatu aplikasi kepada modules dan mengaitkan providers antaranya melalui imports/exports adalah perlu untuk membina mana-mana aplikasi NestJS yang bukan remeh, dan ia merupakan titik kekeliruan yang kerap berlaku yang wajar difahami betul-betul sejak awal.