Programación modular en NestJS con UserModule

Contenido del curso

Fundamentos y Primer CRUD

Base de Datos y Persistencia con TypeORM

Autenticación y Autorización

Tu API Completa

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0012:26

Programación modular en NestJS con UserModule

Curso de Backend con NestJS

Clase 10 de 35

Clase 10 / 35

Recursos

La programación modular en NestJS te permite encapsular funcionalidades específicas dentro de módulos independientes, lo que hace tu aplicación más escalable y mantenible. Si vienes trabajando con el app module por defecto y tu proyecto empieza a crecer, este enfoque te ayuda a organizar controladores, servicios y entidades por dominio. Ideal para desarrolladores backend que construyen APIs con NestJS y buscan estructuras profesionales.

Qué es un módulo en NestJS y por qué importa

Un módulo es una unidad que encapsula toda la funcionalidad de un dominio o feature dentro de tu aplicación. Piensa en un e-commerce: en lugar de mezclar todo, separas la lógica en módulos independientes que conviven entre sí.

Ejemplos típicos de módulos en una aplicación real:

Módulo de órdenes de compra con sus controllers, servicios y entidades.
Módulo de autenticación con su propia lógica de login y validación.
Módulo de facturación con sus reglas y endpoints específicos.
Módulo de usuarios para gestionar perfiles y consultas.

¿Qué hace un módulo en NestJS? Agrupa controladores, servicios y entidades relacionadas con una misma funcionalidad, creando un scope aislado que puede comunicarse con otros módulos de forma controlada.

La clave está en que cada módulo tenga responsabilidad sobre un solo dominio. Así, cuando tu app crezca, sabrás exactamente dónde tocar para modificar una feature.

Cómo creo un módulo con el CLI de NestJS

NestJS trae un generador que te ahorra el trabajo manual. Desde la terminal ejecutas el comando y listo.

bash nest g mo users

Este comando hace dos cosas: crea el archivo users.module.ts dentro de la carpeta users y actualiza automáticamente el app.module.ts para incluirlo en los imports. Es un patrón que verás repetido en cualquier proyecto productivo de NestJS.

Cómo refactorizo el App Module para usar módulos

Una vez generado el módulo, toca limpiar el app.module.ts. La idea es que el App Module solo declare otros módulos, no contenga controladores ni servicios propios.

Los pasos concretos del refactor:

Elimina el AppController y el AppService que vienen por defecto.
Borra los imports asociados y el archivo de pruebas del controller.
Mueve UserController y UserService al UserModule, dentro de sus arrays controllers y providers.
Deja el AppModule solo con módulos en imports, como ConfigModule y UserModule.

Después del refactor, tu AppModule queda limpio y declarativo. Es la estructura que vas a encontrar en aplicaciones reales con módulos como PostModule, AuthenticationModule o ChatModule.

Cómo comparto un servicio entre módulos con exports

Aquí viene una de las partes más potentes de la arquitectura modular en NestJS: el control de qué se comparte y qué se mantiene privado. Por defecto, un servicio declarado en un módulo solo puede usarse dentro de ese mismo scope.

Si quieres que otro módulo, como AuthModule, pueda inyectar UserService para hacer un login por email, debes exportarlo explícitamente:

typescript @Module({ controllers: [UserController], providers: [UserService], exports: [UserService], }) export class UserModule {}

¿Por qué exportar un servicio en NestJS? Porque sin el array exports, otros módulos no pueden inyectar ese servicio. Es el mecanismo que protege los límites de tu aplicación y evita acoplamientos no deseados.

Normalmente se exportan los servicios, no los controladores. Los controllers exponen endpoints HTTP hacia el exterior, mientras que los servicios contienen la lógica reutilizable. Esa separación es la que mantiene tu código sano cuando el proyecto escala.

Qué pasa con entidades, DTOs y modelos dentro del módulo

Las entidades, Data Transfer Objects (DTOs) y modelos también viven dentro de la carpeta del módulo, pero no necesitas declararlos explícitamente en el decorador @Module(). Solo controladores y servicios se registran ahí.

Esto te permite mantener toda la estructura de archivos organizada por feature, sin saturar la configuración del módulo.

Qué hago si NestJS no detecta los cambios después del refactor

Un detalle práctico que aparece al refactorizar: a veces el servidor en modo watch se queda con una versión vieja del AppModule y lanza errores diciendo que no encuentra el AppController. La solución es simple.

Detén el proceso en la terminal.
Vuelve a ejecutar el comando de inicio.
Verifica los endpoints en Postman para confirmar que todo responde.

Los endpoints viejos como /my-test o el Hello World deberían devolver un 404 not found, mientras que los de usuarios siguen funcionando igual: GET, POST, PATCH y DELETE responden sin problema en el puerto que tengas configurado, por ejemplo el 4001 si lo defines en una variable de entorno.

