How kdstrides/nestjs-structure works
This is a NestJS starter backend with a small users API and a separate hello-world endpoint. The principal workflow is an HTTP request to a users route, then controller-to-service delegation and (for create/update) service-to-repository delegation. The tree also shows app and database configuration, persistence models, and serialization support, but the available excerpts do not establish their runtime wiring in detail; those components are shown without speculative connections.
Main entry points: app.module.ts App module · users.module.ts Users module · config.module.ts App config module · app.controller.ts App controller
Components 23
API and app
- App controller
src/app.controller.ts - App service
src/app.service.ts - App module
src/app.module.ts - Application entry
src/main.ts
Users domain
- Users controller
src/modules/users/users.controller.ts - Users service
src/modules/users/users.service.ts - Users module
src/modules/users/users.module.ts - User interface
src/models/users/interfaces/users.interface.ts - User serializer
src/models/users/serializers/users.serializer.ts - Queried entity decorator
src/common/decorators/queried.entity.ts
Persistence
- Users repository
src/modules/users/users.repository.ts - Model repository
src/models/model.repository.ts - User entity
src/models/users/entities/users.entity.ts - Model serializer
src/common/serializers/model.serializer.ts - Postgres provider
src/providers/database/provider.module.ts
Configuration
- App config module
src/config/app/config.module.ts - App config service
src/config/app/config.service.ts - App configuration
src/config/app/configuration.ts - Database config module
src/config/database/config.module.ts - Database config service
src/config/database/config.service.ts - Database configuration
src/config/database/configuration.ts - Database config interface
src/config/database/config.interface.ts
Other components
- HTTP client
Connections 15
- HTTP client → Users controller: sends HTTP
src/modules/users/users.controller.ts - HTTP client → App controller: sends HTTP
src/app.controller.ts - Users controller → Users service: delegates to
src/modules/users/users.controller.ts - Users service → Users repository: calls
src/modules/users/users.service.ts - App controller → App service: calls
src/app.controller.ts - App module → App controller: registers
src/app.module.ts - App module → App service: registers
src/app.module.ts - App module → App config module: imports
src/app.module.ts - App module → Postgres provider: imports
src/app.module.ts - App module → Users module: imports
src/app.module.ts - Users module → Users controller: registers
src/modules/users/users.module.ts - Users module → Users service: provides
src/modules/users/users.module.ts - Users module → Users repository: registers repository
src/modules/users/users.module.ts - App config module → App configuration: loads
src/config/app/config.module.ts - App config module → App config service: provides
src/config/app/config.module.ts