X'inhuma l-moduli f'NestJS?

Question

Accepted Answer

A **module** huwa klassi ddkorata b'`@Module()` li **tiġbor il-komponenti relatati** — controllers, providers/services — f'unità koeziva. Il-moduli huma kif NestJS jorganizza applikazzjoni f'features, u kull app Nest għandha mill-inqas module root `AppModule`.

## Tad-definizzjoni ta' 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 {}
```

## Il-erbgħa proprjetajiet ewlenin

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

Il-moduli jiffurmaw **scope ta' DI**: provider huwa disponibbli fid-daħħal tal-module tiegħu, u l-moduli oħra biss jekk ikun **esportat** (u l-module l-oħra **timporta** lilu).

## Il-module root

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

Kull app għandha module root `AppModule` li jimporta l-feature modules, u jikkomponi l-applikazzjoni kollha.

## Organizzazzjoni bbażata fuq il-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)
```

Il-konvenzjoni hija **module wieħed għal kull feature/domain** (users, auth, products), billi żżomm il-kodiċi relatat flimkien u d-dipendenzit espliċiti.

## Qsim ta' providers fost il-moduli

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

Bex tuża provider minn module ieħor, il-module li jipprovdi għandu **jespot** lilu u l-module li jkonsumah għandu **jimporta** l-module li jipprovdi — u dan jagħmel id-dipendenzit espliċiti.

## Għaliex din hija importanti

Il-moduli huma l-umm tal-organizzazzjoni ta' kull applikazzjoni NestJS — huma jiġbru controllers u providers relatati f'unitajiet feature koezivi u jiddefinisċu l-limitazzjonijiet tal-dependency-injection.
"