Tema 2 · Módulos (@Module)

2. Módulos (@Module): Encapsulamiento de Dominios, imports, providers, controllers y exports

Organiza tu aplicación en módulos de dominio cohesivos, comparte servicios entre módulos y comprende los módulos globales (@Global).

El Grafo Modular de NestJS

Toda aplicación NestJS tiene al menos un módulo raíz (AppModule), pero en proyectos reales jamás registramos todos los controladores y servicios allí. En su lugar, dividimos el sistema en Módulos de Dominio (Feature Modules) como CursosModule, EstudiantesModule y PagosModule.

Diagrama Técnico: Arquitectura Modular e Inyección de Dependencias en NestJS

Diagrama 2.1: Encapsulamiento en @Module, enrutamiento en @Controller e inyección IoC en @Injectable.

Las 4 Propiedades del Decorador @Module()

Propiedad Propósito en el Contenedor de NestJS
providers Servicios, repositorios o fábricas instanciados por el inyector de Nest y compartidos dentro de este módulo.
controllers Conjunto de controladores HTTP definidos en este módulo que deben ser instanciados para escuchar rutas.
imports Lista de otros módulos cuyos proveedores exportados son necesarios dentro de este módulo.
exports Subconjunto de providers de este módulo que se hacen públicos para cualquier otro módulo que lo importe.
💡 Generación rápida con CLI: Ejecuta nest g resource cursos para generar de un solo golpe el módulo, controlador, servicio y carpeta de DTOs/Entidades.

⚡ Encapsulamiento y Exportación de Servicios entre Módulos

Definición de CursosModule exportando CursosService para que MatriculasModule pueda reutilizarlo:

src/cursos/cursos.module.ts
Solo lectura
import { Module } from '@nestjs/common';
import { CursosController } from './cursos.controller';
import { CursosService } from './cursos.service';

@Module({
  imports: [],
  controllers: [CursosController],
  providers: [CursosService],
  // En NestJS los providers son privados al módulo por defecto.
  // Al incluir CursosService en exports, otros módulos que importen CursosModule podrán inyectarlo:
  exports: [CursosService],
})
export class CursosModule {}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
Si el módulo MatriculasModule necesita inyectar y usar CursosService (que pertenece a CursosModule), ¿qué configuración es obligatoria en NestJS?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.