Što su moduli u NestJS-u?

Question

Accepted Answer

**Modul** je klasa dekorirana sa `@Module()` koja **grupira povezane komponente** — kontrolere, providere/servise — u kohezivnu jedinicu. Moduli su način na koji NestJS organizira aplikaciju u funkcionalnosti, i svaka Nest aplikacija ima barem jedan root `AppModule`.

## Definiranje modula

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

## Četiri ključna svojstva

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

Moduli čine **DI opseg**: provider je dostupan unutar svog modula, i ostalim modulima samo ako je **exportan** (i drugi modul ga **importa**).

## Root modul

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

Svaka aplikacija ima root `AppModule` koji importa feature module-e, komponirajući cijelu aplikaciju.

## Organizacija po funkcionalnostima

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

Konvencija je **jedan modul po funkcionalnosti/domeni** (users, auth, products), čuvajući povezan kod zajedno i eksplicirne ovisnosti.

## Dijeljenje providera između modula

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

Da biste koristili provider iz drugog modula, modul koji ga pruža mora ga **exportati** a modul koji ga koristi mora **importati** taj modul — čineći ovisnosti eksplicirnim.

## Zašto je to važno

Moduli su organizacijska osnova svake NestJS aplikacije — oni grupiraju povezane kontrolere i providere u kohezivne feature jedinice i definiraju granice dependency-injection-a.

Razumijevanje četiri svojstva (`controllers`, `providers`, `imports`, `exports`) i posebno **import/export mehanizma** za dijeljenje providera između modula je bitno: to je način na koji NestJS postiže modularnu, slabo-vezanu arhitekturu gdje je svaka funkcionalnost samozatvoren i ovisnosti su eksplicirne.

Struktura modula temeljena na funkcionalnostima (jedan modul po domeni) je standardni način organizacije Nest aplikacija za skalabilnost i održivost.

Moduli, zajedno s kontrolerima i providerima, čine NestJS-ovu jezgru arhitekture, čineći ih fundamentalnim znanjem — vladanje kako strukturirati aplikaciju u module-e i povezati providere između njih preko import/export mehanizma je neophodno za pisanje bilo koje ne-trivijalne NestJS aplikacije i često je točka zbunjenosti koja je vrijedna razumijevanja rano.