Configuración

Runtime

La API es una aplicación NestJS ejecutada sobre Node.js. La persistencia se realiza con MongoDB mediante Mongoose.

Variables De Entorno

Variable	Obligatoria	Descripción
PORT	No	Puerto HTTP donde escucha la aplicación. Si no se define, usa el valor por defecto del código.
MONGODB_URI	Si	Cadena de conexión a MongoDB. No debe documentarse ni commitearse con valores reales.

Health Check

GET /health

Respuesta esperada:

{
  "ok": true,
  "service": "customers-api",
  "timestamp": "2026-06-24T19:30:00.000Z"
}

Scripts NPM

Script	Descripción
npm run start	Inicia NestJS
npm run start:dev	Inicia NestJS en modo watch
npm run build	Compila la aplicación
npm run start:prod	Ejecuta dist/main
npm run test	Ejecuta pruebas unitarias
npm run test:e2e	Ejecuta pruebas e2e
npm run lint	Ejecuta ESLint con autofix
npm run format	Formatea archivos TS con Prettier

Validación De Requests

La aplicación registra un ValidationPipe global con:

• whitelist: true
• forbidNonWhitelisted: true
• transform: true

Esto significa que NestJS rechaza propiedades no declaradas en los DTOs y transforma tipos cuando corresponde.