Skip to content

Estado actual

Listo hoy (CLI + template)

  • NestJS 11 + TypeScript + pnpm
  • Módulo ejemplo health-check (domain → application → infrastructure)
  • Módulo users con endpoint de creación (POST /api/v1/users) cuando eliges base de datos
  • Domain events opcionales (DomainEvent, AggregateRoot, EventBus Nest/Memory)
  • Hasher con puerto HasherService + adapter HasherBcrypt
  • Value objects compartidos (Email, Password, Salt, HashedString) y contrato UseCase
  • Tests unitarios (*.spec.ts) y e2e (*.e2e-spec.ts)
  • ESLint + Prettier desacoplados
  • Husky (pre-commit) + lint-staged + Commitlint
  • Documentación Swagger (api/docs)
  • Filtro global de errores de dominio (DomainErrorFilter)
  • AGENTS.md — contrato universal para agentes de IA
  • Persistencia PostgreSQL + TypeORM o MongoDB + Mongoose (XOR vía CLI)
  • Health check de BD (GET /api/v1/health-check/database)
  • Docker Compose con perfiles según la BD elegida
  • Scaffolding con wizard interactivo o flags no interactivos

Fases del CLI

FaseStatus
1. Base template copy + Done
2. PostgreSQL installer (TypeORM + users + docker + migrations + db-health)Done
3. Domain events installerDone
4. Mongo installer (XOR with postgres)Done
5. Full sync from backend-boilerDone

En camino

  • EventBus alternativo RabbitMQ-ready (mismo puerto EventBus)
  • Observabilidad opcional (logs Pino, metrics Prometheus/Grafana, traces OpenTelemetry)
  • Logging, validación de env y Docker multi-stage en el template generado

MIT License · Scaffold from backend-boiler