Τι είναι τα modules στο NestJS;

Question

Accepted Answer

Ένα **module** είναι μια κλάση διακοσμημένη με `@Module()` που **ομαδοποιεί σχετικά components** — controllers, providers/services — σε μια συνεκτική μονάδα. Τα modules είναι ο τρόπος με τον οποίο το NestJS οργανώνει μια εφαρμογή σε features, και κάθε Nest app έχει τουλάχιστον ένα root `AppModule`.

## Ορισμός ενός 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 {}
```

## Οι τέσσερις βασικές ιδιότητες

```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 σχηματίζουν ένα **DI scope**: ένας provider είναι διαθέσιμος εντός του module του και σε άλλα modules μόνο αν **εξάγεται** (και το άλλο module το **εισάγει**).

## Το root module

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

Κάθε app έχει ένα root `AppModule` που εισάγει τα feature modules, συνθέτοντας ολόκληρη την εφαρμογή.

## Οργάνωση βασισμένη σε features

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

Η σύμβαση είναι **ένα module ανά feature/domain** (users, auth, products), διατηρώντας τον σχετικό κώδικα μαζί και τις εξαρτήσεις ξεκάθαρες.

## Κοινή χρήση providers μεταξύ 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 {}
```

Για να χρησιμοποιήσετε ένα provider από ένα άλλο module, το module που παρέχει πρέπει να το **εξάγει** και το module που καταναλώνει πρέπει να **εισάγει** το module που παρέχει — κάνοντας τις εξαρτήσεις ξεκάθαρες.

## Γιατί είναι σημαντικό

Τα modules είναι το οργανωτικό σκελετό κάθε εφαρμογής NestJS — ομαδοποιούν τους σχετικούς controllers και providers σε συνεκτικές feature units και ορίζουν τα όρια dependency-injection.

Η κατανόηση των τεσσάρων ιδιοτήτων (`controllers`, `providers`, `imports`, `exports`) και ειδικότερα ο **μηχανισμός import/export** για την κοινή χρήση providers μεταξύ modules είναι απαραίτητη: έτσι το NestJS επιτυγχάνει μια ντόμενη, χαλαρά συζευγμένη αρχιτεκτονική όπου κάθε feature είναι αυτόνομη και οι εξαρτήσεις είναι σαφείς.

Η δομή modules βασισμένη σε features (ένα module ανά domain) είναι ο τυποποιημένος τρόπος οργάνωσης Nest apps για κλιμακωσιμότητα και συντηρησιμότητα.

Τα modules, μαζί με controllers και providers, αποτελούν την βασική αρχιτεκτονική του NestJS, κάνοντάς τα θεμελιακή γνώση — η κατάκτηση του τρόπου δόμησης μιας εφαρμογής σε modules και της σύνδεσης providers μεταξύ τους μέσω imports/exports είναι απαραίτητη για τη δημιουργία οποιασδήποτε μη-τετριμμένης εφαρμογής NestJS και είναι ένα συχνό σημείο σύγχυσης που αξίζει να κατανοηθεί καλά νωρίς.