Con esto ya tienes tu primera aplicación NestJS estructurada con programación modular. Cuéntame en los comentarios qué módulos planeas crear primero en tu proyecto.

Juan Diego Mejia Maestre

Hace 6 meses•editado

🏗️ Arquitectura y Modularización en NestJS

> Guía Definitiva: Cómo estructurar aplicaciones escalables separando responsabilidades y encapsulando dominios.

🧩 1. Programación Modular

La modularización consiste en dividir la aplicación en "mini-aplicaciones" independientes llamadas Módulos. Cada uno se encarga de un dominio específico (ej: Usuarios, Pagos, Autenticación).

🏗️ Anatomía de un @Module()

Imports: Otros módulos que este módulo necesita (ej: TypeOrmModule).
Controllers: Puertas de entrada que exponen los endpoints.
Providers: Servicios que contienen la lógica de negocio.
Exports: Servicios que este módulo permite que otros utilicen.

📡 2. Controllers vs. Services

NestJS impone una separación clara entre el "Mensajero" y el "Cerebro".

Componente

Responsabilidad

Analogía

Controller

Manejar protocolos (GET, POST), recibir parámetros y validar DTOs.

El Mesero: Toma el pedido y entrega el resultado.

Service

Procesar lógica de negocio, reglas financieras y manipulación de datos.

El Chef: Sabe exactamente cómo preparar la comida.

> [!IMPORTANT] Patrón SingletonLos servicios en NestJS son Singletons por defecto. Esto significa que existe una única instancia del servicio en toda la aplicación, asegurando la integridad de los datos en memoria.

💉 3. Inyección de Dependencias (DI)

Es el mecanismo por el cual un Controller solicita un Servicio. Se realiza a través del Constructor.

TypeScript

// users.controller.ts
constructor(private readonly usersService: UsersService) {}

🛠️ 4. Comandos Esenciales (CLI)

Para mantener la estructura profesional, usa siempre el CLI de NestJS (evita confundirlo con el de Angular ng).

Generar Módulo: nest g mo [nombre]
Generar Servicio: nest g s [nombre]
Generar Controlador: nest g co [nombre]
Generar Recurso Completo (CRUD): nest g res [nombre]

✅ 5. Mejores Prácticas de Refactorización

Vaciar el AppModule: El módulo raíz solo debe importar otros módulos y configuraciones globales.
No compartir Controllers: Nunca exportes un Controller; solo exporta Servicios si otro módulo necesita su lógica.
Encapsulamiento: Si un módulo de Pagos necesita datos de Usuarios, importa el UsersModule (previa exportación del UsersService).
DRY (Don't Repeat Yourself): Centraliza la lógica repetitiva en métodos privados dentro de tus servicios.

Fundamentos y Primer CRUD

Crea una API RESTful con NestJS

Instalación del CLI de NestJS y primer proyecto con API

Creación de endpoints dinámicos para consultar usuarios en NestJS

Operaciones CRUD en APIs REST con Postman

Método PUT para actualizar usuarios con ID automático

Manejo de status codes HTTP en NestJS

DTOs y validación automática de datos en APIs con NestJS

Servicios y lógica de negocio en NestJS

Variables de entorno seguras en NestJS

Programación modular en NestJS con UserModule

Base de Datos y Persistencia con TypeORM

Configuración de PostgreSQL con Docker y Docker Compose

Configuración de PostgreSQL con TypeORM en aplicaciones NestJS

Creación de entidades ORM con decoradores en TypeScript

Repository Pattern con TypeORM en NestJS

Relaciones uno a uno entre usuarios y perfiles en PostgreSQL

Actualización de DTOs con mapped types en NestJS para perfil y usuario

Generación automática de módulos CRUD con NestJS y AI

Relación uno a muchos con TypeORM

CRUD de categorías con IA en NestJS

Relaciones many-to-many con TypeORM y validación de arrays

Reutilización de servicios entre módulos en NestJS

Migraciones en TypeORM sin perder datos

Cómo evitar perder datos al migrar columnas

Autenticación y Autorización

Hashing de contraseñas con Bcrypt en NestJS

Excluir campos sensibles con ClassTransformer

Autenticación local con Passport en NestJS

Endpoint de login con Passport en NestJS

Implementación de JSON Web Token para autenticación en NestJS

Rutas protegidas con JWT en NestJS

User ID automático desde JWT en NestJS

Tu API Completa

Autogenera resúmenes e imágenes con OpenAI en NestJS

Documentación automática de APIs con Swagger en NestJS

Preparar tu API NestJS para producción

Desplegar aplicación Node.js a producción con Railway y PostgreSQL

Desarrollo de API REST escalable con NestJS en producción

Programación modular en NestJS con UserModule